Claude Code 全攻略：命令大全 + 实战工作流（建议收藏）

Claude Code 全攻略命令大全 实战工作流建议收藏1. Claude 常用命令查看版本claude --version启动交互界面当前目录claude指定目录启动claude /path/to/project升级到最新版本claude update2. Claude Code 界面说明左下模式指示器Default / Accept Edits / Plan ModeShiftTab 切换模式1、Default默认模式 — 每次编辑文件或执行命令都需要你确认2、Auto-Accept自动接受模式 — 文件修改自动执行无需逐一确认但 shell 命令仍需确认3、Plan计划模式 — 只读模式Claude 只分析和规划不做任何修改等你审核计划后再执行 Skill-gallery、Claude Code 底部状态栏显示的不同状态1、默认模式2、自动接受模式3、计划模式对话中工具调用Claude 读文件、写文件、执行命令的详情嵌入在对话流中中间对话输入框自然语言输入需求支持Markdown可拖拽文件/图片底部快捷键提示CtrlC 中断· CtrlB 后台· ESC 返回/取消输入 ? 显示一些快捷键3. Claude 常用指令速查Claude Code 指令 / 快捷键参考指令 / 快捷键作用典型场景/compact压缩对话上下文保留核心摘要对话过长 token 超限时/clear清空所有对话历史全新开始切换到完全不同的任务时claude -c启动时恢复上一次对话次日继续昨天未完成的工作CtrlB将当前任务挂到后台运行让 AI 后台编译前台讨论下一步ESC×2(/rewind)回退或总结回滚 AI 操作AI 改错了代码快速撤销↓ / /tasks管理后台任务查看/停止检查后台编译/测试是否完成CtrlT显示/隐藏任务列表面板查看 Claude 创建的任务进度AltV粘贴图像Windows截图粘贴给 Claude 分析 UI/报错/memory打开并编辑 CLAUDE.md修改项目规则或个人偏好/init自动生成 CLAUDE.md 初稿新项目首次接入 Claude Code/hooks配置工具钩子自动化触发写文件后自动 prettier 格式化\Enter输入框内换行不发送消息输入多行代码或多段需求描述时ShiftTab循环切换三种工作模式从 Plan Mode 切到 Accept Edits 执行claude code 读取图片信息处理机制4. Claude Code 的命令行输入Claude Code 是 Anthropic 推出的终端 AI 编码助手在交互界面中通过 斜杠命令Slash Commands来控制 AI 助手的行为和上下文合理使用斜杠命令配合自然语言输入更加顺利完成开发操作。Calude Code 执行初始化命令在使用Claude Code的时候一般都会首先添加工作目录。这里一般通过一个斜杠/来表示输入指令。这里输入如下指令选定工作目录/add-dir 你的工作目录在创建工作目录后使用初始化工具对该目录下的项目进行初始化分析生成一份CLAUDE.md文档。这个文档的作用是建立上下文让Claude Code理解当前项目的目标和结构、设置代码风格和一些规则、设置Claude Code的角色。可以在进行初始化之后通过自然语言输入让其修改该初始化说明文档进而实现所需的设定在一个已完成的项目下通过/init完成项目分析的初始化4.1 /init – 初始化项目记忆指南定义与语法 /init 无参数。运行此命令会扫描当前项目代码库在项目根目录生成一个CLAUDE.md文件作为该项目的知识指南。CLAUDE.md通常包含项目结构摘要、主要模块说明、依赖列表等内容。使用场景 建议首次在新项目中使用 Claude Code时立即执行 /init。这样Claude会自动了解项目的大概结构和背景相当于给Claude这个AI同事一本项目手册。/init 生成的 CLAUDE.md 可由Claude根据代码自动提取要点你也可以在Claude的帮助下完善它——比如询问 “请列出项目架构的关键部分写入 CLAUDE.md” 等。完成后将 CLAUDE.md 保存甚至提交进仓库共享给团队。之后每次在该项目目录启动Claude Code它都会首先读取 CLAUDE.md拥有持久的项目信息。/init4.2 /help – 查看命令列表/help4.3 /clear – 清除对话历史/clear定义与语法 /clear 无参数。用于清除当前会话的对话历史使 Claude 忘记之前的所有对话内容。执行后相当于开启一个新会话但不会退出 Claude Code 界面。使用场景 当对话持续很久、上下文累积过多时可以使用 /clear 来重置上下文窗口保持思路清晰。例如在完成一个独立任务后开始新任务前执行 /clearClaude 将从空上下文开始理解你的下一指令。这在任务切换时非常有用可以避免旧话题干扰新需求。此外当Claude的回答出现偏离正轨或上下文混乱时/clear 可以一键“重启”对话。4.4 /compact – 压缩对话内容/compact定义与语法/compact [instructions]可选附加“指令”参数。此命令会将当前对话历史总结压缩并以该摘要作为新对话的开场上下文。可选的 instructions 参数允许你指定压缩时的侧重点例如 /compact 保留尚未解决的问题 会让 Claude 在总结时侧重未解决问题部分。使用场景 当会话长度接近模型上下文长度上限时/compact 是延续长对话的救星。Claude 会将已有对话自动总结为更短的内容从而释放大量上下文令牌供后续交流使用。这类似于有个 AI 秘书在会议途中帮你记录会议纪要确保你们不会因为对话太长而“忘记”前情。不过与 /clear 不同/compact 保留了上下文的精华——在新会话中Claude仍可以参考之前对话的摘要继续讨论。4.5 /memory – 编辑会话记忆文件/memory定义与语法 /memory 无参数。用于直接打开并编辑当前项目的持久记忆文件 CLAUDE.md或用户级别的全局记忆文件方便查看和修改 Claude 的“长期记忆”。你也可以通过这个命令向 CLAUDE.md 添加或移除内容。使用场景 CLAUDE.md 是 Claude Code 用于初始化上下文的指南文件通常包含项目简介、架构要点、代码惯例等。通过 /memory 命令你可以随时更新该文件的内容比如在初始化项目后发现 CLAUDE.md 漏掉了一些关键业务术语解释可以输入 /memory 打开文件在其中添加术语解释列表并保存。保存退出后可以 /clear 然后开始新会话Claude 将自动参照更新后的 CLAUDE.md 来回答问题减少对术语的误解。一般选择当前项目记忆简单理解就是Project memory 这个项目的专属规则/偏好User memory 你个人的全局习惯/偏好跨项目通用Auto-memory 让 Claude 自己决定什么值得记自动写入不用你手动管举几个典型场景Project memory项目记忆./CLAUDE.md适合写跟这个项目强绑定的内容这是一个 React TypeScript 项目使用 pnpm不要修改src/legacy/目录下的任何文件测试命令是pnpm test构建是pnpm buildAPI 接口统一放在src/api/不要分散User memory用户记忆~/.claude/CLAUDE.md适合写跟你个人习惯相关、所有项目通用的内容回复一律用中文代码注释保持简洁不要废话提交信息用英文格式feat: xxx不要主动帮我重构我没提到的代码Auto-memory自动记忆Claude 自己判断什么重要自动写入比如你在对话中说了我们公司规定所有接口要加错误边界处理——Claude 自动记下来这个项目不用写单元测试——自动记下来下次不再建议你写测试总结就是项目记忆管这个项目怎么做用户记忆管我这个人怎么工作自动记忆省去你手动整理的麻烦。4.6 /status – 会话状态检查/status定义与语法 /status 无参数。显示当前 Claude Code 会话和系统状态包括工作目录、登录账户、所用模型、加载的项目记忆等。这是一条只读命令不会更改任何设置。使用场景 当你需要确认当前环境时例如切换目录后不确定Claude是否跟随了新项目或刚切换模型后想验证当前模型名/status 可以立刻给出答案。它也是排查问题的起点如果Claude行为异常先看一下 /status 是否仍指向正确的路径和模型是否有正确加载 CLAUDE.md 等。4.7 /cost – 令牌与费用统计/cost定义与语法 /cost 无参数。用于显示当前会话的令牌使用量统计包括提示和回答分别用了多少 token以及预估的 API 消耗费用。这对掌控 Claude Code 的使用成本非常有帮助。使用场景 如果你使用按量计费的API密钥或免费额度随时关注对话的 token 消耗情况是个好习惯。执行 /cost 可以让你了解目前这场对话累计用了多少 token并据此估算花费。在长时间编程会话或密集代码生成功能中偶尔检查 /cost 有助于及时止损发现token飙升可以选择提问更具体、压缩上下文等节约开销。另外当你打算结束当天工作时可以用 /cost 获取会话用量总结核对是否在预算之内。4.8 /config – 查看或修改配置/config定义与语法 /config 可交互式查看和修改 Claude Code 配置参数。执行命令会显示配置菜单你可以根据提示修改设置例如启用/禁用自动压缩、设置主题、切换编辑模式等。部分配置也支持通过子命令直接设置比如 /config set autocompact off 等。使用场景 Claude Code 提供许多可定制选项通过 /config 你可以根据个人习惯进行调整。例如Autocompact自动压缩默认开启以防止上下文溢出通常建议保持开启待办事项to-do功能可以让Claude Code在长任务中列步骤你可在配置中启用/停用verbose输出用于调试可通过 /config 打开当需要看Claude内部推理步骤时很有用对应快捷键 CtrlR 切换verbose模式还有主题配色、通知方式如终端铃声提醒Claude完成思考、编辑模式等。总之/config 是你的个性化Claude控制面板。4.9 /model – 切换AI模型版本/model定义与语法 /model [model_name]。不带参数时通常会显示当前使用的模型并提示可选模型列表指定参数则可切换Claude所用的AI模型。Claude Code 常用的模型代号包括 Sonnet较快、上下文较短和 Opus较慢但能力更强、上下文长度更大等或具体版本如 claude-4-100k 等。使用场景 根据任务需要选择合适的模型能在速度和质量间取得平衡。默认情况下Claude Code启动用的是较快的模型。当你需要更深入的分析、更大的上下文或更高准确度时可以通过 /model opus 切换到能力更强的模型。例如复杂架构设计讨论、批量代码重构等场景Opus模型类似GPT-4之于GPT-3.5的角色会表现更佳。而在简单问答或需要快速响应的场景下继续使用Sonnet模型更高效。/model 让你动态调整AI助手的大脑以匹配任务要求。模型选项选项含义1. Default当前默认模型是qwen3-max-2026-01-232. Sonnet (1M context)均衡型性价比高适合日常编码3. Opus (1M context)最强模型适合复杂架构/难题但最慢最贵4. Haiku最快最便宜适合简单问答/快速任务价格$3/$15 per Mtok 输入输出15每百万 token底部两个设置项目含义◐ Medium effort思考力度← → 可调节分 low / medium / high越高越慢越费 token/fast快速模式仅 Opus 可用关闭深度思考速度更快一般怎么选日常写代码 →Sonnet复杂重构/架构设计 →Opus配合 Plan Mode 效果最好简单问题/快速查询 →Haiku4.10 /doctor – 环境健康检查/doctor定义与语法 /doctor 无参数。执行后Claude Code会检查当前安装环境的健康状态验证所需依赖和权限是否正确配置并报告潜在问题。使用场景 当Claude Code行为异常比如无法读取文件、工具调用总是失败等/doctor 是排查问题的第一步。它会自动检查Anthropic API连通性、已登录账户有效性、必需的依赖git、GitHub CLI、ripgrep等是否安装、Claude Code所需的文件权限是否授予等等。检查完后会输出一份报告指出哪些项目通过哪些存在问题。例如 “✘ 未检测到 GitHub CLI请安装以使用 PR 功能” 或 “当前Anthropic API凭据无效” 等。有了这些信息你可以据此修复环境然后重试之前的操作。5. Claude Code 进阶实战指南5.1 核心理念Claude Code 的真正价值不在于某个单一功能而在于将命令、模型、记忆、模式串联成流。开发者负责方向和判断Claude 负责执行和细节。5.2 一套完整的开发工作流以接手新项目并开发新功能为例展示如何从头到尾组合使用各项能力。第一步初始化项目认知进入项目目录后第一件事不是写代码而是让 Claude 先读懂项目。/init自动扫描代码库生成CLAUDE.md初稿包含技术栈、目录结构、常用命令等基础信息。生成后用/memory打开补充人工经验- 不要修改 src/legacy/ 目录 - 提交信息格式feat: / fix: / chore: - 测试命令pnpm test这份记忆会在之后每次对话自动加载省去反复交代背景的成本。第二步理解代码结构Plan Mode熟悉陌生代码库Plan Mode 是最安全的方式——只读不改专注理解。ShiftTab × 2 → 进入 Plan Mode然后自然语言提问分析 src/auth/ 模块的整体架构梳理用户登录的完整调用链Claude 会遍历相关文件、整理逻辑、输出结构图和说明全程不碰任何代码。遇到复杂架构时切换到 Opus 模型思考更深/model → 选择 Opus第三步规划新功能Plan Mode Opus理解现有代码后继续在 Plan Mode 里规划新功能不要急着切换到执行模式。我需要给登录模块加上 OAuth 支持请分析现有代码结构 制定一个改动最小、风险最低的实现方案Claude 输出计划后用CtrlG直接打开计划文件编辑删掉不需要的步骤、补充业务约束比对话描述修改精准得多。 这一步不要省。花 10 分钟确认计划能避免后面返工 1 小时。第四步分模块执行Auto-Accept 后台任务计划确认后切换到 Auto-Accept 模式开始执行ShiftTab × 1 → 进入 Auto-Accept 模式对于耗时操作跑测试、编译挂到后台CtrlB → 后台执行 CtrlT → 查看任务进度前台继续和 Claude 讨论下一个模块互不干扰。每完成一个独立模块及时/clear避免上下文污染下一个任务/clear对话变长但还没到切换模块的时机用/compact压缩而非清空/compact 保留 OAuth 登录相关的讨论和决策第五步性能分析与优化功能开发完成后切回 Plan Mode让 Claude 做一轮审视ShiftTab × 2 → Plan Mode 分析刚才新增的代码找出潜在的性能问题和安全隐患不要修改只给报告确认问题后再切换到执行模式针对性优化。这样比边写边优化更清晰也不容易引入新问题。第六步收尾与记忆沉淀开发完成后用/memory把这次积累的项目经验写进 CLAUDE.md- OAuth 相关逻辑统一在 src/auth/oauth/ 下 - 新增第三方登录时参考 GoogleOAuthProvider 的实现模式下一个功能开发、或者团队其他人接手时这些经验直接生效。5.3 模式与模型的选用原则阶段模式模型读代码 / 规划Plan ModeOpus日常编码DefaultSonnet重复性修改Auto-AcceptSonnet / Haiku快速问答DefaultHaiku5.4 一句话总结Plan Mode 想清楚 → Auto-Accept 执行 → /compact 或 /clear 管理上下文 → /memory 沉淀经验把这条主线跑顺Claude Code 才算真正用起来了。