🚀 Claude Code 命令大全:CLI指令速查手册(2026最新完整版)
📅 更新时间:2026年6月 | 👤 作者:爱吃茶叶蛋的小羊 | 🏷️ 专栏:AI大模型与工程化实战
⚠️ 使用说明:本文档基于 Claude Code 官方文档整理,加粗的命令均为经过验证的标准命令。由于 Claude Code 持续更新,部分新功能(如 /batch、/desktop 等)可能在不同版本中存在差异,建议以官方文档为准。
在 AI 时代,高效利用工具接管“脏活累活”是程序员的必备技能。本文为你整理了 Anthropic 最新推出的 Claude Code CLI 的完整命令手册。从基础的核心指令到高级的 Shell 模式、环境变量以及实战组合,助你一键通关 Claude Code!
🚀 一、 CLI 基础命令总览
⚡ 1. 核心运行命令
核心命令用于在终端中启动、恢复或更新 Claude Code 会话。
| 命令 |
说明 |
示例 |
claude |
启动标准交互模式会话 |
claude |
claude "任务描述" |
带着初始明确的提示词或任务直接启动 |
claude "帮我看看这个bug" |
claude -p "查询" |
非交互模式,输出 AI 的回答后直接退出终端 |
claude -p "解释这段代码" |
claude -c |
继续执行最近一次的对话会话 |
claude -c |
claude -r "会话ID" |
恢复指定的历史会话 |
claude -r "session_uuid_123" |
claude update |
一键更新 Claude Code 到最新版本 |
claude update |
claude --version |
显示当前安装的客户端版本号(简写:-v) |
claude -v |
🔐 2. 认证命令
用于管理你的 Anthropic 账户登录状态及凭证。
| 命令 |
说明 |
常见参数 |
claude auth login |
登录认证 |
支持 --email, --sso, --console |
claude auth logout |
登出并清除本地凭证 |
- |
claude auth status |
查看当前认证状态 |
默认输出 JSON,加 --text 转换为人类可读 |
⚙️ 3. 系统管理命令
用于子代理、MCP(Model Context Protocol)服务器及项目本地状态的管理。
| 命令 |
说明 |
示例 / 参数 |
claude agents |
列出当前所有配置的子代理 |
claude agents |
claude mcp |
配置和管理 MCP 服务器 |
claude mcp |
claude plugin |
管理扩展插件 |
claude plugin install <name> |
claude project purge [path] |
清除指定项目的本地所有状态 |
可加 --dry-run 仅预览不删除 |
claude setup-token |
生成用于 CI/CD 或自动化脚本的长期 OAuth Token |
claude setup-token |
claude ultrareview [target] |
运行云端深度多代理代码审查 |
claude ultrareview . |
💬 二、 交互模式斜杠命令(Slash Commands)
在进入 claude 交互界面后,输入 / 即可唤起斜杠命令。以下按照功能对命令进行了归类:
💬 1. 会话管理
| 命令 |
别名 |
说明 |
/clear |
/reset, /new |
清空当前上下文,开始一个全新的对话 |
/compact [指令] |
- |
压缩当前上下文,释放 Token 空间 |
/resume [会话] |
/continue |
恢复指定的历史对话 |
/branch [名称] |
/fork |
基于当前对话节点创建一个新的分支 |
/rename [名称] |
- |
重命名当前的会话,方便后续查找 |
/export [文件名] |
- |
将当前的对话历史导出为纯文本文件 |
/rewind |
/checkpoint, /undo |
回退到上一个检查点或撤销上一步操作 |
/recap |
- |
让模型为当前的会话生成一份简明摘要 |
/teleport |
/tp |
将正在 Web 浏览器中进行的会话无缝拉到本地终端 |
/exit |
/quit |
退出当前的交互会话 |
📁 2. 项目配置与架构
| 命令 |
说明 |
/init |
初始化当前项目,在根目录创建 CLAUDE.md 指南文件 |
/memory |
快速编辑 CLAUDE.md 记忆文件,用于固化项目规范 |
/add-dir <路径> |
向当前的工作空间添加额外的参考工作目录 |
🧠 3. 模型与核心配置
| 命令 |
说明 |
/model [模型名] |
切换或选择当前使用的 AI 模型(如 sonnet, opus 等) |
/effort [级别] |
设置 AI 的努力级别,可选:low/medium/high/xhigh/max/auto |
/config |
打开交互式图形设置界面 |
/theme |
更改终端的颜色主题 |
/color [颜色] |
单独设置提示符状态栏的颜色 |
/fast [on|off] |
切换快速模式的开启与关闭 |
/sandbox |
切换沙盒隔离模式,保障代码运行安全 |
🔒 4. 权限、工具与安全
| 命令 |
说明 |
/permissions |
管理智能体的允许/询问/拒绝规则(白名单管理) |
/hooks |
查看当前集群或项目配置的生命周期钩子 |
/mcp |
管理当前连接的 MCP(模型上下文协议)服务器 |
/agents |
查看和修改子代理的运行配置 |
/skills |
列出当前模型可以调用的所有内置或自定义技能 |
/fewer-permission-prompts |
自动扫描代码并将其加入允许列表,减少烦人的权限确认弹窗 |
🔍 5. 代码分析与审查
| 命令 |
说明 |
/diff |
打开交互式代码差异(Diff)查看器 |
/review [PR] |
在本地直接审查特定的 Pull Request 更改 |
/security-review |
静态分析当前代码库中潜在的安全漏洞 |
/simplify [焦点] |
审查代码质量,寻找冗余并进行效率优化提升 |
/ultrareview [PR] |
触发云端深度多代理联合代码审查 |
/ultraplan <提示> |
在专用的计划会话中起草大型项目的重构或开发计划 |
🩺 6. 系统诊断与状态
| 命令 |
别名 |
说明 |
/doctor |
- |
自动诊断当前的安装环境、网络和配置问题 |
/debug [描述] |
- |
开启详细的调试日志记录 |
/usage |
/cost, /stats |
实时显示当前会话的 API 花费、用量统计和 Token 消耗 |
/context [all] |
- |
可视化当前上下文窗口的使用情况占满百分比 |
/copy [N] |
- |
快速将第 N 条 AI 的回复复制到系统剪贴板 |
/insights |
- |
生成当前会话的代码逻辑分析报告 |
/tasks |
- |
查看和管理在后台异步运行的任务列表 |
🌐 7. 协作与远程扩展
| 命令 |
说明 |
/remote-control |
开启远程控制,允许通过安全的外部连接管理此会话 |
/autofix-pr [提示] |
自动监视 PR,当 CI/CD 失败时由 Agent 自动修复并提交 |
/install-github-app |
为当前的 GitHub 仓库一键设置 Claude GitHub Actions 自动化流程 |
/install-slack-app |
将当前的 Claude 实例连接并集成到团队的 Slack 工作区中 |
/batch <指令> |
启动批量编排模式,并行在多处大规模修改代码库 |
/loop [间隔] [提示] |
设定一个时间间隔,重复循环运行某个提示词指令 |
/schedule [描述] |
创建、修改或管理云端托管的定时自动化脚本任务 |
/btw <问题> |
旁白提问。快速向 AI 请教一个问题,此对话不计入上下文历史 |
/desktop |
将终端中的当前会话一键转移到 Claude 桌面客户端中继续 |
🎛️ 三、 CLI 启动参数详解(Flags)
通过在终端中附加启动参数,可以在初始化 claude 时精细化控制其行为。
🔄 1. 会话与恢复参数
| 参数 |
说明 |
--continue / -c |
加载当前目录下最近一次活跃的对话 |
--resume / -r |
恢复指定 ID 的会话,若不带 ID 则显示交互式选择列表 |
--fork-session |
恢复会话时克隆一份,为其创建全新独立的会话 ID |
--session-id <UUID> |
通过严格的 UUID 格式指定加载某一个历史会话 |
--name / -n |
为本次新创建的会话设置一个易读的别名 |
--from-pr |
恢复与特定 Pull Request 关联的上下文会话 |
📤 2. 输出与格式参数
| 参数 |
说明 |
--print / -p |
强制进入非交互模式,打印结果后立刻退出 |
--output-format |
指定输出格式,可选:text / json / stream-json |
--input-format |
指定输入流格式,可选:text / stream-json |
--json-schema |
配合 JSON 输出,提供 Schema 定义以确保结构化输出完全合规 |
--verbose |
启动详细的冗长日志模式,打印底层 API 交互细节 |
🧠 3. 模型与提示词控制
| 参数 |
说明 |
--model |
覆盖默认模型。可填别名(sonnet/opus)或完整官方模型全称 |
--effort |
覆盖默认思考努力级别:low / medium / high / xhigh / max |
--fallback-model |
设定备用模型,当主模型限流时自动降级(仅在 --print 模式下生效) |
--system-prompt |
彻底替换掉系统默认的 System Prompt |
--system-prompt-file |
从本地指定的文本文件中加载并替换系统提示词 |
--append-system-prompt |
在默认系统提示词的末尾追加一段自定义指导文本 |
🔐 4. 权限与工具限制
| 参数 |
说明 |
--permission-mode |
设定全局权限模式:default/acceptEdits/plan/auto/dontAsk/bypassPermissions |
--dangerously-skip-permissions |
💥 危险操作!跳过所有执行工具(如写文件、跑命令)的权限确认提示 |
--allowedTools |
显式指定一组工具列表,调用这些工具时无需向用户发出确认提示 |
--disallowedTools |
显式禁用某些内置工具,将其彻底从大模型的可用上下文中剥离 |
💻 5. 运行环境与预算限制
| 参数 |
说明 |
--add-dir |
启动时额外挂载读取的工作目录 |
--worktree / -w |
在一个完全隔离的 git worktree 环境中启动,防止弄脏当前主分支代码 |
--tmux |
配合 git worktree 启动,自动为其在后台创建一个独立的 tmux 会话 |
--max-budget-usd |
💰 防破产闸门。设定单次任务的最大花费上限(美元),达到即熔断 |
--max-turns |
限制 Agent 自动思考和调用工具的最大轮次,防止陷入死循环 |
--no-session-persistence |
禁用会话本地持久化,本次对话的历史记录在关闭后不会存储到本地硬盘 |
⌨️ 四、 键盘快捷键速查
在交互模式下,利用快捷键可以大幅提升输入和控制的效率。
🎮 1. 通用控制
| 快捷键 |
功能说明 |
Ctrl + C |
终止当前大模型的文本生成,或取消当前终端正在输入的文本 |
Ctrl + D |
快速正常退出当前的交互会话 |
Ctrl + L |
清屏并重绘终端界面(相当于 Linux 的 clear) |
Ctrl + O |
🔄 核心切换:打开/关闭内置的“对话历史记录查看器” |
Ctrl + R |
反向搜索之前输入过的历史提示词命令 |
Ctrl + V / Cmd + V |
直接在终端中粘贴剪贴板里的图片(多模态解析支持) |
Ctrl + B |
将当前正在前台运行的长耗时任务切入后台异步执行 |
Ctrl + T |
弹出或隐藏当前后台任务的状态列表视图 |
Shift + Tab |
在不同的权限询问机制(如 default, auto 等)之间循环切换 |
Option + P |
快速调出模型选择切换面板 |
Option + T |
开启或关闭“扩展思考(Extended Thinking)”机制 |
✍️ 2. 多行文本输入
| 录入方法 |
快捷键组合 |
| 快速转义换行 |
输入 \ 后直接敲击 Enter 键 |
| Option 键换行 |
使用 Option + Enter 组合键直接原地换行 |
| 标准换行 |
使用 Shift + Enter 组合键原地换行 |
🎯 五、 特色模式(Shell & Vim)
🖥️ 1. Shell 增强模式
在交互框中输入内容时,只要在最前面加上感叹号 !,即可直接执行本地的 Shell 命令。
💡 最大特色:执行命令输出的结果,会自动作为 Context(上下文)喂给 Claude,方便其紧接着进行 Bug 分析或下一步重构!
! npm test
! git status
! pip install -r requirements.txt
📝 2. 内置 Vim 极简编辑器模式
当你进入历史记录查看器或某些特定配置编辑框时,Claude Code 支持标准 Vim 导航习惯。
| 模式/动作 |
快捷键命令 |
功能说明 |
| 模式切换 |
Esc |
退回到 NORMAL 模式 |
|
i / a |
在光标前 / 光标后进入编辑插入模式 |
| 光标导航 |
h / j / k / l |
左 / 下 / 上 / 右 |
|
w / b |
向后跳一个单词 / 向前跳一个单词 |
|
gg / G |
快速跳转到文件的首行 / 尾行 |
| 文本编辑 |
dd / yy |
删除(剪切)当前行 / 复制当前行 |
|
p |
在当前光标行下方进行粘贴 |
|
u / . |
撤销上一步操作 / 重复执行上一步的编辑动作 |
🌳 六、 常用环境变量列表
在系统的 .bashrc 或 .zshrc 中配置以下环境变量,可以让你的 Claude Code 启动即具备特定默认行为。
| 环境变量名 |
说明 |
示例值 |
ANTHROPIC_API_KEY |
你的 Anthropic 官方核心 API 密钥 |
sk-ant-xxx |
ANTHROPIC_BASE_URL |
覆盖默认的 API 访问端点(常用于内网代理或中转网关) |
https://api.your-proxy.com |
MAX_THINKING_TOKENS |
限制模型单次思考能够消耗的最大 Token 数量 |
4096 |
CLAUDE_CODE_SIMPLE |
开启后进入极简纯文本模式,禁用各种复杂的 UI 特效 |
true |
CLAUDE_CODE_DISABLE_AUTO_MEMORY |
强行禁用自动记忆功能,不再自动频繁读写 CLAUDE.md |
true |
HTTP_PROXY / HTTPS_PROXY |
企业私有云或本地开发时配置的网络代理地址 |
http://127.0.0.1:7890 |
🛠️ 七、 实战高频命令组合示例
💡 1. 日常功能开发黄金流
claude "使用 JWT 重构当前 src/auth 目录下的登录逻辑"
/debug "登录接口频繁返回 401 未授权错误"
/security-review
/compact
! git add -A
! git commit -m "feat: implement jwt auth via Claude Code"
🚀 2. 管道与非交互式流水线
cat logs/error.log | claude -p "分析这个调用栈中的核心错误原因并给出修复方案"
claude -p "优化当前 src/routers 下所有接口的响应时间" --worktree --max-budget-usd 2.5
🏆 八、 总结:最常用命令 TOP 10 记忆卡片
如果你刚刚开始使用,建议将以下 10 个最核心的命令贴在电脑边缘,它们能覆盖你 90% 的日常开发场景:
claude:启动交互对话。
claude -c:继续上一次的对话。
claude -p "问题":快问快答,查完就走。
/clear:擦除记忆,开启新话题。
/compact:Token 快满了,一键压缩。
/model:在 Sonnet 和 Opus 模型之间无缝切换。
/usage:随时看一眼今天又花了多少 API 额度。
/diff:看看到底帮我改了哪些本地文件。
Ctrl + C:大模型开始说废话时,一键打断。
! <command>:在聊天框里直接敲 Shell 命令。
📚 参考资料
💡 下一篇预告:《Claude Code 实战案例:10 个真实企业开发场景手把手教学》。欢迎点赞、收藏、订阅专栏,持续解锁 AI 自动化工程化落地新姿势!
所有评论(0)