前言

用 Claude Code 有一阵子了。从年初接触 Cursor，再辗转到 Windsurf、Claude Code、Codex，和 CC 也算得上老朋友了。

真心话说一句：工具拿来简单用用，和真正把它用透，中间的差距不是一星半点。只有吃透了、用熟了，才能让效率真正翻倍。从最初的摸索，到后来吃透全部命令，期间踩过的坑不少，但沉淀下来的实战经验也不少。

今天就把 Claude Code 的常用命令和工程配置梳理一版。不论你是刚入门的新手，还是已经上手的老玩家，都值得认真看看，收藏起来慢慢用。把这个工具用好、用精，工作效率的提升真的立竿见影。

全篇主要分成四个部分：

1. 命令大全：CLI 命令、斜杠命令、快捷键、多模型配置、CLAUDE.md、Hooks，一应俱全。
2. 高频黄金命令：精选最实用的那十几个，重点讲清楚怎么用。
3. 踩坑记录：真实踩过的坑，直接告诉你，就不用再走一遍。
4. 最佳实践：把命令串成工程工作流，适合拿来直接套用。

另外，Claude Code 不建议一直“裸用”。命令、配置、Hooks 只是基础，真正拉开差距的，是 Skills 和 MCP 生态。之前写过一篇专门讲 Skills 和 MCP 的实战文章，建议配合本篇一起看。

所有命令都经过终端验证，多数配了插图，不存在编造或臆想的情况。后面用到时，直接回来翻就行。

先搞懂：Claude Code 到底能干啥？

一句话概括：Claude Code 是 Anthropic 推出的终端 AI 编程助手。它不是代码补全插件，而是一个任务驱动型袋里。你只需要说出目标，它自己就会规划步骤、读代码、跑命令、改文件。

第一部分：命令大全

一、CLI 命令（终端直接执行）

1.1 安装与更新

# npm 全局安装（最常用）npm install -g @anthropic-ai/claude-code# 原生二进制安装claude install stable # 安装稳定版claude install latest # 安装最新版claude install 2.1.92 # 安装指定版本# 一键安装（省心省力）：curl -fsSL https://claude.ai/install.sh | bash# 更新claude update# 查看版本claude -v

由于已经安装了，安装过程就不演示了，只放个更新演示的截图。

1.2 登录认证

# 登录（浏览器OAuth，Pro/Max用户）claude auth login# 用 API Key 登录（Console 用户）claude auth login --console# 企业 SSO 登录claude auth login --sso# 查看登录状态claude auth status # JSON 格式claude auth status --text # 人类可读格式# 登出claude auth logout

1.2.1 第三方模型配置（以智谱为例）

方式一：环境变量配置

# 智谱 GLMexport CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1" export API_TIMEOUT_MS="3000000" export ANTHROPIC_AUTH_TOKEN="xxxxxxxxxxxxx" export ANTHROPIC_BASE_URL="https://open.bigmodel.cn/api/anthropic" export ANTHROPIC_DEFAULT_HAIKU_MODEL="glm-5.1" export ANTHROPIC_DEFAULT_SONNET_MODEL="glm-5.1" export ANTHROPIC_DEFAULT_OPUS_MODEL="glm-5.1"

方式二：配置文件（推荐）

编辑 ~/.claude/settings.json：

{"env": {"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1","API_TIMEOUT_MS": "3000000","ANTHROPIC_AUTH_TOKEN": "xxxxxxxxxxxxx","ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic","ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-5.1","ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5.1","ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.1"}}

其他国内模型如 DeepSeek、Kimi、MiniMax 等，在其官方文档中都有接入示例，直接跳过去看就行。

1.3 启动方式

演示部分直接看截图。

1.4 管道模式

# 分析文件cat xzll-im-server/im-business/pom.xml | claude -p "分析这个模块的依赖和潜在问题"# 分析 git diffgit diff HEAD~3 | claude -p "总结这些改动"# 分析日志cat error.log | claude -p "分析这个错误日志，找出根因"# 分析多个文件cat xzll-im-server/im-common/src/main/proto/*.proto | claude -p "找出所有 TODO 注释"

1.5 其他 CLI 子命令

# MCP 配置claude mcp add  --  # 添加 MCP 服务器claude mcp list # 列出已配置的 MCPclaude mcp remove  # 移除 MCP 服务器# 插件管理claude plugin install  # 安装插件claude plugin list # 列出插件# 远程控制（需订阅正版 Claude Code）claude remote-control --name "My Project"# CI/CD 用的长期 Tokenclaude setup-token# 非交互式超级代码审查（需订阅正版 Claude Code）claude ultrareview --json# 健康检查claude doctor

二、斜杠命令大全（/ 开头，交互模式内用）

这是 Claude Code 最核心的部分，55+ 个斜杠命令，按场景分类整理。

2.1 会话管理（最高频）

2.2 规划与执行（效率翻倍）

/plan 是对付大任务、复杂任务的利器。先把方案想清楚，再动代码，后面能省很多回滚成本。
/batch 的特点：快、暴力、适合大批量重复修改。
/loop 适合难缠的 bug 或定时代码 review。

2.3 代码审查

2.4 模型与配置

2.5 权限与安全

权限这里，更推荐按风险分层：

• allow：确定安全的读文件、搜索、测试命令。
• ask：删除文件、数据库写入、部署、改生产配置，每次都确认。
• deny：密钥、.env、生产凭证、危险删除命令。

2.6 MCP 与插件

2.7 Agent 与任务

agents 很有用，尤其在大型项目多任务分工明确时，创建几个不同角色的 agents 会非常顺手。Claude 本身也内置了一些，一般情况下够用了。

Built-in (always a vailable):claude-code-guide · haiku：代码规范指南助手Explore · haiku：项目探索分析助手general-purpose · inherit：通用万能助手Plan · inherit：规划专用助手statusline-setup · sonnet：界面配置助手

2.8 信息与帮助

2.9 其他实用命令

这部分命令版本差异会更明显，特别是 /schedule、/stickers、/heapdump 这类偏平台或诊断能力的。如果本地没有，还是以 /help 输出为准。

三、CLI 参数大全（-- 开头）

CLI 参数是在终端启动 Claude Code 时传入的，用于控制各种行为。

3.1 模型与输出控制

3.2 会话管理

3.3 权限与安全

3.4 系统提示定制

3.5 MCP 与插件

3.6 调试与开发

3.7 工作区

3.8 花费控制

3.9 其他实用参数

四、快捷键速查表

4.1 通用控制

4.2 特殊前缀

4.3 深度思考触发词：ultrathink （重要！复杂任务必用）

在提示词中加入特定关键词，触发 Claude 的深度思考模式：

# 超深度思考（最详细）ultrathink 分析这段代码的所有潜在问题

ultrathink 不是斜杠命令，而是一个提示词关键词。适合放在复杂架构设计、疑难 bug 排查、关键方案评审这类需要深度推理的任务里。

4.4 三种交互模式详解

通过 Shift+Tab 循环切换：

五、配置文件体系

5.1 配置文件层级（优先级从高到低）

越靠近当前项目、越临时的配置，优先级越高。下面这个表说的是个人开发者最常接触到的配置层级。

实际工程里建议这么分：

注意：真实 token 只放 settings.local.json。临时切换模型直接用 claude --model xxx 或交互模式里的 /model xxx。

5.2 项目记忆 vs 全局记忆：到底该写哪里？

全局记忆适合写：通用偏好，如回答语言、改代码前先说明计划、危险命令必须确认。

项目记忆适合写：项目技术栈、目录结构、测试命令、业务边界、团队约定。

临时项目记忆适合写：只跟本机有关的信息，如本地数据库地址、个人脚本路径。

5.3 不同项目使用不同模型

推荐做法：全局配置放通用默认值，项目配置覆盖差异。例如全局配置默认模型为 GLM，在 Flutter 客户端项目的 .claude/settings.local.json 中覆盖模型为 Kimi。

如果是团队统一要求，可写到 .claude/settings.json 并提交 Git；如果是个人偏好或临时切换，用 claude --model xxx 或 /model xxx。

5.4 其他重要文件

5.5 关键配置项

下面是一份个人本地配置示例。注意：真实 token 不要提交到 Git。

{"env": { "ANTHROPIC_AUTH_TOKEN": "xxxxxxxxxxxxxxxxxxx.rrrrrrr", "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic", ... },"permissions": {"allow": ["Bash(*)", "Read(*)", "Write(*)", "Edit(*)", "Glob(*)", "Grep(*)", "Agent(*)", "WebSearch(*)", "WebFetch(*)"]},"model": "glm-5.1","statusLine": {"type": "command","command": "printf 'IM | %s | %s' "$(basename "$PWD")" "$(git branch --show-current 2>/dev/null)""}}

5.6 statusLine 状态栏

在多项目、多模型切换的场景下非常实用。它能在底部状态栏显示当前目录、分支、模型等信息，避免弄混。

六、Hooks 机制

Hooks 是在特定事件发生时自动执行预设操作的机制。

七、自定义 Skills

Skills 可以将高频工作流沉淀为可复用能力。通过 .claude/skills//SKILL.md 定义。

第二部分：高频黄金命令

日常开发中，真正高频使用的命令可能就那么十几个。这部分把最实用的拎出来讲清楚。

如果刚开始用，不要按命令酷不酷来记，而是按工作流来记。最推荐先吃透以下 17 个命令/关键词/工作流：

像 /batch、/loop 也很有用，但更偏向进阶提效命令，场景对了很猛，场景不对就只是看起来很高级。

第三部分：踩坑记录

这部分不写成工具故障手册。真实工程里更常见的坑，其实是上下文没给清楚、项目记忆没沉淀、模型切错了、改完没验证。下面这些更贴近日常编码和设计场景。

快速排查表

主要坑点回顾

• 没让 Claude 认识项目：新项目先跑 /init，把长期规则写进 CLAUDE.md。
• 需求太宽，Claude 一口气改飞：复杂任务先 /plan，先方案后执行。
• 不指定 @ 文件，Claude 会自己猜上下文：输入越精准，AI 越不容易胡来。
• mono repo 只打开一个目录：跨端联动时，用 /add-dir 加相关目录。
• 多模型切换只改模型名，结果配置冲突：把一整组配置放在项目级 settings.local.json 或写成启动脚本。
• 把临时需求写进长期记忆：临时任务要求只放在当前对话里，不要沉淀到 memory。
• 改完不看 /diff：每轮关键改动后看差异，发现无关修改及时拦住。
• 方向错了还继续打补丁：发现方向不对，直接 /rewind 再重新描述边界。
• 只相信“应该可以”，不跑验证：用 ! 直接跑测试、lint、build。
• 设计任务只说“好看一点”：把设计目标说成工程验收标准，给截图和具体约束。

十七个最佳实践

1. 新项目先 /init
2. 长期规则写进 /memory 或 CLAUDE.md
3. 按任务选择模型
4. 不同项目单独配置模型
5. 高频模型切换写成脚本
6. 多目录项目用 /add-dir
7. 状态栏用 /statusline 配好
8. 输出风格用 /output-style 控制
9. 复杂任务先 /plan，关键问题加 ultrathink
10. 用 @ 精准引用文件和目录
11. 每轮关键改动后都看 /diff
12. 发现方向错了及时 /rewind
13. 用 ! 跑验证命令
14. 用 /context 管理上下文健康
15. 压缩前先 /recap，压缩时再 /compact
16. 临时旁路问题用 /btw
17. 权限默认保守，用 /permissions 精细放行

写在最后

Claude Code 真正厉害的地方，在于能把“理解项目 → 制定方案 → 修改代码 → 运行验证 → 复盘改动”这一整条链路串起来。新手容易把它当成更聪明的聊天窗口，想到什么问什么。更稳的方式是把它当成会执行任务的工程搭档：先给上下文，再让它计划，改完看 diff，跑完验证，最后把重要结论沉淀下来。

如果只记一套最小工作流，建议是：

项目记忆/模型配置 → /init → @指定文件 → /plan + ultrathink → 执行修改 → /diff → 必要时 /rewind → !跑测试 → /review → /recap 或 /compact

把这套流程用顺之后，Claude Code 就真正融入日常开发节奏了。

Claude Code 更新很快，命令、配置、模型接入方式还会继续变化。收藏起来方便随时查。