1. 为什么命令手册值得单独写一篇Claude Code 命令手册实战场景Claude Code 的命令手册说白了就是一套用/触发的快捷操作集合。它能做什么把会话管理、模型切换、上下文压缩、权限控制、插件加载这些高频动作从「翻文档找参数」变成「敲一个斜杠命令」。适合谁已经在用 Claude Code 写代码、但每次都要停下来查配置的人以及刚接入第三方模型通道、想快速跑通完整工作流的人。我自己的痛点是项目一多会话上下文经常爆掉模型切换要改配置文件权限弹窗反复确认。后来把命令手册里的 30 多个命令按场景分组配合 TaoToken 统一 Key 和 API 通道整个流程顺了很多。这篇就按「命令怎么用 怎么接入 怎么排错」的顺序逐条演示。先明确一个概念命令和 Skill 已经合并。输入/会列出所有可用命令输入/加字母可以筛选。自定义命令比如.claude/commands/deploy.md和.claude/skills/deploy/SKILL.md都会创建/deploy工作方式一样同名时 Skill 优先级更高。所以这篇手册里的命令你既可以直接用内置的也可以自己扩展。下面按会话、模型、项目、扩展、配置五类拆开讲每类都给出可复制的操作和验证动作。核心检索词就是 Claude Code 命令手册全文围绕它展开。2. TaoToken 前置准备统一 Key 与 API 通道接入 Claude Code在跑命令之前得先把通道接上。Claude Code 默认走 Anthropic 官方接口但很多人需要统一管理 Key、切换模型、控制成本。TaoToken 在这里的角色是提供一个统一的 API 通道你拿到一个 Base URL 和一个 Key就能在 Claude Code 里配置。官网入口https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 地址https://taotoken.net/api不加 UTM接入前你需要准备三件套Base URL、API Key、Model ID。这三个缺一不可后面所有配置片段都围绕它们展开。第一步去控制台创建 Key。打开 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 登录后新建一个 API Key复制保存。这个 Key 只显示一次丢了就重新建。第二步确认你要用的 Model ID。不同模型对应的 ID 不一样比如你想用某个编码能力强的模型就在模型列表里找到对应标识。这个 ID 后面要写进配置。第三步确认 Base URL。统一用https://taotoken.net/api注意不要带 UTM 参数配置里写干净地址。这里有个容易踩的坑有人把官网地址当成 API 地址填进去结果请求 404。记住官网是给人看的API 是给程序调的两者路径不同。配置方式有两种环境变量和 settings 文件。环境变量适合临时测试settings 文件适合长期使用。我建议直接用 settings 文件因为 Claude Code 启动时会读取它不用每次开终端都 export。环境变量方式长这样export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEY你的Key export ANTHROPIC_MODEL你的ModelID但这种方式在 Windows 下要配合 WSL2而且换项目就得重设。所以更推荐 settings 文件下一节详细给。3. 可复制配置settings.json 与命令组合工作流Claude Code 的配置文件在~/.claude/settings.jsonWindows 下 WSL2 里就是/home/你的用户名/.claude/settings.json。这个文件控制模型连接、权限、hooks、状态栏等。下面给一份可直接复制的片段把 Base URL、Key、Model ID 三件套写进去。{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的TaoToken密钥, ANTHROPIC_MODEL: 你的ModelID }, permissions: { allow: [ Bash(git status), Bash(git diff), Read ], ask: [ Bash(git push) ], deny: [] }, statusLine: { type: command, command: ~/.claude/statusline.sh } }注意env里的三个键名必须和上面一致写错了 Claude Code 读不到。permissions里我给了个最小示例允许查看 git 状态和 diffpush 前询问危险操作默认拒绝。你可以按项目调整。如果你用的是 Codex 风格的auth.json结构类似把 Base URL 和 Key 填进对应字段即可。Cline MCP 场景下则是在 MCP Server 配置里填 Base URL 和 KeyModel ID 单独指定。配置写完后用/config命令打开设置界面切到 Config 选项卡确认模型连接信息显示正常。如果显示的还是官方地址说明 settings 没生效检查文件路径和 JSON 格式。接下来是命令组合工作流。我常用的一个组合是/context看上下文占用 →/compact压缩 →/model切换模型 →/diff看改动 →/security-review扫漏洞。这一套下来一个中等规模的重构任务能省不少来回。/context会把当前上下文可视化成彩色网格包括 MCP tools、Memory files、Skills、Project、User 的占用。看到某一块特别大就知道该清理哪里。/compact [instructions]压缩上下文可以带关注点说明比如/compact 保留认证相关讨论。压缩后上下文释放但关键信息保留。/model [model]切换模型立即生效不用等当前响应完成。配合/effort设置工作量级别low、medium、high 在会话间保持max 仅当前会话。/diff打开交互式差异查看器左右箭头切换 git 差异和单轮差异上下浏览文件。审代码时比在终端里翻 git log 直观。/security-review分析当前分支待处理更改识别注入、身份验证、数据泄露风险。提交前跑一次心里有底。这些命令单独用是工具组合起来才是工作流。你可以把常用组合写进自定义命令比如.claude/commands/review.md内容就是上面几步的说明之后敲/review就能触发。4. 逐条验证从 /context 到 /doctor 的成功结果对照配置好之后逐条验证命令是否正常工作。下面按类别给出验证动作和预期结果。会话类命令验证输入/context应该看到彩色网格显示各类占用。如果报错unknown command说明 Claude Code 版本太旧升级到最新版。输入/compact上下文被压缩提示栏显示压缩后的 token 数。如果提示nothing to compact说明当前上下文已经很小正常。输入/clear对话历史清空上下文释放。别名/reset、/new也能用。输入/resume打开会话选择器按 ID 或名称恢复。如果列表为空说明没有历史会话。模型类命令验证输入/model显示当前模型和可选模型列表。切换后立即生效。如果列表里没有你配置的 Model ID检查 settings 里的ANTHROPIC_MODEL拼写。输入/cost显示持续使用时间、代码变更数量、模型信息。如果显示0 tokens可能是刚启动还没请求。输入/effort不带参数显示当前级别。带参数设置比如/effort high。注意这个参数是 Anthropic API 专有特性连第三方模型时会被静默忽略模型按默认推理方式运行。项目类命令验证输入/init创建CLAUDE.md文件。第一次初始化较慢取决于仓库大小。完成后项目根目录多一个CLAUDE.md。输入/add-dir path为当前会话添加额外工作目录。注意大多数.claude/配置不会从添加的目录中发现。输入/plan fix the auth bug进入 Plan 模式并立即开始任务。Plan 模式下 Claude 先给方案再执行。输入/diff打开差异查看器。如果提示not a git repository说明当前目录不是 git 仓库。扩展类命令验证输入/memory查看或编辑CLAUDE.md或 Auto Memory。如果文件不存在会提示创建。输入/skills列出所有可用 Skills。如果为空说明还没创建自定义 Skill。输入/agents管理 subagent。内置的有 general-purpose、Plan、Explore、claude-code-guide、statusline-setup。输入/mcp管理 MCP Server 连接和 OAuth 身份验证。这里能看到哪些 Server 连上了、有哪些工具可用。如果 OAuth 失败检查 Key 和网络。输入/hooks查看工具事件的 hook 配置只读。要改就编辑settings.json。配置类命令验证输入/config或/settings打开设置界面。Status 选项卡显示版本、Session 信息、模型连接信息。如果模型连接显示异常回到第 3 节检查 settings。输入/status显示版本、模型、账户和连接性。在 Claude 响应时也能用不用等。输入/doctor诊断安装和设置。如果报错按提示修复。输入/permissions管理工具权限的允许、询问、拒绝规则。别名/allowed-tools。输入/statusline配置状态行。比如/statusline show model name and context percentage with a progress barClaude 会生成脚本并写入 settings.json。输入/help显示帮助和可用命令。command 是内置命令custom-command 是自定义命令包括 skills。输入/exit退出 CLI。别名/quit。以上命令跑一遍基本覆盖日常高频操作。如果某条命令在你的 npm 安装版本里没有比如/desktop、/chrome、/mobile那是平台限制不影响核心工作流。5. 常见报错排查401、local proxy failed、reading choices、OAuth接入和调用过程中几个报错反复出现。下面按真实报错对照排查。报错一401 Unauthorized。原因通常是 Key 无效或没传对。检查 settings.json 里ANTHROPIC_API_KEY是否填了完整 Key有没有多余空格。如果用的是环境变量确认终端里echo $ANTHROPIC_API_KEY能打印出来。另外确认 Base URL 是https://taotoken.net/api不是官网地址。报错二local proxy failed。这个多半是本地网络或代理配置问题。先确认没有多余的代理环境变量干扰比如HTTP_PROXY、HTTPS_PROXY。如果有临时 unset 掉再试。然后确认 Base URL 可达用 curl 测一下curl -I https://taotoken.net/api返回 200 或 401 都说明网络通返回超时就是网络问题。报错三reading choices相关错误。这通常出现在响应解析阶段说明返回格式不符合预期。检查 Model ID 是否正确有些模型 ID 写错会导致返回结构异常。另外确认没有在settings.json里同时配多个冲突的模型字段。报错四OAuth 失败。/mcp里做 OAuth 身份验证时失败先确认 Key 有效再确认回调地址没被拦截。如果反复失败可以改用 API Key 方式而不是 OAuth。报错五unknown command。命令不存在要么版本旧要么该命令在当前安装方式下不可用。用/help看实际可用列表。npm 安装的 Claude 里没有/desktop、/chrome、/mobile、/passes、/privacy-settings、/upgrade、/voice、/usage、/vim、/extra-usage、/keybindings、/terminal-setup、/pr-comments、/sandbox、/schedule、/remote-control、/remote-env这些。报错六nothing to compact。不是错误是提示当前上下文太小无需压缩。继续操作即可。报错七not a git repository。/diff、/security-review依赖 git。在项目根目录执行或先git init。排查顺序建议先看 Key 和 Base URL再看网络再看 Model ID最后看版本。大部分问题出在前两步。如果排障过程中需要重新生成 Key去 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有完整的参数说明。6. 按手册复现从命令调用到效率提升的落地路径把上面的内容串起来一条可复现的路径是这样的先配好settings.json三件套写对。然后用/doctor确认环境正常/config确认模型连接。接着/init初始化项目生成CLAUDE.md。日常开发用/context监控上下文/compact压缩/model切换/diff审改动/security-review扫风险。扩展阶段用/skills、/agents、/mcp、/hooks把重复动作自动化。最后用/statusline配一个状态行把模型名和上下文百分比常驻显示。这套流程跑顺之后命令调用不再是负担而是肌肉记忆。效率提升不是来自某一个命令而是来自组合和自动化。如果你要长期做编码和 Agent 任务可以考虑 Coding Plan入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。想先验证模型对话效果用 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。Claude Code 相关的接入细节参考 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。最后提醒一句/effort设置的思考深度是 Anthropic API 专有特性连第三方模型时会被忽略。别在这个参数上纠结模型会按自己的默认推理方式跑。命令手册的价值在于让你少查文档、少改配置、少等响应把时间留给真正要解决的问题。