The reviewed guide body for this track is currently maintained in Chinese.
预计阅读时间: 14 分钟
Claude Code 是一个面向工程任务的 coding agent。它的核心不是“在终端里聊天”，而是把自然语言目标转成一系列项目内动作：读取文件、搜索上下文、运行命令、修改代码、验证结果，再把结果反馈给你。
理解 Claude Code，要先理解它的 agentic search and execution loop：先尽可能掌握上下文，再执行动作，再用反馈继续收敛。
一句话模型
用户目标 -> 项目上下文 -> 工具动作 -> 代码变更 -> 验证输出 -> 继续迭代
Claude Code 默认在你的项目目录里工作，因此它天然贴近这些任务：
- 读现有代码。
- 修复 bug。
- 解释架构。
- 写测试。
- 重构模块。
- 运行命令验证结果。
- 生成提交说明或 PR 描述。
- 通过 MCP 连接外部工具。
它和普通聊天的差异在于：普通聊天主要给答案，Claude Code 会在项目中执行。
上下文如何进入模型
Claude Code 会从多个来源获得上下文：
| 来源 | 例子 | 用途 |
|---|---|---|
| 当前提示 | 目标、约束、截图、错误日志 | 决定本轮任务 |
| 项目文件 | 源码、配置、测试、文档 | 理解系统真实结构 |
| 项目记忆 | CLAUDE.md 等指导文件 | 保持仓库级工作协议 |
| 命令输出 | test、lint、build、grep 结果 | 验证假设 |
| MCP | GitHub、文档、设计稿、工单 | 接入项目外部信息 |
| 会话历史 | 前面讨论和决策 | 保持当前任务连续性 |
上下文越明确，它越容易减少误判。上下文越杂，它越需要你定义边界。
执行动作的安全边界
Claude Code 可以运行命令和修改文件，所以权限模式非常重要。你应该知道：
- 哪些动作只读。
- 哪些动作会写文件。
- 哪些动作会访问网络。
- 哪些动作会影响工作区外资源。
- 哪些动作需要你确认。
适合自动执行的动作通常是本地、可回滚、可验证的动作。涉及生产、密钥、账单、云资源和数据删除时，应该先让 Claude Code 写方案和检查清单，再由人确认执行。
终端优先的工作方式
Claude Code 的一个重要特点是贴近终端。它适合在命令行里完成：
claude
然后把任务交给它。它也支持继续会话、非交互执行、IDE 集成等方式。无论界面如何变化，核心流程都是同一套：读上下文、计划、执行、验证。
与 IDE 自动补全的区别
IDE 补全通常发生在局部文件内，关注下一段代码。Claude Code 更像一个工程代理，关注任务完成：
| 工具类型 | 关注点 | 适合任务 |
|---|---|---|
| 自动补全 | 当前行或当前函数 | 写样板代码、补局部逻辑 |
| 聊天助手 | 解释和建议 | 问概念、讨论方案 |
| Claude Code | 仓库级任务闭环 | 修改多文件、跑测试、重构、部署前检查 |
这也是为什么你要给它完整任务，而不是只给一句“帮我写个函数”。
一个好任务如何被 Claude Code 处理
假设你说：
学习页手机端看不到入口，请优化移动端导航，保持现有设计风格，完成后跑构建。
Claude Code 应该做：
- 找到导航组件和移动端 CSS。
- 理解当前菜单结构。
- 修改最小必要文件。
- 运行 lint/build。
- 如果可行，用浏览器或 HTML 检查移动端入口。
- 汇报改动和验证。
它不应该顺手重做整个导航、不应该删除 unrelated code，也不应该跳过验证就说完成。
学习路径怎么读
这组 Claude Code 专题按下面顺序组织：
- 原理与架构：知道它是什么。
- 安装与项目记忆：让它在正确边界里工作。
- 日常开发：把任务交付流程跑顺。
- 代码阅读与重构：处理大型仓库和复杂变化。
- Hooks/MCP/Subagents：把能力扩展到系统。
- 团队、安全与成本：让它进入真实工程组织。
参考资料
- Claude Code overview: https://code.claude.com/docs/en/overview
- Claude Code best practices: https://www.anthropic.com/engineering/claude-code-best-practices
- Claude Code settings: https://code.claude.com/docs/en/settings