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 CLInpminstall-ganthropic-ai/claude-code# 启动并登录claude提示如果你使用 macOS建议开启系统辅助功能中的语音输入系统设置 → 辅助功能 → 语音控制按两次口述键即可语音输入提示大幅提升效率。2.2 推荐初始配置# 设置终端主题浅色/深色/道尔顿模式claude /theme light# 或 dark / dalton# 连接 GitHub App可在 Issue/PR 中 Claudeclaude /github-connect# 自定义允许使用的工具避免每次手动确认claude /config tools--allowbash,edit,read三、入门阶段代码库问答Codebase QAClaude Code 的界面非常自由——只有一个提示栏。对于新手最重要的建议是从「代码库问答」开始而不是直接让它写代码。3.1 为什么从问答开始零设置Claude Code不做索引代码不会上传到远程数据库也不用于训练模型。下载即用无需等待索引构建。学习边界通过问答了解 Claude 能做什么、不能做什么掌握提示的粒度一句话 vs 多轮交互。降低团队负担技术入职时间从 2-3 周缩短到 2-3 天新成员可以自主探索代码库。3.2 代码库问答提示词PromptsPrompt 1理解代码用法这段代码是如何使用的Prompt 2查找实例化方式如何实例化这个类Claude 不会只做文本搜索它会深入挖掘调用链找到实际使用示例给出比CtrlF更深入的答案。Prompt 3分析 Git 历史理解参数设计为什么这个函数有15个参数为什么参数的方式如此奇怪它会查看 Git 历史找出这些参数是如何引入的、是谁引入的、当时的情况如何并总结所有提交信息。Prompt 4浏览 Git 历史浏览一下 Git 历史。Claude 会自动查看 Git 日志、分析提交信息、总结历史演变无需手动翻阅提交记录。Prompt 5GitHub 周报生成我这周 ship 了什么连接 GitHub App 后Claude 会拉取你的 PR、Issue 上下文生成工作周报直接复制粘贴到文档中。3.3 入门建议总结如果你是第一次向团队展示 Claude Code推荐的工作流从代码库问答开始不要从使用花哨的工具开始不要从编辑代码开始从询问有关代码库的问题开始这将教会人们如何提示开始教授边界——Claude 能做什么、不能做什么什么可以是一个镜头单次交互什么需要两个、三个镜头什么时候需要使用交互模式。四、进阶阶段代码编辑与工作流4.1 核心工具集Claude Code 内置了精简但强大的工具集无需手动指定工具只需描述目标Claude 会自动串联工具功能edit编辑文件bash运行终端命令read/search搜索和读取文件4.2 编辑前的关键步骤先计划后执行反模式直接要求实现一个 3000 行的巨大功能结果可能不是想要的。正确做法先让 Claude 头脑风暴、制定计划获得你的批准后再写代码。Prompt 6计划驱动开发请帮我实现 [功能描述]。 第一步先探索代码库了解现有架构。 第二步制定实现计划列出步骤和文件修改清单。 第三步等我确认后再开始编写代码。你也可以更简单地说在写代码之前先制定一个计划。Claude 会自动理解这个工作流无需使用特殊的「计划模式」。4.3 一键提交与推送Prompt 7自动提交、推送、创建 PR完成修改后提交代码并推送到远程仓库创建一个 Pull Request。更简洁的咒语版本commit, push, and make a pull request for me on GitHubClaude 会查看 Git 日志推断团队的提交格式规范自动编写提交信息创建分支、提交、推送在 GitHub 上发起 PR4.4 迭代验证让 Claude 检查自己的工作最强大的技巧是给 Claude 提供反馈工具让它自我迭代场景反馈工具效果Web UI 开发Puppeteer / Playwright 截图迭代 2-3 次后接近完美iOS App 开发iOS 模拟器截图自动调整 UI 细节后端开发单元测试 / 集成测试自动修复失败测试Prompt 8截图迭代开发根据这个设计稿截图构建对应的 Web UI。配合 Puppeteer MCP ServerClaude 可以自动截图、对比、迭代 CSS。Prompt 9iOS 模拟器迭代构建这个 App UI使用 iOS 模拟器截图来验证。核心原则无论你的领域是什么Web、App、后端只要给 Claude 某种工具让它能看到结果它就会自行迭代结果会越来越好。五、高阶阶段上下文配置与团队共享5.1 CLAUDE.md项目级上下文在项目根目录创建CLAUDE.mdClaude 会在每个会话开始时自动读取。建议内容常见 Bash 命令代码风格指南核心架构文件说明重要的架构决策记录注意事项保持精简过长会浪费上下文窗口应签入版本控制与团队共享也可在子目录放置CLAUDE.mdClaude 会根据工作目录自动拉取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 MCPModel Context ProtocolMCP 是 Anthropic 开源的标准协议让 Claude 能够调用外部工具# 安装 MCP 服务器以 Puppeteer 为例npminstall-ganthropic-ai/mcp-puppeteer常用 MCP 工具Puppeteer/Playwright浏览器自动化、截图验证GitHub MCPIssue/PR 管理Postgres MCP数据库查询自定义 MCP团队内部工具6.2 Bash 工具扩展对于常用的 CLI 工具可以直接在提示中告诉 ClaudePrompt 10使用特定 CLI 工具使用 dash CLI 来完成这个任务。如果不确定用法运行 dash --help 查看帮助。如果频繁使用将其写入CLAUDE.mdClaude 会在整个会话期间记住。七、Claude Code SDK构建自定义工作流Claude Code 底层使用Claude SDK你也可以直接调用import{Claude}fromanthropic-ai/claude-sdk;constclaudenewClaude();constresultawaitclaude.run({prompt:分析这个日志文件找出异常模式,allowedTools:[bash,read],outputFormat:json// 或 streaming-json});// 结果可以直接管道到 jq 或其他工具console.log(result);典型用途CI/CD 管道中的自动化步骤事件响应自动分析日志、生成报告作为 Unix 工具链的一环git log | claude-sdk | jq从 GCS/S3 读取大日志文件让 Claude 分析八、效率技巧与快捷键快捷键功能Shift Tab接受当前编辑建议Esc停止 Claude 当前操作不破坏会话EscEsc回到历史记录!进入 Bash 模式命令也会进入上下文窗口#让 Claude 记住某事写入 CLAUDE.md↑/↓查看完整输出8.1 自动接受模式/auto-accept文件编辑自动接受无需逐个确认Bash 命令仍需手动批准安全考虑适合编写单元测试、已知正确路径的迭代8.2 让 Claude 记住事情Prompt 11持久化记忆# [你想让 Claude 记住的内容]例如# 记住在这个项目中所有 API 调用都必须通过 /lib/api 封装层Claude 会将其写入CLAUDE.md在后续会话中自动应用。九、并行工作最大化生产力Claude Code 支持任意数量的并行会话策略说明多终端标签同一仓库的不同分支/功能并行开发Git Worktree同一仓库的多个独立工作区多仓库同时处理多个相关项目SSH TMUX远程服务器上的持久会话示例在微服务架构中同时让 3 个 Claude 会话分别处理会话 A修改 API 网关会话 B更新用户服务会话 C编写集成测试十、安全设计Bash 命令的分层权限Bash 命令本质上是危险的。Claude Code 采用了分层权限系统静态分析识别只读命令如git log、cat安全组合判断哪些命令可以安全地连续执行分层许可全局允许/阻止列表项目级配置企业策略用户本地配置这样既保证了生产力不用每次确认又确保了安全性。十一、多模态能力Claude Code 完全支持多模态输入方式操作拖拽图片直接将图片拖入终端文件路径提供图片的绝对/相对路径复制粘贴从剪贴板粘贴图片Prompt 12基于截图实现 UI根据这个设计稿截图实现对应的 UI。Prompt 13基于截图排查错误分析这个错误截图找出问题所在。十二、斜杠命令Slash CommandsClaude Code 支持自定义斜杠命令可在~/.claude/commands/或项目目录中定义Prompt 14运行斜杠命令/triage-github-issues示例Anthropic 团队使用/triage-github-issues命令自动标记和分类 GitHub Issue通过 GitHub Actions 运行无需人工操作。十三、完整提示词速查表编号场景提示词1理解代码用法这段代码是如何使用的2查找实例化方式如何实例化这个类3分析参数设计为什么这个函数有15个参数为什么参数的方式如此奇怪4浏览 Git 历史浏览一下 Git 历史。5生成工作周报我这周 ship 了什么6计划驱动开发在写代码之前先制定一个计划。/先探索代码库了解现有架构制定实现计划等我确认后再开始编写代码。7提交推送 PRcommit, push, and make a pull request for me on GitHub8Web UI 迭代根据这个设计稿截图构建对应的 Web UI。9iOS UI 迭代构建这个 App UI使用 iOS 模拟器截图来验证。10使用特定 CLI使用 dash CLI 来完成这个任务。如果不确定用法运行 dash --help 查看帮助。11持久化记忆# [你想让 Claude 记住的内容]12基于截图实现根据这个设计稿截图实现对应的 UI。13基于截图排查分析这个错误截图找出问题所在。14运行斜杠命令/[command-name]十四、推荐的学习路径第 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