Claude Code

关注公众号 jb51net

关闭
AI > Claude Code >

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+CCtrl+RShift+Tab

Slash Commands 与 CLI Flags 的核心区别:

维度Slash CommandsCLI 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的高级用法

三、上下文与资源管理类(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内置安全审查当前分支待提交改动,识别注入攻击、身份验证缺陷等风险
/simplifyBundled Skill并行启动三个审查 Agent,分别检查复用性、质量与效率,汇总后自动修复
/batchBundled Skill大规模代码改造的并行编排命令,将任务拆解为 5~30 个独立单元并行执行
/autofix-prBundled Skill启动持续监听当前 PR 的云端 Agent,CI 失败或有评论时自动推送修复
/init内置初始化项目,扫描代码库自动生成 CLAUDE.md 记忆文件
/pr_comments内置查看 Pull Request 评论,代码审查时查看反馈

/diff使用说明

/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快速模式提升响应速度
/vimVim 编辑模式用 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检查项目

  1. Node.js 版本(最低 18,2026 年推荐 Node.js 22)
  2. API 连接性
  3. 认证令牌有效性
  4. 文件权限
  5. Git 配置
  6. 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-appGitHub 集成

九、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+SPrompt 暂存(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

命令解析优先级

  1. 内置命令(硬编码在 CLI 中)
  2. .claude/commands/(项目级)
  3. ~/.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查看状态诊断连接问题

十四、第三方资源与社区

社区项目

第三方命令集合

类别包含命令
开发工作流/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-codehttps://github.com/hesreallyhim/awesome-claude-code
CCPluginshttps://github.com/brennercruvinel/CCPlugins

十五、最佳实践建议

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

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

到此这篇关于Claude Code cli 以及vscode版本的各种命令参考手册的文章就介绍到这了,更多相关Claude Code cli 及vscode命令参考内容请搜索脚本之家以前的文章或继续浏览下面的相关文章,希望大家以后多多支持脚本之家!