Claude Code 完整使用流程指南

🎯 学习目标

本指南涵盖 Claude Code 从安装配置到高级多代理工作流的完整使用流程，助你将 AI 从简单的代码生成工具转变为可编排的智能开发团队。

一、🚀 初始安装与配置

1.1 安装 Claude Code

bash

# 安装 Claude Code CLI（避免使用 sudo）
npm install -g @anthropic-ai/claude-code

# 启动 Claude Code
claude

1.2 初始化配置

选择主题 — 选择终端主题（如深色模式）
身份认证 — 方式一：使用 Claude 订阅账户（推荐，固定月费）；方式二：使用 API Key（按使用量计费）
终端设置 — 选择推荐的默认设置或自定义
工作区信任 — 只在项目目录中运行，避免从根目录启动

1.3 定价方案选择

方案	价格	特点	适用人群
Pro	$17-20/月	仅支持 Sonnet 模型	个人开发者
Max	起步 $100/月	Sonnet + Opus，5倍使用量	专业开发

💡 模型选择建议

Sonnet — 日常编码任务（快速、高效、成本友好）
Opus — 复杂推理、深度规划、研究任务

二、🎯 基础使用流程

2.1 项目初始化

bash

# 1. 进入项目目录
cd /path/to/your/project

# 2. 启动 Claude Code
claude

# 3. 初始化项目上下文
/init

📌 /init 命令的作用

自动分析整个代码库
生成 CLAUDE.md 文件（项目记忆文件）
包含项目架构、技术栈、关键文件、开发命令等信息

2.2 构建项目记忆系统

记忆层级结构：

~/.claude/CLAUDE.md          # 用户级记忆（全局偏好）
./CLAUDE.md                   # 项目级记忆（团队共享）
./memory/spec/CLAUDE.md       # 自定义模块化记忆
./memory/frontend/CLAUDE.md   # 专门领域记忆

添加记忆的方法：

方法	命令	说明
快捷键	`内容 #`	在句尾加 `#` 快速添加新记忆
命令	`/memory`	打开记忆文件编辑器
手动	`mkdir -p memory/frontend`	创建模块化记忆目录

2.3 基本交互模式

直接对话模式（快速任务）：

适用于简单问题、快速修复、单文件编辑：

"修复 src/utils.ts 中的 TypeScript 错误"
"给 calculateTotal 函数添加注释"
"这个项目使用什么技术栈？"

规范驱动开发模式（复杂任务）：

切换到计划模式 — 按 Shift + Tab 或在提示中明确说明"使用计划模式"
创建项目规范 — 描述功能需求，Claude 会使用网络搜索收集信息
保存规范 — 将规范保存到 memory/spec/CLAUDE.md
执行实现 — 使用 根据 @memory/spec/CLAUDE.md 实现主页网格布局

三、⚙️ 进阶功能配置

3.1 斜杠命令管理

上下文管理命令：

命令	作用	使用时机
`/clear`	清除对话历史（释放上下文空间）	开始新任务时
`/compact`	压缩对话历史（保留关键信息）	上下文过载时

配置与成本命令：

命令	作用
`/config`	打开配置面板（用户/项目/本地三级配置）
`/cost`	查看当前会话成本和持续时间
`/memory`	编辑记忆文件

代理与工具管理：

命令	作用
`/agents`	管理子代理（创建、编辑、删除）
`/mcp`	管理 MCP 服务器（外部工具集成）
`/hooks`	管理钩子（自动化工作流）
`/ide`	安装 IDE 集成（Cursor/VS Code）

3.2 MCP 集成（外部工具）

添加 MCP 服务器：

bash

# 示例：添加 Context7（30,000+ 库的最新文档）
claude mcp add --transport http context7 https://mcp.context7.com/mcp --scope project

# 重启 Claude Code 生效
/exit
claude

使用 MCP 工具：

💡 自动使用（通过记忆规则）

在 CLAUDE.md 中添加：

markdown

每次我询问关于 LangGraph 的问题时，自动使用 context7 MCP

手动调用："使用 context7 查询 Next.js 14 的最新路由功能"

3.3 自定义斜杠命令

文件位置： .claude/commands/commit-code.md

markdown

---
name: commit-code
description: 生成智能 Git 提交信息
---

# 系统提示
分析 git diff，生成简洁的提交信息。
使用用户提供的提示作为主题：$arguments

# 示例
用户输入：/commit-code 自定义命令功能
输出：feat: 添加自定义命令创建功能

📎 高级命令示例（带安全控制）

文件位置： .claude/commands/smart-commit.md

markdown

---
name: smart-commit
description: 带 RAG 的智能提交
allowed-tools:
  - git status
  - git diff
  - git add
  - git commit
---

# 工作流程
1. 运行 `!git status` 获取当前状态
2. 运行 `!git diff` 查看更改
3. 运行 `!git log -5 --oneline` 分析历史风格
4. 生成提交信息
5. 运行 `!git add .` 和 `!git commit -m "[生成的信息]"`

💡 说明： allowed-tools 实现最小权限原则

3.4 输出样式自定义

创建输出样式：

bash

# 用户级样式（全局可用）
/output-style:new
提示："使用简洁的项目符号，精炼要点"

# 项目级样式（项目专属）
/output-style:new
提示："项目级样式，所有响应格式化为 YAML，包含状态、下一步、风险字段"

样式配置文件位置：

用户级：~/.claude/output-styles/minimal-bullets.md
项目级：./.claude/output-styles/yaml-concise.md

3.5 自定义状态栏

bash

# 基础状态栏（显示输出样式）
/statusline
提示："显示当前 output-style，使用 Python 实现，通过 uv 运行"

# 高级状态栏（显示最后提示）
/statusline
提示："显示当前会话的最后一个用户提示，读取 transcript_path，过滤命令和 AI 响应"

四、🤖 高级多代理工作流

4.1 子代理系统

📌 子代理的核心概念

隔离上下文 — 每个子代理有独立的上下文窗口
专用工具 — 可限制子代理的工具访问权限
可重用性 — 跨项目和团队共享

创建子代理：

bash

# 启动代理创建流程
/agents

# 选择范围
# - Project（项目级，保存到 .claude/agents/）
# - User（用户级，保存到 ~/.claude/agents/）

# 生成方式
# - Generate with Claude（交互式生成）
# - Manual（手动编辑）

子代理配置文件示例：

markdown

---
name: code-comedy-carl
description: 当用户说 "funny review" 时，生成幽默的代码审查
model: sonnet
color: yellow
tools:
  - read_file
  - grep
  - list_dir
---

# 系统提示
你是 Code Comedy Carl，一位以幽默方式审查代码的专家。

# 审查流程
1. 读取文件
2. 分析代码质量
3. 生成幽默但有建设性的反馈
4. 包含实际改进建议

调用子代理：

方式	示例
单次调用	`"funny review @main.py"`
批量调用	`"创建 2 个有趣的代码审查"`

常用子代理类型：

类型	描述	工具
代码审查员	执行彻底的代码审查，检查质量、安全性、性能	`read_file`, `grep`, `codebase_search`
研究员	进行深度技术研究，查找文档和最佳实践	`web_search`, `mcp_context7`
测试代理	生成测试用例并运行测试	`read_file`, `write`, `run_terminal_cmd`
图表生成器	将文本概念转换为 Mermaid 流程图	`web_search`, `write`

4.2 并行会话（多 Claude 实例）

⚠️ 使用场景

✅ 适用任务（独立任务）：

修复不同模块的不相关 bug
构建独立的 UI 页面（关于页面 + 联系页面）
创建独立的组件（按钮组件 + 模态框组件）

❌ 避免任务（依赖任务）：

一个代理构建 API，另一个构建调用该 API 的前端
相互依赖的功能（会导致契约分歧和静默失败）

实施步骤：

bash

# 终端 1
cd /path/to/project
claude
# 任务："重新设计 HookCard.tsx 组件，使其更现代、视觉吸引"

# 终端 2（同一目录）
cd /path/to/project
claude
# 任务："重新设计 page.tsx 中的 hero 区域"

💡 角色转变： 开发者从 编写代码 转变为 编排 AI 代理 — 识别可并行化的任务、确定任务依赖关系、协调多个 AI 代理的工作

4.3 专门化 AI 环境

挑战： 同一目录的多个实例共享配置（输出样式会相互影响）

解决方案： 为每个专门代理创建独立目录

bash

# 创建专门化工作区
mkdir -p ~/ai-agents/frontend-expert
mkdir -p ~/ai-agents/backend-expert
mkdir -p ~/ai-agents/devops-expert

# 在每个目录中配置独立的输出样式和记忆
cd ~/ai-agents/frontend-expert
claude
/output-style:new "项目级，专注于 React 最佳实践"

💡 未来愿景

每个终端窗口 = 一个命名的 AI 专家：

Frontend Expert — React/Next.js 专家，详细的组件建议
Backend Expert — API 设计，YAML 格式输出
DevOps Expert — 基础设施即代码，Terraform/Docker 专家
Security Auditor — 安全审查，CVE 扫描

五、🔗 团队协作与自动化

5.1 GitHub Actions 自动化

前置条件：

bash

# 1. 安装 GitHub CLI
brew install gh  # macOS

# 2. 认证 GitHub CLI
gh auth login

# 3. 确保在 Git 仓库目录中
cd /path/to/your/repo

安装 Claude GitHub App：

bash

# 在 Claude Code 中运行
/install-github-app

# 按照提示操作：
# 1. 在浏览器中授权 Claude GitHub App
# 2. 选择要集成的仓库
# 3. 选择工作流（@Claude issue 评论、自动代码审查）
# 4. 选择认证方式（使用订阅绑定的 token）

安装会自动创建 PR，添加以下文件：

.github/workflows/claude-issue-comment.yml
.github/workflows/claude-pr-review.yml

使用方式：

触发方式	示例
Issue 评论	在 GitHub Issue 中评论 `@claude 能否修复这个 bug？`
PR 评论	在 Pull Request 中评论 `@claude 请审查这个 PR`

💡 最佳实践：提供上下文

在仓库中添加 CLAUDE.md，Claude 在执行 GitHub Actions 时会读取它，理解项目架构和约束。

bash

# 在本地项目中
claude
/init  # 生成 CLAUDE.md

# 提交并推送
git add CLAUDE.md
git commit -m "docs: 添加 Claude AI 项目上下文"
git push

5.2 IDE 集成（Cursor）

bash

# 在 Claude Code 中运行
/ide

# 选择 Cursor（或 VS Code）
# 自动安装扩展

优势：

自动设置工作目录
访问打开的文件
上下文感知（光标位置、选中文本）

5.3 钩子（Hooks）自动化

钩子类型：

时机	说明
`before_tool_use`	工具使用前
`after_tool_use`	工具使用后
`on_start`	Claude 启动时
`on_error`	错误发生时

示例配置（.claude/hooks.json）：

json

{
  "after_tool_use": {
    "edit": "prettier --write $FILE && eslint --fix $FILE",
    "write": "prettier --write $FILE"
  },
  "before_tool_use": {
    "delete": "echo '确认删除 $FILE' && read -p '继续? (y/n) ' confirm"
  }
}

📎 高级用法：调用子代理

json

{
  "after_tool_use": {
    "write": "claude invoke code-reviewer @$FILE"
  }
}

六、✅ 最佳实践与注意事项

6.1 上下文工程原则

分层记忆策略：

~/.claude/CLAUDE.md          # 个人偏好、代码风格
./CLAUDE.md                   # 项目架构、团队规范
./memory/spec/CLAUDE.md       # 功能规范
./memory/frontend/CLAUDE.md   # 领域知识（按需加载）

原则：

保持记忆文件简洁（避免过载上下文）
使用模块化目录结构
通过 @ 语法手动加载特定记忆

动态上下文管理：

命令	使用时机	效果
`/compact`	长对话时	压缩历史，保留关键决策和信息，节省 token
`/clear`	开始新任务时	释放完整上下文空间，保留项目记忆

⚠️ 避免上下文污染

上下文中毒 — 早期错误污染后续流程
上下文混淆 — 无关信息分散注意力
上下文冲突 — 矛盾信息导致困惑

解决方案： 使用子代理隔离复杂任务、定期 /compact 或 /clear、精确定义记忆内容

6.2 安全性最佳实践

最小权限原则：

自定义命令：

markdown

---
allowed-tools:
  - git status
  - git diff
  # 只授予必要的工具
---

子代理：

markdown

---
tools:
  - read_file
  - grep
  # 不授予 write 或 run_terminal_cmd
---

工作区信任：

始终在项目目录中运行 claude
避免从根目录或敏感目录启动
定期审查 Claude 的操作

6.3 成本优化策略

模型选择：

任务类型	推荐模型	原因
日常编码	Sonnet	快速、成本低、质量高
复杂规划	Opus	深度推理、研究能力强
简单问答	Sonnet	足够智能、响应快

Token 节省技巧：

使用 /compact 压缩历史
避免重复读取大文件
使用子代理隔离大型任务（子代理的 token 不计入主代理）
查看当前会话成本：/cost

6.4 工作流程最佳实践

📎 典型的一天工作流

早晨（项目启动）：

bash

cd ~/projects/my-app
claude
/memory  # 检查项目状态
"总结昨天的工作"  # 如果需要

日间（功能开发）：

bash

# 复杂功能：使用规范驱动
Shift+Tab  # 进入计划模式
"帮我规划用户认证系统的实现"
# 审查计划 → 批准 → 执行

# 简单任务：直接实现
"修复 UserProfile.tsx 中的 TypeScript 错误"

代码审查：

bash

"code review @src/auth/login.ts"

提交代码：

bash

/commit-code 用户认证功能

傍晚（清理和总结）：

bash

/compact  # 压缩对话历史
"今天实现了 JWT 认证，使用 jose 库而非 jsonwebtoken #"  # 添加重要记忆

📎 团队协作流程

项目初始化（团队负责人）：

bash

# 1. 创建项目记忆
/init

# 2. 添加团队规范（/memory）
# - 代码风格指南
# - Git 提交规范
# - 架构决策
# - 第三方依赖说明

# 3. 创建共享子代理
/agents
# 创建项目级代理：code-reviewer、test-generator

# 4. 配置 MCP 和钩子
claude mcp add context7 --scope project
/hooks  # 配置自动格式化

# 5. 提交配置文件
git add .claude/ CLAUDE.md
git commit -m "chore: 配置 Claude Code 团队环境"
git push

团队成员使用：

bash

git clone <repo-url>
cd <project>
claude  # 自动加载团队配置
"根据 @CLAUDE.md 实现用户注册功能"

6.5 故障排查

问题	解决方案
权限错误（EACCES）	`sudo chown -R $(whoami) ~/.npm`（修复 npm 目录所有权）
MCP 未加载	检查配置 `/mcp` → 重启 Claude `/exit && claude` → 授予权限
子代理未触发	检查文件位置（`.claude/agents/`）、`description` 字段清晰、提示词包含触发短语
状态栏显示错误	查看错误信息 → 请求修复 → 手动编辑 `~/.claude/statusline.py`

七、📖 快速参考卡片

7.1 常用命令速查

命令	用途	使用频率
`/init`	初始化项目记忆	项目开始时
`/clear`	清除对话历史	切换任务时
`/compact`	压缩对话历史	对话过长时
`/memory`	编辑记忆文件	需要添加规则时
`/agents`	管理子代理	创建专门代理时
`/mcp`	管理 MCP 服务器	添加外部工具时
`/cost`	查看成本	监控使用量时
`/output-style:new`	创建输出样式	自定义交互方式时

7.2 提示词模板

场景	模板
功能实现	`根据 @memory/spec/CLAUDE.md 实现 [功能名称]`
代码审查	`code review @[文件路径]`
调试	`调试 @[文件路径] 中的 [问题描述]`
重构	`重构 @[文件路径]，改进 [具体方面]`
文档生成	`为 @[文件路径] 生成详细的文档`

7.3 上下文引用语法

语法	作用
`@文件路径`	引用特定文件
`@目录路径`	引用整个目录
`@memory/spec/CLAUDE.md`	引用特定记忆文件
`#`	快速添加记忆（在句尾）

八、🎓 核心概念总结

8.1 上下文工程（Context Engineering）

在任务的每个步骤中，用正确的信息填充 LLM 的上下文窗口的艺术和科学

关键要素：

持久记忆 — CLAUDE.md 文件
智能检索 — 自动上下文发现
上下文压缩 — /compact 命令
上下文隔离 — 子代理系统

8.2 规范驱动开发（Spec-Driven Development）

先规划（计划模式）→ 后执行（实现模式）

优势：

✅ 更安全（先审查再执行）
✅ 更一致（明确规范）
✅ 可追溯（规范文档可共享）

8.3 多代理编排（Multi-Agent Orchestration）

开发者从编码员转变为 AI 代理的指挥家

核心能力：

识别可并行化的任务
分配专门化角色
协调代理协作
管理依赖关系

九、📚 进阶学习路径

第一阶段：基础掌握（1-2 周）

[x] 安装和配置
[x] /init 创建项目记忆
[x] 基本对话和代码生成
[x] 使用 /clear 和 /compact 管理上下文

第二阶段：进阶功能（2-4 周）

[x] 创建自定义斜杠命令
[x] 配置输出样式
[x] 集成 MCP 服务器
[x] 使用计划模式进行规范驱动开发

第三阶段：多代理系统（4-8 周）

[x] 创建和配置子代理
[x] 并行会话工作流
[x] 配置钩子自动化
[x] 设置 GitHub Actions 集成

第四阶段：团队和企业（持续优化）

[x] 团队配置标准化
[x] 企业级安全策略
[x] 自定义工作流优化
[x] 性能和成本监控

最终目标：将 AI 从简单的代码生成工具转变为可编排的智能开发团队。

文档版本：v1.0 | 最后更新：2025-11-13 | 适用版本：Claude Code CLI (所有版本)

Claude Code 完整使用流程指南 ​

一、🚀 初始安装与配置 ​

1.1 安装 Claude Code ​

1.2 初始化配置 ​

1.3 定价方案选择 ​

二、🎯 基础使用流程 ​

2.1 项目初始化 ​

2.2 构建项目记忆系统 ​

2.3 基本交互模式 ​

三、⚙️ 进阶功能配置 ​

3.1 斜杠命令管理 ​

3.2 MCP 集成（外部工具） ​

3.3 自定义斜杠命令 ​

3.4 输出样式自定义 ​

3.5 自定义状态栏 ​

四、🤖 高级多代理工作流 ​

4.1 子代理系统 ​

4.2 并行会话（多 Claude 实例） ​

4.3 专门化 AI 环境 ​

五、🔗 团队协作与自动化 ​

5.1 GitHub Actions 自动化 ​

5.2 IDE 集成（Cursor） ​

5.3 钩子（Hooks）自动化 ​

六、✅ 最佳实践与注意事项 ​

6.1 上下文工程原则 ​

6.2 安全性最佳实践 ​

6.3 成本优化策略 ​

6.4 工作流程最佳实践 ​

6.5 故障排查 ​

七、📖 快速参考卡片 ​

7.1 常用命令速查 ​

7.2 提示词模板 ​

7.3 上下文引用语法 ​

八、🎓 核心概念总结 ​

8.1 上下文工程（Context Engineering） ​

8.2 规范驱动开发（Spec-Driven Development） ​

8.3 多代理编排（Multi-Agent Orchestration） ​

九、📚 进阶学习路径 ​

第一阶段：基础掌握（1-2 周） ​

第二阶段：进阶功能（2-4 周） ​

第三阶段：多代理系统（4-8 周） ​

第四阶段：团队和企业（持续优化） ​

Claude Code 完整使用流程指南

一、🚀 初始安装与配置

1.1 安装 Claude Code

1.2 初始化配置

1.3 定价方案选择

二、🎯 基础使用流程

2.1 项目初始化

2.2 构建项目记忆系统

2.3 基本交互模式

三、⚙️ 进阶功能配置

3.1 斜杠命令管理

3.2 MCP 集成（外部工具）

3.3 自定义斜杠命令

3.4 输出样式自定义

3.5 自定义状态栏

四、🤖 高级多代理工作流

4.1 子代理系统

4.2 并行会话（多 Claude 实例）

4.3 专门化 AI 环境

五、🔗 团队协作与自动化

5.1 GitHub Actions 自动化

5.2 IDE 集成（Cursor）

5.3 钩子（Hooks）自动化

六、✅ 最佳实践与注意事项

6.1 上下文工程原则

6.2 安全性最佳实践

6.3 成本优化策略

6.4 工作流程最佳实践

6.5 故障排查

七、📖 快速参考卡片

7.1 常用命令速查

7.2 提示词模板

7.3 上下文引用语法

八、🎓 核心概念总结

8.1 上下文工程（Context Engineering）

8.2 规范驱动开发（Spec-Driven Development）

8.3 多代理编排（Multi-Agent Orchestration）

九、📚 进阶学习路径

第一阶段：基础掌握（1-2 周）

第二阶段：进阶功能（2-4 周）

第三阶段：多代理系统（4-8 周）

第四阶段：团队和企业（持续优化）