目录

  1. 绪论:Claude Code 命令体系的三大支柱
  2. CLI 启动命令与标志
    • 2.1 基础启动命令
    • 2.2 会话管理标志
    • 2.3 输出与格式控制标志
    • 2.4 权限与安全标志
    • 2.5 环境配置标志
    • 2.6 完整标志参考表
  3. 斜杠命令(Slash Commands)深度解析
    • 3.1 项目管理类命令
    • 3.2 会话控制类命令
    • 3.3 模型与资源类命令
    • 3.4 配置与诊断类命令
    • 3.5 辅助开发类命令
    • 3.6 自定义斜杠命令
  4. 键盘快捷键与交互技巧
    • 4.1 基础操作快捷键
    • 4.2 高级交互快捷键
    • 4.3 多行输入技巧
    • 4.4 Vim 模式命令
  5. MCP 集成命令
  6. 子代理(Sub-agent)与 Skills 命令
  7. 命令组合最佳实践
  8. 结语:从命令到工作流的进化

1. 绪论:Claude Code 命令体系的三大支柱

Claude Code 的命令体系远比你想象的丰富。根据最新的命令参考,Claude Code 内置了超过 50 个命令,但大多数开发者只用了其中 3 到 5 个。这不仅是效率的浪费,更是对工具潜力的低估。

Claude Code 的命令体系可以分为三个核心层次,理解这三个层次是掌握所有命令的基础:

1.1 三种命令类型

类型

触发方式

作用域

典型示例

CLI 命令

终端启动时执行

会话启动前

claude -p "query"

斜杠命令

会话内 / 触发

会话中进行时

/compact/model

键盘快捷键

直接按键操作

会话中即时生效

Ctrl+CShift+Tab

CLI 命令在终端启动 Claude Code 时执行,用于控制整个会话的行为模式——是进入交互式环境还是执行单次查询,使用什么模型,添加哪些额外目录。

斜杠命令在交互式会话内部输入 / 触发,是日常操作的核心。输入 / 即可查看所有可用命令,边输入边筛选。

键盘快捷键在会话期间直接生效,提供最快速的交互方式。熟练使用快捷键可以将操作速度提升数倍。

1.2 命令体系的设计哲学

Claude Code 的命令体系遵循“渐进式发现”的设计哲学:

  • 新手友好/help/init 降低了上手门槛
  • 专家高效:键盘快捷键和自定义命令满足深度使用需求
  • 可扩展性:自定义命令、MCP 集成、Sub-agent 提供了无限扩展空间

理解这一哲学后,我们逐层深入每个命令的细节。

2. CLI 启动命令与标志

CLI 命令是 Claude Code 的入口点,决定了整个会话的启动方式和行为模式。

2.1 基础启动命令

claude标准交互式启动

claude

这是最常用的启动方式。执行后,Claude Code 会:

  1. 扫描当前目录及子目录的代码文件
  2. 读取项目根目录的 CLAUDE.md 记忆文件
  3. 启动交互式 REPL 环境,等待用户输入

适用场景:日常开发、需要多轮对话的任务

claude "query"携带初始提示启动

claude "分析这个文件的结构,然后优化性能"

启动后立即将 query 作为初始提示发送给 Claude,进入交互模式。

适用场景:明确知道要做什么,快速进入任务状态

claude -p "query" / --print — 单次查询模式

claude -p "解释这个函数的逻辑"          # 基础用法
cat logs.txt | claude -p "分析这些日志" # 管道输入

-p 标志是最重要的 CLI 标志之一。它会:

  1. 执行查询
  2. 打印响应结果
  3. 立即退出(不进入交互模式)

这是非交互模式的典型用法,特别适合脚本和自动化工作流。

管道支持claude -p 支持从标准输入读取内容,配合管道使用效果极佳:

git diff | claude -p "生成commit message"

claude update更新到最新版本

claude update

将 Claude Code 更新到官方发布的最新版本。执行后可以立即使用 claude --version 验证更新结果。

claude --version / -v — 查看版本

claude --version
# 输出示例: 2.1.84

确认当前安装版本,排查问题时常用。

2.2 会话管理标志

claude -c / --continue — 继续最近对话

claude -c

继续当前目录中最近的一次对话,加载完整的历史上下文。

典型场景

  • 午休后恢复上午的工作
  • 跨日处理同一个任务
  • 不小心退出了会话,需要恢复

claude -r <id> / --resume — 按 ID 恢复会话

claude -r abc123           # 按 ID 恢复
claude --resume auth-refactor  # 按保存的名称恢复

每个会话都有唯一 ID(可通过 /sessions 查看)。-r 允许精确恢复特定会话。

claude -c -p "query"延续上下文 + 查询

claude -c -p "检查类型错误"

组合使用:恢复最近会话,在已有上下文中执行新查询,然后退出。

2.3 输出与格式控制标志

--output-format输出格式

格式

说明

适用场景

text

纯文本

默认,人工阅读

json

JSON 格式

脚本解析、自动化处理

stream-json

流式 JSON

实时处理输出

claude -p "列出所有函数" --output-format json

--max-turns最大交互轮数

claude -p "重构代码" --max-turns 3

限制 Agent 的最大交互轮数,防止无限循环。

--verbose详细日志模式

claude --verbose

启用详细日志记录,显示工具执行的完整细节,用于调试和性能分析。

2.4 权限与安全标志

--dangerously-skip-permissions跳过所有权限确认

claude --dangerously-skip-permissions

⚠️ 高危标志:跳过所有权限提示,AI 可以自由执行任何操作。

官方警告:仅在隔离环境(如 CI 容器、开发专用沙盒)中使用。生产环境慎用。

--permission-mode指定权限模式

claude --permission-mode plan   # 计划模式启动
claude --permission-mode accept # 自动接受模式

可选的模式:

  • normal:默认,每次工具调用前请求确认
  • accept:自动接受,无需确认
  • plan:计划模式,只展示方案不执行

--allowedTools / --disallowedTools — 工具白名单/黑名单

claude --allowedTools "Read,Edit,View"
claude --disallowedTools "Bash"

精确控制 Claude 可以使用的工具。

2.5 环境配置标志

--add-dir添加额外工作目录

claude --add-dir ../lib ../apps

允许 Claude 同时访问主目录之外的其他代码库。对于 Monorepo 或微服务架构项目特别有用。

--model指定模型

claude --model sonnet   # 使用 Sonnet
claude --model opus     # 使用 Opus
claude --model haiku    # 使用 Haiku

启动时直接指定使用的模型,覆盖默认配置。

--system-prompt / --append-system-prompt — 自定义系统提示

claude --system-prompt "你是一个Python专家"                    # 完全替换
claude --append-system-prompt "始终使用TypeScript"            # 追加

  • --system-prompt:完全替换默认的系统指令
  • --append-system-prompt:追加到默认指令之后,保留 Claude Code 内置能力

2.6 完整标志参考表

标志

短标志

说明

示例

--print

-p

单次查询后退出

claude -p "hi"

--continue

-c

继续最近会话

claude -c

--resume

-r

按 ID 恢复会话

claude -r abc123

--model

-

指定模型

--model opus

--add-dir

-

添加工作目录

--add-dir ../lib

--verbose

-

详细日志

--verbose

--output-format

-

输出格式

--output-format json

--max-turns

-

最大轮数

--max-turns 5

--system-prompt

-

自定义系统提示

--system-prompt "..."

--append-system-prompt

-

追加系统提示

--append-system-prompt "..."

--allowedTools

-

工具白名单

--allowedTools "Read,Grep"

--disallowedTools

-

工具黑名单

--disallowedTools "Bash"

--permission-mode

-

权限模式

--permission-mode plan

--dangerously-skip-permissions

-

跳过权限

--dangerously-skip-permissions

--help

-h

帮助信息

claude --help

--version

-v

版本信息

claude --version

3. 斜杠命令(Slash Commands)深度解析

斜杠命令是 Claude Code 交互式会话的核心操作界面。输入 / 即可查看所有可用命令。

3.1 项目管理类命令

/init项目初始化

> /init

这是每个项目的第一条命令。/init 会在项目根目录创建 CLAUDE.md 文件——Claude 每次会话都会读取的持久记忆文件。

自动生成内容

  • 项目描述
  • 技术栈(根据 package.jsonrequirements.txt 等自动检测)
  • 构建命令
  • 测试命令
  • 代码风格偏好

实战技巧/init 执行后,立即手动编辑 CLAUDE.md 追加具体规则:

# 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 }

开发者反馈:每个项目从 /init 开始可以消除 80% 的重复上下文设置。

/memory编辑长期记忆

> /memory

不退出会话即可打开 CLAUDE.md 进行编辑。会话中途添加编码规范、更新项目上下文时直接调用。

快速添加语法

# 无需打开编辑器,直接追加到记忆
# Use async/await for all database queries

/todos任务列表管理(v2.1.16 新增)

> /todos

维护一个跨会话持久保存的任务列表。功能特点:

  • 关闭会话后任务不会消失
  • 上下文压缩不影响任务列表
  • 支持自然语言创建:"添加认证功能,按依赖关系拆解任务"

高级用法:设置 CLAUDE_CODE_TASK_LIST_ID 环境变量,可以在多个 Claude Code 会话间共享同一份任务列表,适合并行处理同一项目不同部分的团队场景。

3.2 会话控制类命令

/compact上下文压缩

> /compact                    # 基础压缩
> /compact retain the error handling patterns and auth module changes  # 定向压缩

上下文窗口快满时,压缩对话历史并进行摘要以回收空间。

压缩保留的内容

  • CLAUDE.md 内容
  • 任务列表项
  • 关键决策和模式

压缩丢弃的内容

  • 冗长的对话往返
  • 已被替代的代码迭代

2026 年 2 月发行说明:/compact 的执行速度已降至即时完成(之前需要 3-5 秒)。

最佳实践:不要等到上下文满了才压缩。通过 /context 检查当前用量,在 70-80% 时主动执行压缩。

/clear硬重置

> /clear

完全清除对话历史,从零开始。

适用场景

  • 切换到截然不同的任务
  • 完成一个功能之后
  • 上下文与接下来的工作无关

/compact /clear 的区别

命令

效果

适用场景

/compact

压缩总结,保留关键信息

继续同一任务,上下文过重

/clear

硬重置,完全清空

切换到不同任务

注意:/clear 会连带清除该目录的命令历史。如果需要保留旧提示的访问记录,用 /compact 替代。

/rewind撤销(2026 年 2 月增强)

> /rewind
Esc Esc   # 快速打开回退菜单

回退对话历史和/或代码更改。2026 年 2 月增强后,对话和代码可以分别回退。

回退选项

  1. Rewind conversation only(保留代码)
  2. Rewind code only(保留对话)
  3. Rewind both(全部回退)

典型用法

# 尝试实验性重构
# → 效果不好
# → Esc Esc
# → "Rewind code only"
# → 代码恢复,对话历史保留

/fork实验性分支

> /fork

创建一个临时对话分支来探索想法,不影响主上下文。

适用场景

  • 测试高风险重构
  • 探索多种解决方案
  • 做快速实验

关闭分支后自动返回主对话,实验性修改完全隔离。

3.3 模型与资源类命令

/model切换模型

> /model                 # 交互式选择
> /model sonnet          # 切换到 Sonnet 4.6
> /model opus            # 切换到 Opus 4.6
> /model haiku           # 切换到 Haiku 4.5

会话中途切换模型。

模型选择策略

模型

特点

适用场景

Sonnet 4.6

平衡性能与成本

日常编码、重构、Bug 修复

Opus 4.6

最强推理能力

复杂多步骤规划、架构决策

Haiku 4.5

最快、最便宜

简单编辑、样板代码生成、快速提问

日常策略:Sonnet 起步,遇到瓶颈切 Opus,琐碎任务交给 Haiku。

/cost — Token 用量与费用

> /cost

显示当前会话的 Token 消耗和费用。

输出示例

Session cost: $2.47
Input tokens: 48,392
Output tokens: 12,847
Model: claude-sonnet-4-20250514

费用控制技巧

  • 简单任务用 Haiku
  • 执行 /compact 压缩上下文
  • 不必要时从 Opus 降级到 Sonnet
  • 每次大交互后跑一次 /cost

/context上下文窗口用量

> /context

以百分比形式实时显示上下文占用情况。

输出示例

Context usage: 67% (134,400 / 200,000 tokens)

最佳实践

  • 70-80% 时主动执行 /compact
  • 90% 以上 Claude 可能开始遗忘早期上下文
  • 上下文过多会拖累 LLM 表现,在触及上限之前压缩

/usage用量统计

> /usage

显示更全面的使用统计,包括历史会话汇总。

3.4 配置与诊断类命令

/config配置菜单

> /config

打开交互式配置菜单,修改全局偏好:

  • 主题(亮色/暗色)
  • 自动权限
  • 通知设置
  • 默认路径

配置保存在 ~/.claude/settings.json

/doctor健康诊断

> /doctor

运行一系列检查,诊断 Claude Code 安装:

检查项

常见失败原因

Node.js 版本

版本 < 18

API 连接

代理或防火墙

认证 Token

Token 过期

配置文件

JSON 格式错误

扩展

版本不兼容

80% 的连接问题由 /doctor 检测出,常见原因是 Token 过期或代理配置错误。

/permissions权限管理

> /permissions

配置 Claude 可以跳过确认直接执行的操作。

配置示例

{
  "allowedTools": ["Read", "Edit", "Bash(npm install *)"],
  "deniedTools": ["Bash(rm -rf *)"]
}

/status系统状态

> /status

显示系统状态和账户信息。

/terminal-setup终端配置

> /terminal-setup

安装 Shift+Enter 多行输入绑定,在 iTerm2 或 VS Code 终端中生效。

3.5 辅助开发类命令

/review/simplify — 代码审查(2026 年 3 月更新)

> /simplify   # 替代已弃用的 /review

用三个并行 Agent 执行代码审查。

审查覆盖

  • 代码质量
  • 安全漏洞
  • 最佳实践违规
  • 性能问题
  • 测试覆盖率

工作流:编写功能 → /simplify → 审查反馈 → 修复问题 → 提交

/diff查看更改

> /diff              # 显示所有更改
> /diff src/auth.ts  # 显示特定文件的更改

显示 Claude 在当前会话中所做更改的 git diff。

使用时机

  • 提交代码之前
  • 审查 Claude 到底改了什么
  • 排查意外修改

每个功能结束后执行 /diff → 审查 → 提交——这就是提交前代码审查。

/btw不打断上下文的提问

> /btw What is the difference between useEffect and useLayoutEffect?

在 Claude 执行当前任务的过程中插入附带问题,不中断主任务,也不污染上下文。

传统方式:取消当前任务 → 提问 → 重新发起原始任务
/btw 方式:一条命令解决,Claude 回答后继续原任务

/fast极速模式

> /fast

启用带有速度优化 API 设置的 Fast Mode。

说明:Fast Mode 运行的是同一个 Opus 4.6,并非换了模型,而是调整了 API 配置。开启后,之前积累的全部上下文会按 Fast Mode 费率重新计费。

适用场景:交互式快速迭代、实时调试、快速实验

/plan计划模式

> /plan
Shift+Tab   # 循环切换模式

代码更改以计划形式提出,审批后才实际执行。

三种模式对比

模式

行为

Normal

每次工具执行前要求确认

Auto-Accept

无需确认直接执行

Plan Mode

只展示方案等待审批

写测试和生成样板代码时用 Auto-Accept;涉及配置、数据库迁移、package.json 这类生产关键文件时切到 Plan Mode。

/output-style输出风格

> /output-style

自定义 Claude 的响应方式。

可选风格

  • Concise(简洁)
  • Educational(教学风格)
  • Code Reviewer(审查者风格)
  • Rapid Prototyping(快速原型)

隐藏功能@agent-output-mode-setup 执行后会在 ~/.claude/output-modes/ 下生成四种自定义模式文件。

/vim — Vim 模式

> /vim

启用类似 Vim 的编辑模式。

Vim 模式支持的命令

  • 光标移动:hjkl
  • 单词跳转:wb
  • 删除整行:dd
  • 修改整行:cc
  • 重复上次修改:.

3.6 自定义斜杠命令

3.6.1 命令文件结构

自定义斜杠命令是 Claude Code 最具扩展性的功能之一。通过创建 Markdown 文件,开发者可以将常用操作模板化、标准化。

两种作用域

作用域

目录位置

适用场景

项目级

.claude/commands/

团队共享、版本控制

用户级

~/.claude/commands/

个人工作流、跨项目通用

创建步骤

# 1. 创建目录
mkdir -p .claude/commands

# 2. 创建命令文件
echo "分析当前代码的性能,提出三个具体的优化建议" > .claude/commands/optimize.md

# 3. 使用命令
> /project:optimize

3.6.2 命名空间与组织

通过子目录创建命名空间,实现命令的分类管理:

.claude/commands/
├── frontend/
│   ├── component.md      # → /project:frontend:component
│   └── test.md           # → /project:frontend:test
├── backend/
│   ├── api.md            # → /project:backend:api
│   └── db.md             # → /project:backend:db
└── review.md             # → /project:review

3.6.3 参数传递($ARGUMENTS

创建接受参数的命令,使用 $ARGUMENTS 占位符。

示例:fix-issue.md

查找并修复问题 #$ARGUMENTS。按以下步骤操作:
1. 理解问题描述
2. 定位相关代码
3. 实现修复方案
4. 运行测试验证
5. 生成 PR 描述

使用/project:fix-issue 1234 → Claude 会修复第 1234 号问题

3.6.4 YAML Frontmatter

在 Markdown 文件顶部添加 YAML Frontmatter,为命令添加元数据:

---
allowed-tools: Read, Grep, Glob
description: 安全审查命令
---

扫描代码库,检查:
- 硬编码的密钥
- SQL 注入风险
- XSS 漏洞

3.6.5 常用自定义命令示例

Git 工作流

命令

内容

用途

/commit

分析变更并生成规范提交信息

自动化提交

/create-pr

完整 PR 创建流程

一键发起 PR

/fix-issue

按问题编号修复

关联 Issue 工作流

代码质量

命令

内容

用途

/optimize

性能分析和优化建议

代码优化

/security-review

安全漏洞扫描

安全审查

/clean

自动格式化、排序 imports、修复 lint

代码清理

/tdd

红-绿-重构 TDD 流程

测试驱动开发

文档与上下文

命令

内容

用途

/context-prime

加载项目概览和关键设计文档

预热上下文

/changelog

生成变更日志

版本发布

3.6.6 动态内容支持

自定义命令支持动态内容:

  • Bash 执行:使用 ! 前缀嵌入命令输出
  • 文件引用:使用 @ 引用文件内容

示例:生成 git status 感知的提交命令

# 在生成提交信息前获取当前状态
! git status
! git diff --cached

请根据上述变更生成符合约定式提交规范的 commit message

4. 键盘快捷键与交互技巧

键盘快捷键是 Claude Code 中最快、最自然的交互方式。熟练使用快捷键可以将操作速度提升数倍。

4.1 基础操作快捷键

快捷键

功能

说明

Ctrl+C

取消当前生成

AI 跑偏时紧急刹车

Ctrl+D

发送 EOF 信号退出

安全退出会话

Ctrl+L

清除屏幕

保持界面整洁,不删除历史

Ctrl+O

切换详细输出模式

查看 AI 的思考过程

Ctrl+R

反向搜索命令历史

快速定位历史输入

/

浏览历史命令

快速重用之前的 Prompt

4.2 高级交互快捷键

Shift+Tab权限模式切换

循环切换三种模式:

  • Normal → Auto-Accept → Plan → Normal

Esc+Esc时光机回退

双击 Esc 打开回退菜单,快速撤销文件改动。比 Git 操作快得多。

Tab命令补全

  • 输入 / 后按 Tab:补全斜杠命令
  • 输入 @ 后按 Tab:补全文件路径
  • 普通输入:补全历史命令

Ctrl+B后台任务模式(2.1.0 新增)

将长时间运行的任务(Agent 或 Bash 命令)放到后台执行,释放终端继续其他工作。

操作流程

  1. 执行长时间命令:! npm run test
  2. Ctrl+B 移至后台
  3. 获得任务 ID:bash_1
  4. 继续其他工作,任务完成后自动通知

tmux 用户可连续按 Ctrl+B+B 操作。

4.3 多行输入技巧

在终端中输入多行内容有三种方法:

方法

操作

适用终端

反斜杠换行

行尾输入 \ 后按 Enter

所有终端

Shift+Enter

直接换行不发送

跨平台通用

Option+Enter

直接换行不发送

macOS

最佳实践:先用 /terminal-setup 安装 Shift+Enter 绑定,肌肉记忆与其他工具保持一致。

4.4 Vim 模式命令

启用 /vim 后,可使用以下 Vim 风格命令:

光标移动

  • h / j / k / l:左/下/上/右移动
  • w / b:向前/向后跳单词
  • 0 / $:行首/行尾

编辑操作

  • dd:删除整行
  • cc:修改整行
  • x:删除光标处字符
  • .:重复上次修改

5. MCP 集成命令

MCP(Model Context Protocol)是 Claude Code 连接外部世界的桥梁。

5.1 MCP 管理命令

claude mcp                    # 交互式 MCP 配置
claude mcp list               # 列出已配置的服务器
claude mcp add <name> <cmd>   # 添加 MCP 服务器

5.2 MCP 传输方式

方式

说明

适用场景

Stdio

本地进程通信

最常用,连接本地工具

SSE

服务端推送

流式数据场景

HTTP

远程服务调用

通过 URL 调用远程服务

5.3 MCP 作用域

作用域

配置位置

适用场景

本地

当前项目 .claude/

仅本项目使用的工具

项目

项目根目录配置

团队共享的工具

用户

~/.claude/

所有项目通用的工具

5.4 MCP 斜杠命令

MCP 服务器公开的 Prompt 会自动转化为斜杠命令:

/mcp__<servername>__<promptname>

例如:/mcp__github__list_prs 直接在终端查看待处理的 PR。

5.5 常用 MCP 服务器

服务器

功能

filesystem

文件系统访问

github

GitHub API 集成

postgres

PostgreSQL 数据库操作

puppeteer

浏览器自动化

slack

Slack 消息发送

google-drive

Google Drive 访问

6. 子代理(Sub-agent)与 Skills 命令

6.1 Sub-agent 定义

通过 --agents 标志定义专业子代理:

claude --agents reviewer.json

reviewer.json 示例

{
  "name": "reviewer",
  "description": "代码审查专家",
  "systemPrompt": "你是一个代码审查专家,专注于安全漏洞和性能问题",
  "tools": ["Read", "Grep"],
  "model": "sonnet"
}

6.2 Skills 系统

Skills 是功能包机制,将特定领域的知识和操作流程封装。

Skill 结构

my-skill/
├── SKILL.md          # 技能定义(含 frontmatter
├── scripts/          # 可执行脚本
└── resources/        # 资源文件

SKILL.md 示例

---
name: apifox-tests
description: 执行和解读 Apifox 自动化测试
---

# 工作流程
1. 选择测试
2. 确认环境
3. 执行测试
4. 解释结果

7. 命令组合最佳实践

7.1 新项目初始化流程

# 1. 进入项目目录
cd my-project

# 2. 启动 Claude Code
claude

# 3. 项目初始化
> /init

# 4. 添加项目规范
> /memory
# 在打开的 CLAUDE.md 中补充具体规则

# 5. 确认配置
> /status
> /doctor

7.2 日常开发工作流

# 启动并继续上次会话
claude -c

# 查看当前上下文
> /context

# 需要压缩时
> /compact

# 切换模型处理复杂任务
> /model opus

# 查看费用
> /cost

# 审查 AI 的修改
> /diff

# 提交代码
> /commit

7.3 自动化脚本示例

# CI 中运行代码审查
claude -p "审查当前 PR 的代码质量" --output-format json --max-turns 3

# 生成变更日志
claude -p "根据 git log 生成 CHANGELOG" --append-system-prompt "输出 Markdown 格式"

7.4 费用控制组合

# 1. 会话开始前确认模型
claude --model haiku

# 2. 会话中定期检查
> /cost

# 3. 上下文过大时压缩
> /compact

# 4. 任务完成切换时清空
> /clear

8. 结语:从命令到工作流的进化

Claude Code 的命令体系经历了从简单的 CLI 工具到完整智能体平台的进化。50+ 命令覆盖了从项目初始化、日常开发、代码审查到自动化集成的完整生命周期。

三类命令各有侧重

  • CLI 命令控制会话的启动行为
  • 斜杠命令是交互式会话的操作核心
  • 键盘快捷键提供最快速的即时操作

扩展能力让命令体系无限生长

  • 自定义命令将团队最佳实践固化
  • MCP 集成连接外部工具和数据源
  • Skills 封装领域专业知识
  • Sub-agent 实现专业化分工

掌握这些命令不是终点,而是起点。真正的价值在于将这些命令组合成适合自己工作流的自动化体系。正如一位开发者所言:“工具本身不产生价值,会用工具的人才产生价值。”

快速参考清单

类别

核心命令

启动

claude, claude -c, claude -p

项目

目录

Claude Code 命令行完全解析:从入门到精通的 50+ 命令深度剖析

目录

1. 绪论:Claude Code 命令体系的三大支柱

1.1 三种命令类型

1.2 命令体系的设计哲学

2. CLI 启动命令与标志

2.1 基础启动命令

claude — 标准交互式启动

claude "query" — 携带初始提示启动

claude -p "query" / --print — 单次查询模式

claude update — 更新到最新版本

claude --version / -v — 查看版本

2.2 会话管理标志

claude -c / --continue — 继续最近对话

claude -r / --resume — 按 ID 恢复会话

claude -c -p "query" — 延续上下文 + 查询

2.3 输出与格式控制标志

--output-format — 输出格式

--max-turns — 最大交互轮数

--verbose — 详细日志模式

2.4 权限与安全标志

--dangerously-skip-permissions — 跳过所有权限确认

--permission-mode — 指定权限模式

--allowedTools / --disallowedTools — 工具白名单/黑名单

2.5 环境配置标志

--add-dir — 添加额外工作目录

--model — 指定模型

--system-prompt / --append-system-prompt — 自定义系统提示

2.6 完整标志参考表

3. 斜杠命令(Slash Commands)深度解析

3.1 项目管理类命令

/init — 项目初始化

/memory — 编辑长期记忆

/todos — 任务列表管理(v2.1.16 新增)

3.2 会话控制类命令

/compact — 上下文压缩

/clear — 硬重置

/rewind — 撤销(2026 年 2 月增强)

/fork — 实验性分支

3.3 模型与资源类命令

/model — 切换模型

/cost — Token 用量与费用

/context — 上下文窗口用量

/usage — 用量统计

3.4 配置与诊断类命令

/config — 配置菜单

/doctor — 健康诊断

/permissions — 权限管理

/status — 系统状态

/terminal-setup — 终端配置

3.5 辅助开发类命令

/review → /simplify — 代码审查(2026 年 3 月更新)

/diff — 查看更改

/btw — 不打断上下文的提问

/fast — 极速模式

/plan — 计划模式

/output-style — 输出风格

/vim — Vim 模式

3.6 自定义斜杠命令

3.6.1 命令文件结构

3.6.2 命名空间与组织

3.6.3 参数传递($ARGUMENTS)

3.6.4 YAML Frontmatter

3.6.5 常用自定义命令示例

3.6.6 动态内容支持

4. 键盘快捷键与交互技巧

4.1 基础操作快捷键

4.2 高级交互快捷键

Shift+Tab — 权限模式切换

Esc+Esc — 时光机回退

Tab — 命令补全

Ctrl+B — 后台任务模式(2.1.0 新增)

4.3 多行输入技巧

4.4 Vim 模式命令

5. MCP 集成命令

5.1 MCP 管理命令

5.2 MCP 传输方式

5.3 MCP 作用域

5.4 MCP 斜杠命令

5.5 常用 MCP 服务器

6. 子代理(Sub-agent)与 Skills 命令

6.1 Sub-agent 定义

6.2 Skills 系统

7. 命令组合最佳实践

7.1 新项目初始化流程

7.2 日常开发工作流

7.3 自动化脚本示例

7.4 费用控制组合

8. 结语:从命令到工作流的进化


/init, /memory, /todos

会话

/compact, /clear, /rewind

模型

/model, /cost, /context

诊断

/doctor, /status, /config

开发

/diff, /simplify, /btw

扩展

/mcp, 自定义命令, Skills

输入 /help 随时查看当前版本的所有命令——这是 Claude Code 始终不变的初心。

参考文献

  1. 阿里云开发者社区. (2026). Claude Code 命令体系解析:三种类型、七大分类、50+ 命令.
  2. Apifox. (2025). Claude Code 核心 CLI 命令全解析.
  3. 阿里云开发者社区. (2026). 我用 Claude Code 写了一周代码,这些技巧让效率翻倍.
  4. Sfeir Institute. (2026). Essential Slash Commands.
  5. 腾讯云. (2025). 一份全面的Claude Code高级技巧指南.
  6. MCP官方文档. (2025). claude-code-guide.
  7. Skywork AI. (2025). Claude Code SDK command list latest reference.
  8. 腾讯云. (2025). Claude Code快速、简明入门.
  9. Steve Kinney. (2026). Claude Code Commands.
Logo

欢迎加入DeepSeek 技术社区。在这里,你可以找到志同道合的朋友,共同探索AI技术的奥秘。

更多推荐