9527code Docs 接入、客户端、排障

9527code 文档

新手快速入门

💡 接口填写指南
OpenAI 协议 (如 ChatGPT Next Web 等常见客户端)
👉 请直接复制带有 /v1 的地址
Gemini\Claude等原生协议 (如调用 Gemini、Claude 原生接口)
👉 请使用 不带 /v1 的基础地址
线路名称 OpenAI 接口地址
(直接复制)
其他接口地址
(原生 Gemini/Claude 等)
说明
主线路 https://9527.codes/v1 https://9527.codes 默认优先
主线路二 https://api.9527.codes/v1 https://api.9527.codes 备用节点
亚太优化 https://cdn.9527.codes/v1 https://cdn.9527.codes 亚太优先

1、注册并登录

进入 9527code 注册并登录。

2、确认余额

进入控制台后先看钱包余额或兑换额度。新用户可加入QQ群1093277927,领取试用额度

3、创建API令牌

进入控制台->令牌管理->添加令牌->输入名称并选择对应分组

注意:令牌分组一定要选对 创建令牌时请选择模型分组,不要选择用户分组或用户订阅分组,例如 default、lite、big、medium。如果使用第三方工具想要获取模型,分组不要选择多个(包括但不限于Cherry Studio等非官方工具)。多选分组会依次尝试分组是否可用。不了解分组时,先看 模型与分组。
创建 API 令牌并选择分组的控制台截图
创建 API 令牌:名称、令牌分组、访问限制和额度设置。
添加令牌字段建议填写注意事项
名称按用途命名,例如 claude-code-work没啥注意的,方便自己后续识别即可。
令牌分组选择模型分组,例如 Claude、Claude-codex、codex不要选择 default、lite、big、medium 这类用户分组;选错可能导致模型不可用或消耗不符合预期。
访问限制新手建议先不限制模型熟悉后可按用途限制模型,避免误用高价模型。
额度设置测试阶段可设置小额度共享设备或团队 Key 建议限制额度。开启“无限额度”时,令牌实际可用额度仍受账户余额限制。

4、配置前环境确认

使用方式是否需要 Node.js / npm说明
只使用 Codex 桌面端不需要额外安装桌面端自带运行环境。只要能在设置或配置文件中写入供应商、Base URL 和 API Key,就不需要 npm 安装 Codex CLI。
只使用 Claude Desktop不需要额外安装Claude Desktop 是桌面聊天客户端,常规使用不依赖 npm。只有配置 MCP 服务或需要本地命令工具时,才可能按具体工具要求安装 Node.js。
使用 Claude Code / Codex CLI / Gemini CLI需要这些是命令行工具,通常需要 Node.js 和 npm 才能安装、升级和运行。

5、配置 CLI 或桌面端工具

先确认API请求地址,再选择 CC Switch 或传统手动配置。新手优先走 CC Switch,老鸟用户再考虑手动配置。

5.1 API 请求地址

登录控制台后,可以查看当前可用的 API Endpoint。先选择线路。

OpenAI 协议需要在下面基础url基础上添加 /v1 Gemini、Anthropic 等直接使用baseUrl /v1。 OpenAI 协议需要添加 /v1
线路默认填写地址说明
主线路https://9527.codes默认优先使用,适合大多数网络环境。
主线路二https://api.9527.codes主线路不可用或网络不稳定时切换。
亚太优化-线路一https://cdn.9527.codes亚太网络优先尝试,具体稳定性以当前网络为准。
国际腾讯线路https://txcdn.9527.codes国际网络可尝试该线路,具体稳定性以当前网络为准。

5.2 使用CC Switch进行API配置切换

下面按原文顺序完成下载、通用配置、供应商配置和直接对话测试。

1、下载并安装CC Switch

官方入口:ccswitch.io、GitHub Releases

打开releases之后,拉到下面assets,按需下载安装即可,一般用户根据系统选择图中框选的两个安装包之一即可

CC Switch GitHub Releases 的 Assets 下载文件列表
在 GitHub Releases 的 Assets 区域按系统选择安装包。
系统推荐方式操作要点
Windows.msi 安装包或 Portable 便携版长期使用选安装包;临时测试选便携版,解压后运行。
macOSHomebrew 或安装包如果系统拦截,进入“系统设置 - 隐私与安全性”允许运行。
Linux.deb 或 .AppImageAppImage 需要先添加可执行权限;deb 安装后按提示修复依赖。

2、修改通用配置

打开CC Switch,点击左上角的设置按钮->通用->窗口行为,开机自启可自行选择(我反正不开),其他可以全部打开(注意 设置->路由->本地路由 不要打开)

不要开启本地路由 这里按原文配置即可:设置->路由->本地路由 不要打开。
CC Switch 通用设置与窗口行为截图
CC Switch 通用设置:窗口行为可按习惯开启,本地路由不要打开。

3、配置api和key

1、选择对应客户端

claude cli和claude desktop需要分别配置,codex桌面端和cli使用一个配置即可。这里以codex为例

注意:不要开启本地路由! 本站已支持自动切换协议,除少部分特殊情况外,所有协议均填写不带 /v1 的地址。
CC Switch 中选择对应客户端标签页
选择对应客户端标签页后再添加供应商。

2、添加配置

预设供应商选择自定义配置

供应商名称按需填写,不填会默认为default。填写完毕后,确认autu.json和图片类似,没有refesh_token之类的字段,否则可能会在测试时报错

CC Switch 添加自定义供应商配置截图
预设供应商选择自定义配置,再填写地址和 Key。
CC Switch 配置文件内容截图
确认配置文件里不要出现 refresh_token 之类不该有的字段。

4、直接对话测试

配置完成后先重启客户端 保存配置后,请完全退出并重新打开对应客户端(如 Claude Code、Claude Desktop、Codex CLI),新的 API 地址和 Key 才会生效。重启后再发送简单对话测试。
不要使用CC Switch的测试按钮进行测试:本站不支持,直接打开对应工具进行测试。

codex:

Codex 直接对话测试截图
Codex 中发送简单对话进行验证。

claude:

Claude 直接对话测试截图
Claude 中发送简单对话进行验证。

claude桌面端新下载后打开CC Switch的跳过初次安装确认,在CC Switch中添加桌面端的供应商配置,启用配置后,直接打开Claude即可正常使用,无需额外开启开发者模式等操作

成功对话,回到本站控制台查看使用日志,出现正常请求日志即配置成功,可愉快使用了

9527code 控制台使用日志截图
控制台出现对应请求日志,即配置成功。
备选:手动配置 CLI 如果不用 CC Switch,再看这里。Claude Code 走 ANTHROPIC_ 变量;Codex CLI 走 OPENAI_ 变量。
Terminal
npm install -g @anthropic-ai/claude-code
export ANTHROPIC_BASE_URL=https://9527.codes
export ANTHROPIC_API_KEY=sk-your-api-key
claude
Terminal
npm install -g @openai/codex
export OPENAI_BASE_URL=https://9527.codes
export OPENAI_API_KEY=sk-your-api-key
codex

价格、模型和分组

1、如何查看分组模型以及模型价格

模型广场中查看分组模型和模型价格截图
模型广场中查看分组模型、价格和可用权限。

模型广场里的价格单位是“站内余额 / 1M Tokens”,不是美元。模型原始价格按官方 API 价格对齐;页面会结合当前模型分组倍率,把官方美元价格换算成站内余额价格。

价格换算示例 例如 gpt-5.4 官方 API 输入价格是 US$2.50 / 1M。如果当前可用模型分组的倍率是 0.38,模型广场显示的输入价格就是 2.50 × 0.38 = 0.95 站内余额 / 1M。这里的 0.38 是对应模型分组/套餐下的倍率,最终以控制台实际显示和扣费为准。

简单理解:分组单价 = 官方 API 价格 × 当前分组倍率。实际消耗再按请求 Token 数和模型广场展示的单价扣减。套餐、倍率和可用分组可能调整,最终以控制台当前显示为准。

2、分组介绍

模型分组

模型分组决定令牌可以请求哪些模型、走哪类渠道或协议。创建令牌时选择的是模型分组;选错分组会导致模型不可用、无法获取模型列表,或计费不符合预期。

default 分组不要选 新建令牌时按用途选择对应分组,选错分组可能导致模型不可用或消耗不符合预期。
分组名称说明
default默认用户存放分组,不要选
ClaudeClaude Max满血账号分组,只能使用官方工具(推荐cli)
Claude-企业Claude Max满血账号分组,可外接第三方工具,不支持龙虾
Claude-kirokiro账号分组
Claude-codex想在claude中使用codex模型,可使用该分组,无需本地路由,具体教程请跳转 claude中使用codex
codexGPT 20X Pro满血账号分组,支持外接
free英伟达渠道,福利分组,无专人维护,不保证可用性,限制高并发,高并发账号会被直接禁用
以控制台为准 文档可能存在延迟,所有分组以模型广场和添加令牌时的显示为准

用户订阅分组

用户订阅分组是套餐档位,例如 big、medium、lite。订阅分组不等于模型分组:它表示当前套餐下,哪些模型分组有对应的专属倍率。

订阅分组模型分组模型分组说明倍率
bigcodexGPT 20X Pro 满血账号分组,支持外接。0.30
claude-codex在 Claude 中使用 Codex 模型的分组,无需本地路由。0.30
claudeClaude Max 满血账号分组,只能使用官方工具(推荐 CLI)。1.45
claude-企业Claude Max 满血账号分组,可外接第三方工具,不支持龙虾。1.68
mediumcodexGPT 20X Pro 满血账号分组,支持外接。0.33
claude-codex在 Claude 中使用 Codex 模型的分组,无需本地路由。0.33
claudeClaude Max 满血账号分组,只能使用官方工具(推荐 CLI)。1.47
claude-aws(满血)Claude AWS 满血渠道分组,具体可用性以控制台为准。0.29
claude-企业Claude Max 满血账号分组,可外接第三方工具,不支持龙虾。1.75
litecodexGPT 20X Pro 满血账号分组,支持外接。0.35
claude-codex在 Claude 中使用 Codex 模型的分组,无需本地路由。0.35
订阅套餐使用事项 购买订阅不代表不能使用其他模型或模型分组;没有出现在上表里的组合,只是没有该订阅分组对应的特殊低倍率。实际请求仍受账户余额、令牌额度、令牌分组、访问限制、渠道状态、并发限制和模型上下文消耗影响,最终以控制台当前显示为准。

进阶玩法

在claude中使用codex模型

按下面四步配置 Claude-codex 分组。本站已支持自动映射,在 Claude 中使用 codex 模型不需要再手动映射模型,也不需要选择实际请求模型;高级选项仍然可以正常使用,手动选择实际请求模型不会影响使用。

1、单独添加令牌

令牌分组选择claude-codex

创建 Claude-codex 分组令牌截图
单独添加令牌并选择 Claude-codex 分组。

2、在cc switch中选择claude cli或desktop,并点击加号添加供应商

CC Switch 中为 Claude 添加供应商截图
在 Claude CLI 或 Desktop 对应标签页添加供应商。

3、高级选项,获取模型列表,实际请求模型把需要的codex模型选上去,保存

这一步现在不是必须操作,站点会自动完成模型映射;如果你习惯手动选择实际请求模型,仍然可以按图选择并保存。

高级选项中获取模型列表并选择 codex 模型截图
高级选项里获取模型列表,再选择实际请求模型。

4、重启claude终端或桌面端,发送简单的对话进行测试,查看本站控制台使用日志,是否有对应模型的请求

看到控制台使用日志中出现对应模型请求,即说明配置生效。若无法获取模型列表,先看 常见问题:无法获取模型列表?

常见问题

1、无法获取模型列表?

1

检查令牌分组

  • 若需要获取模型列表,令牌分组不可选择多个

2、401报错?

无法通过服务器验证,一般为key或api请求地址填写错误

先检查 Key 是否复制完整,再回到 API 请求地址 核对请求地址。

3、API Connect Error

1

本地网络异常

  • 检查网络连接是否正常
  • 尝试访问其他网站验证网络
2

代理服务不稳定

  • 检查代理配置
  • 尝试切换代理节点
3

残留的环境变量影响

  • 检查是否有曾经手动配置的残留环境变量覆盖了配置

4、400报错

上下文过大或上下文被污染,可新开对话尝试

5、无法绕过claude code桌面端登录

  1. 配置配错位置了,没有配置到桌面端上,检查CC Switch配置是否正常
  2. 没有打开跳过 Claude Code 初次安装确认

快速排障流程

  1. ✅ 检查令牌分组是否配置正确,密钥是否复制正确,api请求地址是否正确
  2. ✅ 检查对应客户端或工具配置文件是否正确修改,若使用CC Switch配置,请检查CC Switch是否为最新版本,更新到最新版本后,尝试重新添加供应商
  3. ✅ 检查网络和代理状态,若非老手,不要开启本地路由
  4. ✅ 查看 Token 余额
  5. ✅ 尝试重新开启会话
补充:环境变量验证 如果走手动配置,可以先确认环境变量存在,再启动客户端。
Terminal
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_API_KEY
echo $OPENAI_BASE_URL
echo $OPENAI_API_KEY
claude --version
codex --version

其他工具推荐

余额监控插件

Terminal
npm install -g 9527code-quota & 9527code-quota

Codex插件解锁工具 - codex++

Codex++ 是外部增强工具,不修改 Codex App 原始文件就可以让使用api登录的codex也能解锁插件。

https://github.com/BigPizzaV3/CodexPlusPlus

Claude/CodeX历史会话修复工具 - CC Sessions

https://github.com/ccpopy/cc-sessions