目录

1. 什么是 Claude Code

2. 快速入门

3. 斜杠命令大全

4. 核心功能详解

5. 高级技巧

6. 配置与定制

7. 最佳实践

---

1. 什么是 Claude Code

Claude Code 是 Anthropic 推出的命令行 AI 编程助手，深度集成在你的终端中。它能理解整个代码库、执行命令、编辑文件、管理 Git 工作流，帮助你完成从简单问答到复杂重构的各种任务。

支持的平台

平台	方式
终端 CLI	直接在命令行中使用 claude 命令
桌面应用	Mac / Windows 原生应用
Web 应用	claude.ai/code
IDE 扩展	VS Code / JetBrains

---

2. 快速入门

启动 Claude Code

# 在终端中进入项目目录，然后运行
claude
​
# 或者指定工作目录
claude /path/to/your/project

基本交互

• 直接在提示符中输入自然语言描述你的需求

• Claude 会读取你的代码库、搜索文件、执行操作

• 敏感操作（如写文件、执行命令）会请求你的确认

常用快捷键

快捷键	功能
Ctrl+C	中断当前操作
Ctrl+D	退出 Claude Code
↑/↓	浏览历史命令
Ctrl+R	搜索历史命令

---

3. 斜杠命令大全

所有斜杠命令都以 / 开头，在 Claude Code 对话中直接输入即可使用。

📋 编程辅助类

/init — 初始化项目文档

为当前项目生成 CLAUDE.md 文件，包含代码库的结构、约定和常用操作说明。Claude 会据此更好地理解你的项目。

/init

/code-review — 代码审查

对当前变更进行审查，找出 bug、代码异味、可简化的地方。

# 基础审查（中等强度）
/code-review
​
# 深度审查
/code-review --effort high
​
# 审查后自动修复
/code-review --fix
​
# 审查并发布为 PR 评论
/code-review --comment

---

/review — PR 审查

审查 GitHub Pull Request，分析代码变更并给出反馈。

/review

/security-review — 安全审查

对当前分支的变更进行全面的安全审查。

/security-review

/simplify — 代码简化

对变更代码进行简化、重构、去重，提升代码质量（不查找 bug，只看质量）。

/simplify

/verify — 验证变更

运行应用并观察行为，确认代码变更是否按预期工作。适用于验证 PR、确认修复、测试功能。

/verify

/run — 启动并调试应用

启动当前项目的应用，确认修改在真实环境中生效（不仅仅是测试通过）。

/run

---

🔧 配置与管理类

/config — 查看/修改配置

查看和修改 Claude Code 的各种配置项，包括主题、模型选择等。

# 切换到 Fable 5 模型
/config model claude-fable-5

# 切换到 Opus 4.8
/config model claude-opus-4-8

# 切换主题
/config theme dark

/update-config — 高级配置（settings.json）

配置自动化行为（hooks）、权限、环境变量等。使用场景：

• "每当 X 发生时自动执行 Y"

• 添加命令执行权限

• 设置环境变量

• 排查 hook 问题

# 允许 npm 命令自动执行（不再询问确认）
/update-config allow npm commands

# 添加全局权限
/update-config add bq permission to global settings

# 设置环境变量
/update-config set DEBUG=true

/keybindings-help — 自定义快捷键

自定义键盘快捷键，修改 ~/.claude/keybindings.json。

# 重新绑定 Ctrl+S
/keybindings-help rebind ctrl+s

# 添加和弦快捷键
/keybindings-help add a chord shortcut

/fewer-permission-prompts — 减少权限询问

扫描历史对话中的常见只读命令，自动添加到项目的 settings.json 白名单中，减少后续的权限确认提示。

/fewer-permission-prompts

---

🔄 自动化与工作流类

/loop — 定时循环任务

按固定间隔重复执行某个命令或提示。

# 每 5 分钟检查一次部署状态
/loop 5m check the deploy status

# 每 10 分钟运行一次（默认间隔）
/loop run the smoke tests

# 每 30 分钟检查一次 CI
/loop 30m check CI pipeline status

/workflows — 多智能体工作流

管理和查看多个子智能体并行执行的工作流。适用于大规模代码审计、迁移等需要并行处理的复杂任务。

/workflows

---

📚 知识查询类

/claude-api — Claude API 参考

查询 Claude API / Anthropic SDK 相关信息，包括：

• 模型 ID 和定价

• API 参数说明

• 流式输出

• Tool Use（工具调用）

• MCP 协议

• Agent SDK

• Token 计数

• 缓存策略

• 模型迁移指南

# 查询最新模型定价
/claude-api what are the latest model prices?

# 查询流式输出用法
/claude-api how to use streaming?

/deep-research — 深度调研

多源搜索 → 获取资料 → 对抗性验证 → 生成带引用的调研报告。

# 调研某个技术选型
/deep-research 比较 React Server Components 和传统 SSR 的性能差异

# 需要明确的问题范围——如果问题太模糊，Claude 会先问你 2-3 个澄清问题

---

⚡ 快捷操作类

/clear — 清空对话

清空当前对话历史，重新开始。

/clear

/compact — 压缩上下文

当对话过长时，压缩历史消息以释放上下文空间。

/compact

/help — 帮助

显示帮助信息。

/help

/status — 状态查看

查看当前 Claude Code 的状态信息。

/status

/doctor — 诊断

诊断 Claude Code 的安装和配置问题。

/doctor

/ide — IDE 相关

查看和管理 IDE 集成状态。

/ide

---

🧠 记忆与偏好

/remember — 保存偏好/事实

让 Claude 记住你的偏好、项目约定或重要信息，持久保存到记忆系统中。

# 记住偏好
/remember I prefer using pnpm over npm

# 记住项目约定
/remember This project uses snake_case for Python files

---

🔀 Git 工作流

Claude Code 内置 Git 集成，支持分支、提交、PR 等操作：

# 创建分支
git checkout -b feature/new-feature

# 提交代码
git add .
git commit -m "feat: add new feature"

# 创建 PR
gh pr create --title "feat: new feature" --body "Description here"

💡 在 Claude Code 中，你可以直接用自然语言说 "创建一个 PR"，Claude 会帮你执行正确的 Git 命令。

---

4. 核心功能详解

4.1 代码理解

Claude Code 能自动搜索和分析你的整个代码库：

• Grep 搜索 — 正则表达式搜索文件内容

• Glob 匹配 — 按文件模式查找文件（如 **/*.tsx）

• 文件读取 — 理解文件结构和内容

• 跨文件分析 — 追踪函数调用链、类型引用等

4.2 代码编辑

Claude 可以直接编辑你的文件：

• 精确替换 — 基于字符串匹配的精确编辑（不会破坏格式）

• 新建文件 — 创建全新的代码文件

• 批量修改 — 支持 replace_all 一次性替换所有出现

4.3 命令执行

Claude 可以在你的终端中执行命令：

• 安装依赖（npm install、pip install 等）

• 运行测试（pytest、jest 等）

• Git 操作（提交、分支、合并等）

• 构建和部署

⚠️ 危险操作会请求确认，确保安全性。

4.4 任务管理

对于复杂任务，Claude 会创建任务列表，让你清晰看到：

• 当前进度（待办 / 进行中 / 已完成）

• 任务之间的依赖关系

• 阻塞项和问题

4.5 计划模式

在开始重要变更前，Claude 可以先进入计划模式：

1. 深入探索代码库

2. 设计实施方案

3. 列出受影响文件

4. 等你确认后再动手写代码

当你看到 "plan mode" 提示时，这意味着 Claude 在想清楚怎么做之后，会先让你审阅方案。

4.6 Worktree 隔离

对于需要隔离环境的任务，Claude 支持 Git worktree：

• 创建独立的临时工作区

• 在不影响主分支的情况下实验

• 完成后可选择保留或删除

---

5. 高级技巧

5.1 子智能体 (Sub-agents)

Claude Code 可以启动多个子智能体并行工作，大幅提升效率：

子智能体类型	用途
Explore	只读搜索智能体，快速扫描大量文件
general-purpose	通用智能体，处理各种任务
Plan	软件架构师，设计实施方案
claude-code-guide	Claude Code 使用问题专家

子智能体在后台运行，完成后通知你。

5.2 多智能体工作流 (Workflows)

对于大规模任务（代码审计、全库迁移、多维度分析），可以使用工作流：

• 并行查找 — 多个角度同时搜索

• 对抗性验证 — 独立验证发现的问题

• 合成报告 — 汇总各个智能体的结果

# 使用 workflow（通过 /workflows 命令或直接说 "use a workflow"）
/workflows

5.3 大文件处理

Claude Code 对超大文件有智能处理策略：

• 自动分页读取

• 按需搜索关键内容

• 避免一次性加载过多上下文

5.4 记忆系统

Claude 的记忆系统能跨会话保存你的偏好：

• 用户偏好 — 你是谁、你的技术栈偏好

• 项目约定 — 项目特有的代码风格、架构决策

• 反馈记录 — 你纠正过的做法

• 外部参考 — URL、文档、工单链接

---

6. 配置与定制

6.1 配置文件位置

~/.claude/
├── settings.json        # 主配置文件
├── settings.local.json  # 本地覆盖配置（不提交到 Git）
├── keybindings.json     # 快捷键配置
├── CLAUDE.md            # 项目文档（项目根目录）
└── memory/              # 记忆存储目录

6.2 常用配置项

{
  "model": "claude-sonnet-4-6",
  "theme": "dark",
  "permissions": {
    "allow": [
      "Bash(npm test)",
      "Bash(git status)"
    ]
  },
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write",
        "hooks": [{"command": "prettier --write $FILE_PATH"}]
      }
    ]
  }
}

6.3 模型选择

模型	特点	适用场景
Fable 5	最新、最强	复杂架构设计
Opus 4.8	深度推理	复杂 bug 排查
Sonnet 4.6	快速均衡	日常开发
Haiku 4.5	极速轻量	简单任务

6.4 Fast Mode

# 开启快速模式（使用 Opus 但更快输出）
/fast

---

7. 最佳实践

✅ 推荐做法

1. 使用 /init 初始化项目 — 让 Claude 充分了解你的项目结构和约定

2. 大任务先说计划 — 让 Claude 先规划方案，确认后再执行

3. 写清楚需求 — 越具体越好，"添加表单验证"不如"添加邮箱格式和密码长度（至少8位）的验证"

4. 善用子智能体 — 并行搜索多个目录或主题时，使用 Explore 智能体

5. 用 /remember 保存偏好 — 让 Claude 记住你的技术栈偏好和项目约定

6. 审查重要变更 — 使用 /code-review 和 /security-review 确保质量

7. 复杂任务用 workflow — 多智能体并行审计、迁移等场景

❌ 避免做法

1. 不要在一个对话中处理过多不相关任务 — 适时使用 /clear

2. 不要让 Claude 猜测 — 如果有多个合理方案，明确你的选择

3. 不要跳过确认步骤 — 写文件和执行命令时仔细审查

4. 不要忽略 Claude 的提问 — 当 Claude 问你澄清问题时，这意味着信息不足以做出正确决策

---

附录：快速参考卡片

命令	用途
/init	初始化项目 CLAUDE.md
/code-review	代码审查
/review	PR 审查
/security-review	安全审查
/simplify	简化代码
/verify	验证变更
/run	启动应用
/clear	清空对话
/compact	压缩上下文
/help	查看帮助
/config	修改配置
/update-config	高级配置
/claude-api	API 参考
/deep-research	深度调研
/loop	定时任务
/workflows	多智能体工作流
/remember	保存偏好
/fast	快速模式
/doctor	诊断问题