跳至主要內容

（5）配置 CLI 工具

大约 4 分钟

（5）配置 CLI 工具

这一页的目标不是覆盖所有细节，而是让你在最短时间内完成首次接入、首次验证，并知道下一步该走哪条路线。

如果你已经完成前 4 步，到这里就只剩三件事：

  1. 选一种配置方式
  2. 确认 CLI 命令能运行
  3. 发出第一条成功请求

更完整的配置细节在 CLI 配置教程 章节，这一页只保留最快可落地路径。

先判断你该走哪条路径

你的情况推荐路线说明
只打算用一个工具，想最少改动手动配置直接按单个 CLI 文档写配置文件
需要在 Claude、Codex、Gemini 之间切换CC-Switch统一管理多套 Provider，后续维护成本更低
你是第一次接入，只想先跑通一次先 Claude，再决定是否切 CC-SwitchClaude 路径最短，便于先验证账号、分组和网络

如果你不确定，默认先走 Claude Code + CC 分组令牌 这条线，最容易完成首次打通。

Claude Code 最短路径（5 步）

Claude Code fast path in 5 steps
Claude Code fast path in 5 steps

示意图：首次接入推荐的 5 步最短路径

  1. 在控制台创建并保存一个 CC 分组令牌。
  2. 选择一种配置方式：
  3. 重新打开终端，执行 claude --version，确认命令可用。
  4. 执行一次模型连通性检查：
curl -s https://www.yuzhixiaolongxia.com/v1/models \
  -H "Authorization: Bearer 你的CC令牌" \
  -H "Content-Type: application/json"
  1. 执行一次最小对话任务，确认响应可返回且不是认证或模型错误。

如果第 4 步失败，先回到 创建令牌 检查分组、令牌有效期和余额。

首次验证建议按“3 段式”执行

Three-stage verification flow
Three-stage verification flow

示意图：按“命令可用 -> 令牌可达 -> 业务可用”三段式排查

很多人第一次接入失败，不是配错了所有内容，而是不知道卡在哪一层。最稳妥的验证方式是分三段。

第 1 段：验证命令是否安装成功

claude --version

判断标准：

  • 能输出版本号：说明 CLI 已安装并在 PATH 中
  • 提示 command not found 或类似错误：先回去处理安装或 PATH

第 2 段：验证令牌和网关是否可达

curl -s https://www.yuzhixiaolongxia.com/v1/models \
  -H "Authorization: Bearer 你的CC令牌" \
  -H "Content-Type: application/json"

判断标准：

  • 返回模型列表：说明网络、网关、令牌基本正常
  • 返回 401 / 403：说明凭证或权限有问题
  • 返回目标模型缺失：优先检查分组

第 3 段：验证首次业务请求

claude

进入会话后发送一句最小测试，例如：

请只回复：连接成功

如果能返回正常文本，就说明你已经完成了首次可用验证。

推荐方式：CC-Switch

CC-Switch 适合下面这些场景：

  • 你同时用 Claude、Codex、Gemini
  • 你需要在测试线路和正式线路之间快速切换
  • 你不想手动维护多套本地配置文件

它的优势不是“第一次最快”，而是“后续长期维护最省事”。

手动配置入口

如果你只用其中一个 CLI，不需要额外引入 CC-Switch，直接按对应文档配置即可。

工具文档
Claude Code/docs/cli/2-claude.html
Codex/docs/cli/3-codex.html
Gemini/docs/cli/4-gemini.html

不同工具该配哪种令牌

工具令牌分组常见错误
Claude CodeCC用了 Codex 或 Gemini 分组令牌
CodexCodex令牌正确，但模型名走错了组
GeminiGemini配置文件正确，但令牌分组不对

不要尝试用“一把令牌跑所有 CLI”。短期可能省事，长期一定会把排错成本抬高。

配好后先做这 4 个检查

  1. 令牌与工具分组是否匹配。
  2. CLI 版本是否可正常输出。
  3. /v1/models 是否能返回可用模型列表。
  4. 首次请求是否返回业务响应而不是认证报错。

首次接入失败时怎么分流处理

现象优先处理方向
命令都跑不起来安装、PATH、终端重开
版本号能看见，但接口 401回到令牌页检查分组、有效期、复制是否完整
能列模型，但实际请求失败看模型名、CLI 配置文件、工具专用配置
Claude 已经通了，Codex 不通很可能是分组或接口风格不一致，不是账号坏了
想同时维护多套线路直接切到 CC-Switch，不要继续手工堆配置

下一步去哪里

预制小龙虾 | 文档系统
Copyright © 2026 预制小龙虾