Claude Code 完整教程：从入门到精通

发表于 更新于 分类于
本文讲解相关技术要点和实践经验。

Claude Code 完整教程：从入门到精通

本教程整合了 Claude Code 的核心功能、隐藏技巧、终端美化以及项目实战经验，助你快速掌握这款革命性的 AI 编程工具。

一、Claude Code 是什么

1.1 核心定位

Claude Code 本质上是一个运行在终端里的 AI 编程代理。你可以把它理解为：

一个懂代码的同事坐在你旁边，你说需求，他直接改文件

它能读你的项目代码、执行 shell 命令、操作 Git，甚至帮你做 Code Review。

1.2 与 Cursor / Trae 的对比

特性 Cursor Trae Claude Code
运行环境 GUI 编辑器（VS Code 改造） GUI 编辑器（AI IDE） 终端 CLI
工作模式 Chat + 代码补全 Chat + 代码补全 + Agent 纯 Agent（任务驱动）
上下文理解 当前项目 当前项目 整个项目（200K+ token）
操作能力 改文件、终端命令有限 改文件、内置工具链 改文件、跑命令、操作 Git、MCP 扩展
模型选择 Claude/GPT 系列 豆包/DeepSeek/GPT Claude 系列 + 多提供商路由
扩展性 插件系统 插件系统 MCP 协议、Skills、Hooks
远程开发 需 VS Code Remote 内置支持 /remote-control 远程操控
适合场景 偏好 GUI、可视化操作 国内用户、中文优化 喜欢终端、追求效率、自动化

选型建议：

  • Cursor：适合习惯 VS Code 工作流、需要可视化界面的开发者
  • Trae：适合国内用户、对中文交互有要求的开发者
  • Claude Code：适合喜欢终端操作、追求极致效率、需要高度自动化的开发者

1.3 核心能力

  • 项目级全局视野：一次性”阅读”项目中成百上千个文件
  • 自然语言交互：用中文/英文描述需求即可
  • 强大实操能力：直接修改代码、执行命令、操作版本控制

二、安装与环境配置

2.1 系统要求

平台 要求
Windows Windows 10/11，PowerShell 5.1+ 或 PowerShell 7+
macOS macOS 10.15 (Catalina) 或更高版本
Linux Ubuntu 18.04+, Debian 10+, CentOS 7+, Fedora 30+

必需软件：

  • Node.js 18.0 或更高版本
  • npm 或 yarn 包管理器
  • Git（推荐）

2.2 安装 Node.js

Windows 安装 Node.js

方式一：使用 winget（推荐）

1
2
3
4
5
# 安装 Node.js LTS 版本
winget install OpenJS.NodeJS.LTS

# 或安装最新版本
winget install OpenJS.NodeJS

方式二：使用官方安装包

  1. 访问 Node.js 官网
  2. 下载 LTS（长期支持）版本
  3. 运行安装程序，一路下一步即可

方式三：使用 nvm-windows（开发者推荐）

1
2
3
4
5
6
# 安装 nvm-windows
winget install CoreyButler.NVMforWindows

# 安装完成后，在新的终端窗口中执行
nvm install lts
nvm use lts

macOS 安装 Node.js

1
2
3
4
5
6
7
8
# 使用 Homebrew 安装
brew install node

# 或使用 nvm（推荐）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.zshrc
nvm install --lts
nvm use --lts

Linux 安装 Node.js

1
2
3
4
5
6
7
8
9
# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

# 或使用 nvm（推荐）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
nvm install --lts
nvm use --lts

2.3 安装 Claude Code

方式一：npm 全局安装（推荐）

1
2
3
4
5
# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

方式二：使用 npx（无需安装）

1
2
# 直接运行，无需全局安装
npx @anthropic-ai/claude-code

方式三：使用 Homebrew（macOS）

1
2
brew tap anthropics/claude-code
brew install claude-code

2.4 首次运行与认证

1
2
3
4
5
# 启动 Claude Code
claude

# 首次启动会提示登录
# 按照提示访问 https://console.anthropic.com/ 获取 API Key

2.5 环境变量配置

Claude Code 支持通过环境变量进行配置：

1
2
3
4
5
6
7
8
# 设置 API Key（可选，也可在运行时登录）
export ANTHROPIC_API_KEY="your-api-key-here"

# 设置代理（如需要）
export HTTPS_PROXY="http://127.0.0.1:7890"

# 设置自定义 API 端点（如使用代理服务）
export ANTHROPIC_BASE_URL="https://your-proxy-server.com"

Windows PowerShell 环境变量设置：

1
2
3
4
5
6
7
# 临时设置（当前会话）
$env:ANTHROPIC_API_KEY = "your-api-key-here"
$env:HTTPS_PROXY = "http://127.0.0.1:7890"

# 永久设置（用户环境变量）
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "your-api-key-here", "User")
[Environment]::SetEnvironmentVariable("HTTPS_PROXY", "http://127.0.0.1:7890", "User")

2.6 验证安装

1
2
3
4
5
6
7
8
# 检查版本
claude --version

# 启动 Claude Code
claude

# 进入后测试
> 你好，请介绍一下你自己

三、斜杠命令全解析

3.1 高频命令（每天都会用）

命令 用途 使用场景
/help 查看帮助信息 忘记某个功能时随手查
/model 切换模型 简单任务切小模型省 token
/cost 查看本次会话费用 每次结束前看看花了多少钱
/memory 编辑记忆文件 让 AI 记住项目的约定和偏好
/clear 清空当前对话 开始新任务时重置上下文

3.2 项目级命令

命令 用途 说明
/init 初始化项目配置 生成 CLAUDE.md，相当于给 AI 写项目说明书
/config 修改配置 调整权限、行为偏好等
/mcp 管理 MCP 服务器 接入外部工具和数据源

重要提示：第一次打开一个新项目，先跑 /init。它会扫描你的代码库，自动生成一份项目描述文件。后续 AI 理解你的代码会准确得多。

3.3 进阶命令

命令 用途
/review 让 AI 做 Code Review
/compact 压缩对话历史，释放上下文空间

四、键盘快捷键速查表

4.1 核心快捷键

1
2
3
4
Ctrl + C      → 打断当前 AI 的执行（跑偏了赶紧刹车）
Ctrl + O      → 切换详细输出模式（看 AI 的思考过程）
Shift + Tab   → 切换权限模式（信任模式 vs 确认模式）
Esc + Esc     → 撤销上一次文件改动（改坏了一键回退）

救命键 Esc + Esc：有一次 AI 帮我重构一个文件，改完发现逻辑不对，双击 Esc 直接回退，比 Git 操作快多了。

4.2 多行输入的三种姿势

  • 反斜杠换行：在行尾打 \ 再按 Enter
  • Option + Enter（macOS）：直接换行不发送
  • Shift + Enter：跨平台通用

推荐使用 Shift + Enter，肌肉记忆和其他工具一致。

4.3 实用快捷键补充

快捷键 功能
Ctrl + V 直接粘贴截图（Mac 用户注意是 Ctrl 不是 Cmd）
Ctrl + J 或 Option + Enter 换行
Ctrl + R 搜索历史 prompt
Ctrl + U 删除整行输入

五、Plan 模式深度应用

5.1 什么是 Plan 模式

Plan 模式是 Claude Code 的一个核心特性，让 AI 在执行复杂任务前先进行规划和分析，而不是直接动手修改代码。这对避免”AI 在错误的方向上狂奔”至关重要。

5.2 何时使用 Plan 模式

必须使用 Plan 模式的场景：

  1. 大型重构任务

    • 涉及多个文件的修改
    • 需要调整架构或模块划分

  2. 新功能开发

    • 需要设计新的 API 或数据结构
    • 涉及多个组件的协作

  3. 复杂 Bug 修复

    • 需要先分析根本原因
    • 可能影响多个模块

  4. 技术选型决策

    • 需要比较多种方案
    • 涉及权衡取舍

5.3 Plan 模式的三种触发方式

方式一：自然语言触发

1
请先分析一下这个项目的架构，然后制定一个重构计划，不要直接改代码。

方式二：EnterPlanMode 工具

Claude Code 会在检测到复杂任务时自动建议进入 Plan 模式。

5.4 Plan 模式最佳实践

实践一：分阶段规划

1
2
3
4
5
6
7
8
9
我需要添加用户认证功能，请分阶段规划：

阶段1：分析现有代码结构
阶段2：设计认证方案（JWT vs Session）
阶段3：规划数据库表结构
阶段4：设计 API 接口
阶段5：制定实现步骤

请先完成阶段1-4的规划，确认后再开始实现。

实践二：明确约束条件

1
2
3
4
5
6
请帮我重构这个模块，但有以下约束：
1. 必须保持向后兼容
2. 不能修改公开 API 的签名
3. 性能不能下降

请先制定计划，列出每个步骤可能的风险点。

实践三：利用 /rewind 做实验

Plan 模式配合 /rewind 使用效果最佳：

  1. 让 AI 尝试一种方案
  2. 不满意？使用 /rewind 回退代码但保留对话
  3. AI 记得上次尝试失败，直接换方向

5.5 Plan 模式工作流程图

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
┌─────────────────┐
│   描述需求      │
└────────┬────────┘
         ↓
┌─────────────────┐
│  进入 Plan 模式 │
└────────┬────────┘
         ↓
┌─────────────────┐
│ AI 分析并规划   │
└────────┬────────┘
         ↓
┌─────────────────┐
│ 用户确认/修改   │
└────────┬────────┘
         ↓
    ┌────┴────┐
    │ 确认？  │
    └────┬────┘
    Yes  │  No
    ↓    └──→ 修改计划
┌─────────────────┐
│  分步执行       │
└────────┬────────┘
         ↓
┌─────────────────┐
│  /rewind 调整   │ ← 如果需要
└─────────────────┘

六、OpenSpec 详细配置

OpenSpec 是一个独立的规范驱动开发工具，与 Claude Code 内置的 Plan 模式有相似之处，但功能更强大。它是本教程重点介绍的高级工作流工具。

6.1 OpenSpec vs Plan 模式

特性 Plan 模式 OpenSpec
定位 Claude Code 内置功能 独立的规范驱动工具
规范存储 临时（会话内） 持久化（文件系统）
团队协作 不支持 支持（规范文件可共享）
历史追溯 无 完整的变更归档
跨工具支持 仅 Claude Code 支持 Claude、Cursor、Windsurf 等

6.2 OpenSpec 的核心优势

1. 规范持久化

  • Plan 模式的规划只在当前会话有效，关闭终端就消失
  • OpenSpec 将规范保存为文件，随时可查看、修改、复用

2. 团队协作友好

  • 规范文件可以提交到 Git，团队成员都能看到
  • 新成员加入项目时，可以快速了解历史决策

3. 变更可追溯

  • /opsx:archive 归档完成的变更
  • 可以回溯查看每个功能的设计决策

4. 跨 AI 工具支持

  • 同一份规范可用于 Claude Code、Cursor、Windsurf
  • 团队成员使用不同工具也能保持一致

5. 更严格的流程控制

  • propose → apply → archive 形成完整闭环
  • 减少 AI”自作主张”的情况

6.3 安装

1
2
3
4
5
6
7
8
# 使用 npm 安装（推荐）
npm install -g @fission-ai/openspec@latest

# 使用 pnpm
pnpm add -g @fission-ai/openspec@latest

# 使用 yarn
yarn global add @fission-ai/openspec@latest

要求：Node.js 20.19.0 或更高版本

6.4 初始化项目

1
2
3
4
5
6
7
8
9
10
11
# 进入项目目录
cd your-project

# 交互式初始化
openspec init

# 指定 AI 工具
openspec init --tools claude,cursor

# 使用全部工具和 core 配置
openspec init --tools all --profile core --force

初始化后会在项目中创建：

  • .claude/skills/ - OpenSpec 技能文件
  • .claude/commands/opsx/ - OpenSpec 命令
  • openspec/config.yaml - 项目配置文件

6.5 核心命令

命令 功能
/opsx:propose 提出新的功能变更方案，生成规范文件
/opsx:explore 探索现有代码结构
/opsx:apply 应用已批准的规范
/opsx:archive 归档完成的变更

6.6 工作流程

1
2
/opsx:propose → 生成规范文件 → 人工审核 → /opsx:apply → /opsx:archive
                （规范持久化保存，可追溯、可共享）

6.7 使用示例

新功能开发

1
/opsx:propose "添加用户认证功能，支持 JWT 和 OAuth2"

代码重构

1
/opsx:propose "重构支付模块，解耦第三方支付接口"

架构探索

1
/opsx:explore 分析当前系统的数据流向

6.8 扩展工作流

通过 openspec config profile 切换到扩展配置后，还支持：

命令 功能
/opsx:new 创建新的规范分支
/opsx:continue 继续之前未完成的工作
/opsx:verify 验证实现是否符合规范
/opsx:sync 同步规范与代码状态

6.9 何时使用 OpenSpec

  • 中大型功能开发
  • 需要团队协作的项目
  • 需要保留设计决策的场景
  • 跨多个 AI 工具的工作流

七、CC Switch：多服务提供商管理神器

CC Switch 是一款专为 Claude Code、Codex 和 Gemini CLI 设计的一站式服务提供商管理工具，支持可视化管理 API 配置、快速切换服务商、速度测试等功能。

7.1 为什么需要 CC Switch

  • 一键切换：无需手动编辑配置文件，图形化界面轻松切换
  • 多服务商支持：同时管理 Anthropic、OpenAI、DeepSeek、智谱 GLM 等多个服务商
  • 国内友好：轻松配置代理和中转服务，解决网络访问问题
  • 成本优化：根据任务复杂度选择合适的模型，节省 API 费用
  • image-20260320212535028

7.2 安装 CC Switch

方式一：下载桌面应用（推荐）

访问 CC Switch GitHub Releases 下载对应平台的安装包：

平台 文件
Windows cc-switch_x.x.x_x64-setup.exe
macOS cc-switch_x.x.x_x64.dmg
Linux cc-switch_x.x.x_amd64.AppImage

方式二：从源码构建

1
2
3
4
5
6
7
8
9
10
11
12
# 克隆仓库
git clone https://github.com/farion1231/cc-switch.git
cd cc-switch

# 安装依赖
npm install

# 开发模式运行
npm run tauri dev

# 构建生产版本
npm run tauri build

7.3 添加服务提供商

启动 CC Switch 后，点击 “Add Provider” 添加新的服务提供商。

PixPin_2026-03-20_21-27-20

7.4 切换服务提供商

方式一：主界面切换

  1. 在 CC Switch 主界面选择目标提供商
  2. 点击 “Enable” 按钮启用
  3. 重启终端或 Claude Code 使配置生效

方式二：系统托盘快速切换

点击系统托盘中的 CC Switch 图标，直接点击提供商名称即可即时切换。

方式三：命令行切换

1
2
3
4
5
6
7
8
# 切换到指定提供商
cc-switch switch "DeepSeek" --app claude

# 查看当前激活的提供商
cc-switch status

# 列出所有提供商
cc-switch list --app claude

7.5 OpenAI 协议兼容模型配置

大多数国产大模型都提供 OpenAI 兼容的 API，可直接通过 CC Switch 接入：

服务商 Base URL 特点
智谱 GLM https://open.bigmodel.cn/api/paas/v4 国产领先，支持长上下文
DeepSeek https://api.deepseek.com 高性价比，代码能力强
月之暗面 https://api.moonshot.cn/v1 支持超长上下文（128K）
通义千问 https://dashscope.aliyuncs.com/compatible-mode/v1 阿里云服务稳定
硅基流动 https://api.siliconflow.cn/v1 多模型聚合平台

八、终端美化：Oh My Posh + PSReadLine（可选）

一个漂亮的终端能显著提升开发体验。下面是 Windows 环境的完整配置方案。

8.1 安装 Oh My Posh

Oh My Posh 是一个跨平台的提示符渲染引擎，可以让你的终端焕然一新。

1
2
3
4
5
# 使用 winget 安装
winget install JanDeDobbeleer.OhMyPosh -s winget

# 或使用 PowerShell Gallery 安装
Install-Module oh-my-posh -Scope CurrentUser

8.2 安装 PSReadLine（增强命令行编辑体验）

PSReadLine 提供了类似 bash 的命令行编辑体验，包括语法高亮、历史搜索、自动补全等。

1
2
3
4
5
# 安装 PSReadLine（Windows 10/11 通常已预装）
Install-Module PSReadLine -Force -SkipPublisherCheck -AllowClobber

# 安装补全模块
Install-Module -Name CompletionPredictor -Force

8.3 配置 PowerShell Profile

打开 PowerShell Profile 文件进行配置：

1
2
# 打开 Profile 文件
notepad $PROFILE

如果文件不存在，先创建：

1
2
New-Item -Path $PROFILE -Type File -Force
notepad $PROFILE

8.4 完整 Profile 配置示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
# ============================================
# PowerShell Profile 配置
# ============================================

# ---------- Oh My Posh 配置 ----------
# 初始化 Oh My Posh，使用指定主题
oh-my-posh init pwsh --config "$env:POSH_THEMES_PATH\paradox.omp.json" | Invoke-Expression

# 推荐主题：
# - paradox: 经典双行提示符
# - agnoster: 简洁美观
# - powerlevel10k_rainbow: 彩虹配色
# - jandedobbeleer: 作者默认主题

# ---------- PSReadLine 配置 ----------
# 开启预测性 IntelliSense（输入时显示历史建议列表）
Set-PSReadLineOption -PredictionSource History
Set-PSReadLineOption -PredictionViewStyle ListView

# 上/下箭头直接浏览历史命令
Set-PSReadLineKeyHandler -Key UpArrow -Function PreviousHistory
Set-PSReadLineKeyHandler -Key DownArrow -Function NextHistory

# Tab 补全显示菜单（可选文件/命令）
Set-PSReadLineKeyHandler -Key Tab -Function MenuComplete

# Ctrl+R 搜索历史
Set-PSReadLineKeyHandler -Key Ctrl+r -Function ReverseSearchHistory

# ---------- 常用别名 ----------
Set-Alias -Name ll -Value Get-ChildItem
Set-Alias -Name which -Value Get-Command

# ---------- Claude Code 快捷别名 ----------
Set-Alias -Name cc -Value claude

# ---------- 欢迎信息 ----------
Write-Host "Welcome to PowerShell with Oh My Posh!" -ForegroundColor Cyan
Write-Host "Claude Code ready. Type 'cc' to start." -ForegroundColor Green

8.5 安装 Nerd Fonts（推荐）

Oh My Posh 的许多主题使用了特殊图标，需要安装 Nerd Fonts 才能正确显示。

1
2
3
4
5
6
7
# 使用 Oh My Posh 安装字体
oh-my-posh font install

# 或手动下载安装推荐字体：
# - CascadiaCode Nerd Font
# - FiraCode Nerd Font
# - JetBrainsMono Nerd Font

安装后在 Windows Terminal 设置中将字体改为对应的 Nerd Font。

8.6 最终效果

image-20260320212305874

配置完成后，你的终端将具备：

  • 美观的提示符（显示 Git 分支、路径、时间等）
  • 语法高亮
  • 历史命令智能搜索
  • Tab 补全菜单
  • 预测性补全

九、高级扩展功能

Claude Code 提供了多种扩展机制，让 AI 能力边界不断拓展。

9.1 MCP（Model Context Protocol）

MCP 是 Claude Code 最具想象力的功能之一，让 AI 能调用外部工具——数据库、API、浏览器，甚至你自己写的脚本。

配置示例：

1
2
3
4
5
6
7
8
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-server-filesystem", "./src"]
    }
  }
}

9.2 Hooks 钩子机制

Hooks 让你在 AI 执行的各个阶段插入自定义脚本，实现自动化工作流。

常用事件：PreToolUse（工具调用前）、PostToolUse（工具调用后）、SessionStart（会话启动时）

9.3 自定义命令（Commands）

在项目的 .claude/commands/ 目录下创建 .md 文件，封装常用工作流。

示例：创建 review-pr.md，之后用 /review-pr 直接调用。

9.4 Skills 技能系统

Skills 是高级扩展机制，比 Commands 更强大，可定义代理的行为规则、工具权限等。

内置 Skills：/code-review、/simplify、/loop

十、隐藏命令大揭秘

10.1 /btw - 并行提问神器

发布时间：2026年3月11日

用途：在 Claude 正在干活时插入问题，但不会污染对话历史。

使用场景：

  • AI 正在重构一个大模块，你突然想问个问题
  • 不想打断当前任务，又想获取信息

使用方法：

1
/btw 这个测试文件在哪个目录来着？

优势：

  • 完全不中断正在执行的任务
  • 上下文干净，不污染对话历史
  • 几乎不费 token（复用提示缓存）

10.2 /rewind - 时光回溯

快捷方式：按两下 Esc

功能：撤销/回退，类似 Ctrl+Z

高级用法：

  • 只回退代码，保留对话
  • 只回退对话，保留代码
  • 从某点开始压缩上下文

实验模式：让 Claude 试一种新方案 → 不行就回退代码但保留对话 → Claude 记得这条路不通，直接换方向。

10.3 /insights - 使用习惯分析

功能：生成一份 HTML 报告，分析你过去一个月使用 Claude Code 的习惯。

报告内容包括：

  • 最常用的命令
  • 重复性的操作模式
  • 自定义命令和 Skills 推荐
  • 翻车现场分析

建议：每月跑一次 /insights，重新认识自己的使用习惯。

10.4 /simplify - 三合一代码审查

功能：启动三个平行的 Agent，分别从以下角度审查代码：

  1. 代码复用
  2. 代码质量
  3. 运行效率

使用时机：

  • 完成几个大功能更新后
  • 想要优化代码时

优势：相当于找了三个同事同时 review。

10.5 /branch - 对话分叉

曾用名：/fork

用途：将当前对话分叉出新会话，原会话不受影响。

使用场景：

  • 聊到一半想试另一个方向
  • 想保留当前进度，同时探索新方案

与 /rewind 的区别：

  • /rewind 是后悔药（回退）
  • /branch 是平行宇宙（分叉）

10.6 /loop - 定时任务

功能：定时重复执行某个任务。

使用方法：

1
/loop 5m 检查一下部署状态

注意事项：

  • 默认间隔 10 分钟
  • 任务 3 天后自动过期
  • 如需长期运行，使用桌面版

10.7 /remote-control - 远程操控

简写：/rc

功能：生成一个 URL，用手机打开后可以远程操控 Claude Code。

特点：

  • 完全同步（手机和终端实时同步）
  • 代码始终在本地运行
  • 安全可靠

10.8 /export - 对话导出

功能：将当前对话导出为 Markdown 文件。

使用场景：

  • 保存重要的架构讨论
  • 与其他 AI 工具协同
  • 作为未来的 context 参考

十一、实战技巧与最佳实践

11.1 用 @ 引用文件

1
请帮我 review @src/utils/auth.ts 这个文件的安全性

用 @ 符号直接引用文件路径，AI 会自动读取文件内容。比复制粘贴干净利落。

11.2 用 ! 前缀执行 Shell 命令

1
! npm run test

不用切出 Claude Code 就能跑命令，测试结果还会作为上下文供 AI 分析。跑完测试如果有报错，直接说”帮我修”就行。

11.3 自定义命令

在项目的 .claude/commands/ 目录下创建 .md 文件：

示例：review-pr.md

1
2
3
4
5
6
7
请对当前分支的所有改动做一次完整的 Code Review，重点关注：

1. 潜在的安全漏洞
2. 性能问题
3. 代码规范

输出格式用表格，包含文件名、问题描述、严重程度。

之后直接调用这个自定义命令，每次 Review 的标准就统一了。

11.4 ultrathink 扩展思考

遇到复杂的设计决策或疑难 bug，可以触发扩展思考模式（ultrathink），让 AI 在给出方案前进行更深入的推理。

11.5 Git Worktrees 并行作战

高级玩法：利用 Git Worktrees 在不同目录同时开多个 Claude Code 会话，每个处理不同的任务分支。等于同时派出多个 AI 同事并行干活，最后合并结果。

十二、配置文件体系

12.1 两层覆盖机制

1
2
~/.claude/settings.json        → 用户级配置（全局生效）
项目/.claude/settings.json     → 项目级配置（覆盖全局）

项目级配置优先级更高，可以在全局配置里设好通用偏好，再在具体项目里做微调。

12.2 CLAUDE.md 项目说明文件

运行 /init 后会自动生成 CLAUDE.md，这是给 AI 的项目说明书。建议包含：

  • 项目概述和技术栈
  • 目录结构说明
  • 编码规范
  • 常用命令
  • 注意事项

12.3 推荐的 settings.json 配置

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
{
  "model": "claude-sonnet-4-6",
  "permissions": {
    "allow": [
      "Read(**)",
      "Write(src/**)",
      "Bash(npm run *)",
      "Bash(git *)"
    ],
    "deny": [
      "Write(.env*)",
      "Bash(rm -rf /*)"
    ]
  },
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-server-filesystem", "./src"]
    }
  }
}

附录：常用命令速查卡

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
=================== 高频命令 ===================
/help          查看帮助
/model         切换模型
/cost          查看费用
/memory        编辑记忆
/clear         清空对话

=================== 项目命令 ===================
/init          初始化项目
/config        修改配置
/mcp           管理 MCP

=================== OpenSpec ==================
/opsx:propose  提出变更方案
/opsx:explore  探索代码结构
/opsx:apply    应用规范
/opsx:archive  归档变更

=================== 隐藏命令 ===================
/btw           并行提问（不污染历史）
/rewind        时光回溯（或按两下 Esc）
/insights      使用习惯分析
/simplify      三合一代码审查
/branch        对话分叉
/loop          定时任务
/rc            远程操控
/export        导出对话

=================== 快捷键 ===================
Ctrl+C         打断执行
Ctrl+O         切换详细模式
Shift+Tab      切换权限模式
Esc+Esc        撤销改动
Ctrl+V         粘贴截图
Ctrl+R         搜索历史
Ctrl+J         换行

结语

Claude Code 不是万能的，它偶尔也会犯错、会跑偏。但只要掌握了正确的使用方法，它确实能大幅提升编码效率。

核心建议：

  1. 先花 30 分钟熟悉斜杠命令和快捷键，这是基本功
  2. 用好 /init 和 memory 功能，让 AI 真正理解你的项目
  3. 复杂任务使用 OpenSpec 规范驱动开发，减少 AI 盲目操作
  4. 善用 Esc + Esc 回退，大胆让 AI 尝试，不满意就撤销
  5. 配置好 CC Switch，灵活选择最适合的服务提供商

工具本身不产生价值，会用工具的人才产生价值。

本教程基于 Claude Code 2026年3月版本整理，功能持续更新中。

参考来源：

总结

本文系统讲解了技术要点，通过学习掌握核心知识和实践方法。