工具接入
按工具选择教程：命令行、图形客户端和一键导入
这一章把不同工具的入口、Base URL、令牌字段和常见误区放在同一处。先看总览，再进入对应工具页，会比直接改配置文件稳得多。
配置工具前先准备好这些
不要一上来就改工具配置文件。先把账号、令牌、模型和本机环境确认清楚，后面每个工具页只是在填不同字段。
| 准备项 | 通过标准 | 没准备好先看 |
|---|---|---|
| 基础 API 请求 | 用当前令牌跑过一次短请求，能返回模型回复。 | 快速开始完整步骤 |
| 工具专用令牌 | 令牌名称能看出用途，分组和目标模型匹配。 | 令牌创建前确认 |
| 模型 ID | 从模型广场或 /v1/models 复制，不凭记忆手写。 |
模型列表与可见性 |
| 本机环境 | 终端、网络、代理、Node 或安装包路径都能正常工作。 | 环境检查 |
先选路径：不要一开始就改配置文件
工具接入最常见的失败，不是工具本身复杂，而是还没确认令牌、分组、Base URL 和模型 ID。按下面四步走，能少绕很多路。
1
先确认基础链路
完成 5 分钟快速开始，至少用一条 curl 请求拿到模型回复。基础链路没通时，不要急着配置客户端。
2
再判断你要接哪类工具
命令行编程工具优先看 CC Switch；图形聊天工具看 Cherry Studio、Chatbox 或 NextChat；自动化看 n8n；自己写程序看开发者 API。
3
按工具规则填地址
Claude Code 用根地址 https://www.6xin.cc；OpenAI 兼容工具通常用 https://www.6xin.cc/v1；Gemini CLI 优先使用 6星中转 一键导入结果。
4
用真实请求收尾
工具里保存成功不等于接入成功。必须做一次短问答、图片任务或工作流请求，并在 6星中转 用量日志里对上时间。
工具分两组，按需选择
命令行编程类
适合在终端里写代码、改项目、跑脚本。能力强，但对配置文件、环境变量和路径更敏感。
图形客户端类
适合不想碰命令行的用户。填写 Base URL 和 API Key 后，就能在图形界面聊天、写作或生成图片。
- Cherry Studio
- Chatbox
- NextChat
- n8n 工作流
- 其他 OpenAI 兼容客户端：按同样的
/v1规则填写。
我应该选哪个教程
| 你的情况 | 推荐路径 | 为什么 |
|---|---|---|
| 我只想尽快把 Claude Code / Codex / Gemini 配好 | CC Switch 使用总览 → 通用配置 → 对应工具页 | 从 6星中转 令牌页直接带入端点、令牌和模型，同时能按工具核对地址规则。 |
| 我已经熟悉终端配置 | Claude Code 手动配置、Codex CLI 手动配置 或 Gemini CLI 手动配置 | 可以直接控制环境变量和配置文件，适合多项目切换；先看速填表，再按安装检查、直接请求和工具内验证排查。 |
| 我要在服务器或脚本里切换工具配置 | ccs CLI 命令行版 | 没有图形界面时，也能 list、use、status、backup 和 restore。 |
| 我要出图、改图或生成视频 | 图像与视频 | 先按能力选模型，再决定用 Cherry Studio 还是 API。 |
| 我想用图形界面聊天和管理会话 | Cherry Studio、Chatbox 或 NextChat | 先按字段速查填地址、令牌和模型；个人桌面优先 Chatbox，团队网页入口优先 NextChat，并用用量日志确认请求进了 6星中转。 |
| 我要把模型接进自动化流程 | n8n 工作流 → 开发者 API 总览 | n8n 适合表单、表格、Webhook 和批量任务，但要先设置专用令牌、凭据、错误分支、重试和日志。 |
| 我是开发者，要接入自己的程序 | 开发者 API 总览 → 进阶玩法 | 先跑通接口，再补服务端代理、令牌拆分、重试限流和用量日志。 |
| 我已经接好工具，想给项目或团队长期使用 | 进阶玩法 | 把多工具配置、模型白名单、密钥边界和上线检查整理成可维护流程。 |
一键导入还是手动配置
| 选择 | 适合谁 | 好处 | 注意事项 |
|---|---|---|---|
| CC Switch 一键导入 | Claude Code、Codex CLI、Gemini CLI 用户，尤其是经常切后端的人。 | 减少手写 Base URL、令牌和模型 ID 的错误；可以保存多套 Provider。 | 切换后要重开终端，并用短请求验证。 |
| ccs CLI 命令行版 | 服务器、脚本、无图形界面环境。 | 能用命令查看、切换、备份和恢复 Provider。 | 适合熟悉终端的用户；仍要保护本地配置文件权限。 |
| 手动配置 | 已经熟悉工具配置文件和环境变量的人。 | 可控性最高，适合项目级配置和 CI/CD。 | 最容易被旧环境变量、项目 `.env` 或 shell alias 覆盖。 |
| 图形客户端填写 | 聊天、写作、轻量图片任务用户。 | 不需要命令行，字段少，适合个人桌面使用。 | 仍然要确认模型分组和 6星中转 用量日志。 |
推荐阅读顺序
| 阶段 | 要读的页面 | 读完应该知道什么 |
|---|---|---|
| 准备账号 | 5 分钟快速开始、令牌与安全、模型分组、图像与视频 | 账号有额度，令牌保存安全，模型分组和任务能力匹配。 |
| 准备电脑 | 环境检查 | 终端、网络、Node、Homebrew 或安装包路径都没问题。 |
| 快速导入 | CC Switch 使用总览、通用概念与配置 | 不用手写配置，也能知道 Provider、Base URL、API Key、Model 每个字段代表什么。 |
| 按工具切换 | 切换 Claude Code、切换 Codex CLI、切换 Gemini CLI | 知道每个工具的地址规则、验证步骤和常见误区。 |
| 手动配置 | Claude Code、Codex CLI、Gemini CLI、Cherry Studio、Chatbox、NextChat、n8n | 能按工具差异正确填写 Base URL、令牌和模型。 |
| 长期使用 | 开发者 API、进阶玩法、FAQ 与排障 | 能处理密钥隔离、服务端接入、失败重试、用量核对和工单信息。 |
接口地址速查：重点是 /v1
| 工具 / 场景 | Base URL | 令牌填写位置 | 容易写错的地方 |
|---|---|---|---|
| Claude Code | https://www.6xin.cc |
ANTHROPIC_AUTH_TOKEN 或工具认证配置 |
不要加 /v1，否则可能拼成 /v1/v1/messages。 |
| Codex CLI | https://www.6xin.cc/v1 |
OPENAI_API_KEY 或配置文件指定的 env key |
使用 OpenAI 兼容接口时通常需要 /v1。 |
| Gemini CLI | https://www.6xin.cc/ |
API Key / 兼容配置字段 | 优先使用 6星中转 一键导入结果；手动核对时保留末尾斜杠。 |
| Cherry Studio | https://www.6xin.cc/v1 |
API Key / 密钥输入框 | 提供商类型选 OpenAI 兼容或自定义 OpenAI。 |
| 通用 OpenAI SDK | https://www.6xin.cc/v1 |
Authorization: Bearer sk-... |
不要把完整密钥写进前端。 |
模型 ID 从哪里来
模型 ID 以 6星中转 模型广场或 /v1/models 返回结果为准。建议复制，不要手写。
curl "https://www.6xin.cc/v1/models" \
-H "Authorization: Bearer sk-你的令牌"
如果
/v1/models 能返回模型，但聊天请求 403，通常说明模型和令牌分组不匹配；如果模型列表也返回 401，先处理令牌格式。
接入前检查清单
| 检查项 | 通过标准 | 没通过先看哪里 |
|---|---|---|
| 令牌 | 复制完整，没有空格、换行和中文引号。 | 令牌与安全 |
| Base URL | Claude Code 根地址，OpenAI 兼容工具带 /v1。 |
接口地址速查 |
| 模型 ID | 从模型广场复制，且属于当前令牌分组。 | 模型分组 |
| 本地网络 | 终端能访问 6星中转 域名，状态页没有明显异常。 | 环境检查、状态页 |
| 密钥安全 | 截图、录屏、日志、Git 提交里都没有完整令牌。 | API 认证与令牌 |
这些情况先停下来，不要继续改更多配置
工具接入失败时，最容易越改越乱。下面这些停止点可以帮你先缩小范围，再进入对应工具页。
| 当前现象 | 先停止什么 | 下一步 |
|---|---|---|
| 最小 curl 还没成功 | 不要继续配置 Claude Code、Codex CLI、Cherry Studio 或 n8n。 | 回到 快速开始，先证明账号、令牌、分组和模型链路可用。 |
| 工具保存成功，但用量日志没有记录 | 不要先换模型或换分组。 | 优先查 Base URL、旧终端是否重开、项目级配置是否覆盖用户级配置。 |
| 401 或 invalid token | 不要把同一条令牌复制到更多工具里。 | 重新创建测试令牌，并按 复制后验证 跑最小请求。 |
403 或 model not found |
不要随机试模型名。 | 回到 模型分组，确认令牌分组和模型能力一致。 |
| 只有某个工具失败，其他工具成功 | 不要怀疑 6星中转 全局不可用。 | 进入该工具专页，查它的地址规则、配置文件位置和重启要求。 |
| 同类模型大面积超时或 5xx | 不要立即全量重试或批量重跑。 | 看 状态页快速判断，必要时降并发、换模型或等待恢复。 |
接入完成标准
不要只看工具里“保存成功”。真正完成接入，至少要能证明配置被目标工具读取、真实请求能返回、6星中转 控制台能看到对应记录。
| 你接入的是 | 必须看到什么 | 失败时先看哪里 |
|---|---|---|
| Claude Code | 新终端里启动 claude 后，短问答能正常返回；Base URL 没有 /v1。 |
CC Switch 切换 Claude 或 Claude Code 手动验证 |
| Codex CLI | 新终端里启动 codex 后，短问答能返回；Base URL 是 https://www.6xin.cc/v1。 |
CC Switch 切换 Codex 或 Codex CLI 手动验证 |
| Gemini CLI | 新终端里启动 gemini 后，短问答能返回；优先使用 CC Switch 导入，手动配置时确认根地址和字段名。 |
CC Switch 切换 Gemini 或 Gemini CLI 手动配置 |
| Cherry Studio 或 OpenAI 兼容客户端 | 模型列表能加载，选中模型后能完成一次短聊天或图片任务。 | Cherry Studio、Chatbox、NextChat、模型分组 |
| n8n 工作流 | HTTP Request 节点能返回短文本，Webhook、失败分支、限流和日志都已经配置。 | n8n 工作流、开发者 API |
| 图像和视频工作流 | 使用对应能力模型发起任务，能拿到结果或任务 ID，并在控制台日志里对上时间。 | 图像与视频、开发者 API |
| 自己写的后端服务 | 服务端 Secret 管理生效，curl 或测试脚本能完成真实请求，错误时有重试和日志。 | 开发者 API、进阶玩法 |
如果“工具显示保存成功”但 6星中转 用量日志没有记录，优先怀疑旧终端没重开、配置文件没被目标工具读取，或工具仍在使用旧 Provider。
常见配置字段对照
| 字段名 | 含义 | 6星中转 应填什么 | 备注 |
|---|---|---|---|
| Base URL / Endpoint | 客户端请求的接口根地址。 | OpenAI 兼容填 https://www.6xin.cc/v1，Claude 原生填 https://www.6xin.cc。 |
这是最容易错的字段。 |
| API Key / Token | 认证用的令牌。 | sk-你的令牌 |
输入框里通常不要写 Bearer。 |
| Model / Model ID | 实际调用的模型名。 | 从模型广场复制。 | 分组不匹配会 403。 |
| Provider Name | 本地配置名称。 | 6星中转 或按项目命名。 |
只影响本地识别，不影响接口。 |
让别人帮你排查时，准备这些信息
工具接入问题要先给足上下文，但不要暴露完整密钥。下面这些信息足够定位大多数配置问题。
工具名称：Claude Code / Codex CLI / Gemini CLI / Cherry Studio / Chatbox / NextChat / n8n
接入方式：CC Switch / 手动配置 / 图形客户端 / API
Base URL：只写域名和路径，不贴完整密钥
模型 ID：从 6星中转 模型广场复制的模型 ID
错误表现：401 / 403 / 404 / 429 / 5xx / model not found / timeout
发生时间：2026-06-21 19:30 左右
6星中转 用量日志：能看到 / 看不到
令牌片段：只提供前后少量字符，不提供完整令牌