1. 核心功能与使用场景

Claude Code 是由 Anthropic 公司开发的一款革命性的 AI 编程助手，它通过终端优先的设计和强大的代理能力，为开发者提供了全新的编程体验 。与传统的 IDE 插件不同，Claude Code 采用代理式架构，能够直接在终端中运行，深度理解整个代码库的上下文，并通过自然语言指令完成复杂的编程任务 。这种“超级智能体化”的特性使其不仅仅是一个聊天机器人，而是一个能够“掌握方向盘”的编程伙伴，能够处理从功能构建到问题调试的全方位开发需求 。其核心优势在于将 AI 的能力无缝融入到开发者最熟悉的终端环境中，无需切换至新的 IDE 或网站，从而最大限度地减少对现有工作流的干扰 。

1.1 从描述构建功能

Claude Code 最核心的功能之一是能够根据自然语言描述直接构建软件功能。开发者只需用 plain English 描述他们想要实现的功能，例如“帮我开发一个完整的用户认证系统”，Claude Code 便会启动其代理式工作流程 。这个过程并非简单的代码生成，而是包含了深入的需求分析、架构规划、代码编写、测试验证等一系列步骤。Claude 会首先分析代码库，理解现有架构和技术栈，然后制定一个详细的实施计划，并在执行过程中不断调整和优化 。例如，在构建一个 OAuth2 认证系统时，它可以自主地创建 API 端点、实现认证逻辑、处理安全漏洞，并生成相应的单元测试，最终确保功能的完整性和可用性 。这种能力极大地提升了开发效率，尤其是在处理复杂或重复性高的任务时，能够将开发者从繁琐的编码工作中解放出来，专注于更高层次的系统设计。

1.2 调试与修复问题

在调试和修复问题方面，Claude Code 展现了其强大的代码库理解和分析能力。当开发者遇到一个 bug 或错误信息时，可以直接将错误描述或日志粘贴给 Claude Code 。Claude 会主动分析整个代码库，追踪问题的根源，并自动实施修复方案。资深开发者 Steve Yegge 曾评价其“绝对无情地处理我那些棘手旧代码库中的遗留 bug”，这得益于其能够深入理解复杂的、甚至是遗留的代码结构 。例如，当遇到一个构建错误时，Claude Code 不仅会检查相关的源代码文件，还会分析构建脚本、依赖关系和配置文件，从而定位问题所在 。此外，它还支持通过截图进行调试，开发者可以将包含错误信息的 UI 截图发送给 Claude，它能够理解视觉信息并辅助排查 UI 相关的问题 。这种主动、全面的调试方式，显著缩短了问题定位和修复的时间，提升了代码的健壮性。

1.3 代码库导航与理解

Claude Code 具备对整个项目代码库的宏观理解能力，这使其成为一个强大的代码导航和知识问答工具。开发者可以向它询问关于代码库的任何问题，例如“解释这个项目的架构”或“这个 API 的调用流程是怎样的” 。Claude Code 能够快速扫描项目结构，读取相关文件，并以清晰的语言给出解释。这种能力对于新成员快速熟悉项目、理解复杂业务逻辑或回顾旧代码库尤其宝贵 。更进一步，通过集成 Model Context Protocol (MCP)，Claude Code 的能力可以扩展到外部数据源，例如直接从 Google Drive 读取设计文档、从 Jira 获取任务详情，或从 Slack 获取团队讨论记录，从而提供更丰富、更全面的上下文信息 。这种深度的上下文感知能力，确保了 Claude 在回答问题和执行任务时，能够始终基于最新、最准确的信息。

1.4 自动化繁琐任务

Claude Code 能够自动化处理开发过程中大量繁琐、重复性的任务，从而显著提升开发者的日常工作效率。这些任务包括但不限于：修复代码风格问题（lint issues）、解决 Git 合并冲突（merge conflicts）、编写发布说明（release notes）以及生成测试用例 。例如，开发者可以简单地指令 Claude “修复所有 ESLint 警告”，Claude 便会自动运行 linter，并根据报告修改代码，直至所有警告被清除。在 Git 工作流中，它可以协助创建提交信息、推送代码并创建 Pull Request (PR) 。对于测试，Claude 可以根据代码变更自动生成相应的单元测试或集成测试，确保代码质量 。这种自动化能力不仅节省了开发者宝贵的时间，也减少了因手动操作可能引入的人为错误，使得开发流程更加规范和高效。

2. 安装与初始化

要开始使用 Claude Code，首先需要进行正确的安装和初始化配置。这个过程主要包括安装 CLI 工具、配置 API 密钥以及为项目建立记忆文件，以便 Claude 能够更好地理解和适应你的代码库。

2.1 安装 Claude Code

安装 Claude Code 有多种方式，适用于不同的操作系统和偏好。官方推荐使用 curl 或 PowerShell 脚本进行安装，这种方式简单快捷。同时，也支持通过 npm 或 Homebrew 进行安装 。

系统要求：

• Node.js 18.0 或更高版本 。
• 一个有效的 Claude.ai 账户（推荐 Pro 或 Max 订阅）或设置了付费的 Anthropic API 密钥 。
• Windows 用户需要通过 WSL2 (Windows Subsystem for Linux) 运行 。

安装方法：

方法	适用平台	命令
curl 脚本	macOS, Linux	`curl -fsSL https://claude.ai/install.sh
PowerShell 脚本	Windows	`irm https://claude.ai/install.ps1
npm	所有平台 (需 Node.js)	npm install -g @anthropic-ai/claude-code
Homebrew	macOS	brew install --cask claude-code

安装完成后，可以通过在终端输入 claude -v 来验证安装是否成功 。首次运行 claude 命令时，系统会引导你通过浏览器登录你的 Anthropic 账户，完成身份验证和授权 。

2.2 配置 API Key

Claude Code 的运行依赖于 Anthropic 的 API，因此需要一个有效的 API 密钥。你可以通过两种方式之一来提供：

1. Claude.ai 订阅账户：如果你使用的是 Claude Pro 或 Claude Max 订阅，登录后，Claude Code 会自动与你的账户关联，无需手动配置 API 密钥。Claude Max 订阅提供了几乎无限的使用量，非常适合重度使用者 。
2. API 密钥：如果你使用的是按量付费的 API 模式，你需要在 Anthropic 控制台创建一个 API 密钥，并将其配置到环境变量 ANTHROPIC_API_KEY 中。这种方式适合企业用户或有特定成本控制需求的开发者 。

在企业环境中，还可以通过企业级部署配置托管策略和 MCP 服务器，以实现对 API 密钥和工具访问的集中管理 。

2.3 项目初始化与记忆配置

为了让 Claude Code 更好地理解你的项目，进行项目初始化是至关重要的一步。这主要通过创建和配置 CLAUDE.md 文件来实现，该文件是 Claude 理解你项目架构、规范和偏好的“大脑”。

2.3.1 使用 /init 创建项目记忆

在项目根目录下启动 Claude Code 后，输入 /init 命令，Claude 会自动扫描你的代码库，分析其结构、技术栈和依赖关系，并生成一个初始的 CLAUDE.md 文件 。这个过程被称为“引导模式”（The Bootstrap Pattern），它相当于让 Claude 对你的项目进行一次全面的“采访”，并将关键信息记录下来，为后续的交互打下基础 。这个初始文件通常包含了项目的基本信息、主要目录结构和关键配置文件的介绍。

2.3.2 理解 CLAUDE.md 的作用

CLAUDE.md 文件是 Claude Code 记忆系统的核心，它扮演着项目“宪法”的角色，为 Claude 提供了持久化的上下文 。这个文件应该被提交到版本控制中，以便团队成员共享，确保所有开发者在使用 Claude 时都能获得一致的、高质量的帮助 。

一个精心维护的 CLAUDE.md 文件应该包含以下内容：

• 项目架构概述：描述项目的整体架构，例如是单体应用还是微服务，采用了哪些核心框架（如 React, Next.js, Django）。
• 编码规范：明确代码风格指南，例如使用 Tab 还是空格，ESLint 规则，命名约定等。
• API 设计模式：记录项目中使用的 API 设计规范，如 REST 或 GraphQL 的最佳实践。
• 关键命令：列出常用的构建、测试和部署命令，例如 npm run build, npm test 。
• 不应触碰的文件或目录：明确指出哪些文件是自动生成的或不应被修改的，以避免 Claude 误操作 。

最佳实践建议将 CLAUDE.md 视为一份高层次、经过精心筛选的指引，而不是一本面面俱到的手册。它应该聚焦于 Claude 容易出错或需要明确指导的地方，而不是从零开始详尽记录所有内容 。

2.3.3 使用 /memory 编辑记忆文件

除了手动编辑 CLAUDE.md 文件外，Claude Code 还提供了 /memory 命令，允许你在交互会话中直接查看和编辑记忆文件 。此外，一个更便捷的技巧是在指令前加上 # 符号。例如，输入 # 构建项目前必须先运行 npm run typecheck，Claude 会自动将这条信息添加到相应的记忆文件中 。这种“快速记忆模式”（The Quick Memory Pattern）使得在开发过程中动态更新项目规范变得非常方便，确保了记忆的实时性和准确性。

3. 常用命令详解

掌握 Claude Code 的常用命令是高效利用其能力的关键。这些命令涵盖了从启动会话、管理上下文到操作代码和配置工具的各个方面。

3.1 启动与会话管理

Claude Code 提供了灵活的会话管理方式，允许开发者根据任务需求选择不同的启动和交互模式。

3.1.1 启动交互模式 (claude)

在项目目录下直接输入 claude 命令，即可启动交互式会话 。这是最常见的使用方式，启动后，你会进入一个聊天界面，可以通过自然语言与 Claude 进行对话，执行各种编程任务。这种方式适合进行复杂的、需要多轮交互的开发工作，例如构建新功能或进行深度调试。

3.1.2 运行一次性任务 (claude -p)

对于简单的、一次性的查询或任务，可以使用 claude -p "your prompt" 命令 。这种方式下，Claude 会执行完指令后立即退出，并将结果输出到终端。例如，claude -p "explain this function" 可以快速获取对某个函数的解析。这种方式非常适合集成到脚本或自动化流程中，例如作为代码审查工具的一部分 。

3.1.3 继续最近的对话 (claude -c)

使用 claude -c 命令可以快速恢复并继续上一次的对话会话 。这在处理一个需要分阶段完成的复杂任务时非常有用，可以避免丢失之前的上下文和讨论历史，确保工作的连续性。

3.1.4 恢复指定会话 (claude -r)

claude -r 命令允许你从历史会话列表中选择一个特定的会话进行恢复 。这对于回顾几天前的某个解决方案或继续一个被中断的长期任务非常有帮助。所有会话历史都保存在 ~/.claude/projects/ 目录下，也可以通过提供具体的会话 ID 来直接恢复 。

3.2 项目管理与上下文

有效管理项目上下文是确保 Claude Code 高效、准确工作的前提。

3.2.1 添加工作目录 (/add-dir)

默认情况下，Claude Code 只能访问启动时所在的项目目录。使用 /add-dir <path> 命令可以添加额外的、允许 Claude 访问的工作目录 。这在处理跨多个目录的 monorepo 项目时尤其有用，可以确保 Claude 拥有完整的项目视图。

3.2.2 清除对话历史 (/clear)

当需要切换到一个全新的、与之前对话无关的任务时，使用 /clear 命令可以清除当前的对话历史和上下文 。这比退出并重启会话更快捷，可以避免之前的上下文对新任务产生干扰，确保 Claude 从一个干净的状态开始工作。

3.2.3 压缩对话上下文 (/compact)

Claude Code 的上下文窗口虽然很大（约 200K tokens），但并非无限 。当对话过长，token 使用量接近上限时，可以使用 /compact 命令 。该命令会智能地总结对话历史，保留关键信息和决策点，同时大幅减少 token 占用，从而允许更长的交互。不过，有经验丰富的用户建议不要完全依赖自动压缩，在复杂任务中，手动清理或使用“记录与清理”模式可能更可靠 。

3.2.4 恢复历史话题 (/resume)

在交互会话中，输入 /resume 可以切换到其他历史会话，功能类似于启动时的 claude -r 命令 。这提供了一种在活跃会话中快速跳转和管理多个任务流的方式。

3.3 代码操作与审查

Claude Code 提供了强大的代码操作和审查功能，可以直接集成到日常开发工作流中。

3.3.1 请求代码审查 (/review)

/review 命令是日常开发中非常实用的功能。它会指示 Claude 对你当前的代码变更（如 Git 工作区中的改动）进行一次全面的审查 。Claude 会检查潜在的 bug、代码风格问题、性能瓶颈，并给出改进建议。这相当于拥有了一个 24/7 在线的 AI 代码审查员，可以显著提高代码质量和审查效率。

3.3.2 执行安全审查 (/security-review)

虽然 /review 命令会涵盖一部分安全问题，但在处理安全关键代码时，可以使用更专门的指令或自定义命令来进行深度安全审查。例如，可以创建一个自定义命令，专门用于检查常见的安全漏洞，如 SQL 注入、XSS 等。

3.3.3 生成 Git 提交 (claude commit)

Claude Code 深度集成了 Git 工作流。claude commit 命令可以分析你的代码变更，并自动生成一条清晰、描述性的提交信息 。这避免了编写“WIP”或无意义提交信息的坏习惯，使得项目历史更加清晰易读。

3.4 配置与管理

这些命令用于管理 Claude Code 自身的设置、模型和集成。

3.4.1 查看与修改配置 (/config)

/config 命令允许你查看和修改当前的配置，包括主题、是否启用待办事项列表、权限提示等 。更高级的配置可以通过编辑 settings.json 文件来完成，该文件支持用户级、项目级和企业级的分层设置 。

3.4.2 切换 AI 模型 (/model)

Claude Code 支持切换不同的 AI 模型，如默认的 Claude 3.5 Sonnet 和更强大的 Claude 4 Opus 。使用 /model 命令可以在交互会话中方便地切换模型，以适应不同复杂度的任务。通常，Sonnet 性价比高，适合日常任务；而 Opus 性能更强，适合处理非常复杂或需要深度推理的问题 。

3.4.3 查看 Token 使用成本 (/cost)

由于 Claude Code 的使用会产生费用，监控成本非常重要。/cost 命令可以显示当前会话的 token 使用情况和预估费用 。对于更详细的监控，社区开发了如 ccusage 这样的第三方工具，可以提供按日、按月或按会话的详细成本分析报告 。

3.4.4 管理 MCP 服务器 (/mcp)

/mcp 命令用于管理 Model Context Protocol (MCP) 服务器的连接和认证 。通过 MCP，可以扩展 Claude 的能力，使其能够与数据库、浏览器等外部工具交互。例如，可以添加一个 Postgres MCP 服务器，让 Claude 能够直接查询数据库 。

3.4.5 检查安装健康状况 (/doctor)

如果在使用过程中遇到问题，/doctor 命令可以检查你的 Claude Code 安装是否健康，并诊断潜在的问题 。这是一个非常有用的故障排查工具。

4. 高级技巧与最佳实践

要真正发挥 Claude Code 的潜力，需要掌握一些高级技巧和最佳实践。这些技巧涵盖了从记忆管理、工作流定制到与环境深度集成的方方面面，旨在帮助你构建一个更高效、更智能、更个性化的开发环境。

4.1 高效记忆管理

Claude Code 的记忆系统是其区别于其他 AI 工具的关键特性之一。通过精心管理记忆，你可以让 AI 更深刻地理解你的项目和个人偏好，从而获得更精准、更一致的输出。

4.1.1 记忆系统的三层架构

Claude Code 的记忆系统采用了一个清晰的三层架构，每一层都有其特定的作用域和优先级，确保了配置的灵活性和可维护性 。

1. 企业策略 (Enterprise Policy) ：这是最高优先级的记忆层，通常由组织的 IT 或 DevOps 团队集中管理。其配置文件位于操作系统的全局目录中，例如在 macOS 上是 /Library/Application Support/ClaudeCode/CLAUDE.md，在 Linux 上是 /etc/claude-code/CLAUDE.md 。这个文件用于定义整个组织范围内的指令，如统一的编码标准、安全策略、合规性要求和 CI/CD 流程。通过配置管理系统（如 Ansible 或 MDM）部署，可以确保组织内所有开发者的 Claude Code 都遵循一致的规范，从而促进团队协作和代码质量的一致性。

2. 项目记忆 (Project Memory) ：这是最常用的一层，存储在项目根目录下的 CLAUDE.md 文件中，并被纳入版本控制 。这个文件是团队的共享大脑，记录了特定项目的所有关键信息，包括项目架构、技术栈、编码规范、常用工作流、构建和测试命令等。当新成员加入项目时，这个文件可以帮助他们快速了解项目背景和开发约定。由于它被提交到 Git 仓库，因此可以随着项目的演进而更新，确保 AI 始终掌握最新的项目状态。

3. 用户记忆 (User Memory) ：这是最个性化的记忆层，存储在用户主目录下的 ~/.claude/CLAUDE.md 文件中 。这个文件用于保存开发者个人的、跨所有项目的偏好设置，例如个人偏好的代码风格、常用的工具别名、默认的交互语言等。这个文件只影响当前用户，为开发者提供了一个定制 AI 行为的私有空间，使其真正成为个人的编程助理。

这种分层架构遵循一个核心原则：越具体的记忆，优先级越高。这意味着，如果一个指令在项目级记忆和用户级记忆中都存在，那么项目级的定义将覆盖用户级的定义，从而确保在团队协作中，项目特定的规范能够优先生效 。

4.1.2 使用 # 快速记录关键信息

在日常开发中，经常会遇到一些需要 AI 记住的临时但重要的信息，例如一个特定的 API 限流规则、一个环境相关的构建参数，或者一个刚刚发现的“坑点”。为了高效地捕捉这些信息，Claude Code 提供了一个极其便捷的快捷方式：在输入框中以 # 字符开头 。当用户输入 # 并跟上需要记录的信息时，Claude Code 会立即识别并弹出一个提示，询问用户希望将此信息保存到哪个记忆文件中（通常是项目级或用户级的 CLAUDE.md）。用户只需确认，该信息就会被自动追加到相应的文件中。例如，在调试一个前端显示问题时，发现需要先检查浏览器控制台日志，可以直接输入 # 遇到前端页面展示问题，先用 playwright mcp 查看页面和 console 日志 。这个看似微小的功能，极大地降低了维护长期记忆的门槛，鼓励开发者将零散的知识即时沉淀下来，避免了在后续会话中因遗忘而重复犯错，从而形成一个持续学习和改进的正向循环。

4.1.3 会话专注与上下文维护

Claude Code 的上下文窗口虽然巨大（高达 200K tokens），但并非无限。在一个会话中混杂多个不相关的任务，或者让对话历史无限增长，都会导致上下文被无关信息“污染”，从而降低 AI 的专注度和输出质量，甚至导致其“忘记”关键指令 。因此，高效的上下文管理是保持 AI 助手高效能的核心。最佳实践建议采用“一个会话，一个任务”的原则 。当开始一个新任务时，最好启动一个新会话或使用 /clear 命令清空历史，以确保一个干净的起点。在任务进行过程中，如果上下文变得过于冗长，可以主动使用 /compact 命令进行压缩，而不是等到自动压缩被触发（通常在 token 使用率达到 92% 时），因为主动压缩能更好地控制保留哪些关键信息 。当任务完成后，应将与该任务相关的关键决策、架构变更或解决方案总结出来，并使用 # 快捷方式或 /memory 命令更新到 CLAUDE.md 中，然后使用 /clear 结束会话。这种结构化的工作流，即“开始-专注-总结-清理”的循环，不仅能保持 AI 的高性能，还能持续丰富项目的长期记忆，实现效率的复利增长。

4.2 自定义工作流

4.2.1 创建自定义斜杠命令

为了将重复性的、复杂的或特定于项目的工作流自动化，Claude Code 允许用户创建自定义的斜杠命令（Slash Commands）。这是一个极其强大的功能，可以将任何预定义的指令序列封装成一个简单的命令，从而极大地提升效率。创建自定义命令非常简单：只需在项目根目录下的 .claude/commands/ 目录中创建一个 Markdown 文件，文件名即为命令名，文件内容则是该命令要执行的指令 。例如，创建一个 .claude/commands/deploy-dev.md 文件，其内容可以是一个部署脚本，包含构建和 SCP 传输命令。保存后，在 Claude Code 中输入 /deploy-dev 即可执行该脚本。自定义命令不仅限于 Bash 脚本，还可以是复杂的自然语言提示，例如创建一个 optimize.md 命令，其内容是“你是性能优化专家，请分析指定代码并给出改进方案” 。此外，命令还支持参数传递，通过 $1, $2 或 $ARGUMENTS 占位符来接收用户输入，使命令更加灵活。这个功能将 Claude Code 从一个通用的 AI 助手，转变为一个深度定制、与项目工作流无缝集成的强大工具。

4.3 提升效率的快捷键

4.3.1 基础操作快捷键

在 Claude Code 的交互式终端中，掌握一些基础的键盘快捷键可以显著提升操作效率，减少在键盘和鼠标之间的切换。以下是一些最常用且核心的快捷键：

• Ctrl + C: 这个快捷键用于取消当前正在进行的操作。如果 AI 正在生成一个冗长的回复，或者用户意识到自己输入了错误的指令，按下 Ctrl + C 可以立即停止当前的生成过程，返回到命令提示符，而不会退出整个会话 。
• ESC: 与 Ctrl + C 类似，ESC 键也可以用来中断当前的输出。在某些情况下，它可能比 Ctrl + C 响应更快，尤其是在需要立即停止 AI 正在执行的任务时 。
• Ctrl + D: 此快捷键用于退出当前的交互式会话（EOF - End of File）。当工作完成或需要关闭终端时，可以使用它来优雅地退出 Claude Code 。
• Ctrl + L: 这个快捷键用于清屏，类似于 clear 命令。它会清除终端屏幕上的所有文本，但不会清除 Claude Code 的对话历史记录。这与 /clear 命令有本质区别，后者会重置 AI 的上下文 。

熟练掌握这些基础快捷键，可以让用户在与 Claude Code 的交互中更加流畅和高效。

4.3.2 多行输入与命令历史

在处理复杂指令或需要输入多行代码时，Claude Code 提供了便捷的支持。默认情况下，按下 Enter 键会立即发送当前输入。如果需要输入多行内容，可以使用 Shift + Enter 来插入一个换行符，而不会执行命令 。这使得用户可以在一个输入框中完整地编写一段代码或一个详细的提示，确保格式的正确性。需要注意的是，在某些终端（如 iTerm2 和 VSCode）中，可能需要先运行 /terminal-setup 命令来启用 Shift+Enter 的绑定 。

此外，Claude Code 还提供了类似 shell 的命令历史功能。通过按 上箭头 和 下箭头 键，用户可以浏览并重新调用之前输入过的命令或提示 。这在需要重复执行相似任务或对之前的指令进行微调时非常有用，避免了重复输入的麻烦。结合 Tab 键的自动补全功能（用于文件路径和命令），可以极大地加快输入速度，提升整体的工作流效率。

4.3.3 启用与使用 Vim 模式

对于许多资深开发者，尤其是后端和运维工程师，Vim 的模态编辑理念已经深入骨髓，成为他们最高效的文本编辑方式。认识到这一点，Claude Code 特别集成了 Vim 模式，允许用户在交互式提示符中直接使用熟悉的 Vim 键位绑定进行文本编辑 。这一功能极大地提升了终端原生用户的体验，让他们无需离开键盘去使用鼠标，也无需适应新的编辑快捷键，从而能够以极快的速度构建和修改发送给 Claude 的指令。启用 Vim 模式非常简单，用户只需在交互会话中输入斜杠命令 /vim 即可立即切换 。此外，用户还可以通过 /config 命令进入配置菜单，将 Vim 模式设置为默认启用的编辑模式，这样每次启动 Claude Code 时都会自动进入该模式 。

Vim 模式的核心在于其模态特性，主要分为 NORMAL（普通）模式和 INSERT（插入）模式。默认情况下，用户处于 INSERT 模式，可以直接输入文本。按下 Esc 键即可从 INSERT 模式切换到 NORMAL 模式，此时用户可以执行各种导航和编辑命令 。例如，在 NORMAL 模式下，用户可以使用 h, j, k, l 键来分别向左、下、上、右移动光标，使用 w, e, b 来按单词进行前后跳转，或者使用 0 和 $ 快速移动到行首和行尾 。编辑方面，命令如 x 用于删除光标下的字符，dd 用于删除整行，而 cw 则可以删除一个单词并立即进入 INSERT 模式进行修改 。这种强大的组合使得在 Claude Code 的输入框中进行复杂的文本操作变得异常高效和直观。

4.3.3.1 模式切换与导航

在 Claude Code 的 Vim 模式中，流畅地在不同模式间切换以及高效地导航文本是提升编辑效率的基础。模式切换是所有 Vim 操作的起始点。用户默认处于 INSERT 模式，可以直接输入文本。当需要执行导航或编辑命令时，必须首先按下 Esc 键进入 NORMAL 模式 。一旦进入 NORMAL 模式，用户就可以通过一系列快捷键来移动光标。最基础的移动是使用 h（左）、j（下）、k（上）、l（右）键，这允许用户以字符为单位进行精确移动 。为了更快地移动，可以使用基于单词的导航：w 键将光标移动到下一个单词的开头，e 键移动到当前或下一个单词的末尾，而 b 键则移动到前一个单词的开头 。

除了基于单词的移动，Vim 模式还支持行内和全文范围的快速跳转。在行内，按 0 键可以将光标移动到当前行的行首，而 $ 键则移动到行尾 。如果需要移动到行内第一个非空白字符，可以使用 ^ 键 。对于更大范围的移动，gg 命令可以将光标直接跳转到整个输入文本的开头，而 G 命令则会跳转到文本的末尾 。这些导航命令的组合使用，使得用户可以在多行、长文本的输入框中快速定位到任何需要编辑的位置，无论是微调一个单词、修改一整行，还是跳转到文本的特定部分，都能通过最少的按键次数完成，极大地优化了构建复杂指令时的文本编辑体验。

命令	模式	动作描述	使用场景
Esc	INSERT -> NORMAL	从插入模式切换到普通模式，以执行命令。	完成文本输入后，准备进行移动、删除或修改操作。
i	NORMAL -> INSERT	在光标当前位置前插入文本。	需要在光标所在位置之前添加新内容。
I	NORMAL -> INSERT	在当前行的行首插入文本。	需要在一行的开头添加内容，比 ^i 更快捷。
a	NORMAL -> INSERT	在光标当前位置后插入文本。	需要在光标所在位置之后立即添加新内容。
A	NORMAL -> INSERT	在当前行的行尾插入文本。	需要在一行的末尾追加内容，比 $a 更快捷。
o	NORMAL -> INSERT	在当前行下方创建一个新行并进入插入模式。	需要在当前行之后开始一段新的文本。
O	NORMAL -> INSERT	在当前行上方创建一个新行并进入插入模式。	需要在当前行之前开始一段新的文本。
h / j / k / l	NORMAL	向左 / 向下 / 向上 / 向右移动光标。	进行精确的、基于字符的光标定位。
w / e / b	NORMAL	移动到下一个单词的开头 / 单词的末尾 / 上一个单词的开头。	在文本中快速按单词进行跳转，提高导航效率。
0 / $ / ^	NORMAL	移动到当前行的行首 / 行尾 / 第一个非空白字符。	在行内进行快速定位，常用于编辑行的开头或结尾。
gg / G	NORMAL	移动到文本的开头 / 文本的末尾。	在长文本中快速跳转到起始或结束位置。

4.3.3.2 文本编辑命令

在 Claude Code 的 Vim 模式中，一旦通过导航命令将光标定位到目标位置，就可以使用一系列强大的编辑命令来修改文本。这些命令的设计遵循 Vim 的哲学，即通过简洁的按键组合完成复杂的编辑任务，从而最大化效率。最基础的编辑操作是删除。在 NORMAL 模式下，按 x 键可以删除光标当前所在的字符 。如果需要删除整行文本，可以使用 dd 命令 。而 D 命令则更为灵活，它会删除从光标位置到该行末尾的所有内容 。此外，还可以结合单词移动命令进行删除，例如 dw 删除从光标到下一个单词开头的字符，de 删除到当前单词末尾的字符，而 db 则删除到前一个单词开头的字符 。

除了删除，修改（change）命令也是文本编辑中的核心。cc 命令会删除整行文本并立即进入 INSERT 模式，方便用户重写整行 。类似地，C 命令会删除从光标到行尾的内容并进入 INSERT 模式。对于单词级别的修改，cw 命令会删除光标所在的单词并进入 INSERT 模式，这在需要替换一个特定单词时非常高效 。同样，ce 和 cb 分别用于修改到单词末尾或前一个单词开头的内容 。Vim 模式还提供了一个非常实用的重复命令 .（点），它会重复执行上一次执行的删除或修改操作，这在需要对多处文本进行相同修改时，可以极大地减少重复劳动 。这些编辑命令的灵活组合，使得在 Claude Code 的输入框中进行复杂的文本重构和修改变得游刃有余。

命令	模式	动作描述	使用场景
x	NORMAL	删除光标当前所在的字符。	快速删除单个错误的字符。
dd	NORMAL	删除光标所在的整行。	需要移除一整行文本时，比用鼠标选中再删除更高效。
D	NORMAL	删除从光标位置到行尾的所有内容。	当需要保留行首内容，但删除后半部分时非常有用。
dw / de / db	NORMAL	删除从光标到下一个单词开头 / 当前单词末尾 / 前一个单词开头的内容。	按单词为单位进行删除，比逐字符删除更快捷。
cc	NORMAL	删除整行并进入插入模式。	需要完全重写一行内容时的快捷操作。
C	NORMAL	删除从光标到行尾的内容并进入插入模式。	需要重写一行后半部分内容时的快捷操作。
cw / ce / cb	NORMAL	删除从光标到单词末尾 / 当前单词末尾 / 前一个单词开头的内容并进入插入模式。	快速修改一个或部分单词，是文本重构中最高频的操作之一。
.	NORMAL	重复上一次执行的编辑操作（删除或修改）。	当需要对多处文本进行相同的修改时，可以避免重复输入命令。

4.3.3.3 当前 Vim 模式的局限性与社区反馈

尽管 Claude Code 的 Vim 模式为终端用户带来了极大的便利，但根据社区在 GitHub 等平台的反馈，当前的实现仍然存在一些局限性和待完善的功能。一个主要的限制是其支持的 Vim 命令集是标准 Vim 的一个子集 。这意味着许多高级或更复杂的 Vim 功能尚未实现。例如，一些非常有用的光标移动命令，如 f 和 t（用于跳转到行内特定字符），以及它们的反向版本 F 和 T，目前还不被支持 。这些命令在进行行内精确导航时至关重要，它们的缺失使得某些编辑操作变得不那么高效。此外，用于重复这些移动的 ; 和 , 命令也同样缺失 。

另一个显著的局限性在于对文本对象（Text Objects）和寄存器操作的支持不足。Vim 的强大之处在于其文本对象，例如 ciw (change inner word) 或 diw (delete inner word)，它们允许用户对特定语义的文本块进行操作。然而，Claude Code 的 Vim 模式目前还不支持这些操作 。同样，复制（yank）和粘贴（paste）操作也受到限制。虽然用户可以在 INSERT 模式下使用系统快捷键（如 Cmd+V 或 Ctrl+V）进行粘贴，但在 NORMAL 模式下使用 y 进行复制和 p 进行粘贴的功能尚未完全实现 。此外，一些用户报告了特定命令的 bug，例如 e 命令（移动到单词末尾）在某些情况下只能移动一次，而不能像预期的那样重复执行 。还有用户提到，在某些交互场景（如编辑计划或回答多选问题）中，Vim 模式的行为可能不一致，甚至导致无法提交输入 。这些局限性表明，虽然 Vim 模式是一个非常有价值的起点，但仍有很大的改进空间，以满足资深 Vim 用户的期望。

5. 快速查阅命令列表

为了方便开发者快速查找和使用 Claude Code 的各项功能，本章节将核心命令和快捷键整理成易于查阅的列表。这些列表涵盖了从启动会话、管理项目到高效编辑的各个方面，旨在成为用户日常开发中的速查手册。通过熟练掌握这些命令，开发者可以最大限度地发挥 Claude Code 的潜力，将其无缝集成到自己的工作流中，从而显著提升编码和问题解决的效率。

5.1 CLI 命令与参数

Claude Code 提供了一系列灵活的命令行界面（CLI）命令和参数，允许用户在启动时对其进行精细控制。这些命令不仅支持启动交互式会话，还能用于执行一次性任务、管理对话历史以及配置工具行为。例如，claude 命令本身会启动一个交互式的 REPL（Read-Eval-Print Loop）环境，用户可以在此与 Claude 进行连续的对话 。如果用户希望在一次调用中完成特定任务并立即返回结果，可以使用 -p 参数，如 claude -p "explain this function"，这非常适合在脚本中集成 Claude Code 或快速获取答案 。对于需要继续之前工作的场景，-c 参数可以恢复最近的对话，而 -r <session-id> 则可以精确地恢复到某个特定的历史会话 。

除了会话管理，CLI 参数还提供了强大的功能定制能力。--model 参数允许用户指定要使用的 AI 模型，例如 claude --model claude-sonnet-4，这为不同任务选择最合适的模型提供了灵活性 。--permission-mode 参数则可以设置工具的执行权限模式，例如 plan 模式，让用户在 Claude 执行操作前进行审查。对于需要高度自动化的场景，--dangerously-skip-permissions 参数可以跳过所有权限提示，但官方强烈建议谨慎使用 。此外，--verbose 参数可以启用详细的日志记录，帮助用户调试问题或了解 Claude Code 的内部工作原理 。

命令/参数	描述	示例
claude	启动交互式 REPL 会话。	claude
claude "query"	启动 REPL 并附带初始提示。	claude "explain this project"
claude -p "query"	执行一次性查询后退出。	claude -p "summarize README.md"
claude -c	继续最近的对话会话。	claude -c
claude -r <session-id>	恢复指定的历史会话。	claude -r abc123
claude update	将 Claude Code 更新到最新版本。	claude update
--model <model-name>	指定要使用的 AI 模型。	claude --model claude-sonnet-4
--permission-mode <mode>	设置工具权限模式（如 plan）。	claude --permission-mode plan
--dangerously-skip-permissions	跳过所有权限提示（高风险）。	claude --dangerously-skip-permissions
--verbose	启用详细日志记录。	claude --verbose
--allowedTools <tools>	限制允许使用的工具列表。	--allowedTools "Bash(git log:*)" "Read"

5.2 交互模式斜杠命令

在 Claude Code 的交互式会话中，斜杠命令（Slash Commands）是执行特定操作和访问高级功能的核心机制。这些命令以 / 开头，提供了一个强大的接口来管理会话、配置环境、操作代码以及与外部工具集成。例如，/help 命令是用户入门的第一步，它会显示所有可用的斜杠命令及其功能说明，是探索 Claude Code 功能的绝佳起点 。当对话历史变得冗长，可能影响上下文理解时，可以使用 /clear 命令来清空当前会话的历史记录，从而开始一个全新的对话 。为了优化性能和 Token 使用，/compact [instructions] 命令可以整理和压缩对话历史，同时可以根据提供的可选指令来保留与当前任务最相关的上下文 。

斜杠命令还深度集成了项目管理和代码操作功能。/init 命令会创建一个 CLAUDE.md 文件，用于存储项目的关键信息、约定和常用命令，帮助 Claude 更好地理解项目上下文 。用户可以通过 /memory 命令随时编辑这个记忆文件 。对于代码审查，/review 命令可以请求 Claude 对当前代码库进行审查，而 /security-review 则会专门进行安全漏洞扫描 。此外，Claude Code 还支持与外部系统的集成，例如 /mcp 命令用于管理 Model Context Protocol (MCP) 服务器连接，这对于扩展 Claude 的功能至关重要 。这些丰富的斜杠命令将 Claude Code 从一个简单的聊天机器人转变为一个功能强大的开发助手。

命令	功能描述	使用场景
/help	显示所有可用的斜杠命令和快捷键的帮助信息。	探索新功能或忘记命令时的首要参考。
/clear	清除当前会话的对话历史。	开始一个全新的、无上下文干扰的任务。
/compact [instructions]	压缩对话历史，减少 Token 使用，可附带保留上下文的指令。	在长对话中保持性能，并聚焦于特定信息。
/vim	启用或禁用 Vim 编辑模式。	为习惯 Vim 的用户提供高效的文本编辑体验。
/config	打开配置菜单，查看和修改 Claude Code 的各项设置。	个性化设置，如默认模型、权限模式等。
/init	初始化项目，创建 CLAUDE.md 文件以存储项目记忆。	帮助 Claude 理解项目结构和约定。
/memory	编辑项目的记忆文件 (CLAUDE.md)。	更新或补充项目的关键信息。
/add-dir <path>	添加额外的工作目录供 Claude 访问。	处理跨多个目录的复杂项目。
/review	请求 Claude 对代码进行审查。	在提交代码前发现潜在问题。
/security-review	对代码变更执行安全审查。	识别潜在的安全漏洞和风险 。
/cost	显示当前会话的 Token 使用统计和计费信息。	监控 API 使用情况，控制成本。
/model	切换当前使用的 AI 模型（如 Sonnet, Opus）。	根据任务需求选择最合适的模型。
/doctor	检查 Claude Code 的安装和配置健康状况。	排查安装或连接问题。
/terminal-setup	配置终端以启用 Shift+Enter 等多行输入功能。	优化在特定终端（如 iTerm2）中的输入体验。

5.3 常用快捷键汇总

熟练掌握快捷键是提升在 Claude Code 终端界面中操作效率的关键。以下是一些最常用和最重要的基础快捷键，它们大多遵循了标准的终端和文本编辑器惯例，易于记忆和使用 。

快捷键	功能描述	使用场景与分析
Ctrl+C	取消当前输入或中断 AI 的生成过程。	当 AI 正在生成一个冗长的回答或执行一个耗时操作时，如果用户发现方向错误或想提前终止，按下 Ctrl+C 可以立即停止当前活动，返回到命令提示符状态，节省等待时间 。
Ctrl+D	退出当前的 Claude Code 会话。	这是一个标准的 EOF (End-of-File) 信号，用于优雅地关闭交互式会话。与 Ctrl+C 不同，它不会中断当前操作，而是正常结束整个程序 。
Ctrl+L	清除终端屏幕。	这个快捷键类似于 clear 命令，可以快速清屏，让界面变得整洁。需要注意的是，它只清除屏幕显示，并不会清除会话的对话历史，上下文依然保留 。
Ctrl+R	反向搜索命令历史。	这是一个非常强大的功能，允许用户在之前输入过的所有命令中进行搜索。按下 Ctrl+R 后，输入关键词，终端会自动匹配并显示包含该关键词的历史命令，方便用户快速重复或修改执行过的复杂指令 。
↑ / ↓	浏览输入历史。	使用上下箭头键可以逐条浏览和调用之前输入过的命令或提示，避免了重复输入，在处理迭代式任务时效率极高。
Esc + Esc	编辑上一条消息。	当发现上一条指令有微小错误或需要补充信息时，无需重新输入，直接编辑即可，极大地提升了指令修正的效率。
Shift+Enter	插入换行符，用于多行输入。	在需要输入多行代码或详细描述时，使用此快捷键可以在不执行命令的情况下换行，确保输入内容的格式正确。在某些终端中可能需要先运行 /terminal-setup。

6. 要点总结

6.1 核心优势

Claude Code 的核心优势在于其代理式（Agentic）的开发模式。它不仅仅是一个代码生成器，更是一个能够理解复杂指令、自主规划并执行多步骤任务的智能伙伴。通过将强大的 AI 模型能力直接带到终端，它无缝集成了开发者的现有工作流，极大地提升了从功能构建、问题调试到代码库理解的效率。其超大的上下文窗口使其能够深刻理解整个项目，而灵活的记忆系统（CLAUDE.md）则确保了其输出始终符合项目规范和个人偏好。

6.2 日常使用关键点

• 初始化是关键：在每个新项目中，首先运行 /init 创建 CLAUDE.md，为 AI 建立项目上下文。
• 会话管理：使用 claude -c 继续工作，使用 /clear 开始新任务，保持上下文专注。
• 高效记忆：善用 # 快速记录重要信息到 CLAUDE.md，持续优化 AI 的知识库。
• 模型切换：根据任务复杂度，使用 /model 在 Sonnet（高效）和 Opus（强大）之间切换，平衡性能与成本。
• 成本意识：定期使用 /cost 监控 Token 消耗，避免不必要的开销。

6.3 高效工作流建议

1. 采用“记录与清理”模式：在处理复杂、长周期的任务时，让 Claude 将关键决策和进展记录在一个 .md 文件中，然后使用 /clear 清空上下文，再让它读取该文件继续工作。这既能保留核心信息，又能避免上下文膨胀。
2. 创建自定义命令：将团队常用的、重复性的工作流程（如代码审查、安全检查、部署）封装成自定义斜杠命令（.claude/commands/），实现一键自动化。
3. 集成到 Git 工作流：利用 claude commit 或自定义命令自动生成高质量的提交信息，保持项目历史的清晰。
4. 拥抱 Vim 模式：对于习惯终端操作的开发者，启用 Vim 模式 (/vim) 可以极大地提升指令输入和编辑的效率。
5. 持续迭代 CLAUDE.md：将 CLAUDE.md 视为一个活的文档，随着项目的发展不断更新，使其成为团队与 AI 之间最准确的沟通桥梁。