Claude Code 常用教程
1. 简介
Claude Code 是 Anthropic 推出的命令行 AI 编程助手，深度集成在终端中，能帮你理解代码、修复 bug、重构项目、生成文档等。
2. 安装与环境
2.1 安装
# npm 全局安装（推荐）npminstall-g@anthropic-ai/claude-code# 或使用 npx 直接运行npx @anthropic-ai/claude-code
2.2 认证
# 首次运行需要认证，支持 API Key 或 OAuthclaude login
2.3 查看帮助
claude--help# 通用帮助claude-c# --continue，继续上次对话claude-p"你的问题"# --print，非交互模式，直接输出答案claude-r"<session>"# --resume，恢复指定会话
3. 基本使用
3.1 启动交互模式
# 在项目目录下直接启动cd/path/to/your/project claude
3.2 常用交互命令
| 命令 | 说明 |
|---|
<Enter> | 发送消息 |
Ctrl+C | 中断生成 |
Ctrl+D | 退出 |
Ctrl+O | 打开/关闭文件预览 |
Ctrl+V | 粘贴图片到对话 |
3.3 一次性问答（非交互模式）
# 快速提问claude-p"解释这个项目的目录结构"# 管道传入内容caterror.log|claude-p"分析这个错误日志"# 配合 gitgitdiff|claude-p"审查这些代码变更"
4. 斜杠命令（Slash Commands）
在交互模式中输入/可以使用的命令：
4.1 对话管理
| 命令 | 说明 |
|---|
/clear | 清空对话历史 |
/compact | 压缩上下文，腾出空间 |
/copy | 复制最后一次回复 |
/restore | 恢复被压缩的内容 |
4.2 配置与状态
| 命令 | 说明 |
|---|
/config | 打开配置面板 |
/status | 当前会话状态 |
/context | 查看上下文使用情况 |
/cost | 查看 API 费用统计 |
/todos | 查看待办任务列表 |
4.3 模型与模式
| 命令 | 说明 |
|---|
/model | 切换模型（Opus/Sonnet/Haiku） |
/fast | 切换快速模式（Opus 加速输出） |
/permissions | 配置工具权限 |
/allowed-tools | 管理允许的工具 |
4.4 版本控制
| 命令 | 说明 |
|---|
/init | 初始化项目记忆文件 CLAUDE.md |
/doctor | 诊断安装问题 |
/upgrade | 升级到最新版本 |
/bug | 提交 bug 报告 |
4.5 工作流程
| 命令 | 说明 |
|---|
/plan | 进入计划模式，先规划再执行 |
/review | 审查 Pull Request |
/loop | 按间隔重复执行命令 |
/memory | 管理持久化记忆 |
5. 项目配置：CLAUDE.md
在项目根目录创建CLAUDE.md或.claude/CLAUDE.md，Claude 会自动读取并遵循其中的规则。
5.1 示例 CLAUDE.md
# 项目规则 ## 技术栈 - 前端：React 18 + TypeScript + Zustand - 后端：Go 1.21 + Gin - 数据库：PostgreSQL - 测试：Jest + Playwright ## 规范 - 使用函数式组件和 Hooks，不使用 class 组件 - 禁止 any 类型 - 提交前确保 npm run check 通过 - 新功能必须写测试 ## 常用命令 - 安装依赖：pnpm install - 启动开发：pnpm dev - 运行测试：pnpm test - 类型检查：pnpm tsc
5.2 设置文件位置
~/.claude/ ├── settings.json # 全局设置 │ 项目/ ├── .claude/ │ ├── settings.local.json # 本地设置 │ └── CLAUDE.md # 项目规则 └── CLAUDE.md # 项目规则（另一种位置）
6. 工具权限系统
Claude Code 有严格的权限控制，分为以下级别：
| 级别 | 说明 |
|---|
Allowlist | 始终允许，无需确认 |
Ask | 每次操作需要确认（默认） |
Denylist | 始终拒绝 |
Workspace-only | 仅允许在当前工作区执行 |
6.1 配置示例
# 在交互模式中用 /permissions 配置# 或直接编辑 settings.json
{"permissions":{"allow":["Bash(npm:*)","Bash(git:status)","Bash(git:diff*)"],"deny":["Bash(rm:*)","Bash(gh:pr:merge)"]}}
7. 常用工作流
7.1 理解和探索代码
# 解释项目结构claude-p"解释这个项目的架构和目录结构"# 理解某个文件claude-p"解释 src/auth/login.ts 的实现逻辑"# 追踪数据流claude-p"追踪用户从登录到获取数据的完整流程"
7.2 编写和修改代码
# 在交互模式中（启动 claude 后） "在 src/components 下创建一个 Loading 组件，支持 spinner 和 skeleton 两种模式" "重构这个函数，把 200 行的 handleSubmit 拆分成更小的函数" "把这段 class 组件改成函数式组件 + hooks"
7.3 调试和修复
# 分析错误caterror.log|claude-p"分析这个错误并给出修复方案"# 查看 git diff 找 buggitdiffmain|claude-p"检查这些改动可能引入的 bug"
7.4 代码审查
# 审查暂存的改动gitdiff--cached|claude-p"审查这些改动，找出潜在问题"# 审查 PRclaude-c# 继续已有对话/review# 使用 review 命令
7.5 编写测试
"为 src/utils/format.ts 中的所有函数写单元测试" "给这个 API 接口写集成测试，覆盖正常和异常情况"
7.6 文档生成
"给这个模块生成 API 文档" "为这个组件写 Storybook story"
8. 实用技巧
8.1 使用 @ 引用文件
# 在对话中引用文件或目录"分析 @src/components 的组件结构""对比 @old.ts 和 @new.ts 的差异""解释 @error.log 中的错误"
8.2 分屏模式（VSCode 扩展）
安装 VS Code 或 JetBrains 扩展后，可以在 IDE 中直接使用 Claude Code，享受分屏体验。
8.3 会话恢复
# 列出历史会话claude--resume# 恢复最近会话claude-c# 恢复指定会话claude-r"<session-name>"
8.4 管道组合
# 日志分析tail-n100app.log|claude-p"找出所有 ERROR 并分类统计"# 代码统计findsrc-name"*.ts"|xargswc-l|claude-p"分析代码量分布是否合理"# Git 历史分析gitlog--oneline-20|claude-p"总结最近的工作内容"
8.5 后台执行
在交互模式中可以让耗时操作在后台运行：
"在后台运行测试套件" # Claude 会自动使用后台任务
8.6 自定义 Hook
在settings.json中配置 hook，实现自动化行为：
{"hooks":{"PostToolUse":[{"matcher":"Edit|Write","hooks":[{"type":"command","command":"npx prettier --write $CLAUDE_TOOL_INPUT_FILE_PATH"}]}]}}
9. 常用提问模式
9.1 代码理解
| 场景 | 提问方式 |
|---|
| 理解代码 | “解释这段代码做了什么” |
| 找实现位置 | “处理用户登录的代码在哪里” |
| 理解调用链 | “从 controller 到 database，这个请求经过了哪些层” |
9.2 代码生成
| 场景 | 提问方式 |
|---|
| 创建组件 | “创建一个 Dialog 弹窗组件” |
| 添加功能 | “给 UserService 添加修改密码的方法” |
| 重构 | “把 useEffect 里的逻辑提取成自定义 hook” |
9.3 代码审查
| 场景 | 提问方式 |
|---|
| 安全性 | “检查这段代码有没有安全漏洞” |
| 性能 | “这个 render 函数有什么性能问题” |
| 最佳实践 | “这个写法符合 React 最佳实践吗” |
10. 注意事项
- 上下文长度：Claude 有上下文限制，长对话会自动压缩，重要信息早点说
- 成本意识：使用
/cost查看费用，Opus 模型成本最高 - 权限审查：首次使用时检查
/permissions，根据项目需要调整 - 安全第一：Claude 执行的命令都可以看到，敏感操作会请求确认
- 项目记忆：用 CLAUDE.md 记录项目规范，让 Claude 始终遵循你的约定
11. 快速参考卡片
# 最常用的 5 个命令claude# 启动交互模式claude-p"问题"# 一次性问答claude-c# 继续上次对话/model# 切换模型/clear# 清空对话
官方文档：https://docs.anthropic.com/en/docs/claude-code
GitHub Issues：https://github.com/anthropics/claude-code/issues
