Claude Code 完全使用指南：从入门到高效协作
1、Claude Code 概述与安装
1.1、什么是 Claude Code
Claude Code 是 Anthropic 推出的智能编程助手工具，直接运行在终端和 IDE 中。它能够读取代码仓库、编辑文件、执行 Shell 命令，自主完成多步骤的编程任务。可与 Git、GitHub、外部服务（通过 MCP）以及开发环境深度集成。
1.2、系统要求
- macOS 13.0+，Windows 10 1809+（需安装 Git for Windows）
- Ubuntu 20.04+，Debian 10+，Alpine Linux 3.19+
- 内存 4 GB 以上
1.3、安装方式
macOS / Linux / WSL：
curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell：
irm https://claude.ai/install.ps1 | iex
Homebrew（macOS/Linux）：
brew install claude
WinGet（Windows）：
winget install Anthropic.ClaudeCode
1.4、更新方式
运行 claude update 即可获取最新版本。
1.5、使用方式
- 终端命令行（CLI）
- VS Code 扩展
- JetBrains 插件（IntelliJ、PyCharm、WebStorm 等）
- 桌面应用（macOS / Windows）
- 网页版 claude.ai/code
- CI/CD 集成（GitHub Actions、GitLab CI/CD）
1.6、启动方式
在项目目录下运行 claude 即可启动交互式会话。
使用 claude -p "你的提示" 可以非交互式运行，适合脚本和自动化场景。
2、核心命令与快捷键
2.1、核心斜杠命令
会话管理：
- /clear：重置对话上下文
- /compact [主题]：压缩对话，可选保留某个主题的关键信息
- /continue：从上次中断处继续
- /resume：从列表中恢复之前的会话
- /fork：将当前对话分支到新会话
- /branch：创建新分支和 worktree
- /rewind：打开回退菜单，恢复到之前的状态
- /exit：退出 Claude Code
代码审查与质量：
- /diff：查看待提交的更改
- /review：审查 Pull Request
- /security-review：对待提交的更改进行安全审查
- /simplify：审查已更改代码的复用性、质量和效率
配置与设置：
- /config：打开配置界面
- /model：切换或配置模型
- /effort：调整推理努力程度
- /permissions：管理权限规则和白名单
- /theme：更改颜色主题
- /keybindings：查看或修改键盘绑定
认证与账户：
- /login：登录 Claude
- /logout：登出
- /setup-bedrock：配置 Amazon Bedrock
- /setup-vertex：配置 Google Vertex AI
工具与集成：
- /mcp：管理 MCP 服务器（连接外部工具）
- /plugin：浏览和安装插件
- /hooks：查看已配置的钩子
- /skills：列出和管理技能
- /agents：列出和创建子代理
- /add-dir：向上下文中添加目录
信息与调试：
- /help：显示帮助信息
- /doctor：运行诊断检查
- /status：显示当前状态
- /cost：显示会话费用
规划与自动化：
- /plan：进入规划模式（只读，先分析再动手）
- /loop：按间隔循环运行提示
- /batch：在隔离的 worktree 中并行执行任务
- /tasks：列出任务
- /fast：切换快速模式
项目与仓库：
- /init：初始化 CLAUDE.md 项目配置文件
- /memory：编辑 CLAUDE.md 记忆文件
2.2、快捷前缀
- /：斜杠命令和技能
- !：直接执行 Bash 命令（如 !ls -la）
- @：引用文件或目录（如 @src/main.py）
2.3、键盘快捷键
通用控制：
- Ctrl+C：取消当前操作
- Ctrl+D：退出 Claude Code
- Ctrl+L：清空输入行
- Ctrl+G：在外部编辑器中打开输入（如 Vim/VS Code）
- Ctrl+O：切换详细/精简视图
- Ctrl+R：反向搜索历史命令
- Ctrl+V：从剪贴板粘贴图片
- Ctrl+B：在后台运行 Bash 命令
- Ctrl+T：打开任务列表
- Esc：中途停止 Claude 的操作
- Esc + Esc：打开回退菜单（双击）
- Shift+Tab：循环切换权限模式（普通 -> 接受编辑 -> 规划）
- Alt+P：切换模型
- Alt+T：切换扩展思考（Extended Thinking）
- Alt+O：切换快速模式
输入行编辑：
- Ctrl+K：删除光标到行尾的内容
- Ctrl+U：删除光标到行首的内容
- Ctrl+Y：粘贴已删除的内容
- Alt+B：光标向前移动一个单词
- Alt+F：光标向后移动一个单词
多行输入：
- \ + Enter：插入新行
- Ctrl+J：插入新行
- Option+Enter：插入新行（macOS）
- 粘贴多行文本时自动进入多行模式
会话选择器（在 /resume 中使用）：
- 上/下方向键：导航会话列表
- Enter：选择会话
- P：预览会话内容
- R：重命名会话
- /：搜索/过滤会话
- Esc：退出选择器
提示：如果偏好 Vim 操作习惯，可以通过 /keybindings 切换 Vim 模式，支持 h/j/k/l 移动、dd 删除行、yy 复制、p 粘贴等经典操作。
3、核心功能详解
3.1、CLAUDE.md 项目记忆文件
CLAUDE.md 是 Claude Code 的"永久上下文"，每次对话开始时自动加载。你可以在其中写明：
- 项目的构建和测试命令
- 代码风格和命名约定
- 架构决策和工作流规则
推荐放置位置：
- ~/.claude/CLAUDE.md：全局配置，对所有项目生效
- ./CLAUDE.md：项目根目录，提交到 Git，团队共享
- ./CLAUDE.local.md：个人项目备注，加入 .gitignore
使用 /init 命令可以自动生成初始模板。
3.2、权限模式
Claude Code 提供多种权限级别，适应不同场景：
- 默认模式：每次文件写入和命令执行都需要你确认
- 接受编辑：自动批准文件编辑，命令执行仍需确认
- 规划模式：只读，Claude 只分析不修改，适合先理解再动手
- 自动模式：分类器自动处理审批，拦截高风险操作
- 跳过权限：跳过所有检查（仅限 CI 环境，危险）
通过 Shift+Tab 快速切换，或在启动时用 --permission-mode 指定。
3.3、MCP 服务器（外部工具集成）
MCP（Model Context Protocol）让 Claude Code 连接外部工具和服务，如数据库、Jira、Figma、Notion、Sentry 等。添加服务器：
claude mcp add <名称> <命令> [参数...]
连接后，MCP 提供的提示会以 /mcp__<服务器>__<提示名> 的形式出现在命令列表中。
3.4、Hooks（确定性自动化）
Hooks 是在特定事件发生时自动执行的脚本，与 CLAUDE.md 中的指令（建议性的）不同，Hooks 保证一定会执行。支持的事件：
- PreToolUse / PostToolUse：工具执行前后
- Notification：Claude 需要注意时
- WorktreeCreate/Remove：Worktree 创建和删除时
示例：每次文件编辑后自动运行 eslint 检查。
在 .claude/settings.json 中配置。
3.5、子代理（Subagents）
子代理在独立的上下文窗口中运行，拥有自己的工具集。适合：
- 研究密集型任务，避免占满主对话的上下文
- 并行执行多个独立任务
- 需要 worktree 隔离的工作
在 .claude/agents/ 目录下用 Markdown 文件定义子代理。
3.6、Worktree 隔离
使用 claude --worktree <名称> 创建隔离的 Git worktree，每个会话有独立的工作目录和分支，适合并行开发多个功能。
3.7、非交互 / 无头模式
适合脚本和 CI/CD：
claude -p "修复所有 lint 错误" --permission-mode auto
claude -p "列出所有 API 端点" --output-format json
cat error.log | claude -p "解释根本原因"
4、高效使用技巧与最佳实践
4.1、积极管理上下文窗口
上下文窗口是最核心的约束，填满后性能会明显下降。
- 不同任务之间运行 /clear 清空上下文
- 使用 /compact <主题> 压缩对话，只保留关键信息
- 用 /btw 提问不会进入上下文的旁注问题
- 把研究任务委托给子代理，保持主对话干净
- 如果连续两次修正同一个问题还没解决，果断 /clear 换个更好的提示重新开始
4.2、给 Claude 验证自己工作的方式
这是提升效果最有效的单一手段。提供测试用例、期望输出或截图对比，让 Claude 能自我纠正。没有验证机制，你就是唯一的反馈环，效率会大打折扣。
4.3、先探索，再规划，最后编码
面对复杂任务，使用规划模式（Shift+Tab 切两次，或 --permission-mode plan）。让 Claude 先读取文件、理解代码库，再动手实现。小而明显的修复则直接做，不必规划。
4.4、写好 CLAUDE.md
保持简短、人类可读。对每一条规则问自己："删掉这条会导致 Claude 犯错吗？"如果不会，就删掉。臃肿的 CLAUDE.md 会让重要规则淹没在噪音中。用 /init 生成模板，然后大刀阔斧地精简。记得提交到 Git，让团队成员共同维护。
4.5、提供具体上下文
- 用 @src/path/to/file.js 引用文件
- 用 Ctrl+V 直接粘贴截图或图片
- 给出文档 URL
- 用管道传入数据：cat error.log | claude -p "解释这个错误"
4.6、善用 CLI 工具
安装 gh、aws、gcloud、sentry-cli 等命令行工具。CLI 工具是 Claude 与外部服务交互最节省上下文的方式。对于不熟悉的工具，告诉 Claude："先运行 foo-cli --help 了解用法，再用它解决问题 X。"
4.7、及时纠偏
- 按 Esc 中途停止 Claude 的操作
- 双击 Esc 打开回退菜单，回到任意之前的检查点
- 直接说"撤回那个修改"来撤销变更
- 上下文混乱时 /clear 重来
4.8、利用并行会话扩展规模
- claude --worktree <名称> 创建隔离的并行工作环境
- 使用桌面应用可视化管理多个会话
- Writer/Reviewer 模式：一个会话写代码，另一个审查代码
- 批量操作：for file in $(cat files.txt); do claude -p "迁移 $file"; done
4.9、让 Claude 采访你
面对大型功能开发，可以这样开始：
"我要构建[简要描述]。请用 AskUserQuestion 工具详细采访我，涵盖技术实现、UI/UX、边界情况和权衡取舍。
一直问到覆盖所有细节，然后把完整规格写到 SPEC.md。"
然后开一个干净的新会话来执行规格，避免上下文污染。
4.10、设置桌面通知
在 ~/.claude/settings.json 中添加 Notification 钩子，这样当 Claude 需要你的注意时，即使你在其他窗口也能收到提醒。
Claude Code 是一款强大的智能编程助手工具，通过合理的使用和配置，可以大大提高开发效率。掌握其核心命令、快捷键和功能，结合最佳实践，能够让你在编程过程中事半功倍。
更多信息请访问官方文档：https://docs.anthropic.com/en/docs/claude-code
