Claude Code 完全使用指南：从入门到高效协作

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