Claude-Code-常用教程

xiaoyan4570

1038人浏览 · 2026-05-25 17:23:05

xiaoyan4570 · 2026-05-25 17:23:05 发布

Claude Code 常用教程

Claude Code安装与配置请看：Claude Code安装与配置

1. 简介

Claude Code 是 Anthropic 推出的命令行 AI 编程助手，深度集成在终端中，能帮你理解代码、修复 bug、重构项目、生成文档等。

2. 安装与环境

2.1 安装

# npm 全局安装（推荐）
npm install -g @anthropic-ai/claude-code

# 或使用 npx 直接运行
npx @anthropic-ai/claude-code

2.2 认证

# 首次运行需要认证，支持 API Key 或 OAuth
claude 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 "解释这个项目的目录结构"

# 管道传入内容
cat error.log | claude -p "分析这个错误日志"

# 配合 git
git diff | 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 调试和修复

# 分析错误
cat error.log | claude -p "分析这个错误并给出修复方案"

# 查看 git diff 找 bug
git diff main | claude -p "检查这些改动可能引入的 bug"

7.4 代码审查

# 审查暂存的改动
git diff --cached | claude -p "审查这些改动，找出潜在问题"

# 审查 PR
claude -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 -n 100 app.log | claude -p "找出所有 ERROR 并分类统计"

# 代码统计
find src -name "*.ts" | xargs wc -l | claude -p "分析代码量分布是否合理"

# Git 历史分析
git log --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                     # 清空对话