Claude Code cli 及vscode版本的各种命令参考手册(最新推荐)

Written by

in

文章目录
  • 版本说明: 截至 2026 年 4 月,Claude Code 官方文档共收录超过 70 条内置命令与绑定技能。其中约一半为内置命令(行为由 CLI 代码实现),另一半为绑定技能(通过 Prompt 机制实现,与用户自定义 Skills 技术一致)。Claude Code 内置了超过 50 个命令,但大多数开发者只用了其中 3 到 5 个。
  • 目录
    • Claude Code 各种命令参考手册
      • 一、命令类型概述
      • 二、会话管理类(Session Management)
        • /compactvs/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)
              • 十三、最常用命令速查
                • 十四、第三方资源与社区
                  • 社区项目
                  • 第三方命令集合
                  • 在线资源
                • 十五、最佳实践建议

                版本说明: 截至 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 Commands CLI Flags
                调用时机 会话进行中,随时可用 启动 claude 命令时指定
                典型场景 切换模型、压缩上下文、进入计划模式 设置权限模式、指定工作目录
                是否持久 部分命令持久(如 /effort),多数仅当前会话 本次启动有效
                可扩展性 支持通过 Skills 和 Plugins 添加自定义命令 固定参数集

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

                管理 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 压缩历史对话,保留关键信息继续工作
                切换到完全不相关的新任务 /clear 从零开始一个干净的对话

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

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

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

                直接挂钩代码质量、安全审计,对企业 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 评论,代码审查时查看反馈

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

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

                Claude 分析代码库后将任务拆解为 5~30 个独立单元,每个单元由独立后台 Agent 在隔离的 git worktree 中执行,完成后分别发起 PR。适用于跨模块框架迁移、批量 API 替换等场景。
                示例:/batch migrate src/ from Solid to React

                在项目根目录创建 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 }
                

                命令 用途 关键说明
                /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%。

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

                命令 用途 关键说明
                /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 插件

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

                /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
                

                命令 用途 关键说明
                /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 登出当前账户 切换账户

                1. Node.js 版本(最低 18,2026 年推荐 Node.js 22)
                2. API 连接性
                3. 认证令牌有效性
                4. 文件权限
                5. Git 配置
                6. VS Code 扩展和磁盘空间

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

                命令 用途 关键说明
                /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 集成

                命令 说明
                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,连接外部数据源

                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 操作快多了。

                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

                .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/(全局)

                通过 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

                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命令参考内容请搜索风君子博客以前的文章或继续浏览下面的相关文章,希望大家以后多多支持风君子博客!

                站内搜索