用好CC，事半功倍！Claude Code 命令大全分享

使用 Claude Code 有很长一段时间了从 25 年初接触 Cursor再到后来的 Windsurf、再到 Claude Code、Codex和 CC 也算是老朋友了。真心想说工具简单使用和真正会用之间差距特别大。只有把工具吃透、用得熟练精通才能真正事半功倍。这段时间我从入门摸索到吃透全部命令期间踩过不少坑也沉淀了很多实操经验。今天整理分享一波 Claude Code 常用命令和工程配置不管是新手还是老玩家都值得认真读一读、收藏起来慢慢用把这个工具真正用好、用精做事真的真的真的能巨提效。ps这篇更像一份 Claude Code 实战手册建议先收藏后面配置项目、排查问题、实践指南、踩坑、查命令时可以直接翻。全文主要分四块命令大全CLI 命令、斜杠命令、快捷键、多模型配置、CLAUDE.md、Hooks。高频黄金命令精选我个人认为最实用的命令重点讲怎么用。踩坑记录我踩过的坑你不用再踩。最佳实践把命令串成工程工作流适合直接照着用。另外Claude Code 不建议一直“裸用”。命令、配置、Hooks 是基础后面真正拉开差距的是Skills MCP生态。本文基于cc 2.1.131 (Claude Code)编写和演示。Claude Code 更新很快如果你本地看到的命令和截图略有差异优先以你当前版本的/help、claude --help和实际终端输出为准。先搞懂Claude Code 到底能干啥一句话Claude Code 是 Anthropic 出的终端 AI 编程助手不是代码补全插件而是任务驱动型代理——你说目标它自己规划步骤、读代码、跑命令、改文件。能力维度具体表现代码生成实时生成、解释、优化代码支持 Python/JS/Java/Go 等命令执行直接跑 Shell 命令、操作 Git、执行测试文件操作读写项目文件、批量修改、目录管理外部集成MCP 协议扩展连接数据库、浏览器、第三方工具自然语言说人话就行不用记语法实测感受它不是帮你补全代码的是帮你干活的。你说帮我重构这个模块它自己去看代码、规划方案、动手改、跑测试全程你只需要确认。第一部分命令大全一、CLI 命令终端直接执行1.1 安装与更新由于我已经安装了这里就不做安装演示了只给个更新演示1.2 登录认证注意以上登录方式适合有 Claude 官方账号的用户但是目前这情况。。你懂得。。。so , 大部分伙伴可能用的是国内其他模型往下看 1.2.1 第三方模型配置这里我以智谱为例方式一环境变量配置方式二配置文件推荐编辑~/.claude/settings.json其他国内模型配置在其官网都有示例。这里给几个链接直接跳过去就能看到接入 CC 的示例小米platform.xiaomimimo.com/docs/zh-CN/…DeepSeekapi-docs.deepseek.com/zh-cn/quick…Kimiplatform.kimi.com/docs/guide/…MiniMaxplatform.minimaxi.com/docs/token-…1.3 启动方式命令用途说明claude启动交互式会话最基础的启动方式claude 帮我分析这个项目带初始提示启动直接进入对话claude -p 解释这个函数非交互模式print mode执行完就退出适合脚本claude -c继续上次会话接着上次的对话继续claude -r展开最近会话列表注意 -r 是 --resume 的短写claude --resume 和 claude -r 等效都会打开可恢复会话列表。claude -r auth-refactor恢复指定会话按会话 ID 或名称恢复claude -n 我的新功能给会话命名当然你也可以在会话内使用/rename xxx这样重命名会话演示如下实测感受claude -r是我用得最多的命令这个可以直接回车选择进入你想要恢复的上下文很方便。1.4 管道模式实测感受管道模式适用于那种一次性任务我个人用的不算多。1.5 其他 CLI 子命令二、斜杠命令大全/ 开头交互模式内用这是 Claude Code 最核心的部分55 个斜杠命令我按场景分类整理。注意下面基于 cc 2.1.131 整理。部分命令依赖版本、订阅计划、平台能力、GitHub CLI、Claude Code on the web 或特定功能开关。如果你本地没有某个命令先用/help看当前环境实际支持情况。2.1 会话管理最高频命令别名用途说明/clear/reset, /new清空上下文开始全新会话/compact [focus]-压缩上下文释放空间可指定保留重点/continue/resume恢复历史会话/rename [name]-重命名当前会话/export [filename]-导出会话为纯文本/rewind/checkpoint, /undo回退到之前的对话/代码点有以下三个可选模式Restore conversation恢复会话 → 直接倒带撤回回到你发「给我分析整个 im 项目」之前的空白对话状态重新提问。Summarize from here从这里开始总结 → 不回退直接从当前位置把后面所有对话帮你精简概括一遍。Never mind算了、取消 → 不做任何回退保持现在对话不变。/branch [name]/fork在当前点创建对话分支/exit/quit退出 CLI2.2 规划与执行效率翻倍命令用途说明/plan [description]进入计划模式先分析再执行省 token 省心非常好用/batch instruction大规模并行代码变更自动创建 worktree 并行执行注意这个命令必须得在git仓库下执行/loop [interval] prompt定时循环执行闭环调试直到成功/plan 大任务、复杂任务一定记得先 plan。这属于基操先把方案想清楚再动代码后面会省很多回滚成本。/batch 这个命令特点是快、暴力、适合大批量重复修改由于我这没这种场景所以不演示了。/loop 这个适合那种难缠的bug或者定时代码review 之类的适合调试 / 修复。实测感受/loop是真正的神器举个例子你让 Claude 修一个 bug它改完跑测试发现还有错再改再跑直到全部通过。这就是闭环调试不用你手动反复催它实测感受大改动之前一定先/plan让它分析完出个方案你确认了再动手。省得它一顿乱改你还得一个个回退2.3 代码审查命令用途/review [PR]本地审查 PR/ultrareview [PR]多 agent 深度代码审查云沙盒/autofix-pr [prompt]自动修复 PR CI 失败/simplify [focus]审查代码质量并优化/diff查看未提交的文件变更/security-review分析当前分支安全漏洞注意/ultrareview、/autofix-pr这类命令更依赖账号计划、GitHub CLI、仓库权限和远程执行环境。建议在正文截图里展示你的实际可用状态读者照着做时更不容易误解。2.4 模型与配置命令用途/model [model]切换模型sonnet/opus/haiku/effort [level]设置推理深度low/medium/high/xhigh/max/fast [on|off]切换 fast mode仅 Opus/config打开设置界面别名/settings/output-style [style]切换输出风格比如 default、explanatory、learning/statusline配置状态栏显示模型、目录、分支等信息/theme更改颜色主题/context可视化当前上下文使用情况 很有用实测感受/context一定要学会用它会用彩色方格展示上下文占用率。低于 70% 正常用70%-85% 考虑/compact超过 85% 幻觉风险飙升赶紧压缩或新开会话2.5 权限与安全命令用途/permissions管理工具权限规则别名/allowed-tools/sandbox切换沙盒模式/security-review安全漏洞分析/privacy-settings查看/更新隐私设置权限这里不要只会一路allow。更推荐按风险分层allow确定安全的读文件、搜索、测试命令可以直接放行。ask删除文件、数据库写入、部署、改生产配置每次都确认。deny密钥、.env、生产凭证、危险删除命令直接禁止。2.6 MCP 与插件命令用途/mcp管理 MCP 服务器连接和 OAuth 认证/plugin管理插件/reload-plugins重载所有活跃插件2.7 Agent 与任务命令用途/agents管理/创建/配置 agent/tasks列出/管理后台任务别名/bashesagents这个很有用 尤其是大型项目多任务分工明确时 创建几个不同角色的agents 会更加得心应手。 当然claude 本身就内置了些一般情况下也够用了 内置如下我这里演示创建个代码审查的agents2.8 信息与帮助命令用途/help显示帮助和所有可用命令/usage费用/限额/活动统计别名/cost, /stats/status版本/模型/账号/连接状态/doctor诊断和验证安装/recap当前会话一行摘要高频使用/insights生成会话分析报告/release-notes查看更新日志这部分一般只是查看不做过多演示2.9 其他实用命令这部分命令版本差异会更明显尤其是/schedule、/stickers、/heapdump这类偏平台能力或诊断能力的命令。如果你本地没有还是以/help输出为准。命令用途/init初始化项目 CLAUDE.md/memory编辑 CLAUDE.md 内存文件/add-dir [path]给当前会话添加额外工作目录/terminal-setup配置终端快捷键常用于 ShiftEnter 换行/vim开关 Vim 输入模式/voice [hold|tap|off]切换语音输入/schedule [description]创建定时任务别名/routines/feedback [report]提交反馈别名/bug/btw question旁路提问不影响主对话上下文很实用/copy [N]复制最后 N 个回复到剪贴板/debug [description]启用调试日志/hooks查看 hook 配置/keybindings打开/创建快捷键配置/heapdump写 JS 堆快照诊断内存问题/stickers订购贴纸对Claude 还能买贴纸 实测感受/btw被严重低估了有时候你正在改代码突然想问个不相关的问题或者想对刚才的指令补一句旁路说明用/btw就不会污染当前上下文也不用中断主会话非常 nice。IM 项目小技巧如果你在xzll-im-server里启动 Claude但这次改动还要看 Flutter SDK可以直接/add-dir ../xzll-im-flutter-sdk不用退出重开。三、CLI 参数大全-- 开头CLI 参数是在终端启动 Claude Code 时传入的控制各种行为。小提醒CLI 参数分两类一类是交互式会话也能用一类只在 print modeclaude -p里生效。下面我会把容易踩坑的地方标出来。3.1 模型与输出控制参数用途适用范围演示命令--model设置模型交互 /print modeclaude --model glm-5.1--effort推理深度交互 /print modeclaude --effort high--output-format输出格式仅 print modeclaude -p --output-format json 分析代码--fallback-model过载时回退模型仅 print modeclaude -p --fallback-model glm-4-flash 分析代码--json-schemaJSON Schema 验证输出仅 print modeclaude -p --json-schema {type:object} 分析代码3.2 会话管理参数用途演示命令--continue, -c继续最近会话claude -c--resume, -r恢复指定会话claude -r 会话ID--name, -n会话命名claude -n IM项目开发会话--fork-session恢复时创建新会话 IDclaude -c --fork-session--session-id指定 UUID 作为会话 IDclaude --session-id 123e4567-e89b-12d3-a456-426614174000--no-session-persistence禁用会话持久化仅 print modeclaude -p --no-session-persistence 分析代码3.3 权限与安全参数用途演示命令--permission-mode权限模式claude --permission-mode auto--dangerously-skip-permissions跳过所有权限提示裸奔模式爽但风险高claude --dangerously-skip-permissions--allowedTools设置免确认执行的工具claude --allowedTools filesystem,edit--disallowedTools移除指定工具claude --disallowedTools shell3.4 系统提示定制参数用途演示命令--system-prompt替换整个系统提示claude --system-prompt 你是Java/Flutter专家--system-prompt-file从文件加载替换系统提示claude --system-prompt-file ./prompt.txt--append-system-prompt追加自定义文本到系统提示claude --append-system-prompt 专注IM即时通讯项目--append-system-prompt-file从文件加载追加系统提示claude --append-system-prompt-file ./append.txt3.5 MCP 与插件参数用途演示命令--mcp-config从 JSON 文件加载 MCP 服务器claude --mcp-config ~/.claude/mcp.json--strict-mcp-config仅使用指定的 MCPclaude --strict-mcp-config --mcp-config ./custom-mcp.json--plugin-dir指定插件目录claude --plugin-dir ~/.claude/plugins3.6 调试与开发参数用途演示命令--debug启用调试模式claude --debug--debug-file调试日志写入文件claude --debug --debug-file ./debug.log--verbose详细日志claude --verbose--bare最小模式禁用扩展claude --bare3.7 工作区参数用途演示命令--add-dir添加额外工作目录claude --add-dir ~/dosomething/im/xzll-im-flutter-client--worktree, -w隔离 git worktree 启动claude -w--tmux为 worktree 创建 tmux 会话claude -w --tmux3.8 花费控制参数用途演示命令--max-budget-usdAPI 最大花费限制仅 print modeclaude -p --max-budget-usd 0.1 分析代码--max-turns限制 agent 轮次仅 print modeclaude -p --max-turns 5 分析代码3.9 其他实用参数参数用途演示命令--remote创建远程 web 会话claude --remote --name IM远程协作--teleport恢复 web 会话到本地claude --teleport--init运行初始化钩子仅 print modeclaude -p --init--chrome启用 Chrome 集成claude --chrome--ide自动连接 IDEclaude --ide四、快捷键速查表4.1 通用控制快捷键用途CtrlC取消当前输入/生成CtrlD退出 Claude CodeCtrlO切换 transcript 查看器CtrlR反向搜索命令历史CtrlV粘贴剪贴板图片CtrlB后台运行任务CtrlT切换任务列表CtrlX CtrlK杀死所有后台 agentEscEsc回退/摘要ShiftTab循环切换权限模式OptionP切换模型OptionT切换扩展思考OptionO切换 fast mode?显示当前环境可用快捷键4.2 特殊前缀前缀用途示例/命令或 skill/help/model opus!Shell 模式直接执行 shell 命令!git status文件路径自动补全xzll-im-server/im-business/#快速添加到 CLAUDE.md 内存# 使用 2 空格缩进实测感受!前缀太方便了有时候就想跑个命令看个结果不用退出 Claude 再开终端直接!git status就行演示 # 演示 使用 指定某个文件进行分析在某些场景下非常有用4.3 深度思考触发词ultrathink 重要复杂任务必用在提示词中加入特定关键词触发 Claude 的深度思考模式ultrathink不是斜杠命令而是一个提示词关键词。它适合放在复杂架构设计、疑难 bug 排查、关键方案评审这类需要深度推理的任务里。这是我在复杂任务里很常用的一个关键词。实测感受复杂任务里加上ultrathinkClaude 的分析会明显更细但 token 消耗也会增加。小问题没必要每次都加。4.4 三种交互模式详解通过ShiftTab循环切换模式切换方式特点适用场景Interactive默认每步需确认重要修改、生产环境Auto-acceptShiftTab 一次AI 自动执行简单任务、批量操作PlanShiftTab 两次只规划不改代码复杂任务前期规划实测感受新手建议用 Interactive熟悉后再切 Auto-accept。Plan 模式适合大改动先出方案你看满意再执行。五、配置文件体系5.1 配置文件层级优先级从高到低这块如果只看表格很容易觉得“知道了路径”但真正用的时候还是会懵。你可以把它理解成一句话越靠近当前项目、越临时的配置优先级越高。下面这个表说的是个人开发者最常接触到的配置层级如果公司用了企业托管策略那种 managed policy 会更高。文件作用域说明CLI 参数当前这一次启动/当前会话最高优先级适合临时覆盖.claude/settings.local.json当前项目 只对你自己生效通常会被 gitignore适合放个人模型、token、本地路径.claude/settings.json当前项目 团队共享可以提交到 Git适合放团队统一规则~/.claude/settings.json用户全局所有项目默认生效适合放通用默认配置举个最常见的例子你全局设置了model: glm-5.1但 IM Flutter 客户端项目里.claude/settings.local.json设置了model: kimi-k2.5。那么你在 Flutter 客户端目录启动claude时最终用的是kimi-k2.5。实际工程里我建议这么分放哪里适合放什么不适合放什么~/.claude/settings.json默认模型、通用权限、通用 hooks、全局 MCP某个项目专属规则.claude/settings.json团队共享权限、项目 MCP、项目 hooks、推荐模型token、个人路径、本机数据库.claude/settings.local.json个人模型选择、本地路径、个人 token、个人权限偏好团队必须遵守的规则CLI 参数临时模型、临时目录、临时 debug长期固定配置拿 IM 项目举例注意/Users/hzz/dosomething/im这个目录在我本机更像一个 IM 工作区不一定本身就是 Git 仓库。所以这里的.claude/settings.json是否“团队共享”取决于你有没有把它放到真正要提交的仓库里。真实 token 一律只放settings.local.json不要放settings.json。如果只是临时这一次想切模型不要改配置文件直接用 CLI或者进会话后用实测建议能提交给团队的放.claude/settings.json只和你自己机器有关的放.claude/settings.local.json只用一次的用 CLI 参数或斜杠命令。5.2 项目记忆 vs 全局记忆到底该写哪里文件作用域说明~/.claude/CLAUDE.md用户全局所有项目生效CLAUDE.md或.claude/CLAUDE.md项目项目级配置CLAUDE.local.md本地项目gitignored个人偏好这块我建议一定要认真用起来。Claude Code 好不好用很多时候不取决于模型多强而取决于你有没有把稳定规则沉淀到记忆里。我的理解是类型放什么不放什么全局记忆~/.claude/CLAUDE.md你所有项目都通用的个人习惯某个项目的业务规则项目记忆CLAUDE.md团队共享的项目规则、架构说明、常用命令个人 token、个人路径、临时想法本地项目记忆CLAUDE.local.md只对你自己生效的项目偏好团队必须遵守的规则全局记忆适合写本地记忆适合写实测建议CLAUDE.md写“稳定、长期、团队共享”的信息临时需求不要乱塞进去。否则记忆越写越多反而会把 Claude 带偏。快速补充记忆可以用5.3 不同项目使用不同模型IM 服务端用 BFlutter 客户端用 D这个需求很常见。比如IM 服务端逻辑复杂希望默认用glm-5.1Flutter 客户端偏 UI 和小改动希望默认用更快/更便宜的模型临时做架构设计或疑难 bug再手动切到更强模型推荐做法是全局配置放通用默认值项目配置覆盖项目差异。配置优先级前面已经说过CLI 参数 .claude/settings.local.json.claude/settings.json~/.claude/settings.json。所以如果只是你自己用最推荐把项目模型写到项目根目录/.claude/settings.local.json。像 IM 这种 mono repo更要注意你是从哪个目录启动claude在工作区根目录启动就读取根目录配置在xzll-im-server或xzll-im-flutter-client启动就优先读取对应子项目配置。比如我的全局配置可以这样放在~/.claude/settings.json作为所有项目的默认模型和安全规则IM 工作区根目录可以放团队共享配置/Users/hzz/dosomething/im/.claude/settings.json如果只是我自己在 IM 项目里想默认用某个模型就放本地配置/Users/hzz/dosomething/im/.claude/settings.local.json这里有个非常关键的点只写model够不够取决于这两个模型是不是走同一个ANTHROPIC_BASE_URL和同一套 token。情况一同一个服务商只是换模型名如果服务端和 Flutter 客户端都走同一个网关比如都走智谱的https://open.bigmodel.cn/api/anthropic全局已经配置好了ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN那子项目里只写model就够了。服务端/Users/hzz/dosomething/im/xzll-im-server/.claude/settings.local.jsonFlutter 客户端/Users/hzz/dosomething/im/xzll-im-flutter-client/.claude/settings.local.json这样你在xzll-im-server启动claude默认走服务端模型在xzll-im-flutter-client启动claude默认走 Flutter 客户端模型。它们共用全局的 URL 和 token只是覆盖了当前项目的默认模型。情况二不同服务商必须同时配置 URL、token 和模型如果服务端用智谱Flutter 客户端用 Kimi那就不能只写因为它会继承全局的ANTHROPIC_BASE_URL。如果你的全局 URL 是智谱但模型写成 Kimi就很容易出现Model not found、认证失败、请求格式不兼容等问题。这时 Flutter 客户端项目的.claude/settings.local.json应该把这一套都覆盖掉服务端继续用智谱就在服务端子项目里写完整的智谱配置我的建议是同一服务商换模型子项目只写model可以。不同服务商切换子项目写完整env model。不要把真实 token 提交到 Git这些配置放.claude/settings.local.json不要放.claude/settings.json。不确定有没有继承冲突用/status看当前模型和连接状态。如果是团队统一要求某个项目使用某个模型可以写到.claude/settings.json并提交到 Git。但注意token、个人路径、本地数据库地址不要提交这些应该放.claude/settings.local.json或系统环境变量里。临时切换模型用/model或 CLI 参数就行交互模式里也可以在会话内配合 ultrathink 使用e我的建议是长期默认写进项目.claude/settings.local.json团队统一写进项目.claude/settings.json只跑这一次用claude --model xxx当前会话临时切换用/model xxx5.3.1 推荐进阶玩法写启动脚本一键切换模型 Profile还有一种很方便的方式也是我个人推荐的方式不改 settings 文件而是写几个启动脚本通过环境变量指定模型和服务商。这个适合经常在多个模型之间切换。比如cc-glm用智谱 GLM 启动 Claude Codecc-kimi用 Kimi 启动 Claude Codecc-im-server进入 IM 服务端目录并使用服务端模型cc-im-flutter进入 Flutter 客户端目录并使用 Flutter 模型先准备一个专门放本地脚本的目录如果你的~/bin还没加入 PATH可以加到~/.zshrc加入这一行然后让配置生效示例一创建智谱启动脚本~/bin/cc-glm粘贴下面内容保存退出后给它加执行权限以后直接这样启动示例二创建 Kimi 启动脚本~/bin/cc-kimi粘贴下面内容保存退出后给它加执行权限之后就可以这样启动如果想进一步贴合 IM 项目可以写项目专用脚本。比如创建cc-im-server粘贴下面内容加执行权限以后直接这样用同理再写一个cc-im-flutter进入xzll-im-flutter-client并切到 Kimi。这种方式的好处是切模型非常快不用手动改配置文件不同服务商的 URL/token 不会互相污染可以和-r、--add-dir、--debug等参数组合适合自己本机使用不影响团队项目配置注意两点脚本里有 token不要放进项目 Git 仓库。如果脚本和 settings 都配置了模型以脚本启动时传入的环境变量和 CLI 参数优先。这是我的快捷启动脚本演示5.4 其他重要文件文件用途~/.claude.json用户级 MCP 服务器配置.mcp.json项目级 MCP 服务器配置~/.claude/agents/用户全局子 agent 配置.claude/agents/项目子 agent 配置.claude/skills/SKILL.md项目 skills十七条最佳实践最后再总结一下我自己的使用习惯。命令只是工具真正决定效果的还是工作流。新项目先/init先让 Claude 了解项目结构、技术栈、测试命令和开发约定。长期规则写进/memory或CLAUDE.md全局、项目、本地三层记忆分清楚不要每次重复解释。按任务选择模型服务端复杂逻辑用 GLMFlutter 轻量任务用 Kimi关键方案再配合ultrathink。不同项目单独配置模型常用项目把默认模型写进.claude/settings.local.json不要每次手动/model。高频模型切换写成脚本cc-glm、cc-kimi、cc-im-server、cc-im-flutter比手动 export 更稳。多目录项目用/add-dir或additionalDirectoriesIM 这种服务端、客户端、SDK 分目录的项目别让 Claude 只看一个目录。状态栏用/statusline配好显示当前目录、分支、模型多项目多模型切换时不容易搞错。输出风格用/output-style控制日常开发用 default学习源码或写教程时再切 explanatory。复杂任务先/plan关键问题加ultrathink重构、迁移、架构调整、疑难 bug都先想清楚再动手。用精准引用文件和目录输入越明确AI 越不容易乱猜。每轮关键改动后都看/diff及时发现无关修改、误删文件和方向跑偏。发现方向错了及时/rewind不要在错误改动上反复补丁回到正确位置重新来更省时间。用!跑验证命令改完就跑测试、lint、build不要只相信 AI 口头说“应该可以”。用/context管理上下文健康70% 以后开始警惕85% 以后尽快处理。压缩前先/recap压缩时再/compact先确认主线再释放上下文重要结论写进文件。临时旁路问题用/btw不相关的提问、补充和解释放旁路别把主线任务聊散。权限默认保守用/permissions精细放行删除、部署、数据库、生产环境相关命令尤其要谨慎自动化任务再用claude -p。写在最后Claude Code 真正厉害的地方不是它有多少命令而是它能把“理解项目 → 制定方案 → 修改代码 → 运行验证 → 复盘改动”这一整条链路串起来。新手最容易犯的错误是把 Claude Code 当成一个更聪明的聊天窗口想到什么问什么改坏了再补救。更稳的方式是把它当成一个会执行任务的工程搭档先给上下文再让它计划改完看 diff跑完验证最后把重要结论沉淀下来。如果只记一套最小工作流我建议是项目记忆/模型配置 → /init → 指定文件 → /plan ultrathink → 执行修改 → /diff → 必要时 /rewind → !跑测试 → /review → /recap 或 /compact把这套流程用顺之后Claude Code 基本就不只是“能用”而是能真正融入你的日常开发节奏了。如果你觉得这篇文章对你有帮助欢迎来个点赞、收藏、评论三连。Claude Code 更新很快后面命令、配置、模型接入方式肯定还会继续变化收藏起来方便随时查。资料展示下面是我整理的AI大模型学习资料和工具包预览适合收藏后按主题逐步学习