前言

你是否花了几百美元购买 AI 编程课程，却发现内容不如官方免费教学来得准确实用？今天分享的这份教程，来自 Claude Code 的核心开发者 ——Anthropic 技术团队成员 Boris 的亲自讲解。没有空洞的历史和理论，全程 30 分钟只讲实操，涵盖 40 个核心指令，每一个技巧都是从开发者口中说出的 "正确答案"。

Claude Code 不是普通的代码补全工具，它是一款专为构建功能而生的全自主 AI 编程代理。与只能逐行补全代码的传统工具不同，它能一次性编辑完整的函数和文件，甚至直接修复整个 bug。更重要的是，它能无缝适配 VS Code、Xcode、JetBrains 系列等所有主流 IDE 和终端，无论你在本地、远程 SSH 还是 tmux 环境中，都能顺畅运行，完全不需要改变你现有的工作流。

一、Claude Code 基础设置：5 分钟快速上手

初次启动 Claude Code，建议先完成以下几项基础设置，让后续使用更加顺手：

  1. 换行与输入优化：在终端中使用Shift+Enter进行换行，无需输入反斜杠，大幅提升长提示词的输入效率。

  2. 主题切换：输入/theme命令，即可轻松切换浅色、深色或护眼主题。

  3. GitHub 应用安装：输入/install github app命令，就能在任何 Issue 或 Pull Request 中直接使用 Claude Code。

  4. 自定义工具权限：提前设置常用工具的自动确认权限，避免每次操作都弹出确认窗口，节省大量时间。

  5. 语音输入技巧：macOS 用户可以进入系统设置→辅助功能→开启听写功能，双击听写键直接口述提示词。提示越具体越好，就像和同事聊天一样与 Claude Code 对话，完全不用手写大量代码。

二、新手入门第一课：从代码库问答开始

这是 Anthropic 培训新人的第一课，也是最强烈推荐给所有初学者的入门方式。

2.1 为什么从代码库问答开始？

以前技术团队新人入职，需要花费两三周时间通读代码、询问同事、摸索工具，效率极低。有了 Claude Code 后，新人只需在入职第一天下载并配置好工具，就能立刻开始向代码库提问，将入职周期缩短至两三天。

2.2 代码库问答的核心优势

  • 零配置即用：下载启动后即可直接使用，无需建立索引，无需等待。

  • 绝对安全：代码完全本地存储，不上传远程服务器，也绝不用于训练模型，代码所有权完全由你掌控。

  • 深度理解：Claude Code 不只是简单搜索文本，它会主动挖掘类的实例化方式、实际使用案例，给出比普通搜索更透彻的答案。

  • 自动整合信息：能直接给出维基百科或官方文档中的答案，无需你手动跳转搜索。

2.3 常用代码库问答指令

  • "这段代码具体是怎么用的？"

  • "该怎么实例化这个对象？"

  • "查看这个函数的 Git 历史记录"

  • "帮我分析这个函数为什么有这么多参数，它们是怎么来的？"

  • "拉取 GitHub 上这个 Issue 的内容并分析相关背景"

  • "生成我本周的交付清单"（Claude Code 会自动识别日期和你的用户名）

三、高效代码编辑：让 Claude Code 成为你的得力助手

熟悉代码库问答功能后，就可以开始使用 Claude Code 进行代码编辑了。作为代理式系统，Claude Code 最神奇的地方在于，只要给它配上工具，它就能自行摸索用法，自动完成任务。

3.1 核心工作流：先规划，后编码

很多用户一上来就丢给 Claude Code 一个长达三千行的功能需求，结果往往不尽如人意。想拿到理想结果，最简单有效的方法是：

"先头脑风暴一下，做个计划发给我，等我点头批准后再动手写代码。"

不需要开启任何特殊模式或工具，只要这样跟 Claude Code 说一声，它自然就懂。先让它思考和规划，既能避免方向错误，又能让你提前了解实现思路，大幅提升最终代码的质量。

3.2 一键完成代码提交与 PR

这是开发者最常用的指令之一，本身没有什么特别之处，但 Claude Code 足够聪明，能直接领会你的意图：

"提交代码并推送新分支，然后提 PR"

它会自动扫描代码、查看 Git 历史、读取提交日志，自己摸清团队的提交格式规范，然后妥妥地完成代码提交、分支推送和 PR 创建的全流程，无需你做任何额外解释。

四、进阶技巧：集成团队工具与自动迭代

当你用得更熟练后，就可以开始将团队的现有工具链接入 Claude Code，这正是它的核心亮点之一。

4.1 两类可集成工具

Claude Code 主要支持两类外部工具：

  1. CLI 命令行工具：比如 CI/CD 工具、构建工具等。只需告知 Claude Code 工具的存在，它就能像执行--help命令一样自行摸索出使用方法。

  2. MCP 协议工具：Claude Code 全面支持 Model Context Protocol（模型上下文协议），只需添加 MCP 工具并说明用法，它就能立刻上手使用。

如果频繁使用某些工具，可以将它们的用法存入Claude.md文件，Claude Code 会自动记忆这些信息，这也是 Anthropic 内部的常规操作。

4.2 自动迭代：让 Claude Code 自我优化

只要给 Claude Code 一个能利用反馈进行自我检验的工具，它就能不断迭代优化，越做越好：

  • 通过编写单元测试验证代码正确性

  • 利用 Puppeteer 进行网页截图对比

  • 使用 iOS 模拟器进行应用界面测试

最神奇的是，只要给它一个设计稿，吩咐它 "把这个界面做出来"，它往往就能完成得相当漂亮。通常只需迭代两三次，效果就能近乎完美。

五、上下文管理：让 Claude Code 更懂你的项目

上下文越充分，Claude Code 的决策就越精准。作为长期耕耘在代码库中的工程师，你对系统全貌、架构、历史以及各种细节了如指掌，而这些信息都可以通过多种方式传递给 Claude Code。

5.1 核心方法：使用 Claude.md 文件

这是最简单也最有效的上下文管理方式：

  • 在项目根目录创建Claude.md文件，每次会话开始时会自动载入，首轮对话即可获得完整上下文。

  • 建议将团队共享的Claude.md提交至版本控制，做到一次编辑，全员通用。

  • 也可以创建个人专用的本地Claude.md文件，无需提交至版本控制。

  • Claude.md文件可以放在任意嵌套子目录中，当 Claude Code 在这些目录内运行时，会自动加载对应的文件。

  • 企业用户可以在企业根目录放置一个跨所有代码库共享的Claude.md，实现统一管理。

5.2 Claude.md 文件内容建议

尽量保持内容简短，只包含在该代码库中工作所必需的背景知识，过长的内容会消耗大量上下文窗口，反而影响效果。建议包含：

  • 常用的 bash 命令

  • 代码风格指南

  • 项目架构说明

  • 关键决策记录

  • 核心文件路径

  • MCP 工具配置

5.3 其他上下文引入方式

除了自动加载的Claude.md文件，你还可以直接使用 Claude Code 的斜杠命令来引入上下文，这些命令既可以存于主目录，也可以放入具体项目中。

结语

Claude Code 的强大之处，不仅在于它能写代码，更在于它能理解你的工作流、适配你的工具、融入你的团队。从新手入门的代码库问答，到进阶的工具集成与自动迭代，再到精细化的上下文管理，每一个环节都经过了 Anthropic 内部团队的实战检验。

这份官方教学的价值，在于它提供了最正确、最有效的使用方法，避免了你在网上摸索各种零散技巧所浪费的时间。30 分钟，40 个核心指令，就能让你的开发效率实现质的飞跃。现在就打开 Claude Code，按照本文的步骤开始实践吧。