Claude Code 实战指南：从入门到高阶的完整技巧手册

Claude Code 实战指南：从入门到高阶的完整技巧手册

Claude Code 是 Anthropic 推出的 AI 编程助手，它不只是代码补全工具，而是能够自主构建功能、修复 Bug、操作文件系统的 Agentic 编码助手。本文基于 Anthropic 技术团队（波利）的内部实践分享，整理出一套从入门到高阶的完整使用技巧，重点保留了所有可直接复用的提示词（Prompts）。

一、Claude Code 的核心定位

Claude Code 的设计哲学是 “不干扰你的工作流” ——无论你使用 VS Code、Xcode、JetBrains IDE、Vim 还是 Emacs，它都能通过终端（Terminal）无缝接入。它支持本地工作、远程 SSH、TMUX 等任意环境。

与逐行补全的 AI 助手不同，Claude Code 是 完全 Agentic 的：

• 编写完整功能、完整文件
• 同时修复多个 Bug
• 调用外部工具（Bash、测试框架、MCP Server 等）
• 自主规划、执行、验证

二、首次使用：环境配置

2.1 基础安装

# 安装 Claude Code CLI
npm install -g @anthropic-ai/claude-code

# 启动并登录
claude

提示：如果你使用 macOS，建议开启系统辅助功能中的 语音输入（系统设置 → 辅助功能 → 语音控制），按两次口述键即可语音输入提示，大幅提升效率。

2.2 推荐初始配置

# 设置终端主题（浅色/深色/道尔顿模式）
claude /theme light    # 或 dark / dalton

# 连接 GitHub App（可在 Issue/PR 中 @Claude）
claude /github-connect

# 自定义允许使用的工具，避免每次手动确认
claude /config tools --allow bash,edit,read

三、入门阶段：代码库问答（Codebase Q&A）

Claude Code 的界面非常自由——只有一个提示栏。对于新手，最重要的建议是从「代码库问答」开始，而不是直接让它写代码。

3.1 为什么从问答开始？

• 零设置：Claude Code 不做索引，代码不会上传到远程数据库，也不用于训练模型。下载即用，无需等待索引构建。
• 学习边界：通过问答了解 Claude 能做什么、不能做什么，掌握提示的粒度（一句话 vs 多轮交互）。
• 降低团队负担：技术入职时间从 2-3 周缩短到 2-3 天，新成员可以自主探索代码库。

3.2 代码库问答提示词（Prompts）

Prompt 1：理解代码用法

这段代码是如何使用的？

Prompt 2：查找实例化方式

如何实例化这个类？

Claude 不会只做文本搜索，它会深入挖掘调用链，找到实际使用示例，给出比 Ctrl+F 更深入的答案。

Prompt 3：分析 Git 历史（理解参数设计）

为什么这个函数有15个参数？为什么参数的方式如此奇怪？

它会查看 Git 历史，找出这些参数是如何引入的、是谁引入的、当时的情况如何，并总结所有提交信息。

Prompt 4：浏览 Git 历史

浏览一下 Git 历史。

Claude 会自动查看 Git 日志、分析提交信息、总结历史演变，无需手动翻阅提交记录。

Prompt 5：GitHub 周报生成

我这周 ship 了什么？

连接 GitHub App 后，Claude 会拉取你的 PR、Issue 上下文，生成工作周报，直接复制粘贴到文档中。

3.3 入门建议总结

如果你是第一次向团队展示 Claude Code，推荐的工作流：

1. 从 代码库问答 开始
2. 不要从使用花哨的工具开始
3. 不要从编辑代码开始
4. 从询问有关代码库的问题开始

这将教会人们如何提示，开始教授边界——Claude 能做什么、不能做什么，什么可以是一个镜头（单次交互），什么需要两个、三个镜头，什么时候需要使用交互模式。

四、进阶阶段：代码编辑与工作流

4.1 核心工具集

Claude Code 内置了精简但强大的工具集，无需手动指定工具，只需描述目标，Claude 会自动串联：

4.2 编辑前的关键步骤：先计划，后执行

反模式：直接要求实现一个 3000 行的巨大功能，结果可能不是想要的。

正确做法：先让 Claude 头脑风暴、制定计划，获得你的批准后再写代码。

Prompt 6：计划驱动开发

请帮我实现 [功能描述]。

第一步：先探索代码库，了解现有架构。
第二步：制定实现计划，列出步骤和文件修改清单。
第三步：等我确认后再开始编写代码。

你也可以更简单地说：

在写代码之前，先制定一个计划。

Claude 会自动理解这个工作流，无需使用特殊的「计划模式」。

4.3 一键提交与推送

Prompt 7：自动提交、推送、创建 PR

完成修改后，提交代码并推送到远程仓库，创建一个 Pull Request。

更简洁的咒语版本：

commit, push, and make a pull request for me on GitHub

Claude 会：

1. 查看 Git 日志，推断团队的提交格式规范
2. 自动编写提交信息
3. 创建分支、提交、推送
4. 在 GitHub 上发起 PR

4.4 迭代验证：让 Claude 检查自己的工作

最强大的技巧是给 Claude 提供 反馈工具，让它自我迭代：

Prompt 8：截图迭代开发

根据这个设计稿截图，构建对应的 Web UI。

配合 Puppeteer MCP Server，Claude 可以自动截图、对比、迭代 CSS。

Prompt 9：iOS 模拟器迭代

构建这个 App UI，使用 iOS 模拟器截图来验证。

核心原则：无论你的领域是什么（Web、App、后端），只要给 Claude 某种工具让它能看到结果，它就会自行迭代，结果会越来越好。

五、高阶阶段：上下文配置与团队共享

5.1 CLAUDE.md：项目级上下文

在项目根目录创建 CLAUDE.md，Claude 会在每个会话开始时自动读取。

建议内容：

• 常见 Bash 命令
• 代码风格指南
• 核心架构文件说明
• 重要的架构决策记录

注意事项：

• 保持精简，过长会浪费上下文窗口
• 应签入版本控制，与团队共享
• 也可在子目录放置 CLAUDE.md，Claude 会根据工作目录自动拉取

5.2 本地配置：~/.claude/CLAUDE.md

用于个人偏好，不签入版本控制：

• 个人常用的 MCP 工具配置
• 私有环境变量
• 个人编码习惯

5.3 企业级配置

企业管理员可以设置全局策略文件，所有员工自动继承：

# 企业策略示例
[permissions]
# 自动批准常用命令
allow_commands = ["npm test", "pytest", "cargo check"]

# 禁止访问危险 URL
block_urls = ["https://internal-secrets.company.com"]

# 强制 MCP 服务器
required_mcp = ["github", "linear"]

六、MCP 与外部工具集成

6.1 MCP（Model Context Protocol）

MCP 是 Anthropic 开源的标准协议，让 Claude 能够调用外部工具：

# 安装 MCP 服务器（以 Puppeteer 为例）
npm install -g @anthropic-ai/mcp-puppeteer

常用 MCP 工具：

• Puppeteer/Playwright：浏览器自动化、截图验证
• GitHub MCP：Issue/PR 管理
• Postgres MCP：数据库查询
• 自定义 MCP：团队内部工具

6.2 Bash 工具扩展

对于常用的 CLI 工具，可以直接在提示中告诉 Claude：

Prompt 10：使用特定 CLI 工具

使用 dash CLI 来完成这个任务。如果不确定用法，运行 dash --help 查看帮助。

如果频繁使用，将其写入 CLAUDE.md，Claude 会在整个会话期间记住。

七、Claude Code SDK：构建自定义工作流

Claude Code 底层使用 Claude SDK，你也可以直接调用：

import { Claude } from "@anthropic-ai/claude-sdk";

const claude = new Claude();

const result = await claude.run({
  prompt: "分析这个日志文件，找出异常模式",
  allowedTools: ["bash", "read"],
  outputFormat: "json"  // 或 "streaming-json"
});

// 结果可以直接管道到 jq 或其他工具
console.log(result);

典型用途：

• CI/CD 管道中的自动化步骤
• 事件响应（自动分析日志、生成报告）
• 作为 Unix 工具链的一环：git log | claude-sdk | jq
• 从 GCS/S3 读取大日志文件，让 Claude 分析

八、效率技巧与快捷键

8.1 自动接受模式

/auto-accept

• 文件编辑自动接受（无需逐个确认）
• Bash 命令仍需手动批准（安全考虑）
• 适合：编写单元测试、已知正确路径的迭代

8.2 让 Claude 记住事情

Prompt 11：持久化记忆

# [你想让 Claude 记住的内容]

例如：

# 记住：在这个项目中，所有 API 调用都必须通过 /lib/api 封装层

Claude 会将其写入 CLAUDE.md，在后续会话中自动应用。

九、并行工作：最大化生产力

Claude Code 支持 任意数量的并行会话：

示例：在微服务架构中，同时让 3 个 Claude 会话分别处理：

• 会话 A：修改 API 网关
• 会话 B：更新用户服务
• 会话 C：编写集成测试

十、安全设计：Bash 命令的分层权限

Bash 命令本质上是危险的。Claude Code 采用了 分层权限系统：

1. 静态分析：识别只读命令（如 git log、cat）
2. 安全组合：判断哪些命令可以安全地连续执行
3. 分层许可：
   • 全局允许/阻止列表
   • 项目级配置
   • 企业策略
   • 用户本地配置

这样既保证了生产力（不用每次确认），又确保了安全性。

十一、多模态能力

Claude Code 完全支持多模态输入：

Prompt 12：基于截图实现 UI

根据这个设计稿截图实现对应的 UI。

Prompt 13：基于截图排查错误

分析这个错误截图，找出问题所在。

十二、斜杠命令（Slash Commands）

Claude Code 支持自定义斜杠命令，可在 ~/.claude/commands/ 或项目目录中定义：

Prompt 14：运行斜杠命令

/triage-github-issues

示例：Anthropic 团队使用 /triage-github-issues 命令自动标记和分类 GitHub Issue，通过 GitHub Actions 运行，无需人工操作。

十三、完整提示词速查表

十四、推荐的学习路径

第 1 步：代码库问答
    └── 使用 Prompt 1-5 了解代码结构、Git 历史、API 用法

第 2 步：简单编辑
    └── 单文件修改、Bug 修复、Refactor

第 3 步：计划驱动开发
    └── 使用 Prompt 6：先计划 → 确认 → 执行 → 验证

第 4 步：工具集成
    └── MCP Server、Bash 工具、Prompt 8-9 截图验证

第 5 步：团队共享
    └── CLAUDE.md、企业策略、Prompt 14 斜杠命令

第 6 步：并行规模化
    └── 多会话、多仓库、自动化管道

核心理念：Claude Code 不是替代工程师，而是像一位「实习生」一样处理繁琐工作，让你专注于架构设计和关键决策。上下文给得越多，决策就越明智——花时间配置好 CLAUDE.md，回报率极高。

参考资源

• Claude Code 官方文档
• MCP 协议规范
• Claude SDK GitHub