Claude Code使用说明
Claude Code 是 Anthropic 官方推出的命令行 AI 编程助手工具，基于 Claude 大模型，可以直接在终端中使用，帮助开发者进行代码编写、调试、重构等任务。
安装
npm install -g @anthropic-ai/claude-code
安装完成后，在终端输入 claude 即可启动。
CLI vs VS Code 插件
Claude Code 提供两种使用方式：命令行（CLI） 和 VS Code 插件，各有优劣：
CLI 的优势
| 特性 | 说明 |
|---|---|
| 直接 Shell 访问 | 可以在终端中直接执行命令 |
| 完整文件系统控制 | 将项目视为文件目录，访问更全面 |
| 更好的自动化 | 可以脚本化，集成到工作流中 |
| 更透明 | 能看到具体执行了什么命令 |
| 后台任务可见性 | 长时间运行的任务有更好的可见性 |
VS Code 插件的优势
| 特性 | 说明 |
|---|---|
| 更清爽的 UI | 更友好的界面，文本显示更好 |
| 集成 Diff 查看器 | 原生 VS Code 代码对比工具 |
| 更容易的文本交互 | 选择、复制、粘贴文本更方便 |
| 问题诊断 | 利用 VS Code 内置的错误检测 |
| 标签页/文件感知 | 可以引用打开的标签页和活动文件 |
使用建议
- 使用 CLI：需要完整终端控制、复杂 shell 操作、自动化或 CI/CD 集成
- 使用 VS Code 插件：想要更清爽的可视化界面、代码审查和 diff 对比、日常编码任务
- 两者可以同时使用：根据任务类型灵活选择
CLI 命令
启动方式
claude # 在当前目录启动交互式会话
claude "解释这个项目" # 带初始提示启动
claude -p "你的提示词" # 单次提问模式（非交互）
claude -c # 继续最近的对话
claude -r <session-id> # 恢复指定会话
cat file.txt | claude -p "分析" # 管道输入
CLI 子命令
| 命令 | 作用 |
|---|---|
claude agents |
列出所有配置的 agents |
claude auth |
管理认证 |
claude doctor |
检查运行环境健康状态 |
claude install [target] |
安装原生版本（stable/latest/指定版本） |
claude mcp |
配置 MCP 服务器 |
claude plugin |
管理 Claude Code 插件 |
claude setup-token |
设置长期认证令牌（需要 Claude 订阅） |
claude update / upgrade |
检查更新并安装 |
常用 CLI Flags
| Flag | 作用 | 示例 |
|---|---|---|
--model |
指定模型（sonnet/opus） | claude --model opus |
--continue / -c |
继续最近的对话 | claude -c |
--resume / -r |
恢复指定会话 | claude -r abc123 |
--print / -p |
非交互模式，打印结果后退出 | claude -p "查询" |
--output-format |
输出格式（text/json/stream-json） | claude -p --output-format json |
--permission-mode |
权限模式（default/plan/acceptEdits） | claude --permission-mode plan |
--dangerously-skip-permissions |
跳过所有权限确认（谨慎使用） | claude --dangerously-skip-permissions |
--allowedTools |
预先允许的工具列表 | claude --allowedTools "Bash(git:*)" |
--ide |
自动连接 IDE | claude --ide |
--worktree / -w |
创建 git worktree 进行隔离 | claude -w |
--mcp-config |
加载 MCP 配置文件 | claude --mcp-config mcp.json |
斜杠命令
在 Claude Code 交互会话中，可以使用以下斜杠命令：
会话管理
| 命令 | 作用 |
|---|---|
/help |
获取帮助信息 |
/clear |
清除当前会话上下文 |
/compact [instructions] |
压缩对话历史，可指定聚焦指令 |
/resume |
恢复之前的会话 |
/status |
查看当前会话状态 |
/cost |
查看当前会话的 token 消耗统计 |
账户与配置
| 命令 | 作用 |
|---|---|
/login |
登录 Anthropic 账户 |
/logout |
登出账户 |
/config |
打开配置设置 |
/permissions |
管理工具权限设置 |
/model |
切换使用的模型 |
/memory |
管理持久化记忆文件 |
项目与上下文
| 命令 | 作用 |
|---|---|
/init |
在当前项目初始化 CLAUDE.md 配置文件 |
/add-dir |
添加目录到上下文 |
/mcp |
管理 MCP 服务器连接和 OAuth 认证 |
开发工具
| 命令 | 作用 |
|---|---|
/agents |
管理自定义 AI subagents |
/review |
启动代码审查模式 |
/pr-comments |
查看 GitHub PR 评论 |
/terminal-setup |
设置终端集成（支持 Shift+Enter 换行） |
/doctor |
检查 Claude Code 的运行环境 |
/bug |
报告 bug（发送对话到 Anthropic） |
/vim |
切换 vim 输入模式 |
/fast |
切换快速模式（使用相同模型但输出更快） |
快速命令
在输入开头使用特殊字符：
| 前缀 | 作用 | 示例 |
|---|---|---|
# |
添加内容到 CLAUDE.md 记忆文件 | # 记住这个项目使用 bun |
/ |
斜杠命令 | /help |
! |
Bash 模式，直接执行命令并添加输出到会话 | ! git status |
快捷键
通用控制
| 快捷键 | 功能 |
|---|---|
Ctrl + C |
中断当前操作 |
Ctrl + D |
退出 Claude Code |
Ctrl + L |
清屏（保留对话历史） |
↑ / ↓ |
浏览历史命令 |
Esc + Esc |
编辑上一条消息 |
Shift + Tab |
切换权限模式（自动接受/计划模式/普通模式） |
多行输入
| 方法 | 快捷键 |
|---|---|
| 快速换行 | \ + Enter |
| macOS 默认 | Option + Enter |
| 终端设置后 | Shift + Enter |
| 控制序列 | Ctrl + J |
内置 Subagents
Claude Code 内置了多个专用的 AI subagent，会根据任务自动调用：
| Agent | 模型 | 用途 |
|---|---|---|
| Explore | Haiku | 快速只读 agent，用于搜索和分析代码库 |
| Plan | 继承 | 计划模式下的研究 agent，收集上下文 |
| General-purpose | 继承 | 复杂多步骤任务，需要探索和修改 |
| Bash | 继承 | 在单独上下文中运行终端命令 |
| statusline-setup | Sonnet | 配置状态栏 |
| Claude Code Guide | Haiku | 回答关于 Claude Code 功能的问题 |
Subagent 使用场景
- Explore：当你需要搜索代码、理解代码库结构时自动调用
- Plan：在计划模式下，Claude 需要研究代码库时使用
- General-purpose：需要同时探索和修改代码的复杂任务
自定义斜杠命令
可以创建自定义斜杠命令，存储为 Markdown 文件：
项目级命令
位置：.claude/commands/
# 创建 /optimize 命令
mkdir -p .claude/commands
echo "分析这段代码的性能问题并建议优化方案：" > .claude/commands/optimize.md
用户级命令
位置：~/.claude/commands/
# 创建 /security-review 命令
mkdir -p ~/.claude/commands
echo "审查这段代码的安全漏洞：" > ~/.claude/commands/security-review.md
命令参数
支持参数占位符：
---
description: 修复指定的 issue
argument-hint: [issue-number]
---
修复 issue #$ARGUMENTS，遵循我们的代码规范。
使用：/fix-issue 123
自定义 Subagents
可以创建自定义 subagent 来处理特定任务：
位置
| 位置 | 范围 | 优先级 |
|---|---|---|
.claude/agents/ |
当前项目 | 高 |
~/.claude/agents/ |
所有项目 | 中 |
插件的 agents/ 目录 |
插件启用时 | 低 |
示例：代码审查 Agent
创建文件 .claude/agents/code-reviewer.md：
---
name: code-reviewer
description: 代码质量审查专家。在编写或修改代码后主动使用。
tools: Read, Grep, Glob, Bash
model: inherit
---
你是一个资深代码审查专家。
审查清单：
- 代码清晰可读
- 函数和变量命名合理
- 没有重复代码
- 正确的错误处理
- 没有暴露密钥或 API key
- 实现了输入验证
- 良好的测试覆盖率
按优先级组织反馈：
- 关键问题（必须修复）
- 警告（应该修复）
- 建议（考虑改进）
使用技巧
1. 使用 CLAUDE.md 配置项目
在项目根目录创建 CLAUDE.md 文件，可以为 Claude Code 提供项目特定的上下文和指令：
# 项目说明
这是一个使用 React + TypeScript 的前端项目。
## 构建命令
- npm run dev: 启动开发服务器
- npm run build: 构建生产版本
- npm run test: 运行测试
## 代码规范
- 使用 ESLint 进行代码检查
- 组件使用 PascalCase 命名
2. 使用管道输入
cat error.log | claude -p "分析这个错误日志"
git diff | claude -p "审查这些代码变更"
3. 权限管理
Claude Code 默认会在执行敏感操作前请求确认。可以通过配置文件预设权限：
- 编辑
~/.claude/settings.json配置全局权限 - 使用
/permissions命令管理权限 - 使用
--allowedTools预先允许特定工具
4. 使用 MCP (Model Context Protocol)
Claude Code 支持通过 MCP 扩展功能，可以连接外部工具和服务：
claude --mcp-config /path/to/mcp-config.json
5. 使用 Worktree 隔离
当需要并行处理多个任务时，可以使用 worktree 隔离：
claude -w feature-branch # 在隔离的 worktree 中工作
6. 并行使用多个 Subagent
对于独立的调查任务，可以并行启动多个 subagent：
使用多个 subagent 并行研究认证模块、数据库模块和 API 模块
常见使用场景
代码调试
帮我找出这个 bug 的原因：运行 npm test 时出现 TypeError
代码重构
把这个函数重构为更简洁的形式，保持功能不变
代码解释
解释这段代码的作用和工作原理
生成测试
为这个函数编写单元测试
Git 操作
帮我创建一个 commit，描述这次的修改内容
代码审查
审查我最近的代码变更，关注性能和安全问题
注意事项
- API 费用：Claude Code 使用 Anthropic API，会产生相应费用，可以使用
/cost查看消耗 - 敏感信息：避免让 Claude Code 处理包含密码、密钥等敏感信息的文件
- 代码审查：始终审查 Claude Code 生成的代码后再使用
- 网络连接：需要稳定的网络连接到 Anthropic 服务器
- 上下文限制：长时间对话会触发自动压缩，可以使用
/compact手动压缩