[控场AI]
教程攻略· 10 分钟阅读· 5,237 字

Claude Code命令完全指南:10大核心命令与实战工作流

Claude Code命令完全指南:10大核心命令与实战工作流

系统梳理Claude Code的核心命令、快捷键与实战工作流指南

本文全面介绍了Claude Code的十大常用命令,涵盖会话与上下文管理(Memory、Compact、Clear/Fork/Resume)、代码审查与安全(Diff、Security Review、Plan)、模型与性能控制(Sonnet/Opus切换策略)三大模块,并详解了键盘快捷键、CLI启动参数及四个实战工作流,帮助开发者从入门到精通,实现成本节省与效率提升。

Claude Code 是 Anthropic 推出的命令行 AI 编程助手,能帮你写代码、修 Bug、做重构、生成测试。但很多人只是把它当作一个「对话式代码生成器」来用,远没有发挥出它的全部潜力。要真正用好 Claude Code,你必须掌握它的核心命令体系。

本文将系统梳理 Claude Code 的十大常用命令、键盘快捷键、CLI 启动参数,以及四个经过验证的实战工作流,帮你从入门到精通。

Claude Code 命令完全指南

会话与上下文管理:五大核心命令

上下文管理是 Claude Code 的基础能力,也是决定使用效率的关键。掌握以下五个命令,你就能有效控制对话质量和 Token 消耗。

要理解这些命令的重要性,首先需要了解 LLM 的核心限制:上下文窗口(Context Window)。上下文窗口是模型在单次推理中能处理的最大文本长度,以 Token 为单位计量。Token 是模型处理文本的最小单元,一个英文单词通常对应 1-2 个 Token,中文字符通常每个字对应 1-2 个 Token。Claude 3.5 Sonnet 和 Claude 3 Opus 的上下文窗口为 200K Token,当对话累积超过这个限制时,早期信息会被截断。更重要的是,API 调用按 Token 数量计费(输入和输出分别计价),因此控制上下文长度直接关系到使用成本。这就是为什么上下文管理命令如此重要。

Memory:项目记忆文件管理

Claude Code 通过 .claude.md 记忆文件来持久化项目信息,相关操作命令如下:

  • /memory view:查看当前记忆文件内容
  • /memory edit:编辑记忆文件
  • /memory clear:清空记忆

在记忆文件中记录项目架构、编码规范、常用工具配置等信息,这些内容会自动注入到每次对话中,省去重复说明的时间。对于长期维护的项目,这是一个必须配置的功能。

从技术实现角度看,.claude.md 本质上是一种 System Prompt 工程化方案。在传统的 LLM 应用中,开发者通过 System Prompt 来设定模型的行为边界和背景知识,但这通常需要在每次 API 调用时手动注入。Claude Code 将这一过程自动化——记忆文件的内容会在每次会话启动时自动加载到上下文中。这类似于 Cursor 的 .cursorrules 或 GitHub Copilot 的 .github/copilot-instructions.md 文件。最佳实践是在记忆文件中记录:项目的技术栈和版本、目录结构约定、代码风格规范(如命名规则、注释要求)、常用的第三方库及其用法、以及团队特有的开发流程。

Compact:对话压缩利器

当对话超过 50 条消息时,上下文会变得臃肿,不仅消耗大量 Token,还可能导致模型「遗忘」早期的关键信息。/compact 命令可以压缩冗余对话,减少 30% 到 50% 的 Token 消耗。

更精细的用法是指定保留重点,例如:

/compact focus TypeScript 类型系统

这样压缩时会优先保留与 TypeScript 类型系统相关的上下文,丢弃不相关的对话内容。

Clear、Fork、Resume:会话流程控制

  • /clear:直接清空上下文,重新开始。适合话题完全切换的场景。
  • /fork:创建会话分支。当你需要尝试不同方案而不影响主线时非常有用——比如同时探索两种架构方案,互不干扰。
  • /resume:恢复之前中断的会话。意外断开或需要隔天继续时,这个命令能帮你无缝衔接。

代码审查与安全:三大防护命令

写代码只是第一步,审查和安全检查同样重要。Claude Code 内置了三个专门的命令来覆盖这个环节。

Diff:可视化代码变更

/diff 以彩色高亮的格式展示代码变更,支持分组展示添加、删除、修改的内容。更重要的是,它支持逐个审批或拒绝更改,让你对每一处修改都有完全的控制权。

Security Review:自动安全审查

/security review 会自动分析分支变更中的安全风险,覆盖的检查项包括:

  • SQL 注入漏洞
  • XSS 跨站脚本攻击
  • 密钥泄漏
  • 权限提升漏洞

这些检查项与 OWASP(开放式 Web 应用安全项目)Top 10 高度对应。OWASP Top 10 是全球公认的 Web 应用安全风险清单,是安全审计的行业标准。SQL 注入(Injection)长期位居榜首,攻击者通过在输入中嵌入恶意 SQL 语句来操纵数据库;XSS 允许攻击者在其他用户的浏览器中执行恶意脚本;密钥泄漏属于「安全配置错误」类别,常见于将 API Key、数据库密码等硬编码在源代码中并提交到版本控制系统;权限提升则属于「失效的访问控制」,攻击者通过绕过权限检查来访问未授权的资源。自动化安全审查虽然无法替代专业的渗透测试,但能在开发阶段捕获大部分常见漏洞。

在提交代码前跑一次安全审查,能有效避免将安全隐患带入生产环境。

Plan:计划模式

/plan 让 Claude 进入计划模式——它会先提出方案,等你确认后才执行。这对于删除文件、修改关键逻辑等敏感操作尤为重要。先看方案再动手,避免不可逆的误操作。

模型与性能控制:成本优化的关键

Claude Code 支持在不同模型之间切换,这是控制成本和效率的核心手段。

模型切换策略

使用 /model 命令(快捷键 Alt+P 或 Cmd+P)可以在两种模式之间切换:

维度Sonnet(快速模式)Opus(高性能模式)
速度⭐⭐⭐⭐⭐⭐⭐⭐
推理能力⭐⭐⭐⭐⭐⭐⭐⭐⭐
代码生成优秀最优秀
成本基准约 2-3 倍
推荐使用占比70%30%

核心原则:日常编码用 Sonnet,复杂推理和系统设计用 Opus。

Claude 3.5 Sonnet 和 Claude 3 Opus 代表了 Anthropic 模型家族中两种不同的设计哲学。Sonnet 是针对速度和成本优化的模型,参数规模相对较小,推理延迟低,适合高频次的日常编码任务如代码补全、简单重构、生成样板代码等。Opus 则是 Anthropic 的旗舰模型,拥有更大的参数规模和更强的推理链(Chain of Thought)能力,在需要多步逻辑推理、复杂系统设计、跨文件依赖分析等场景中表现显著优于 Sonnet。从定价来看,Opus 的输入价格为每百万 Token 15 美元,输出为 75 美元;Sonnet 的输入为 3 美元,输出为 15 美元。这种 5 倍的价格差异使得模型切换策略成为成本控制的核心手段。

此外,/fast 可以直接开关快速模式,/cost 查看 API Token 使用和成本明细,Pro 订阅用户还可以用 /stats 查看使用统计。合理组合这些命令,据实践经验可以节省 50% 到 70% 的成本,同时提升 3 到 5 倍效率。

键盘快捷键与权限模式

快捷键是提升操作速度的关键,以下是日常使用中必须掌握的几个。

基础操作快捷键

  • Ctrl+C:取消当前输入
  • Ctrl+D:退出会话
  • Ctrl+L:清屏但保留对话
  • ↑↓ 方向键:浏览命令历史
  • Tab:自动补全

权限模式切换

Shift+Tab 是最常用的快捷键之一,用于循环切换三种权限模式:

  1. Plan 模式:Claude 提出计划,需要你确认后才执行
  2. Auto 模式:Claude 自动执行,无需确认
  3. Normal 模式:纯对话,不执行代码

根据当前任务的风险等级灵活切换权限模式,是高效使用 Claude Code 的核心技巧。

CLI启动参数:灵活的启动方式

Claude Code 的 CLI 启动参数支持多种场景,以下是常用的启动命令:

# 基础启动
claude

# 在特定目录启动
claude --cwd /path/to/project

# 使用特定模型启动
claude --model opus

# 非交互模式(适合脚本调用)
claude -p "你的提示词"

# 继续上次会话
claude -c

# 恢复特定会话
claude --resume

# 在工作树中启动
claude -w

# 高级组合:继续会话 + Opus模型 + JSON输出
claude --continue --model opus --output-format json

非交互模式(-p 参数)特别适合集成到 CI/CD 流水线或自动化脚本中,让 Claude Code 成为工程化工具链的一部分。CI/CD(持续集成/持续部署)是现代软件工程中的核心实践,通过自动化的构建、测试、部署流程来保证代码质量和交付速度。常见的 CI/CD 平台包括 GitHub Actions、GitLab CI、Jenkins 等。通过非交互模式,你可以在 PR(Pull Request)创建时自动触发 Claude Code 进行代码审查、在合并前自动执行安全扫描、或者在部署前自动生成变更日志。配合 --output-format json 参数,输出可以被下游工具解析和处理,形成完整的自动化工具链。

-w 参数则利用了 Git Worktree(工作树)功能。Git Worktree 允许你在同一个仓库中同时检出多个分支到不同的目录,而不需要频繁切换分支或维护多个仓库副本。传统的 git checkout 切换分支时,工作目录中的文件会被替换,这意味着你无法同时在两个分支上工作。而 Git Worktree 为每个分支创建独立的工作目录,共享同一个 .git 数据库,既节省磁盘空间又支持并行开发。在 Claude Code 中使用工作树模式,意味着你可以让 AI 在一个独立的分支目录中进行开发,完全不影响你当前正在工作的主分支。

四个实战工作流

掌握了命令之后,关键是如何组合使用。以下是四个经过验证的高效工作流。

工作流一:快速原型开发

  1. 启动会话,切换到 Sonnet 快速探索
  2. 用 /plan 规划方案
  3. Shift+Tab 切到 Auto 模式执行
  4. 用 /diff 查看变更
  5. 用 /memory 记录关键决策

工作流二:代码审查与优化

  1. 用 Opus 模型启动(claude --model opus)
  2. /plan 规划审查方案
  3. /security review 执行安全审查
  4. /diff 查看变更详情
  5. 执行重构优化,生成测试用例

工作流三:长期项目维护

  1. 创建记忆文件,记录架构和规范
  2. 下次用 /resume 恢复会话
  3. 长对话后用 /compact 优化上下文
  4. 功能完成后提交代码

工作流四:团队协作开发

  1. 在工作树中开发新功能分支(claude -w)
  2. /plan 规划开发方案
  3. /security review 安全检查
  4. 审查通过后提交

三条核心建议

最后总结三条最重要的使用原则:

  1. 日常开发用 Sonnet,复杂任务用 Opus,长期项目必用 Memory。 这是成本和效率的最佳平衡点。
  2. 善用 Resume 保持高效上下文。 不要每次都从零开始,持续的上下文能让 Claude 越来越理解你的项目。
  3. 多用 Fork 安全尝试不同方案。 分支探索比在主线上反复撤销要高效得多。

掌握这套命令体系,你就能真正释放 Claude Code 的全部潜力,从「能用」进阶到「用好」。

#Claude Code命令#Claude Code教程#AI编程助手#Claude Code工作流#Claude Code快捷键#命令行编程工具#Claude Code上下文管理#AI代码审查
分享:

相关推荐