How Claude Code Works

Claude Code 核心概念学习笔记

一、 代理循环 (Agentic Loop)

• Claude Code 的工作机制基于“代理循环”。
• 循环步骤：
• 输入提示 (Prompt) → 收集上下文 (Gather Context)。
• 模型返回文本或工具调用 (Tool Call) → 执行操作 (Take Action)。
• 验证结果 (Verify Results) → 判断是否达成目标。
• 循环机制： 若结果未达成，则返回循环重新执行；若达成，则完成任务。
• 用户干预： 在循环过程中，用户可以随时添加上下文、中断或引导模型。

二、 上下文窗口 (Context Window)

• 定义： 决定了对话、文件内容、命令输出等信息可以存储和回顾的容量。
• 容量限制： 当达到限制时，Claude Code 会自动进行“上下文压缩” (Context Compaction)。
• 压缩机制： 系统自动确定哪些信息可以被移除或总结，以腾出空间。

三、 工具 (Tools)

• 作用： 是代理（Agent）工作的核心基础。
• 功能扩展： 允许 Claude Code 走出“输入文本 → 输出文本”的限制，执行实际任务。
• 工具示例： 读取文件工具、网页搜索工具。
• 决策过程： Claude Code 使用语义搜索来决定何时调用特定工具并获取输出。

四、 权限模式 (Permissions)

• 默认行为： 在编辑文件或运行 Shell 命令前，必须获得明确的许可。
• 模式切换： 可使用 Shift 和 Tab 键切换不同模式。
• 模式类型：
• 默认模式： 需明确许可。
• 自动接受模式： 可自动接受编辑文件，但仍需询问命令执行。
• 规划模式 (Plan Mode)： 使用只读工具来先制定行动计划，再开始执行。
• 风险提示： 绕过权限可能导致错误难以在发生前被察觉。

总结： Claude Code 的独特之处在于它结合了代理循环、受管理的上下文窗口、工具以及可配置的权限，使其能够读取代码库、执行操作并自我验证工作。

Takeaways

• Claude Code 的核心机制是“代理循环”，即通过输入提示、执行操作和验证结果来持续达成任务目标。
• 上下文窗口决定了信息存储容量，当容量达到限制时，系统会自动进行“上下文压缩”以腾出空间。
• 工具是代理工作的核心，它允许 Claude Code 执行实际任务（如文件读取、网页搜索），突破纯文本交互的限制。
• 权限模式确保操作安全，在执行文件编辑或Shell命令前，必须获得明确的许可。