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等键盘快捷键在会话期间直接生效CtrlC、CtrlR、ShiftTab等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的高级用法保留的内容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内置安全审查当前分支待提交改动识别注入攻击、身份验证缺陷等风险/simplifyBundled Skill并行启动三个审查 Agent分别检查复用性、质量与效率汇总后自动修复/batchBundled Skill大规模代码改造的并行编排命令将任务拆解为 530 个独立单元并行执行/autofix-prBundled Skill启动持续监听当前 PR 的云端 AgentCI 失败或有评论时自动推送修复/init内置初始化项目扫描代码库自动生成 CLAUDE.md 记忆文件/pr_comments内置查看 Pull Request 评论代码审查时查看反馈/diff使用说明左右方向键在“当前 git diff”与“各轮 Claude 操作”间切换上下键浏览文件列表/simplify使用示例/simplify /simplify focus on memory efficiency # 定向优化内存效率/batch使用说明Claude 分析代码库后将任务拆解为 530 个独立单元每个单元由独立后台 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 ModeClaude 先输出方案供确认不会立即修改代码适合复杂任务/fast快速模式提升响应速度/vimVim 编辑模式用 hjkl 导航dd 删除ciw 修改单词再次输入/vim退出/output-style输出格式控制控制 AI 回复的输出风格/voice语音模式—/effort设置推理强度直接影响模型推理深度是很多人忽略的关键能力模型切换建议模型推荐场景Token 价格参考Claude 3.5 Haiku简单任务代码注释、格式调整、拼写检查最低Claude 3.7 Sonnet日常开发代码生成、Debug、重构中等Claude Opus复杂任务架构设计、深度分析、算法优化最高省钱技巧做简单任务如添加注释、调整格式时切换到 HaikuToken 消耗可降低约 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 插件示例/plugininstalltypescript-lspclaude-plugins-official /plugininstallpyright-lspclaude-plugins-official /plugininstallgopls-lspclaude-plugins-official /plugininstallrust-analyzer-lspclaude-plugins-official七、诊断、调试与协作类Diagnostics Debugging命令用途关键说明/doctor诊断 Claude Code 安装和配置问题环境异常时的首要排查命令检查 6 项关键配置/debug开启当前会话的调试日志Bundled Skill可从当前节点开始捕获日志辅助排障/bug报告 Bug将对话发送给 Anthropic/insights生成使用分析报告包括交互模式、常见摩擦点、模型偏好等/stats可视化使用统计每日用量、会话历史、连续使用天数和模型偏好/schedule云端定时任务管理创建、更新、列出或运行定时任务支持对话式配置/status-line状态栏控制—/terminal-setup终端集成设置为 iTerm2 或 VSCode 设置 ShiftEnter 插入新行/upgrade升级 Claude Code获取新功能和修复/login重新登录 Anthropic 账户更换账号或刷新认证/logout登出当前账户切换账户/doctor检查项目Node.js 版本最低 182026 年推荐 Node.js 22API 连接性认证令牌有效性文件权限Git 配置VS Code 扩展和磁盘空间调试相关 CLI FlagsFlag说明--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 FlagsFlag说明--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 配置文件十、键盘快捷键快捷键功能说明CtrlC中断当前 AI 生成打断当前执行CtrlR搜索命令历史按下循环选择Tab 编辑Enter 执行CtrlO切换详细输出模式查看 AI 思考过程CtrlSPrompt 暂存Stash暂存当前草稿处理完后自动恢复ShiftTab切换权限模式信任模式 vs 确认模式切换Esc中断当前动作不会丢失上下文Esc Esc撤销上一次文件改动回退到上一个干净的检查点代码和对话都会恢复↑/↓浏览输入历史—\ Enter多行输入反斜杠换行行尾打\再按 EnterOption EntermacOS多行输入直接换行不发送Shift Enter多行输入跨平台通用—Tab接受智能工作流建议预测下一步操作时Tab 接受并编辑Enter 直接运行小技巧Esc Esc是救命键。AI 改完文件逻辑不对双击 Esc 直接回退比 Git 操作快多了。十一、自定义 Slash Commands创建步骤1. 创建命令目录# 项目级命令仅在当前项目可用mkdir-p.claude/commands# 用户全局命令所有项目可用mkdir-p~/.claude/commands2. 创建 Markdown 文件每个.md文件成为一个斜杠命令命令名即为文件名不含扩展名。命令参数使用$ARGUMENTS捕获命令后的所有内容也可使用$0、$1等位置语法。示例部署命令.claude/commands/deploy.mdYou 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.mdReview 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.mdCreate 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-codeClaude Code Ultimate GuideDeepWikihttps://deepwiki.com/FlorianBruniaux/claude-code-ultimate-guideawesome-claude-codehttps://github.com/hesreallyhim/awesome-claude-codeCCPluginshttps://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 ccclaude --dangerously-skip-permissions前提是明确知道哪些操作能放权。复杂问题时加上 ultrathink架构讨论、链路排查、复杂调试适合明确告诉它多想一层。技能只在需要时加载主上下文越干净Claude 越不容易被噪音带偏。用自然语言更新记忆不需要手动编辑 CLAUDE.md直接告诉 Claude 更新即可。本文档基于 Anthropic 官方文档及社区资源整理覆盖 Claude Code 超过 70 条内置命令与绑定技能。命令数量和功能可能随版本更新而变化建议定期查阅官方文档获取最新信息。