排障手册
FAQ 与排障：先定位是令牌、分组、地址、模型还是线路
遇到问题时不要立刻重装工具。先按本页的五步法定位层级，再按现象或错误码查原因。大多数问题都能在 Base URL、令牌、分组和模型 ID 里找到答案。
先做 1 分钟分流
排障前先回答这几个问题。能回答清楚，后面基本只是在对应教程页修配置；回答不清楚，就先补最小验证，不要继续反复重装工具。
| 先问自己 | 如果答案是“是” | 如果答案是“否” |
|---|---|---|
| 最小 curl 是否成功过？ | 说明 6星中转 账号、令牌和至少一个模型链路可用，继续查具体工具配置。 | 先回 快速开始完整步骤 跑短请求。 |
| 用量日志里是否有对应时间点？ | 说明请求确实进入 6星中转，继续看错误码、模型和分组。 | 优先查 Base URL、工具是否仍读旧配置、代理是否把请求发到别处。 |
| 只有一个工具失败吗？ | 按 按工具继续排障 查该工具的地址、配置文件和重启要求。 | 多个工具都失败时，先查令牌、分组、余额和状态页。 |
| 错误是否集中在同一类模型或能力？ | 优先查 模型分组、模型列表 或 图像视频能力。 | 如果所有模型都慢或 5xx，再看 状态页。 |
先看最常见的 3 个误区
这里是排障入口，不是从零教程。如果你还没注册、准备额度、创建令牌或跑过第一次短请求，先回到 5 分钟快速开始 走完基础链路。
误区 1：Base URL 套用错工具
Claude Code 用 https://www.6xin.cc，OpenAI 兼容工具用 https://www.6xin.cc/v1。地址层级错，最常见表现是 404、connection error 或工具一直连不上。
五步排障法
1
确认地址
Claude Code 用根地址，OpenAI 兼容工具用 /v1。地址错会导致 404 或工具一直连不上。
2
确认令牌
令牌是否完整、未禁用、没有空格，认证头是否是 Bearer。
3
确认分组
当前令牌能否访问请求里的模型。403 优先看这里。
4
确认模型 ID
模型名从模型广场复制。404 不一定是接口地址错，也可能是模型不存在。
5
确认状态页
持续 5xx、超时或某类模型大面积失败时，看 状态页快速判断 判断是否线路波动。
先用最小 curl 排除工具问题
如果不确定是 6星中转 链路问题，还是某个客户端配置问题，先用终端跑一次最小请求。curl 成功但工具失败，重点查工具配置；curl 也失败，重点查令牌、模型、分组、地址和状态页。
export COMEU_API_KEY="sk-你的令牌"
curl "https://www.6xin.cc/v1/chat/completions" \
-H "Authorization: Bearer $COMEU_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "从模型广场复制的模型ID",
"messages": [
{"role": "user", "content": "回复 OK"}
],
"max_tokens": 16
}'| curl 结果 | 说明 | 下一步 |
|---|---|---|
| 成功返回文本 | 6星中转 令牌、模型和基础聊天链路可用。 | 回到具体工具页检查 Base URL、配置读取和重启要求。 |
| 401 | 令牌或认证 Header 有问题。 | 看 API 认证 Header。 |
| 403 或模型不可用 | 令牌分组和模型不匹配。 | 看 模型分组。 |
| 5xx 或超时 | 可能是临时波动，也可能是本地网络。 | 看 状态页快速判断 和 网络检查。 |
按现象快速定位
如果你还不知道错误码是什么意思，先从自己看到的现象开始。定位到大类后，再回到五步法或错误码表逐项确认。
| 你看到的现象 | 最常见原因 | 先做这一步 | 继续看哪里 |
|---|---|---|---|
| 工具完全连不上，或提示 connection error | Base URL 填错、本机网络或代理没生效、工具仍在读旧配置。 | 先用终端执行最小 curl，确认 https://www.6xin.cc 或 https://www.6xin.cc/v1 能访问。 |
环境检查、接口地址速查 |
| 401、invalid token、unauthorized | 令牌复制不完整、认证头格式错、令牌被禁用或填到了错误字段。 | 重新创建一条测试令牌，只用最小 curl 验证，不要先改复杂工具配置。 | 令牌复制后验证、API 认证与令牌 |
| 余额还有，但 403 或无权访问模型 | 令牌分组和模型家族不匹配，或模型没有开放给当前分组。 | 回到令牌页确认分组，再从模型广场复制同分组可用模型 ID。 | 模型分组三步判断、模型列表与可见性 |
| 404、model not found、接口路径不存在 | 模型 ID 手写错、模型已变化，或 Claude / OpenAI 兼容地址层级混用。 | 先确认工具类型：Claude Code 用根地址，Codex、Cherry Studio 等 OpenAI 兼容工具用 /v1。 |
聊天与 Messages 地址规则、接口格式 |
/v1/models 能返回，但聊天或生图失败 |
模型列表只证明令牌可见，不代表请求体、模型能力或分组完全匹配。 | 用对应能力的最小请求复现：聊天、生图、图像编辑和视频不要互相替代。 | 模型真实烟测、图像与视频 |
| 改了配置还是走旧地址或旧模型 | 终端没有重开、项目级配置覆盖用户级配置、CC Switch 切换后工具进程未重启。 | 关闭当前 CLI 或图形客户端，重开终端，再查看当前配置来源。 | 验证有没有切成功、Codex 验证与排障 |
| 429、响应很慢、偶发超时 | 并发过高、请求频率太快、模型或线路临时波动。 | 降并发，用 1s / 2s / 4s 退避重试；如果同类模型都慢，再看状态页。 | 状态页与可用性、稳定性建议 |
| 图像编辑或视频任务失败 | 文件字段、格式、大小、模型能力或异步任务状态处理不正确。 | 先用一张小图或 5 秒视频 prompt 跑最小请求，再逐步加复杂参数。 | 图像视频接入流程、多媒体 API 示例 |
错误码速查
| 错误 | 最可能原因 | 马上做什么 |
|---|---|---|
400 | 请求 JSON 不合法、字段缺失、参数类型错。 | 复制最小示例重新请求，逐个加参数。 |
401 | 令牌错误、过期、禁用、认证头格式错。 | 重新创建令牌，按 复制后验证 跑最小 curl。 |
403 | 分组无权访问该模型。 | 换模型或换分组令牌，先看 分组选择表。 |
404 | 模型不存在、路径错、/v1 写错。 | 确认模型 ID 和 Base URL。 |
413 | 请求体太大或上下文超限。 | 缩短上下文、压缩图片、分批处理。 |
429 | 限流或并发过高。 | 降低并发，指数退避重试。 |
5xx | 服务或上游临时异常。 | 看 状态页，等待后重试；持续异常再提交工单。 |
按工具继续排障
如果你已经知道是哪一个客户端出问题，先看这一张表。每个工具的地址规则、配置来源和验证方式都不一样，不要把一个工具的修法照搬到另一个工具。
| 工具或场景 | 最常见问题 | 先确认什么 | 继续看哪里 |
|---|---|---|---|
| Claude Code | Base URL 多写了 /v1、模型 ID 不在当前分组、终端还在读旧环境变量。 |
地址使用 https://www.6xin.cc，重开终端后再跑一次最小请求。 |
CC Switch 切换 Claude Code、速填表、手动验证 |
| Codex CLI | 用户级配置和项目级配置互相覆盖，或者 Base URL 没有使用 OpenAI 兼容路径。 | 地址使用 https://www.6xin.cc/v1，确认当前项目没有单独覆盖 provider 设置。 |
CC Switch 切换 Codex CLI、速填表、Codex 验证 |
| Gemini CLI | 根地址、斜杠、模型分组没有对齐，导致能启动但请求失败。 | 从模型广场复制 Gemini 可用模型 ID，确认令牌分组包含 Gemini 能力。 | CC Switch 切换 Gemini CLI、Gemini CLI 错误速查、模型分组 |
| CC Switch | 导入链接没有唤起应用、切换后工具未重启，或者配置槽位选错。 | 先打开 CC Switch，确认系统允许 ccswitch:// 协议，再检查当前激活配置。 |
CC Switch 排障流程、验证有没有切成功 |
| Cherry Studio | 提供商类型、Base URL、模型列表刷新或聊天/图像能力混用。 | 提供商选择 OpenAI 兼容，地址使用 https://www.6xin.cc/v1，再按能力选择模型。 |
Cherry Studio 排障、连接验证 |
| Chatbox / NextChat | OpenAI 兼容地址、API Path、模型列表或部署环境变量没有生效。 | 地址使用 https://www.6xin.cc/v1；Chatbox 先跑最小预检，NextChat 改环境变量后要重启或重新部署。 |
Chatbox 预检、NextChat 验证顺序 |
| n8n 工作流 | HTTP Request 节点没有带认证头、JSON 路径取错，Webhook 没切生产 URL，或批量任务缺少限流和错误分支。 | 先用固定 prompt 跑通 /v1/chat/completions，再接入动态数据、Webhook 和批量流程。 |
n8n 最小请求、错误分支 |
| API / SDK / 图像视频 | SDK baseURL 写法、请求体字段、文件上传或异步任务轮询方式不匹配。 | 先用文档里的最小 curl 成功一次，再把同样参数迁到 SDK 或业务代码里。 | 认证错误、聊天错误、图像视频流程 |
常见工具问答
Claude Code 一直 404
把 Base URL 改成 https://www.6xin.cc。Claude Code 会自己拼 /v1/messages，你不需要手动加 /v1。
Codex CLI 仍然访问旧地址
检查当前用户的配置文件路径、环境变量是否在同一个终端生效，以及是否有项目级配置覆盖用户级配置。
Cherry Studio 模型列表为空
确认提供商类型是 OpenAI 兼容，Base URL 是 https://www.6xin.cc/v1，API Key 输入框里只放令牌本身。
CC Switch 点击导入没有反应
先打开一次 CC Switch，确认系统注册了 ccswitch:// 协议；浏览器询问打开外部应用时选择允许。
控制台里先自查这 6 件事
很多问题不用等人工协助，先在 6星中转 自己的页面里查一遍。下面这些入口需要登录；如果被跳到登录页，登录后再回到同一个动作继续。
| 你要确认什么 | 打开哪里 | 正常时应该看到什么 | 不正常时怎么处理 |
|---|---|---|---|
| 余额是否够用 | 充值与余额页 | 账号有可用余额，最近充值已经到账。 | 余额不足先充值；刚付款未到账时保留订单号再提交工单。 |
| 令牌是否存在且启用 | 令牌管理 | 令牌没有被删除或禁用，名称能看出用途，分组符合目标模型。 | 新建一条测试令牌，不要继续排查已经泄露或用途不清的旧令牌。 |
| 模型 ID 和分组是否匹配 | 模型广场 | 模型 ID 来自当前页面，并且能力类型和令牌分组一致。 | 重新复制模型 ID，必要时创建同分组令牌。 |
| 请求有没有进入 6星中转 | 用量日志 | 按时间点能看到模型、状态、耗时或消耗记录。 | 没有记录时，优先查工具是否还在读旧 Base URL、旧令牌或旧项目配置。 |
| 是否是平台或线路波动 | 状态页 | 目标模型或分组近期状态正常，或能看到明确异常范围。 | 同类模型大面积异常时先等待或降级；只有你失败时回到本页查配置。 |
| 是否需要人工协助 | 工单系统 | 你已经准备好时间、模型、错误码、脱敏令牌片段和截图。 | 不要贴完整令牌、私密图片、客户数据或可复用的业务请求。 |
余额、扣费和账单问题
请求失败是否扣费
一般只有完成有效输出才会产生用量记录。网络中断、参数错误、认证失败通常不会形成有效生成账单。
余额不足
先查看控制台余额和近期账单，再确认是不是多个工具共用一个令牌导致用量集中。
倍率怎么看
以模型广场和账单展示为准。不同分组、不同模型的倍率可能不同。
怀疑异常消耗
立即禁用相关令牌，保留时间、模型、脱敏令牌片段和请求 ID 后提交工单。
提交工单时请带上这些信息
| 信息 | 示例 | 不要提供什么 |
|---|---|---|
| 问题发生时间 | 2026-06-18 14:30 左右 | 不要只写“刚刚”。 |
| 工具和版本 | Claude Code / Cherry Studio / Codex CLI | 不要只写“客户端”。 |
| Base URL | https://www.6xin.cc/v1 | 可以提供地址，不要提供完整令牌。 |
| 模型 ID | gpt-4.1-mini | 不要用“那个模型”代替。 |
| 错误信息 | HTTP 403 / 404 / 429，或截图 | 截图前遮住 API Key。 |
| 令牌片段 | 只给前 6 位和后 4 位 | 绝对不要贴完整令牌。 |
可复制的工单模板
提交前先把真实密钥、私人图片、客户数据遮住。下面模板里的令牌只填脱敏片段，例如 sk-abc123...wxyz。
问题类型：工具接入 / API 调用 / 图像视频 / 余额账单 / 状态波动
发生时间：2026-06-21 17:30 左右（请改成你的实际时间）
使用工具：Claude Code / Codex CLI / Cherry Studio / 自写程序
工具版本：可选；不知道可写“不清楚”
Base URL：https://www.6xin.cc/v1 或 https://www.6xin.cc
请求路径：/v1/chat/completions、/v1/messages、/v1/images/generations 等
模型 ID：从模型广场或请求体复制
错误码和报错：HTTP 403 / model not found / timeout / 其他完整错误摘要
是否能复现：每次都失败 / 偶发失败 / 某个模型失败
状态页现象：绿色 / 黄色 / 橙色 / 红色 / 未查看
脱敏令牌片段：sk-前6位...后4位
已经尝试：重开终端、换模型、检查分组、查看用量日志等
补充说明：不要粘贴完整 API Key、私人图片、用户隐私文本或完整业务日志
如果问题涉及异常扣费或疑似泄露，先在 6星中转 控制台禁用相关令牌，再提交工单。不要等定位完成后才止损。
排障完成标准
| 状态 | 说明 | 下一步 |
|---|---|---|
| 已定位到配置问题 | 能明确是 Base URL、令牌、分组、模型 ID 或客户端读取配置出错。 | 回到对应教程页修正，再做一次短请求验证。 |
| 已定位到额度或限流 | 余额不足、429、并发过高或倍率理解错误。 | 降低并发、检查余额和账单，必要时更换 模型分组。 |
| 已定位到平台或上游波动 | 状态页异常、同类模型大面积 5xx 或超时。 | 记录时间和模型，等待恢复或提交工单。 |
| 需要提交工单 | 已经有时间、工具、Base URL、模型 ID、错误信息和脱敏令牌片段。 | 按上方表格提交，不要提供完整令牌。 |