Claude Code 命令体系全拆解：三种类型、七大分类、50+ 命令与 TaoToken 配置骨架-拓冰网站定制

1. 为什么你的 Claude Code 只发挥了 20%

Claude Code 内置了 50 多个命令，但绝大多数开发者日常只反复用其中 3 到 5 个。这不是懒，而是没人系统梳理过：哪些命令属于终端启动参数、哪些是会话内斜杠命令、哪些是键盘快捷键，它们各自解决什么问题、什么时候该用哪个。结果就是上下文爆了才想起压缩、改错了代码只能手动回滚、每次新会话都要重新解释项目规范。

这篇把 Claude Code 的命令体系按三种类型、七大分类拆开讲清楚，覆盖斜杠命令、CLI 标志、键盘快捷键与 CLAUDE.md 的配合方式，并给出 settings.json 与 config.toml 的可复制配置骨架。同时演示如何通过统一 Key/API 通道接入，让命令速查和配置基线可查、可改、可复现。适合已经装好 Claude Code、但感觉效率没拉满的开发者，也适合想给团队建立统一配置规范的 Tech Lead。

三种命令类型的边界先划清楚：CLI 标志在终端启动时生效，比如claude -c恢复最近会话；斜杠命令在交互式会话内部输入/触发，比如/compact压缩上下文；键盘快捷键在会话期间直接按键生效，比如Shift+Tab切换模式。搞混这三类，就会出现"为什么我输入 /model 没反应"这种问题——因为你可能是在 shell 里而不是会话里敲的。

七大分类则是按用途划分：会话管理、上下文控制、模型与成本、代码审查、任务与 Agent、配置与记忆、启动与输出。下面逐类拆解。

2. 前置准备：统一 Key/API 通道与配置骨架

在深入命令之前，先把接入层配好。Claude Code 支持通过环境变量指定 API 端点和 Key，这样你可以在不同项目间复用同一套凭证，也方便团队统一管理。

TaoToken 提供统一的 API 通道，官网入口是 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 地址为 https://taotoken.net/api 。你需要先在控制台创建一个 API Key，然后把它写进配置。

2.1 settings.json 配置骨架

Claude Code 的用户级配置位于~/.claude/settings.json，项目级配置位于项目根目录的.claude/settings.json。项目级会覆盖用户级同名项。下面是一份可直接复制的骨架：

{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_API_KEY": "sk-your-key-here", "CLAUDE_CODE_TASK_LIST_ID": "my-project-tasks" }, "permissions": { "allow": [ "Bash(npm test)", "Bash(git status)", "Bash(git diff)", "Read" ], "deny": [ "Bash(git push)", "Bash(rm -rf)" ] }, "model": "claude-sonnet-4-20250514" }

env块里的ANTHROPIC_BASE_URL指向统一通道，ANTHROPIC_API_KEY填你在控制台生成的 Key。permissions.allow列出可以跳过确认直接执行的操作，deny列出永远需要人工确认的危险操作。CLAUDE_CODE_TASK_LIST_ID用于跨会话共享任务列表。

2.2 config.toml 配置骨架

如果你用的是支持 TOML 的封装工具或自建网关，可以用下面这份等价配置：

[api] base_url = "https://taotoken.net/api" api_key = "sk-your-key-here" timeout_seconds = 120 [model] default = "claude-sonnet-4-20250514" fallback = "claude-haiku-4-20250514" [context] compact_threshold = 0.75 auto_compact = true [permissions] auto_approve = ["Read", "Bash(git status)", "Bash(npm test)"] require_approval = ["Bash(git push)", "Write"]

compact_threshold = 0.75表示上下文用到 75% 时自动触发压缩，这个值比等到 90% 再手动处理要稳妥得多。auto_approve和require_approval对应 settings.json 里的 allow/deny。

2.3 环境变量方式（临时验证用）

不想改配置文件时，可以直接在 shell 里导出：

export ANTHROPIC_BASE_URL="https://taotoken.net/api" export ANTHROPIC_API_KEY="sk-your-key-here" claude --print "say hello"

这种方式适合快速验证通道是否通，但不适合长期使用，因为每次开新终端都要重新导出。

3. 七大分类命令速查与可复制配置

3.1 会话管理类

这类命令控制会话的启动、恢复和切换。CLI 标志为主。

claude # 在当前目录启动新会话 claude -c # 恢复当前目录最近的会话 claude --resume # 从会话列表中选择恢复 claude --resume auth-fix # 按名称恢复指定会话 claude --from-pr 123 # 恢复与 PR #123 关联的会话

会话数据保存在~/.claude/projects/下，按项目路径分目录。/resume斜杠命令在会话内也能触发恢复菜单。切换任务时用/clear硬重置，继续同一任务时用/compact压缩保留。

3.2 上下文控制类

上下文窗口是 Claude Code 最稀缺的资源。这类命令决定你什么时候该压缩、什么时候该清空。

/context # 查看当前上下文占用百分比 /compact # 压缩对话历史，保留关键决策 /compact retain the auth module changes and error patterns /clear # 完全清空对话历史

/context输出类似Context usage: 67% (134,400 / 200,000 tokens)。实测下来，70% 到 80% 之间主动执行/compact效果最好，等到 90% 以上 Claude 已经开始遗忘早期决策了。/compact后面可以跟保留指令，告诉它哪些内容必须留下。

3.3 模型与成本类

/model # 交互式选择模型 /model sonnet # 切到 Sonnet /model opus # 切到 Opus /model haiku # 切到 Haiku /cost # 查看当前会话 Token 消耗和费用 /fast # 切换 Fast Mode

日常策略是 Sonnet 起步，遇到复杂多步规划切 Opus，简单编辑和模板生成交给 Haiku。/cost输出会显示输入输出 Token 数和估算费用。Fast Mode 运行的是同一个 Opus 模型，但调整了 API 配置以降低延迟，适合快速迭代；写生产代码时建议关掉。

3.4 代码审查类

/diff # 查看当前会话所有代码改动 /diff src/auth.ts # 只看指定文件的改动 /simplify # 三 Agent 并行代码审查

/diff是提交前的必跑命令。每个功能做完，执行/diff审查改动，确认无误再提交。/simplify会从代码质量、安全、最佳实践、性能、测试覆盖五个维度并行审查，替代了早期的/review。

3.5 任务与 Agent 类

/todos # 查看持久化任务列表 Ctrl+T # 切换任务列表显示 /agents # 管理子 Agent @agent-create test-writer "Writes comprehensive Jest tests"

任务列表跨会话持久保存，/compact也不会影响它。设置CLAUDE_CODE_TASK_LIST_ID环境变量可以让多个会话共享同一份任务列表。子 Agent 用于把专项工作（比如写测试）委派出去，主对话保持干净。

3.6 配置与记忆类

/init # 在项目根目录生成 CLAUDE.md /memory # 在会话内编辑 CLAUDE.md # 快速记忆语法 # Use async/await for all database queries

/init生成的 CLAUDE.md 包含项目描述、技术栈、代码风格和常见模式。每个项目从/init开始，能消除大量重复的上下文设置。以#开头的输入会直接追加到 CLAUDE.md，不用退出会话打开编辑器。

3.7 启动与输出类

claude --print "question" # 一次性查询后退出 claude --print "..." --output-format json # JSON 结构化输出 claude --append-system-prompt "Always use TypeScript strict mode" claude --agents '{"test-writer": {"role": "Write Jest tests"}}'

--print适合脚本和 CI/CD 流水线。--output-format json让输出可被程序解析。--append-system-prompt在保留默认能力的基础上追加规则，比--system-prompt安全得多——后者会完全替换默认指令集，只在需要完全控制时使用。

4. 验证请求：确认通道与命令生效

配置写完后，先验证 API 通道是否通，再验证命令是否按预期工作。

4.1 验证 API 通道

export ANTHROPIC_BASE_URL="https://taotoken.net/api" export ANTHROPIC_API_KEY="sk-your-key-here" claude --print "Reply with exactly: channel-ok"

预期输出就是channel-ok。如果返回认证错误，检查 Key 是否复制完整、是否有多余空格。如果返回连接超时，检查ANTHROPIC_BASE_URL是否写成了https://taotoken.net/api（注意结尾没有斜杠）。

4.2 验证配置文件被读取

claude --print "What is your base URL?" --output-format json

返回的 JSON 里如果包含你配置的端点信息，说明 settings.json 被正确加载。也可以直接检查：

cat ~/.claude/settings.json | python3 -m json.tool

确保 JSON 格式合法，没有尾随逗号。

4.3 验证斜杠命令与快捷键

启动交互式会话后：

claude

在会话内依次输入/context、/cost、/help，确认都有输出。按Shift+Tab观察模式是否在 normal → auto-accept → plan 之间循环。按Ctrl+T确认任务列表显示切换。这些动作都正常，说明命令体系已经就绪。

4.4 验证 CLAUDE.md 生效

在项目根目录执行/init，然后检查生成的 CLAUDE.md：

cat CLAUDE.md

接着在会话里问一个项目相关的问题，比如"这个项目用什么测试框架"，如果 Claude 能直接答出来而不是反问你，说明 CLAUDE.md 被正确读取了。

5. 本篇常见错排查

5.1`/model`输入后没反应

最常见的原因是你在 shell 里而不是会话里敲的。斜杠命令只在claude交互式会话内部生效。先运行claude进入会话，再输入/model。

5.2`/compact`后关键信息丢失

/compact默认会摘要对话历史，但可能丢掉你认为重要的细节。解决办法是在命令后跟保留指令：

/compact retain the database schema decisions and auth module changes

另外，把长期有效的规则写进 CLAUDE.md，而不是依赖对话历史。CLAUDE.md 的内容在压缩时会被保留。

5.3`--print`在脚本里返回空

检查是否在非交互环境下缺少 API Key。--print模式不会读取交互式登录态，必须通过环境变量或配置文件提供凭证。另外确认--output-format json时输出被正确解析，有些 shell 会把 JSON 里的引号吃掉，建议用jq处理：

claude --print "list files" --output-format json | jq -r '.result'

5.4`Shift+Tab`在 WSL 或 Windows Terminal 里无效

WSL 环境下某些键位绑定可能被终端拦截。执行/terminal-setup安装对应的键位绑定即可。macOS 上如果Alt相关快捷键无效，需要在 iTerm2 的 Settings → Profiles → Keys 里把 Option 键设为 "Esc+"。

5.5 配置文件改了但不生效

Claude Code 读取配置的优先级是：项目级.claude/settings.json> 用户级~/.claude/settings.json> 环境变量。如果你在用户级改了但项目级有同名项，项目级会覆盖。检查两个文件是否有冲突。另外 JSON 格式错误会导致整个文件被忽略，用python3 -m json.tool验证一下。

5.6`/cost`显示的费用和预期不符

/cost显示的是当前会话的累计消耗。如果你在会话中途切换了模型（比如从 Haiku 切到 Opus），费用会按各模型的实际用量分别计算。Fast Mode 开启后，之前积累的上下文会按 Fast Mode 费率重新计费，这是费用跳升的常见原因。

6. 把命令体系变成团队基线

命令速查只是起点，真正有价值的是把配置固化成团队可复用的基线。建议把.claude/settings.json和CLAUDE.md一起提交到项目仓库，新成员克隆后直接就有统一的权限规则、模型选择和项目记忆。

API Key 不要写进仓库，用环境变量或本地覆盖文件处理。团队统一使用同一个 API 通道时，把ANTHROPIC_BASE_URL写进项目级配置，Key 通过 CI/CD 的 secret 注入。

需要长期跑编码任务或 Agent 工作流的，可以了解 Coding Plan 的额度方案：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。想先在网页里验证模型对话效果，用模型对话入口：https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。生成和管理 Key 在控制台：https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，Key 列表页：https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。接入细节查文档：https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。

从核心 10 个命令开始用起，每周加一个新命令，把关键会话用/export导出保留。命令体系熟悉之后，Claude Code 才真正从"终端版聊天框"变成可编程的编码伙伴。

资讯详情

Claude Code 命令体系全拆解：三种类型、七大分类、50+ 命令与 TaoToken 配置骨架