Claude Code 常用命令速查手册

引言

Claude Code 是 Anthropic 推出的命令行 AI 编程助手。日常使用中，掌握常用命令和快捷键能显著提升效率。本文整理了高频使用的命令、参数和操作技巧，适合随时查阅。

启动与基础命令

启动 Claude Code

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 在项目目录下启动
claude

# 直接带问题启动
claude "帮我分析这个项目的结构"

# 指定模型
claude --model opus

# 跳过权限检查（一次性）
claude --dangerously-skip-permissions

查看帮助

1
2
3
4
5
6


# 查看所有命令
/help

# 查看指定命令的帮助
/help compact
/help memory

退出

1
2


/exit
# 或 Ctrl+C / Ctrl+D

会话管理

对话上下文中断与恢复

多次连续对话后 token 积累较多时，可以主动压缩上下文：

1

/compact

Claude 会自动压缩历史对话、保留关键信息并更新 token 用量。建议对话超过几十轮后手动压缩，避免达到上下文限制。

开始新对话

1

/clear

保留当前会话的工作目录和权限设置，只清空对话历史。

查看对话统计

1

/context

显示当前会话的 token 使用量、剩余空间等关键信息。

文件与代码编辑

Claude Code 在对话中直接编辑文件，理解意图后修改代码。以下是主动触发文件操作的方式：

格式化代码

1
2
3
4
5


# 格式化指定文件
/format-file src/index.ts

# 格式化当前打开的全部文件
/format-file

查看差异

当 Claude 修改代码后，通常不会默认展示 diff。可以在对话中直接说"显示差异"或：

1

/diff

回退修改

对修改不满意时：

1

/undo

创建与管理

初始化项目文档

1

/init

Claude 会自动扫描项目结构、技术栈、构建系统，生成项目级 CLAUDE.md 文件。这是让 Claude 快速理解项目的最佳方式。

创建 PR

对当前分支有提交但未合并的情况：

1

/pr

Claude 会自动分析变更生成标题和描述，创建 Pull Request。

查看已安装的 Skills

1

/skills

列出当前项目可用和已安装的所有 Skill。

计划模式与工作树

计划模式

复杂任务先规划再执行：

1
2
3
4
5


# 进入计划模式
/plan

# 或者直接描述任务，Claude 会自动询问是否需要先规划
"帮我重构用户认证模块"

在计划模式下 Claude 只会探索代码库并设计方案，不修改代码，直到你确认方案。

工作树隔离

开发新功能时，可以先创建隔离的工作树，不影响主工作区：

1

/worktree

Claude 会在 .claude/worktrees/ 下创建独立的 git 工作树，在其中完成开发，避免污染主分支。

记忆系统

Claude Code 支持文件持久化的记忆系统，跨会话保留关键信息。

记住信息

1
2
3
4
5


# 记住用户偏好
/remember "这个项目使用 Go 1.22，模块路径是 github.com/user/repo"

# 记住项目约定
/remember "测试文件放在 __tests__ 目录，使用 vitest"

管理记忆

记忆文件存放在项目和用户目录的 .claude/projects/ 下。可直接在对话中说"显示记忆"或"删除记忆 X"进行管理。

权限管理

配置权限

每个 Bash 命令、文件操作都可能需要用户确认。可以精细化控制：

1

/permissions

或在 settings.json 中配置白名单：

1
2
3
4
5
6
7
8
9


{
  "permissions": {
    "allow": [
      "Bash(git:*)",
      "Bash(npm:* test*)",
      "Bash(hugo:*)"
    ]
  }
}

免打扰模式

1
2


# 减少确认提示
claude --output-format stream-json

配置与自定义

全局设置

1

/config

进入交互式配置菜单，修改主题、模型、权限等。

配置文件位置

级别	路径	作用
用户级	`~/.claude/settings.json`	全局生效
项目级	`.claude/settings.json`	当前项目生效
本地覆盖	`.claude/settings.local.json`	本地覆盖，不入库

设置环境变量

1
2


# 添加环境变量
/env

也可以在 settings.json 中通过 env 字段设置。

常用快捷键

在交互式 TUI 中使用以下快捷键提升效率：

快捷键	作用
`Ctrl+C`	中断当前生成或操作
`Ctrl+D`	退出 Claude Code
`Ctrl+R`	搜索对话历史
`Ctrl+O`	查看压缩后的对话摘要
`Ctrl+G`	切换对话模式（需要权限时）
`↑/↓`	浏览历史命令
`Shift+Tab`	切换焦点区域
`Esc`	返回 / 取消当前操作

自定义快捷键

编辑 ~/.claude/keybindings.json 自定义快捷键：

1
2


/claude keybindings
# 或在对话中说"帮我自定义快捷键"

命令组合

日常使用中常见的命令组合流程：

流程一：代码审查

1
2
3
4
5
6
7
8


# 1. 检查当前状态
"帮我看看未提交的改动"

# 2. 安全审查
/security-review

# 3. 格式化
/format-file

流程二：功能开发

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


# 1. 确认要修改
"在 Go 后端 blog 项目中添加文章标签过滤接口"

# 2. 复杂任务先规划
/plan

# 3. 确认方案后开始实现

# 4. 审查代码
/review

流程三：提交与发布

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 1. 检查状态
"git status 看看有什么变更"

# 2. 让 Claude 生成提交信息
/commit

# 3. 推送
"push 一下"

# 4. 创建 PR
/pr

常用 CLI 参数

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17


# 指定模型
claude --model haiku           # 轻量快速
claude --model sonnet          # 平衡
claude --model opus            # 最强推理

# 调试模式
claude --debug

# 输出格式
claude --output-format json    # JSON 输出
claude --output-format stream-json  # 流式 JSON

# 只生成不交互
claude -p "解释 Go 的接口"     # 直接输出后退出

# 指定工作目录
claude --cwd /path/to/project

小结

会话管理：/compact 压缩上下文，/clear 清空对话
文件操作：/diff、/format-file、/undo
项目管理：/init 初始化、/pr 创建 PR
开发流程：/plan 先规划、/review 后审查
安全与权限：/permissions 配置、/security-review 审查

掌握这些命令，日常使用 Claude Code 的效率会有质的提升。不需要记所有命令——用 /help 随时查，需要什么看什么。