企业官网建设流程全解析

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_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=
API 地址：https://taotoken.net/api（不加 UTM）

接入前你需要准备三件套：Base URL、API Key、Model ID。这三个缺一不可，后面所有配置片段都围绕它们展开。

第一步，去控制台创建 Key。打开 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite ，登录后新建一个 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_URL="https://taotoken.net/api" export ANTHROPIC_API_KEY="你的Key" export ANTHROPIC_MODEL="你的ModelID"

但这种方式在 Windows 下要配合 WSL2，而且换项目就得重设。所以更推荐 settings 文件，下一节详细给。

3. 可复制配置：settings.json 与命令组合工作流

Claude Code 的配置文件在~/.claude/settings.json，Windows 下 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 状态和 diff，push 前询问，危险操作默认拒绝。你可以按项目调整。

如果你用的是 Codex 风格的auth.json，结构类似，把 Base URL 和 Key 填进对应字段即可。Cline MCP 场景下，则是在 MCP Server 配置里填 Base URL 和 Key，Model 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 bar，Claude 会生成脚本并写入 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_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite 。接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite ，里面有完整的参数说明。

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_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite 。想先验证模型对话效果，用 https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=models&utm_campaign=rewrite 。Claude Code 相关的接入细节，参考 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 。

最后提醒一句：/effort设置的思考深度是 Anthropic API 专有特性，连第三方模型时会被忽略。别在这个参数上纠结，模型会按自己的默认推理方式跑。命令手册的价值在于让你少查文档、少改配置、少等响应，把时间留给真正要解决的问题。