Claude Code 是一个在您的终端中运行的代理助手。虽然它擅长编码，但它可以帮助您从命令行执行的任何操作：编写文档、运行构建、搜索文件、研究主题等。
本指南涵盖核心架构、内置功能和有效使用 Claude Code 的提示。有关分步演练，请参阅常见工作流。有关 skills、MCP 和 hooks 等可扩展性功能，请参阅扩展 Claude Code。
代理循环
当您给 Claude 一个任务时，它会经历三个阶段：收集上下文、采取行动和验证结果。这些阶段相互融合。Claude 始终使用工具，无论是搜索文件以了解您的代码、编辑以进行更改，还是运行测试以检查其工作。
循环适应您的要求。关于您代码库的问题可能只需要收集上下文。错误修复会循环通过所有三个阶段多次。重构可能涉及广泛的验证。Claude 根据从前一步学到的内容决定每一步需要什么，将数十个操作链接在一起并沿途进行纠正。
您也是这个循环的一部分。您可以在任何时刻中断以引导 Claude 朝不同的方向发展、提供额外的上下文或要求它尝试不同的方法。Claude 自主工作但对您的输入保持响应。
代理循环由两个组件驱动：模型进行推理和工具采取行动。Claude Code 充当 Claude 周围的代理工具：它提供工具、上下文管理和执行环境，将语言模型转变为能够进行编码的代理。
Claude Code 使用 Claude 模型来理解您的代码并推理任务。Claude 可以读取任何语言的代码、理解组件如何连接，以及确定需要更改什么来实现您的目标。对于复杂的任务，它将工作分解为步骤、执行它们，并根据学到的内容进行调整。
多个模型可用，具有不同的权衡。Sonnet 可以很好地处理大多数编码任务。Opus 为复杂的架构决策提供更强的推理能力。在会话期间使用 /model 切换或使用 claude --model <name> 启动。
当本指南说”Claude 选择”或”Claude 决定”时，是模型在进行推理。
工具是使 Claude Code 成为代理的原因。没有工具，Claude 只能用文本回应。有了工具，Claude 可以采取行动：读取您的代码、编辑文件、运行命令、搜索网络并与外部服务交互。每个工具使用都会返回信息，反馈到循环中，告知 Claude 的下一个决定。
内置工具通常分为四类，每一类代表不同类型的代理能力。
| 类别 | Claude 可以做什么 |
|---|
| 文件操作 | 读取文件、编辑代码、创建新文件、重命名和重新组织 |
| 搜索 | 按模式查找文件、使用正则表达式搜索内容、探索代码库 |
| 执行 | 运行 shell 命令、启动服务器、运行测试、使用 git |
| 网络 | 搜索网络、获取文档、查找错误消息 |
| 代码智能 | 编辑后查看类型错误和警告、跳转到定义、查找引用（需要代码智能插件） |
- 运行测试套件以查看失败的内容
- 读取错误输出
- 搜索相关的源文件
- 读取这些文件以理解代码
- 编辑文件以修复问题
- 再次运行测试以验证
每个工具使用都会给 Claude 新的信息，告知下一步。这就是代理循环的实际应用。
扩展基本功能： 内置工具是基础。您可以使用 skills 扩展 Claude 知道的内容、使用 MCP 连接到外部服务、使用 hooks 自动化工作流，以及使用 subagents 卸载任务。这些扩展形成了核心代理循环之上的一层。有关为您的需求选择正确扩展的指导，请参阅扩展 Claude Code。
Claude 可以访问什么
本指南重点关注终端。Claude Code 也在 VS Code、JetBrains IDE 和其他环境中运行。
当您在目录中运行 claude 时，Claude Code 可以访问：
- 您的项目。 您的目录和子目录中的文件，以及您允许的其他地方的文件。
- 您的终端。 您可以运行的任何命令：构建工具、git、包管理器、系统实用程序、脚本。如果您可以从命令行执行，Claude 也可以。
- 您的 git 状态。 当前分支、未提交的更改和最近的提交历史。
- 您的 CLAUDE.md。 一个 markdown 文件，您可以在其中存储项目特定的说明、约定和 Claude 应该在每个会话中了解的上下文。
- 您配置的扩展。 用于外部服务的 MCP servers、用于工作流的 skills、用于委派工作的 subagents 和用于浏览器交互的 Claude in Chrome。
因为 Claude 看到您的整个项目，它可以跨越它工作。当您要求 Claude”修复身份验证错误”时，它搜索相关文件、读取多个文件以理解上下文、跨它们进行协调编辑、运行测试以验证修复，并在您要求时提交更改。这与只看到当前文件的内联代码助手不同。
使用会话工作
Claude Code 在您工作时将您的对话保存在本地。每条消息、工具使用和结果都被存储，这使得回退、恢复和分叉会话成为可能。在 Claude 进行代码更改之前，它还会对受影响的文件进行快照，以便您在需要时可以恢复。
会话是短暂的。 与 claude.ai 不同，Claude Code 在会话之间没有持久的内存。每个新会话都从头开始。Claude 不会”学习”您的偏好或记住您上周做了什么。如果您希望 Claude 在会话之间了解某些内容，请将其放在您的 CLAUDE.md 中。
跨分支工作
每个 Claude Code 对话都是与您当前目录相关联的会话。当您恢复时，您只会看到来自该目录的会话。
Claude 看到您当前分支的文件。当您切换分支时，Claude 看到新分支的文件，但您的对话历史保持不变。Claude 记得您讨论过的内容，即使在切换后也是如此。
由于会话与目录相关联，您可以通过使用 git worktrees 运行并行 Claude 会话，这为各个分支创建单独的目录。
恢复或分叉会话
当您使用 claude --continue 或 claude --resume 恢复会话时，您使用相同的会话 ID 从中断处继续。新消息附加到现有对话。您的完整对话历史被恢复，但会话范围的权限不会。您需要重新批准这些。
要分支并尝试不同的方法而不影响原始会话，请使用 --fork-session 标志：
claude --continue --fork-session
--fork-session 为每个终端提供自己的干净会话。
上下文窗口
Claude 的上下文窗口包含您的对话历史、文件内容、命令输出、CLAUDE.md、加载的 skills 和系统说明。当您工作时，上下文会填满。Claude 会自动压缩，但对话早期的说明可能会丢失。将持久规则放在 CLAUDE.md 中，并运行 /context 以查看占用空间的内容。
当上下文填满时
Claude Code 在您接近限制时自动管理上下文。它首先清除较旧的工具输出，然后在需要时总结对话。您的请求和关键代码片段被保留；对话早期的详细说明可能会丢失。将持久规则放在 CLAUDE.md 中，而不是依赖对话历史。
要控制在压缩期间保留的内容，请在 CLAUDE.md 中添加”Compact Instructions”部分或使用焦点运行 /compact（如 /compact focus on the API changes）。
运行 /context 以查看占用空间的内容。MCP servers 将工具定义添加到每个请求，因此几个服务器在您开始工作之前可能会消耗大量上下文。运行 /mcp 以检查每个服务器的成本。
使用 skills 和 subagents 管理上下文
除了压缩，您可以使用其他功能来控制加载到上下文中的内容。
Skills 按需加载。Claude 在会话开始时看到 skill 描述，但完整内容仅在使用 skill 时加载。对于您手动调用的 skills，设置 disable-model-invocation: true 以将描述保留在上下文之外，直到您需要它们。
Subagents 获得自己的新鲜上下文，完全独立于您的主要对话。他们的工作不会膨胀您的上下文。完成后，他们返回摘要。这种隔离是 subagents 在长会话中有帮助的原因。
有关每个功能的成本，请参阅上下文成本，有关管理上下文的提示，请参阅减少令牌使用。
使用检查点和权限保持安全
Claude 有两个安全机制：检查点让您撤销文件更改，权限控制 Claude 可以在不询问的情况下做什么。
使用检查点撤销更改
每个文件编辑都是可逆的。 在 Claude 编辑任何文件之前，它会对当前内容进行快照。如果出现问题，按两次 Esc 以回退到之前的状态，或要求 Claude 撤销。
检查点是会话本地的，独立于 git。它们仅涵盖文件更改。影响远程系统（数据库、API、部署）的操作无法进行检查点，这就是为什么 Claude 在运行具有外部副作用的命令之前会询问。
控制 Claude 可以做什么
按 Shift+Tab 循环通过权限模式：
- 默认：Claude 在文件编辑和 shell 命令之前询问
- 自动接受编辑：Claude 编辑文件而不询问，仍然询问命令
- Plan Mode：Claude 仅使用只读工具，创建您可以在执行前批准的计划
- Delegate mode：Claude 仅通过代理团队协调工作，没有直接实现。仅在代理团队活跃时可用。
您也可以在 .claude/settings.json 中允许特定命令，以便 Claude 不会每次都询问。这对于受信任的命令（如 npm test 或 git status）很有用。设置可以从组织范围的策略范围到个人偏好。有关详细信息，请参阅权限。
有效使用 Claude Code
这些提示可帮助您从 Claude Code 获得更好的结果。
向 Claude Code 寻求帮助
Claude Code 可以教您如何使用它。提出问题，如”我如何设置 hooks？“或”构建我的 CLAUDE.md 的最佳方式是什么？“Claude 会解释。
内置命令也会指导您完成设置：
/init 引导您为项目创建 CLAUDE.md/agents 帮助您配置自定义 subagents/doctor 诊断您的安装的常见问题
这是一个对话
Claude Code 是对话式的。您不需要完美的提示。从您想要的开始，然后细化：
> 修复登录错误
[Claude 调查，尝试一些东西]
> 这不太对。问题在于会话处理。
[Claude 调整方法]
中断和引导
您可以在任何时刻中断 Claude。如果它走错了路，只需输入您的更正并按 Enter。Claude 将停止正在做的事情并根据您的输入调整其方法。您不必等待它完成或重新开始。
预先具体
您的初始提示越精确，您需要的更正就越少。参考特定文件、提及约束并指向示例模式。
> 对于持卡人过期的用户，结账流程已损坏。
> 检查 src/payments/ 中的问题，特别是令牌刷新。
> 首先编写失败的测试，然后修复它。
给 Claude 一些东西来验证
当 Claude 可以检查自己的工作时，它表现更好。包括测试用例、粘贴预期 UI 的屏幕截图或定义您想要的输出。
对于视觉工作，粘贴设计的屏幕截图并要求 Claude 将其实现与其进行比较。
在实现之前探索
对于复杂的问题，将研究与编码分开。使用计划模式（按两次 Shift+Tab）首先分析代码库：
> 读取 src/auth/ 并理解我们如何处理会话。
> 然后为添加 OAuth 支持创建计划。
委派，不要指示
想象委派给一个有能力的同事。提供上下文和方向，然后相信 Claude 会弄清楚细节：
> 对于持卡人过期的用户，结账流程已损坏。
> 相关代码在 src/payments/ 中。您能调查并修复它吗？
接下来是什么
Last modified on February 12, 2026
