Claude Code 命令大全：233 个指令速查手册与 TaoToken 接入配置

1. 为什么 233 个命令记不住，却必须查得快

Claude Code 的命令体系确实庞大，斜杠命令、CLI 启动参数、键盘快捷键加起来超过 233 个。但真正的问题不是"记不住"，而是"用的时候找不到"。我见过太多开发者把/compact、/context、/code-review这几个高频命令背得滚瓜烂熟，结果遇到上下文溢出、模型切换、后台任务编排时，还是得翻文档。

这篇速查手册的目标很明确：把 233 个命令按使用场景分类，让你在需要的时候能快速定位。同时，我会把 TaoToken 的接入配置一并写清楚——因为很多人卡在第一步：Base URL 填什么、auth.json 怎么改、Key 从哪里拿。命令再熟，通道不通也白搭。

适合谁看？三类人：刚接触 Claude Code CLI 想系统梳理命令的新手；已经在用但经常忘记某个斜杠命令的中级用户；以及需要把 Claude Code 接入统一 API 通道、做团队配置的开发者。全文按"命令分类速查 + TaoToken 接入 + 验证排障"三段式展开，你可以直接跳到需要的章节。

先说结论：233 个命令里，日常高频的其实就 30 个左右。剩下的要么是特定场景才用，要么是版本迭代新增的。所以别被数字吓到，先把核心命令用顺，再按需扩展。

2. TaoToken 前置准备：Base URL、Key 与 auth.json 三件套

在讲命令之前，必须先把接入通道打通。Claude Code 默认走 Anthropic 官方通道，但很多开发者需要统一管理 Key、切换模型、控制成本，这时候 TaoToken 就派上用场了。它的作用是提供一个统一的 API 入口，你只需要配置一次 Base URL 和 Key，后续所有模型调用都走这个通道。

先明确三件套：

获取 Key 的路径：访问 TaoToken 控制台，进入 API Keys 页面，点击创建新 Key。建议按项目或环境分开创建，方便后续排查和额度管理。创建后立即复制保存，页面刷新后不会再显示完整 Key。

接下来是 Claude Code 的配置文件。Claude Code 读取配置的优先级是：项目级.claude/settings.json> 用户级~/.claude/settings.json。如果你想让所有项目都走 TaoToken，改用户级；如果只想某个项目走，改项目级。

用户级配置路径（macOS/Linux）：

~/.claude/settings.json

Windows（WSL）下同样是~/.claude/settings.json，注意是在 WSL 的文件系统里，不是 Windows 的C:\Users\。

配置内容需要包含 Base URL 和认证信息。Claude Code 支持通过环境变量或 settings.json 注入。推荐用 settings.json，因为更稳定、可版本控制（项目级时）。

{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_API_KEY": "sk-你的实际Key" } }

注意：ANTHROPIC_BASE_URL不要带末尾斜杠，也不要加任何查询参数。ANTHROPIC_API_KEY填你在控制台创建的那串。

如果你用的是 Claude Code 的 auth.json 机制（部分版本或第三方封装会用到），路径通常在：

~/.claude/auth.json

内容格式：

{ "baseUrl": "https://taotoken.net/api", "apiKey": "sk-你的实际Key", "model": "claude-sonnet-4-6" }

这里的三件套必须齐全：Base URL、Key、Model ID。缺任何一个都会导致请求失败。Model ID 可以先填一个默认的，后续用/model命令动态切换。

配置完成后，不要急着跑复杂命令，先用最简单的验证请求确认通道通了。下一节会讲具体验证步骤。

3. 可复制配置片段：settings.json 与 auth.json 完整示例

这一节直接给可复制的配置片段，你照着改 Key 就行。我会把 settings.json 和 auth.json 两种都写全，并说明各自适用场景。

3.1 settings.json 完整配置

用户级~/.claude/settings.json：

{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_API_KEY": "sk-替换成你的Key" }, "permissions": { "allow": [ "Bash(npm run *)", "Bash(git status)", "Bash(git diff *)", "Read", "Write", "Edit", "Grep", "Glob" ], "deny": [ "Bash(rm -rf *)", "Bash(git push --force*)", "Bash(sudo *)" ] }, "model": "claude-sonnet-4-6" }

项目级.claude/settings.json（放在项目根目录）：

{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_API_KEY": "sk-替换成你的Key" }, "permissions": { "allow": ["Bash(npm test)", "Bash(npm run lint)", "Read", "Edit"], "deny": ["Bash(git push --force*)"] } }

项目级配置会覆盖用户级同名项。所以如果你在用户级配了 TaoToken，项目级又配了官方地址，项目里就会走官方。这点在排查"为什么这个项目不走 TaoToken"时特别有用。

3.2 auth.json 完整配置

如果你用的版本或封装读取 auth.json，路径~/.claude/auth.json：

{ "baseUrl": "https://taotoken.net/api", "apiKey": "sk-替换成你的Key", "model": "claude-sonnet-4-6", "effort": "high" }

auth.json 和 settings.json 不要同时配冲突的值。如果两个文件都存在且 Base URL 不一致，以 settings.json 的 env 为准（大多数版本的行为）。保险起见，只保留一种配置方式。

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

如果你只是想临时验证通道，不想改配置文件，可以直接在终端 export：

export ANTHROPIC_BASE_URL="https://taotoken.net/api" export ANTHROPIC_API_KEY="sk-替换成你的Key" claude --version

这种方式只在当前终端会话有效，关掉就没了。适合快速测试，不适合长期使用。

3.4 配置检查清单

改完配置后，逐项确认：

• Base URL 是https://taotoken.net/api，没有多余斜杠和参数
• Key 是完整的，没有空格和换行
• Model ID 拼写正确，比如claude-sonnet-4-6不是claude-sonnet-4.6
• 文件保存为 UTF-8 编码，JSON 格式合法（可以用python -m json.tool校验）
• 文件权限正确，~/.claude/目录可读写

校验 JSON 格式的命令：

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

如果输出格式化后的 JSON，说明格式没问题；如果报错，按提示修。

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

配置写完不代表生效，必须验证。这一节给具体的验证动作，从简单到复杂，逐步确认。

4.1 第一步：确认 Claude Code 能启动

claude --version

正常输出类似2.1.201 (Claude Code)。如果报 command not found，说明没装好或 PATH 没配。先解决安装问题，再谈接入。

4.2 第二步：确认通道连通

用一次性模式发一个最简单的请求：

claude -p "回复 OK 两个字母即可"

如果通道正常，几秒内会返回OK。如果卡住或报错，看下一节的排障。

这一步走的是你配置的 Base URL。如果返回正常，说明 Base URL 和 Key 都对。

4.3 第三步：确认模型切换生效

进入交互模式，用/model查看当前模型：

claude

然后在交互界面输入：

/model

会弹出模型选择器，显示当前可用模型列表。如果列表能正常加载，说明通道支持模型枚举。选一个模型后，再用/status确认：

/status

输出里会显示当前模型、版本、工作目录。确认模型 ID 和你配置的一致。

4.4 第四步：验证斜杠命令可用

在交互模式里输入/，会弹出命令补全菜单。能看到/compact、/context、/code-review等命令，说明命令体系加载正常。

再试一个实际命令：

/context

会显示上下文窗口使用情况的彩色网格图。如果能看到图，说明命令执行链路通了。

4.5 第五步：验证文件引用

在项目目录下启动 Claude Code，输入：

@package.json 这个项目用了哪些依赖？

Claude 会读取 package.json 并回答。如果它能正确列出依赖，说明文件引用和模型推理都正常。

4.6 验证结果对照表

全部通过，说明接入完成，可以正常使用 233 个命令了。

5. 常见报错排查：401、local proxy failed、reading choices、OAuth

这一节对照真实报错，给排查路径。这些是我在实际使用中遇到过的，按出现频率排序。

5.1 401 Unauthorized

报错原文：

API Error: 401 Unauthorized

原因：Key 无效、过期、或没传对。

排查步骤：

1. 确认ANTHROPIC_API_KEY的值是完整的，没有多余空格
2. 去 TaoToken 控制台确认 Key 状态是"启用"
3. 确认 Base URL 是https://taotoken.net/api，不是别的地址
4. 如果用了环境变量，确认当前终端会话里echo $ANTHROPIC_API_KEY有值

修复：重新创建 Key，更新配置文件，重启 Claude Code。

5.2 local proxy failed

报错原文：

Error: local proxy failed to start

原因：通常是端口冲突或代理配置残留。

排查步骤：

1. 检查是否有其他进程占用 Claude Code 需要的端口
2. 确认没有残留的代理环境变量，比如HTTP_PROXY、HTTPS_PROXY
3. 如果有，临时 unset：

unset HTTP_PROXY unset HTTPS_PROXY unset ALL_PROXY

4. 重启终端和 Claude Code

注意：这里说的代理是系统层面的网络代理配置，不是让你去配什么特殊通道。TaoToken 本身就是直连的 API 入口，不需要额外代理。

5.3 reading choices 相关报错

报错原文：

Error reading choices: unexpected end of JSON input

原因：模型返回的响应格式异常，通常是通道返回了非预期内容。

排查步骤：

1. 用claude -p "回复OK"测试基础通道
2. 如果基础通道正常，说明是特定模型或特定请求的问题
3. 换一个 Model ID 试试，比如从claude-opus-4-8换到claude-sonnet-4-6
4. 检查请求里有没有特殊字符导致 JSON 解析失败

修复：切换模型，或简化请求内容。

5.4 OAuth 相关报错

报错原文：

OAuth error: invalid_grant

原因：Claude Code 某些版本会走 OAuth 流程，如果配置了自定义 Base URL，OAuth 可能不兼容。

排查步骤：

1. 确认你用的是 API Key 模式，不是 OAuth 模式
2. 检查 settings.json 里有没有 OAuth 相关配置残留
3. 如果有claude auth login的历史，先 logout：

claude auth logout

4. 重新用 API Key 配置

修复：确保配置里只有ANTHROPIC_API_KEY，没有 OAuth token。

5.5 模型不存在

报错原文：

Model not found: claude-xxx

原因：Model ID 拼写错误，或通道不支持该模型。

排查步骤：

1. 用/model查看可用模型列表
2. 从列表里选一个，不要手写
3. 确认 Model ID 格式，比如claude-sonnet-4-6不是claude-sonnet-4.6

修复：用/model选择器切换，或从文档复制准确的 Model ID。

5.6 排障速查表

排障的核心思路：先确认基础通道（claude -p），再确认模型（/model），最后确认具体命令。分层排查，不要一上来就改一堆配置。

6. 命令分类速查与 TaoToken 接入后的使用建议

前面把接入和排障讲完了，这一节回到命令本身。233 个命令按场景分，日常高频的其实就几类。我按使用频率排序，你可以优先掌握前四类。

6.1 会话与上下文管理（最高频）

/safe-clear和/clear的区别值得强调：前者会先把当前状态保存为 handoff 文件，后者直接清空。日常推荐用/safe-clear，除非你确定不需要回顾。

6.2 模型与推理控制

接入 TaoToken 后，模型切换走的是统一通道，不需要改 Base URL。你可以根据任务复杂度灵活切换：简单任务用 Sonnet 省成本，复杂算法用 Opus 保质量。

6.3 代码审查与质量

/code-review是提交前的第一道防线。接入 TaoToken 后，审查请求也走统一通道，成本可控。

6.4 任务自动化

/loop配合/background可以实现 24/7 监控。比如/loop 5m check deploy status，每 5 分钟检查部署状态。

6.5 诊断与配置

/doctor是遇到问题时的第一反应。它会检查安装状态、连接性、配置问题。接入 TaoToken 后如果请求失败，先跑/doctor。

6.6 接入后的使用建议

配置好 TaoToken 后，建议做三件事：

第一，把/safe-clear、/compact、/context设成肌肉记忆。这三个命令决定了你的会话质量和成本。

第二，用/model和/effort做成本控制。不是所有任务都需要最高推理强度，简单任务用低强度模型，能省不少。

第三，定期跑/doctor和/cost。前者确认通道健康，后者确认成本在预期内。

6.7 自定义命令扩展

Claude Code 支持自定义斜杠命令，在.claude/commands/下创建 Markdown 文件即可。文件名就是命令名，内容支持 YAML frontmatter。

比如创建.claude/commands/deploy.md：

--- description: 部署前检查并触发部署 --- 1. 运行 npm run typecheck 2. 运行 npm test 3. 运行 npm run lint 4. 全部通过后执行 npm run deploy

之后在 Claude Code 里输入/deploy就能触发这套流程。接入 TaoToken 后，自定义命令的请求同样走统一通道。

6.8 快速参考卡片

会话管理: /safe-clear /compact /context /resume 模型控制: /model /effort 代码审查: /code-review /simplify /verify 任务自动化: /loop /background /goal /batch 诊断配置: /doctor /cost /status /config 文件引用: @filename

这 20 个命令覆盖了 80% 的日常场景。剩下的 200 多个，按需查文档即可。

最后说一个实际经验：Claude Code 更新很频繁，命令会增删改。建议定期跑claude update，并关注版本变更日志。接入 TaoToken 后，通道层是稳定的，你只需要关注命令层的变化。

如果你还没配置 TaoToken，现在就可以去控制台创建 Key，按第 3 节的配置片段改好 settings.json，然后用第 4 节的验证步骤确认通道。配置一次，后续所有命令都能用。遇到报错就对照第 5 节排查，大部分问题都能自己解决。