Claude Code cli 及vscode版本的各种命令参考手册(最新推荐)
Robot_Nav
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 | — |
/compactvs/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% 的重复上下文设置。
执行完毕后,可立即追加具体规则:
# 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 插件示例
/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|stream-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. 创建命令目录
# 项目级命令(仅在当前项目可用) mkdir -p .claude/commands # 用户全局命令(所有项目可用) mkdir -p ~/.claude/commands
2. 创建 Markdown 文件
每个 .md 文件成为一个斜杠命令,命令名即为文件名(不含扩展名)。
命令参数
使用 $ARGUMENTS 捕获命令后的所有内容,也可使用 $0、$1 等位置语法。
示例:部署命令
.claude/commands/deploy.md:
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:
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:
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 cli 及vscode命令参考内容请搜索脚本之家以前的文章或继续浏览下面的相关文章,希望大家以后多多支持脚本之家!
