> ## Documentation Index > Fetch the complete documentation index at: https://docs.openclaude.app/llms.txt > Use this file to discover all available pages before exploring further. # Claude Code 如何工作 > 了解代理循环、内置工具以及 Claude Code 如何与您的项目交互。 Claude Code 是一个在您的终端中运行的代理助手。虽然它擅长编码，但它可以帮助您从命令行执行的任何操作：编写文档、运行构建、搜索文件、研究主题等。 本指南涵盖核心架构、内置功能和[有效使用 Claude Code 的提示](#work-effectively-with-claude-code)。有关分步演练，请参阅[常见工作流](/claude-code/02-core-concepts/03-common-workflows)。有关 skills、MCP 和 hooks 等可扩展性功能，请参阅[扩展 Claude Code](/claude-code/02-core-concepts/02-features-overview)。 ## 代理循环 当您给 Claude 一个任务时，它会经历三个阶段：**收集上下文**、**采取行动**和**验证结果**。这些阶段相互融合。Claude 始终使用工具，无论是搜索文件以了解您的代码、编辑以进行更改，还是运行测试以检查其工作。 代理循环：您的提示导致 Claude 收集上下文、采取行动、验证结果，并重复直到任务完成。您可以在任何时刻中断。 循环适应您的要求。关于您代码库的问题可能只需要收集上下文。错误修复会循环通过所有三个阶段多次。重构可能涉及广泛的验证。Claude 根据从前一步学到的内容决定每一步需要什么，将数十个操作链接在一起并沿途进行纠正。 您也是这个循环的一部分。您可以在任何时刻中断以引导 Claude 朝不同的方向发展、提供额外的上下文或要求它尝试不同的方法。Claude 自主工作但对您的输入保持响应。 代理循环由两个组件驱动：[模型](#models)进行推理和[工具](#tools)采取行动。Claude Code 充当 Claude 周围的**代理工具**：它提供工具、上下文管理和执行环境，将语言模型转变为能够进行编码的代理。 ### 模型 Claude Code 使用 Claude 模型来理解您的代码并推理任务。Claude 可以读取任何语言的代码、理解组件如何连接，以及确定需要更改什么来实现您的目标。对于复杂的任务，它将工作分解为步骤、执行它们，并根据学到的内容进行调整。 [多个模型](/claude-code/07-configuration/04-model-config)可用，具有不同的权衡。Sonnet 可以很好地处理大多数编码任务。Opus 为复杂的架构决策提供更强的推理能力。在会话期间使用 `/model` 切换或使用 `claude --model ` 启动。 当本指南说"Claude 选择"或"Claude 决定"时，是模型在进行推理。 ### 工具 工具是使 Claude Code 成为代理的原因。没有工具，Claude 只能用文本回应。有了工具，Claude 可以采取行动：读取您的代码、编辑文件、运行命令、搜索网络并与外部服务交互。每个工具使用都会返回信息，反馈到循环中，告知 Claude 的下一个决定。 内置工具通常分为四类，每一类代表不同类型的代理能力。 | 类别 | Claude 可以做什么 | | -------- | ------------------------------------------------------------------------------------------------------------ | | **文件操作** | 读取文件、编辑代码、创建新文件、重命名和重新组织 | | **搜索** | 按模式查找文件、使用正则表达式搜索内容、探索代码库 | | **执行** | 运行 shell 命令、启动服务器、运行测试、使用 git | | **网络** | 搜索网络、获取文档、查找错误消息 | | **代码智能** | 编辑后查看类型错误和警告、跳转到定义、查找引用（需要[代码智能插件](/claude-code/04-build-with-claude/08-discover-plugins#code-intelligence)） | 这些是主要功能。Claude 还有用于生成 subagents、询问您问题和其他编排任务的工具。有关完整列表，请参阅[Claude 可用的工具](/claude-code/07-configuration/01-settings#tools-available-to-claude)。 Claude 根据您的提示和沿途学到的内容选择使用哪些工具。当您说"修复失败的测试"时，Claude 可能会： 1. 运行测试套件以查看失败的内容 2. 读取错误输出 3. 搜索相关的源文件 4. 读取这些文件以理解代码 5. 编辑文件以修复问题 6. 再次运行测试以验证 每个工具使用都会给 Claude 新的信息，告知下一步。这就是代理循环的实际应用。 **扩展基本功能：** 内置工具是基础。您可以使用 [skills](/claude-code/04-build-with-claude/01-skills) 扩展 Claude 知道的内容、使用 [MCP](/claude-code/04-build-with-claude/05-mcp) 连接到外部服务、使用 [hooks](/claude-code/04-build-with-claude/03-hooks) 自动化工作流，以及使用 [subagents](/claude-code/04-build-with-claude/02-sub-agents) 卸载任务。这些扩展形成了核心代理循环之上的一层。有关为您的需求选择正确扩展的指导，请参阅[扩展 Claude Code](/claude-code/02-core-concepts/02-features-overview)。 ## Claude 可以访问什么 本指南重点关注终端。Claude Code 也在 [VS Code、JetBrains IDE 和其他环境](/claude-code/03-platforms/04-vs-code)中运行。 当您在目录中运行 `claude` 时，Claude Code 可以访问： * **您的项目。** 您的目录和子目录中的文件，以及您允许的其他地方的文件。 * **您的终端。** 您可以运行的任何命令：构建工具、git、包管理器、系统实用程序、脚本。如果您可以从命令行执行，Claude 也可以。 * **您的 git 状态。** 当前分支、未提交的更改和最近的提交历史。 * **您的 [CLAUDE.md](/claude-code/07-configuration/03-memory)。** 一个 markdown 文件，您可以在其中存储项目特定的说明、约定和 Claude 应该在每个会话中了解的上下文。 * **您配置的扩展。** 用于外部服务的 [MCP servers](/claude-code/04-build-with-claude/05-mcp)、用于工作流的 [skills](/claude-code/04-build-with-claude/01-skills)、用于委派工作的 [subagents](/claude-code/04-build-with-claude/02-sub-agents) 和用于浏览器交互的 [Claude in Chrome](/claude-code/03-platforms/03-chrome)。 因为 Claude 看到您的整个项目，它可以跨越它工作。当您要求 Claude"修复身份验证错误"时，它搜索相关文件、读取多个文件以理解上下文、跨它们进行协调编辑、运行测试以验证修复，并在您要求时提交更改。这与只看到当前文件的内联代码助手不同。 ## 使用会话工作 Claude Code 在您工作时将您的对话保存在本地。每条消息、工具使用和结果都被存储，这使得[回退](#undo-changes-with-checkpoints)、[恢复和分叉](#resume-or-fork-sessions)会话成为可能。在 Claude 进行代码更改之前，它还会对受影响的文件进行快照，以便您在需要时可以恢复。 **会话是短暂的。** 与 claude.ai 不同，Claude Code 在会话之间没有持久的内存。每个新会话都从头开始。Claude 不会"学习"您的偏好或记住您上周做了什么。如果您希望 Claude 在会话之间了解某些内容，请将其放在您的 [CLAUDE.md](/claude-code/07-configuration/03-memory) 中。 ### 跨分支工作 每个 Claude Code 对话都是与您当前目录相关联的会话。当您恢复时，您只会看到来自该目录的会话。 Claude 看到您当前分支的文件。当您切换分支时，Claude 看到新分支的文件，但您的对话历史保持不变。Claude 记得您讨论过的内容，即使在切换后也是如此。 由于会话与目录相关联，您可以通过使用 [git worktrees](/claude-code/02-core-concepts/03-common-workflows#run-parallel-claude-code-sessions-with-git-worktrees) 运行并行 Claude 会话，这为各个分支创建单独的目录。 ### 恢复或分叉会话 当您使用 `claude --continue` 或 `claude --resume` 恢复会话时，您使用相同的会话 ID 从中断处继续。新消息附加到现有对话。您的完整对话历史被恢复，但会话范围的权限不会。您需要重新批准这些。 会话连续性：恢复继续相同的会话，分叉创建具有新 ID 的新分支。 要分支并尝试不同的方法而不影响原始会话，请使用 `--fork-session` 标志： ```bash theme={null} theme={null} claude --continue --fork-session ``` 这会创建一个新的会话 ID，同时保留到该点的对话历史。原始会话保持不变。与恢复一样，分叉的会话不继承会话范围的权限。 **在多个终端中的相同会话**：如果您在多个终端中恢复相同的会话，两个终端都会写入相同的会话文件。来自两者的消息会交错，就像两个人在同一个笔记本中写字一样。没有任何内容损坏，但对话变得混乱。每个终端在会话期间只看到自己的消息，但如果您稍后恢复该会话，您会看到所有内容交错。对于从相同起点进行的并行工作，使用 `--fork-session` 为每个终端提供自己的干净会话。 ### 上下文窗口 Claude 的上下文窗口包含您的对话历史、文件内容、命令输出、[CLAUDE.md](/claude-code/07-configuration/03-memory)、加载的 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-code/04-build-with-claude/01-skills) 按需加载。Claude 在会话开始时看到 skill 描述，但完整内容仅在使用 skill 时加载。对于您手动调用的 skills，设置 `disable-model-invocation: true` 以将描述保留在上下文之外，直到您需要它们。 [Subagents](/claude-code/04-build-with-claude/02-sub-agents) 获得自己的新鲜上下文，完全独立于您的主要对话。他们的工作不会膨胀您的上下文。完成后，他们返回摘要。这种隔离是 subagents 在长会话中有帮助的原因。 有关每个功能的成本，请参阅[上下文成本](/claude-code/02-core-concepts/02-features-overview#understand-context-costs)，有关管理上下文的提示，请参阅[减少令牌使用](/claude-code/06-administration/08-costs#reduce-token-usage)。 ## 使用检查点和权限保持安全 Claude 有两个安全机制：检查点让您撤销文件更改，权限控制 Claude 可以在不询问的情况下做什么。 ### 使用检查点撤销更改 **每个文件编辑都是可逆的。** 在 Claude 编辑任何文件之前，它会对当前内容进行快照。如果出现问题，按两次 `Esc` 以回退到之前的状态，或要求 Claude 撤销。 检查点是会话本地的，独立于 git。它们仅涵盖文件更改。影响远程系统（数据库、API、部署）的操作无法进行检查点，这就是为什么 Claude 在运行具有外部副作用的命令之前会询问。 ### 控制 Claude 可以做什么 按 `Shift+Tab` 循环通过权限模式： * **默认**：Claude 在文件编辑和 shell 命令之前询问 * **自动接受编辑**：Claude 编辑文件而不询问，仍然询问命令 * **Plan Mode**：Claude 仅使用只读工具，创建您可以在执行前批准的计划 * **Delegate mode**：Claude 仅通过[代理团队](/claude-code/05-deployment/04-agent-teams)协调工作，没有直接实现。仅在代理团队活跃时可用。 您也可以在 `.claude/settings.json` 中允许特定命令，以便 Claude 不会每次都询问。这对于受信任的命令（如 `npm test` 或 `git status`）很有用。设置可以从组织范围的策略范围到个人偏好。有关详细信息，请参阅[权限](/claude-code/07-configuration/02-permissions)。 *** ## 有效使用 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 的屏幕截图或定义您想要的输出。 ``` > 实现 validateEmail。测试用例：'user@example.com' → true， > 'invalid' → false，'user@.com' → false。之后运行测试。 ``` 对于视觉工作，粘贴设计的屏幕截图并要求 Claude 将其实现与其进行比较。 ### 在实现之前探索 对于复杂的问题，将研究与编码分开。使用计划模式（按两次 `Shift+Tab`）首先分析代码库： ``` > 读取 src/auth/ 并理解我们如何处理会话。 > 然后为添加 OAuth 支持创建计划。 ``` 审查计划，通过对话细化它，然后让 Claude 实现。这种两阶段方法比直接跳到代码产生更好的结果。 ### 委派，不要指示 想象委派给一个有能力的同事。提供上下文和方向，然后相信 Claude 会弄清楚细节： ``` > 对于持卡人过期的用户，结账流程已损坏。 > 相关代码在 src/payments/ 中。您能调查并修复它吗？ ``` 您不需要指定要读取哪些文件或运行哪些命令。Claude 会弄清楚。 ## 接下来是什么 添加 Skills、MCP 连接和自定义命令 典型任务的分步指南