ClaudeCode命令总结与使用技巧
Claude Code 命令总结与使用技巧
本文系统梳理 Claude Code（Anthropic 官方 CLI）的常用命令、特殊语法以及一套完整的项目开发流程。
所有命令均可在 Claude Code 交互界面中以/开头输入触发。运行/help可查看当前环境实际可用的全部命令。
一、命令体系概览
Claude Code 的命令分为两大类：
- 内置命令（Built-in）：CLI 本身提供，所有用户都有
- Skill 命令：通过 Anthropic 官方 Skill 体系或自定义 Skill 安装，按需扩展
区分技巧：内置命令通常是基础功能（会话管理、配置、记忆等）；Skill 命令多是高阶工作流（代码审查、深度研究、循环执行等）。
二、内置命令详解
2.1 会话与上下文管理
| 命令 | 用途 | 何时使用 |
|---|---|---|
/help |
查看当前环境支持的所有命令 | 不知道有哪些命令时；新环境首次接触 |
/clear |
清空当前会话上下文 | 开新任务、上下文已无关时；释放 token |
/compact |
主动压缩历史上下文，保留关键信息 | 长会话接近上下文窗口上限；想保留上下文但腾出空间 |
/resume |
恢复之前中断的会话 | 重启 CLI 后想接着之前的工作继续 |
/export |
导出当前会话内容 | 需要把对话归档、分享、复盘 |
/status |
查看当前会话状态（模型、目录、token 等） | 排查异常；确认环境配置 |
/cost |
查看本次会话的 token 消耗与费用 | 关注成本；任务复盘 |
2.2 项目初始化与配置
| 命令 | 用途 | 何时使用 |
|---|---|---|
/init |
分析当前仓库并生成 CLAUDE.md |
新项目首次接入 Claude Code 必做 |
/config |
进入交互式配置面板 | 调整主题、模型、键位等基础设置 |
/model |
切换当前会话使用的模型（Opus / Sonnet / Haiku） | 任务复杂度变化；成本/速度权衡 |
/fast |
切换 Fast Mode（用 Opus 但加速输出） | 需要又快又强的响应（仅 Opus 4.6/4.7/4.8 支持） |
/permissions |
管理工具调用权限白名单 | 减少授权弹窗；批量允许某类命令 |
/add-dir |
把额外目录加入 Claude 的工作范围 | 跨多仓库协作时 |
/ide |
配置 IDE 集成（VS Code / JetBrains） | 想在 IDE 中调用 Claude Code |
2.3 记忆与知识管理
| 命令 | 用途 | 何时使用 |
|---|---|---|
/memory |
查看 / 编辑跨会话持久化记忆 | 想检查、修改、清理 Claude 记住的信息 |
# <文本> |
快速追加一条记忆（前缀 # 输入） |
临时让 Claude 记住某件事，无需进入 /memory |
记忆按类型分四类：
user（用户画像）、feedback（工作偏好）、project（项目状态）、reference（外部资源指针）。Claude 会按类型自动归档。
2.4 工程化扩展
| 命令 | 用途 | 何时使用 |
|---|---|---|
/agents |
查看 / 管理可用的 Subagent | 想看有哪些专项子智能体；自定义 Agent |
/mcp |
管理 MCP 服务（接入外部工具/数据源） | 接入数据库、API、第三方服务 |
/hooks |
管理 Hook（事件触发的自动化脚本） | 让 Claude 在某事件发生时自动执行命令 |
2.5 其他实用命令
| 命令 | 用途 |
|---|---|
/vim |
切换 Vim 键位模式 |
/pr_comments |
查看 GitHub PR 的评论列表 |
/bug |
提交 Claude Code Bug 反馈 |
/doctor |
诊断 CLI 安装与环境问题 |
/login / /logout |
登录 / 登出 Anthropic 账户 |
三、Skill 命令详解（基于本仓库已装 Skill）
不同环境装的 Skill 不同，运行
/help看自己实际有哪些。以下是本仓库（cnblogs 笔记仓）当前可用的 Skill 命令。
3.1 代码质量类
| 命令 | 用途 | 关键参数 / 用法 |
|---|---|---|
/code-review |
审查当前 diff 中的正确性 Bug 与可简化点 | --effort low/medium/high/max 控制深度；--comment 发到 PR；--fix 直接修 |
/review |
审查一个 GitHub Pull Request | 直接传 PR URL 或分支名 |
/security-review |
对当前分支待提交内容做安全审查 | 上线前的最后一道安全网 |
/simplify |
重构当前 diff，专注复用 / 简化 / 效率，不查 Bug | 与 /code-review 互补：一个找 Bug，一个做清理 |
/verify |
启动应用验证一项变更确实生效 | 适用于 PR 验证、修复确认、上线前手测 |
/run |
启动并驱动当前项目的应用 | 想看到改动在真实应用中跑起来的效果 |
3.2 工程化与配置类
| 命令 | 用途 | 何时使用 |
|---|---|---|
/init |
分析仓库生成 CLAUDE.md（也是内置命令） |
新仓库第一步 |
/update-config |
通过对话方式修改 settings.json |
配 hook、加权限、设环境变量 |
/fewer-permission-prompts |
扫描历史会话，自动加白常用只读命令 | 用一段时间后觉得弹权限烦 |
/keybindings-help |
自定义键盘快捷键 / 添加和弦键 | 觉得默认键位不顺手 |
3.3 自动化与研究类
| 命令 | 用途 | 何时使用 |
|---|---|---|
/loop |
周期性循环执行某条 prompt 或命令 | 轮询部署状态、定时检查 PR、定期跑某任务 |
/deep-research |
多源 fan-out 检索 + 对抗验证 + 报告合成 | 需要严谨多源、有引用的研究报告 |
/claude-api |
调试 / 优化 Claude API（Anthropic SDK）应用 | 写代码调用 Claude API 时；模型升级迁移 |
/skill-creator |
创建、改进、评估 Skill | 想沉淀自己的工作流为可复用 Skill |
/good-habits-skill |
注入 AI Agent 工作好习惯（先方案后动手等） | 想让 Claude 更规范地协作 |
四、特殊语法（非斜杠命令）
这些不是 / 开头的命令，但同样高频使用：
| 语法 | 含义 | 示例 |
|---|---|---|
! <命令> |
在当前 shell 上下文中执行命令，输出回灌到对话 | ! gcloud auth login（适合需要交互式输入的命令） |
@ <路径> |
把指定文件 / 目录引用进当前消息 | @src/main.java 这段代码有什么问题？ |
# <文本> |
快速追加一条记忆（替代 /memory） |
# 用户偏好用 TypeScript |
Esc |
中断当前响应 | 跑偏了立刻打断 |
Esc Esc |
回退并编辑上一条用户消息 | 改提示词重跑，无需重新输入 |
Shift + Tab |
切换 Plan Mode（计划模式） | 让 Claude 先出方案、不直接动手 |
| 拖拽图片 | 直接把截图 / 图片拖入对话 | 描述 UI、贴报错截图 |
Plan Mode 是高频技巧：复杂任务先按
Shift+Tab进 Plan，让 Claude 列方案 → 用户审 → 同意后才进入实施，能极大降低踩坑概率。
五、项目开发完整流程
下面是一套基于 Claude Code 的项目开发工作流，融合了 Spec-Driven Development（SDD）思想：
┌─────────────────────────────────────────────────────────────────┐
│ 阶段 0：环境准备 │
└─────────────────────────────────────────────────────────────────┘
│
cd <项目根目录> && claude
│
▼
┌──────────────────────────┐
│ /doctor 检查环境 │ ← 首次安装时
│ /model 选择模型 │ ← Opus 复杂 / Sonnet 通用
└──────────┬───────────────┘
▼
┌─────────────────────────────────────────────────────────────────┐
│ 阶段 1：项目初始化（让 Claude 认识你的代码） │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌──────────────────────────┐
│ /init │
│ → 自动分析仓库 │
│ → 生成 CLAUDE.md │ ← 项目"宪法"，所有未来
│ → 沉淀架构、命令、约定 │ Claude 会话都会读
└──────────┬───────────────┘
▼
┌──────────────────────────┐
│ /permissions │ ← 配好常用工具白名单
│ /fewer-permission-prompts│ 减少弹窗骚扰
└──────────┬───────────────┘
▼
┌─────────────────────────────────────────────────────────────────┐
│ 阶段 2：需求规划（Spec-Driven，先方案后代码） │
└─────────────────────────────────────────────────────────────────┘
│
┌──────────┴───────────┐
│ │
简单任务 复杂任务
│ │
▼ ▼
┌─────────────────┐ ┌──────────────────────────┐
│ Shift+Tab │ │ 使用 specify CLI │
│ → Plan Mode │ │ /constitution → 项目原则 │
│ → Claude 出方案 │ │ /specify → 业务规范 │
│ → 审核 → 同意 │ │ /clarify → 模糊点澄清│
│ │ │ /plan → 技术选型 │
│ │ │ /tasks → 任务拆解 │
└─────────┬───────┘ └──────────┬───────────────┘
│ │
└───────────┬───────────┘
▼
┌─────────────────────────────────────────────────────────────────┐
│ 阶段 3：编码实施 │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌──────────────────────────┐
│ 按 plan / tasks 推进 │
│ Claude 按计划逐步实现 │
│ 随时用 #<文本> 沉淀偏好 │ ← 让 Claude 记住临时约定
│ 长任务接近上限 → /compact │
└──────────┬───────────────┘
▼
┌─────────────────────────────────────────────────────────────────┐
│ 阶段 4：质量保证 │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌──────────────────────────┐
│ /simplify │ ← 先做清理（复用、简化）
│ /code-review --effort │ ← 再查 Bug
│ high │ 高 effort = 严格审查
│ /verify 或 /run │ ← 运行验证改动确实生效
│ /security-review │ ← 上线前安全网
└──────────┬───────────────┘
▼
┌─────────────────────────────────────────────────────────────────┐
│ 阶段 5：提交与发布 │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌──────────────────────────┐
│ 请 Claude 写 commit msg │
│ 请 Claude 创建 PR │ ← gh pr create
│ /review <PR_URL> │ ← 让 Claude 自审 PR
│ /pr_comments │ ← 看评论并响应
└──────────┬───────────────┘
▼
┌─────────────────────────────────────────────────────────────────┐
│ 阶段 6：复盘与沉淀 │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌──────────────────────────┐
│ /cost 看 token 消耗 │
│ /memory 整理本次学到的 │ ← 跨会话沉淀
│ 偏好/项目知识 │
│ /export 归档对话 │ ← 需要复盘时
│ 更新 CLAUDE.md │ ← 把新约定写入项目宪法
└──────────────────────────┘
六、关键阶段的"为什么"
| 阶段 | 关键命令 | 目的（为什么不能跳过） |
|---|---|---|
| 0 环境准备 | /doctor、/model |
模型选错会显著影响成本和效果 — Opus 适合复杂推理（架构设计、跨文件重构），Sonnet 适合通用编码，Haiku 适合简单任务批处理 |
| 1 项目初始化 | /init |
CLAUDE.md 是给未来所有 Claude 实例的"项目宪法"，没有它每次都得重新理解项目，效率极低；这是给 AI 看的最重要的文档 |
| 2 需求规划 | Plan Mode / specify |
先 plan 后写代码，看上去慢一步，实际 AI 埋坑更少。直接写 prompt → AI 自由发挥 → 反复返工，远比先 plan 慢 |
| 3 编码实施 | 配合 # 记忆 / /compact |
长任务的隐藏杀手是上下文腐烂（Context Rot），主动 /compact 比被动撞窗口稳得多 |
| 4 质量保证 | /simplify → /code-review → /verify → /security-review |
顺序很重要：先清理（噪声少）再查 Bug（信号清）再验证（真实跑）再安全（上线前）；颠倒顺序效率低 |
| 5 提交与发布 | /review、/pr_comments |
自己提的 PR 自己用 Claude 再审一遍，能发现一波遗漏，几乎不要钱 |
| 6 复盘与沉淀 | /memory、更新 CLAUDE.md |
这一步最容易被跳过，但它是 AI 协作能滚雪球变好的唯一通路 — 没有沉淀，每次都从零开始 |
七、高频使用技巧
7.1 Plan Mode 是默认习惯
任何非平凡任务（>3 步 / 涉及多文件 / 有架构选型空间），先 Shift+Tab 进 Plan Mode 让 Claude 出方案。先方案后动手这一条习惯能拉开 Claude Code 用户的水平差距。
7.2 善用 /clear 而非堆叠对话
任务切换时果断 /clear，不要让旧任务的上下文污染新任务。Claude 不会因为"刚才聊了很多"就更聪明，反而会被无关信息分散注意力。
7.3 CLAUDE.md 持续更新
每次发现 Claude 重复犯同一个错、或踩了项目特有的坑，就把规则写进 CLAUDE.md。这个文件应该越用越厚（直到 200 行左右见顶），是项目知识的核心沉淀。
7.4 /memory 与 CLAUDE.md 的分工
CLAUDE.md：项目级，团队共享，进 git，写项目特有的事（架构、约定、坑）/memory：用户级，跨项目，本地，写个人偏好的事（编码风格、惯用工具、工作模式）
7.5 成本敏感时的模型路由策略
日常对话 / 简单改动 → Haiku 或 Sonnet
通用编码 / 调试 → Sonnet
架构设计 / 复杂推理 → Opus
跨多文件大重构 → Opus + Plan Mode
7.6 用 ! 前缀处理交互式命令
需要登录、确认、二次输入的命令（如 gcloud auth login、heroku login），让用户用 ! 前缀在他们自己的终端运行，而不是让 Claude 通过 Bash 工具调（Bash 工具非交互）。
7.7 @ 引用比复制粘贴更优
需要 Claude 看某个文件时，用 @路径 而不是把内容复制到对话里。前者更省 token，后者会让上下文重复占用空间。
八、参考资料
- Claude Code 官方文档
- GitHub Spec Kit（specify CLI）
- 反馈与问题：会话中输入
/bug，或访问 https://github.com/anthropics/claude-code/issues
最后一句话：Claude Code 命令很多，但真正高频用的不超过 10 个：
/init、/clear、/compact、/model、/code-review、/verify、/memory、#、!、Shift+Tab。把这 10 个用熟，比记住所有命令更有用。
浙公网安备 33010602011771号