🚀 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显示当前安装的客户端版本号(简写:-vclaude -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 Tokenclaude 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             # 运行本地前端单元测试,错漏会自动被 Claude 捕获
! 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.mdtrue
HTTP_PROXY / HTTPS_PROXY企业私有云或本地开发时配置的网络代理地址http://127.0.0.1:7890

🛠️ 七、 实战高频命令组合示例

💡 1. 日常功能开发黄金流

# 1. 带着明确重构目标启动
claude "使用 JWT 重构当前 src/auth 目录下的登录逻辑"

# 2. 如果中间发生非预期 Bug,在交互中开启调试日志
/debug "登录接口频繁返回 401 未授权错误"

# 3. 功能开发完毕后,原地进行本地代码安全扫描
/security-review

# 4. 提交代码前,精简上下文并执行 Git 提交
/compact
! git add -A
! git commit -m "feat: implement jwt auth via Claude Code"

🚀 2. 管道与非交互式流水线

# 自动抓取最新的本地错误日志,直接丢给 Claude 并在输出分析报告后退出
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 自动化工程化落地新姿势!

更多推荐