Claude Code cli 以及vscode版本的各种命令参考手册

Claude Code 各种命令参考手册

版本说明： 截至 2026 年 4 月，Claude Code 官方文档共收录超过 70 条内置命令与绑定技能。其中约一半为内置命令（行为由 CLI 代码实现），另一半为绑定技能（通过 Prompt 机制实现，与用户自定义 Skills 技术一致）。Claude Code 内置了超过 50 个命令，但大多数开发者只用了其中 3 到 5 个。

一、命令类型概述

进入具体命令之前，先区分 Claude Code 的三种命令形态：

类型	说明	调用方式
CLI 命令	在终端启动 Claude Code 时执行	`claude` / `claude -c` / `claude --print "query"`
斜杠命令（Slash Commands）	在交互式会话内部输入 `/` 触发	`/init`、`/compact`、`/model` 等
键盘快捷键	在会话期间直接生效	`Ctrl+C`、`Ctrl+R`、`Shift+Tab` 等

Slash Commands 与 CLI Flags 的核心区别：

维度	Slash Commands	CLI Flags
调用时机	会话进行中，随时可用	启动 `claude` 命令时指定
典型场景	切换模型、压缩上下文、进入计划模式	设置权限模式、指定工作目录
是否持久	部分命令持久（如 `/effort`），多数仅当前会话	本次启动有效
可扩展性	支持通过 Skills 和 Plugins 添加自定义命令	固定参数集

在会话中输入 / 即可弹出所有可用命令的交互式列表，输入 / 后接字母可实时过滤。

二、会话管理类（Session Management）

管理 Claude Code 交互的整个生命周期，包括清除历史、总结上下文和重命名会话。

命令	别名	用途	关键说明
`/help`	---	显示所有可用命令及其简短说明	带命令名可查看详细帮助，高亮当前会话相关命令
`/clear`	`/reset`、`/new`	清除对话历史，释放上下文	完全清除对话，不会清除 CLAUDE.md 内容
`/compact`	---	压缩对话历史，保留关键信息	可附加聚焦说明告知 AI 保留哪部分上下文
`/rewind`	`/checkpoint`	回滚对话与代码到指定节点	快速恢复误操作
`/resume`	`/continue`	恢复指定历史会话	配合 `--name` 启动参数使用
`/branch`	`/fork`	从当前节点创建对话分支	适合对比不同方案
`/export`	---	导出当前对话为 Markdown 文件	无文件名时弹出对话框选择复制或保存
`/rename`	---	重命名当前会话	在提示栏显示名称，无参数时自动生成
`/exit`	`/quit`	退出 Claude Code	---

`/compact` vs `/clear` 选择策略

场景	推荐命令	说明
上下文快用满，但需要保留项目背景	`/compact`	压缩历史对话，保留关键信息继续工作
切换到完全不相关的新任务	`/clear`	从零开始一个干净的对话

`/compact` 的高级用法

保留的内容： CLAUDE.md 内容、任务列表项、关键决策和模式
丢弃的内容： 冗长的对话往返、已被替代的代码迭代
定向压缩示例： /compact retain the error handling patterns and auth module changes
使用时机： 会话超过 30 分钟、出现"上下文过大"警告、Claude 开始遗忘先前决策

三、上下文与资源管理类（Context Management）

直接影响 AI 回答质量和 Token 成本控制。

命令	用途	关键说明
`/context`	以彩色网格可视化当前上下文使用情况	给出优化建议，包括内存膨胀警告和容量预警
`/cost`	展示当前会话的 Token 用量统计	对使用 API Key 计费的团队尤为重要
`/usage`	查看 Token 使用情况	`/cost` 和 `/stats` 现为 `/usage` 的别名
`/memory`	查看和编辑 CLAUDE.md 记忆文件	管理项目级、用户级的持久化指令；可开关"自动记忆"
`/status`	显示当前会话状态和上下文使用百分比	查看账户与系统状态
`/tasks`	查看当前任务分解列表	跟踪复杂任务的进度
`/todos`	查看任务列表	---

四、代码分析与质量类（Code Analysis & Quality）

直接挂钩代码质量、安全审计，对企业 IT 团队价值较高。

命令	类型	用途
`/diff`	内置	打开交互式差异查看器，展示 git 未提交修改及 Claude 逐轮操作 diff
`/review`	内置	请求代码审查，让 Claude 分析 PR、文件或代码片段
`/security-review`	内置	安全审查当前分支待提交改动，识别注入攻击、身份验证缺陷等风险
`/simplify`	Bundled Skill	并行启动三个审查 Agent，分别检查复用性、质量与效率，汇总后自动修复
`/batch`	Bundled Skill	大规模代码改造的并行编排命令，将任务拆解为 5～30 个独立单元并行执行
`/autofix-pr`	Bundled Skill	启动持续监听当前 PR 的云端 Agent，CI 失败或有评论时自动推送修复
`/init`	内置	初始化项目，扫描代码库自动生成 CLAUDE.md 记忆文件
`/pr_comments`	内置	查看 Pull Request 评论，代码审查时查看反馈

`/diff` 使用说明

左右方向键在"当前 git diff"与"各轮 Claude 操作"间切换
上下键浏览文件列表

`/simplify` 使用示例

复制代码

/simplify
/simplify focus on memory efficiency   # 定向优化内存效率

`/batch` 使用说明

Claude 分析代码库后将任务拆解为 5～30 个独立单元，每个单元由独立后台 Agent 在隔离的 git worktree 中执行，完成后分别发起 PR。适用于跨模块框架迁移、批量 API 替换等场景。

示例：/batch migrate src/ from Solid to React

`/init` 使用说明

在项目根目录创建 CLAUDE.md------Claude 每次会话都会读取的持久记忆文件。每个项目从 /init 开始可消除 80% 的重复上下文设置。

执行完毕后，可立即追加具体规则：

markdown 复制代码

# CLAUDE.md
Authentication - Use JWT tokens, not sessions - Store in httpOnly cookies
Testing - Write tests for all API endpoints - Use Jest, not Mocha
Error Handling - Return structured errors: { error: string, code: number }

五、模式控制类（Mode Control）

命令	用途	关键说明
`/model`	切换 AI 模型	交互式选择器；也可直接指定：`/model sonnet`、`/model opus`、`/model haiku`
`/plan`	进入计划模式（Plan Mode）	Claude 先输出方案供确认，不会立即修改代码，适合复杂任务
`/fast`	快速模式	提升响应速度
`/vim`	Vim 编辑模式	用 hjkl 导航，dd 删除，ciw 修改单词；再次输入 `/vim` 退出
`/output-style`	输出格式控制	控制 AI 回复的输出风格
`/voice`	语音模式	---
`/effort`	设置推理强度	直接影响模型推理深度，是很多人忽略的关键能力

模型切换建议

模型	推荐场景	Token 价格参考
Claude 3.5 Haiku	简单任务：代码注释、格式调整、拼写检查	最低
Claude 3.7 Sonnet	日常开发：代码生成、Debug、重构	中等
Claude Opus	复杂任务：架构设计、深度分析、算法优化	最高

省钱技巧： 做简单任务（如添加注释、调整格式）时切换到 Haiku，Token 消耗可降低约 80%。

六、配置与环境管理类（Configuration & Environment）

企业部署场景下，用于统一团队配置和环境切换。

命令	用途	关键说明
`/config`	查看或修改配置项	修改主题、默认模型等简单设置
`/update-config`	配置 settings.json	设置 hooks（自动化行为）、权限、环境变量等
`/keybindings-help`	自定义快捷键	修改 `~/.claude/keybindings.json`，绑定或更改按键映射
`/permissions`	查看或更新权限设置	如文件读写工具权限
`/fewer-permission-prompts`	减少权限弹窗	扫描常用只读命令，自动加入项目级允许列表
`/add-dir`	添加额外工作目录	让 Claude 能读取相关文件，跨项目操作时使用
`/mcp`	管理 MCP 服务器配置	连接外部工具和数据源（如 Google Drive、Slack 等）
`/plugin`	管理插件	如安装 LSP 插件

MCP 作用域

作用域	配置位置	适用场景
本地	当前项目 `.claude/`	只在这个项目用的工具
项目	项目根目录配置	团队共享的项目工具
用户	`~/.claude/`	所有项目通用的工具

安装 LSP 插件示例

bash 复制代码

/plugin install typescript-lsp@claude-plugins-official
/plugin install pyright-lsp@claude-plugins-official
/plugin install gopls-lsp@claude-plugins-official
/plugin install rust-analyzer-lsp@claude-plugins-official

七、诊断、调试与协作类（Diagnostics & Debugging）

命令	用途	关键说明
`/doctor`	诊断 Claude Code 安装和配置问题	环境异常时的首要排查命令，检查 6 项关键配置
`/debug`	开启当前会话的调试日志	Bundled Skill；可从当前节点开始捕获日志，辅助排障
`/bug`	报告 Bug	将对话发送给 Anthropic
`/insights`	生成使用分析报告	包括交互模式、常见摩擦点、模型偏好等
`/stats`	可视化使用统计	每日用量、会话历史、连续使用天数和模型偏好
`/schedule`	云端定时任务管理	创建、更新、列出或运行定时任务，支持对话式配置
`/status-line`	状态栏控制	---
`/terminal-setup`	终端集成设置	为 iTerm2 或 VSCode 设置 Shift+Enter 插入新行
`/upgrade`	升级 Claude Code	获取新功能和修复
`/login`	重新登录 Anthropic 账户	更换账号或刷新认证
`/logout`	登出当前账户	切换账户

`/doctor` 检查项目

Node.js 版本（最低 18，2026 年推荐 Node.js 22）
API 连接性
认证令牌有效性
文件权限
Git 配置
VS Code 扩展和磁盘空间

调试相关 CLI Flags

Flag	说明
`--debug` 或 `-d`	启用完整调试模式，显示详细调试输出包括 API 调用
`--debug-file`	把调试日志写入指定路径
`--verbose`	覆盖配置中的详细模式设置，显示扩展日志/逐轮输出

八、高级开发与自动化类（Advanced Development & Automation）

命令	用途	关键说明
`/run`	启动并驱动项目应用	检测项目类型，按对应模式启动并交互验证改动生效
`/verify`	验证代码改动确实有效	启动应用并观察行为，确认修复/功能正常工作
`/loop`	定时重复执行	以指定间隔重复运行某个 prompt 或命令（如 `/loop 5m /run`）
`/btw`	临时只读 Agent	快速提问，不修改代码
`/agents`	创建和管理 Agent	可拆分多个 Agent 执行不同任务
`/hooks`	生命周期 hooks	在 Claude 执行的不同阶段自动触发脚本
`/sandbox`	沙箱模式	在安全隔离环境中运行
`/copy`	交互式代码块选择器	选择并复制代码块
`/teleport`	导入 Web UI 会话	将网页版会话传送到本地终端继续工作
`/skills`	技能管理	按需加载技能
`/find-skills`	技能查找	---
`/claude-api`	构建/调试 Claude API 应用	处理 prompt caching、模型迁移等
`/bashes`	列出所有活动的后台 Bash 命令	管理后台任务
`/commit`	暂存并提交	自动生成 AI 提交信息
`/remote-env`	配置远程执行环境	---
`/rc`	远程控制	---
`/install-github-app`	GitHub 集成	---

九、CLI 命令与参数（CLI Commands & Flags）

基础 CLI 命令

命令	说明
`claude`	启动交互式 REPL 会话
`claude "query"`	以指定内容启动会话
`claude -p "query"`	执行一次查询后退出，适用于脚本或 SDK 使用
`cat file	claude -p "query"`
`claude -c`	继续最近的交互会话
`claude -c -p "query"`	在现有会话中执行一次查询
`claude -r "<session>" "query"`	恢复特定会话进行查询
`claude --resume`	从历史会话列表中选择并恢复
`claude --continue`	立即恢复上一次的对话
`claude update`	更新 Claude Code 工具至最新版本
`claude mcp`	配置 MCP，连接外部数据源

常用 CLI Flags

Flag	说明
`--print` / `-p`	以纯文本输出响应
`--add-dir <路径>`	指定额外的可读目录
`--model <模型名>`	设置会话使用的模型
`--output-format <text	json
`--input-format <text	stream-json>`
`--verbose`	开启详细日志，适合调试
`--max-turns <数字>`	限制交互轮数，适合非交互脚本模式
`--permission-mode`	控制权限提示策略
`--permission-prompt-tool`	非交互模式下使用 MCP 工具
`--dangerously-skip-permissions`	跳过权限提示（需谨慎使用）
`--allowedTools`	配置允许的工具操作
`--disallowedTools`	配置禁用的工具操作
`--mcp-config <路径>`	指定 MCP 配置文件

十、键盘快捷键

快捷键	功能	说明
`Ctrl+C`	中断当前 AI 生成	打断当前执行
`Ctrl+R`	搜索命令历史	按下循环选择，Tab 编辑，Enter 执行
`Ctrl+O`	切换详细输出模式	查看 AI 思考过程
`Ctrl+S`	Prompt 暂存（Stash）	暂存当前草稿，处理完后自动恢复
`Shift+Tab`	切换权限模式	信任模式 vs 确认模式切换
`Esc`	中断当前动作	不会丢失上下文
`Esc + Esc`	撤销上一次文件改动	回退到上一个干净的检查点，代码和对话都会恢复
`↑/↓`	浏览输入历史	---
`\ + Enter`	多行输入（反斜杠换行）	行尾打 `\` 再按 Enter
`Option + Enter`（macOS）	多行输入	直接换行不发送
`Shift + Enter`	多行输入（跨平台通用）	---
`Tab`	接受智能工作流建议	预测下一步操作时，Tab 接受并编辑，Enter 直接运行

小技巧： Esc + Esc 是救命键。AI 改完文件逻辑不对，双击 Esc 直接回退，比 Git 操作快多了。

十一、自定义 Slash Commands

创建步骤

1. 创建命令目录

bash 复制代码

# 项目级命令（仅在当前项目可用）
mkdir -p .claude/commands

# 用户全局命令（所有项目可用）
mkdir -p ~/.claude/commands

2. 创建 Markdown 文件

每个 .md 文件成为一个斜杠命令，命令名即为文件名（不含扩展名）。

命令参数

使用 $ARGUMENTS 捕获命令后的所有内容，也可使用 $0、$1 等位置语法。

示例：部署命令

.claude/commands/deploy.md：

markdown 复制代码

You are a deployment assistant. Run the following:
1. Check all tests pass: `npm test`
2. Build: `npm run build`
3. Check for uncommitted changes: `git status`
4. If clean, create a git tag: `git tag v$ARGUMENTS`
5. Push with tags: `git push origin main --tags`
If anything fails, stop and report exactly what failed.

使用方式：/deploy 1.4.2

示例：代码审查命令

.claude/commands/review.md：

markdown 复制代码

Review the file at $ARGUMENTS against our team standards:
- Functions under 30 lines
- No nested callbacks (use async/await)
- Error handling on every async operation
- JSDoc on all exported functions
List violations with line numbers. Be direct.

使用方式：/review src/auth/ 或 /review api/payments.js

示例：Hotfix 命令

.claude/commands/hotfix.md：

markdown 复制代码

Create a hotfix for $ARGUMENTS.
1. Create branch: `git checkout -b hotfix/$ARGUMENTS`
2. Identify the bug in the codebase related to $ARGUMENTS
3. Write a minimal fix (no refactoring, surgical change only)
4. Add a regression test that would have caught this bug
5. Commit with message: `hotfix: $ARGUMENTS`
6. Show diff for review before pushing

命令解析优先级

内置命令（硬编码在 CLI 中）
.claude/commands/（项目级）
~/.claude/commands/（全局）

十二、项目技能类（Bundled Skills）

通过 Prompt 机制实现的特殊命令，与用户自定义 Skills 技术一致。

命令	用途	使用示例
`/run`	启动并驱动项目应用，按类型交互验证改动生效	`/run`
`/verify`	验证代码改动确实有效，启动应用并观察行为	`/verify`
`/init`	初始化 CLAUDE.md，扫描项目生成代码库文档	`/init`
`/review`	审查 Pull Request，分析当前分支改动	`/review`
`/security-review`	安全审查当前分支的待提交改动	`/security-review`
`/simplify`	代码简化/质量审查，检查复用性、质量、效率并修复	`/simplify focus on memory efficiency`
`/loop`	定时重复执行某个 prompt 或命令	`/loop 5m /run`
`/batch`	大规模代码改造并行编排命令	`/batch migrate src/ from Solid to React`
`/autofix-pr`	启动持续监听当前 PR 的云端 Agent	`/autofix-pr`
`/debug`	开启当前会话的调试日志并读取分析	`/debug`
`/plan`	直接进入计划模式	`/plan`

十三、最常用命令速查

日常开发中使用频率最高的命令：

命令	用途	使用场景
`/init`	项目初始化	新项目首次使用时运行，消除 80% 的重复上下文设置
`/help`	查看帮助信息	忘记某个功能时随手查
`/clear`	清除对话历史	对话太长时清理上下文，切换到新任务
`/compact`	压缩上下文	Token 用量接近上限时保留核心上下文
`/model`	切换模型	在 Opus/Sonnet/Haiku 之间灵活切换
`/cost`	查看费用	每次结束前查看 Token 消耗
`/doctor`	环境诊断	出现异常行为时排查问题
`/diff`	查看变更	查看当前 git diff
`/review`	代码审查	准备提 PR 前做代码审查
`/memory`	编辑记忆文件	让 AI 记住项目的约定和偏好
`/run`	启动项目应用	想看改动实际跑起来的效果时用
`/status`	查看状态	诊断连接问题

十四、第三方资源与社区

社区项目

awesome-claude-code：社区整理的资源仓库，收录 88+ 实用命令、hooks、CLAUDE.md 模板等资源。

第三方命令集合

CCPlugins：精心整理的命令集合，包含 24 条专业命令，为 Claude Code CLI 扩展企业级开发工作流。针对 Opus 4 和 Sonnet 4 模型优化。

类别	包含命令
开发工作流	`/cleanproject`、`/commit`、`/format`、`/scaffold`、`/test`、`/implement`、`/refactor`
代码质量 & 安全	`/review`、`/security-scan`、`/predict-issues`、`/remove-comments`、`/fix-imports`、`/find-todos`、`/create-todos`、`/fix-todos`
高级分析	`/understand`、`/explain-like-senior`、`/contributing`、`/make-it-pretty`
会话 & 项目管理	`/session-start`、`/session-end`、`/docs`、`/todos-to-issues`、`/undo`

在线资源

资源	链接
官方文档	https://docs.anthropic.com/en/docs/claude-code
Claude Code Ultimate Guide（DeepWiki）	https://deepwiki.com/FlorianBruniaux/claude-code-ultimate-guide
awesome-claude-code	https://github.com/hesreallyhim/awesome-claude-code
CCPlugins	https://github.com/brennercruvinel/CCPlugins

十五、最佳实践建议

每个项目从 /init 开始：自动生成 CLAUDE.md，消除 80% 的重复上下文设置。
主动执行 /compact ：上下文 70-80% 时就该主动压缩，用 /context 检查用量。
频繁使用 /cost：若按量计费，建议每完成一个主要任务后运行一次。
善用 ! 前缀 ：如 !git status、!npm test，无需模型思考直接执行。
给常用语言装上 LSP 插件：更早暴露类型错误、未使用导入等问题。
创建 3-5 个常用自定义命令 ：放在 ~/.claude/commands/ 下全局可用。
给 Claude Code 配一个顺手的别名 ：alias cc='claude --dangerously-skip-permissions'（前提是明确知道哪些操作能放权）。
复杂问题时加上 ultrathink：架构讨论、链路排查、复杂调试，适合明确告诉它多想一层。
技能只在需要时加载：主上下文越干净，Claude 越不容易被噪音带偏。
用自然语言更新记忆：不需要手动编辑 CLAUDE.md，直接告诉 Claude 更新即可。

本文档基于 Anthropic 官方文档及社区资源整理，覆盖 Claude Code 超过 70 条内置命令与绑定技能。命令数量和功能可能随版本更新而变化，建议定期查阅官方文档获取最新信息。

Claude Code cli 以及vscode版本的各种命令参考手册

Claude Code 各种命令参考手册

一、命令类型概述

二、会话管理类（Session Management）

/compact vs /clear 选择策略

/compact 的高级用法

三、上下文与资源管理类（Context Management）

四、代码分析与质量类（Code Analysis & Quality）

/diff 使用说明

/simplify 使用示例

/batch 使用说明

/init 使用说明

五、模式控制类（Mode Control）

模型切换建议

六、配置与环境管理类（Configuration & Environment）

MCP 作用域

安装 LSP 插件示例

七、诊断、调试与协作类（Diagnostics & Debugging）

/doctor 检查项目

调试相关 CLI Flags

八、高级开发与自动化类（Advanced Development & Automation）

九、CLI 命令与参数（CLI Commands & Flags）

基础 CLI 命令

常用 CLI Flags

十、键盘快捷键

十一、自定义 Slash Commands

创建步骤

命令参数

示例：部署命令

示例：代码审查命令

示例：Hotfix 命令

命令解析优先级

十二、项目技能类（Bundled Skills）

十三、最常用命令速查

十四、第三方资源与社区

社区项目

第三方命令集合

在线资源

十五、最佳实践建议

`/compact` vs `/clear` 选择策略

`/compact` 的高级用法

`/diff` 使用说明

`/simplify` 使用示例

`/batch` 使用说明

`/init` 使用说明

`/doctor` 检查项目