Token自由计划
本文介绍如何通过自建 API 中转站,统一管理和使用高质量模型 API。主要覆盖三类使用场景:
- 使用 Cherry Studio 进行多模型对话。
- 使用 CC Switch 管理 API 配置与模型代理。
- 在 Codex 或 Claude Code 中接入自建 API 进行编程辅助。
模型与价格:https://api.neonexus.top/pricing
注意:文档中的
NEWAPI_CC_KEY、NEWAPI_CODEX_KEY、NEWAPI_CHERRY_KEY均为占位符,请统一替换为你在第零节注册账号后自行创建的 API Key。
零、注册账号并获取 API Key
访问以下地址注册账号:
创建 API Key:
创建令牌时,建议根据实际使用场景选择对应的分组:
- Claude Code:选择 Claude Code 专用分组。
- Cherry Studio:支持多种接口,可选择 Auto 分组,由系统自动匹配。
- Codex:仅支持 Responses 接口,因此使用 Codex 时请选择 Codex 专用分组。
分组在创建令牌时选定,之后每个 Key 只走自己的分组,因此建议一个分组建一个 Key:Claude Code、Codex、Cherry Studio 各创建一个令牌,分别对应上面三个分组。这样切换软件时就不用回后台反复改分组,也就是开头提到的 NEWAPI_CC_KEY、NEWAPI_CODEX_KEY、NEWAPI_CHERRY_KEY 三个占位符。
默认令牌分组选 Auto 即可,但模型显示可能不准确:有些模型仅支持 Claude 接口,有些仅支持 OpenAI 接口。如果只是先试试,可以先用 Auto;如果选了某个模型后一直没有回复或者报错,请把使用记录发给管理员:
下文各章节需要填写的 API Key,均在这里自行创建并复制:
一、CC Switch:API 配置管理与代理工具
CC Switch(GitHub 仓库名为 cc-switch,官网 https://ccswitch.io)是 API 配置管理和模型代理的核心工具,建议最先安装。
提示:请安装最新版本的 CC Switch,无需与文档截图中的版本一致。
下载地址:
https://github.com/farion1231/cc-switch/releases
macOS 请选择 macOS.dmg(新版本已合并为通用包,同时支持 Apple 芯片与 Intel;旧版本分为 arm64 与 x86 两个安装包,按机型选择):
Windows 请按架构选择(ARM 机型选 arm64 版):
二、Claude Code 接入(插件与命令行)
1. 安装 Claude Code
Claude Code 可以通过命令行安装,也可以在 VS Code / PyCharm 插件市场中安装插件,推荐使用插件方式。
提示:请安装最新版本的 Claude Code,无需与文档截图中的版本一致。
VS Code 插件安装:
安装完成后不需要登录,保持当前状态即可:
2. 接入配置
目前支持的模型包括:
- DeepSeek V4 系列模型
- GLM 系列模型
- Kimi 系列模型
- MiniMax 系列模型
2.1 在 CC Switch 中添加供应商

向下滚动,填写以下信息:
供应商名称:NewAPI-cc
API Key:NEWAPI_CC_KEY【替换为你在第零节自行创建的 API Key】
请求地址:https://api.neonexus.top


点击「获取模型列表」:

推荐使用下列模型配置。可先按此处配置,后续再尝试其他喜欢的模型:

向下滑动,下方的配置 JSON 应如下所示:

2.2 重启 VS Code 并开始使用
配置完成后,重新打开 VS Code。看到对应状态后,即可开始使用 Claude Code 进行编码:
三、Codex 接入配置
1. 安装 Codex
提示:请安装最新版本的 Codex,无需与文档截图中的版本一致。
下载地址:
https://openai.com/zh-Hans-CN/codex/
安装 Codex 后,先关闭 Codex:
2. 在 CC Switch 中添加配置


供应商名称:NewAPI codex 专用
API Key:NEWAPI_CODEX_KEY【替换为你在第零节自行创建的 API Key】
API 地址:https://api.neonexus.top/v1



子代理设置推荐使用 DeepSeek:


新版已经支持我们的模型列表:

另外,上下文压缩需要保持开启:

四、Cherry Studio 综合对话配置
1. 添加 API 供应商
打开 Cherry Studio,添加 API 配置:
API 密钥:NEWAPI_CHERRY_KEY【替换为你在第零节自行创建的 API Key】
API 地址:https://api.neonexus.top
搜索 New API:


填写上述信息。
2. 选择模型并添加到对话
选择需要使用的模型:
在右侧添加模型后,即可在对话中使用。
不同厂商的模型添加后可能需要修改端点类型。大部分模型不需要修改,部分模型需要:
- GPT 系列模型:OpenAI-Response 端点
- Claude 系列模型:Anthropic 端点
- Gemini 系列模型:OpenAI 端点
- Kimi 系列模型:OpenAI 端点
- GLM 系列模型:Anthropic 端点
- MiniMax 系列模型:OpenAI 端点
- MiMo 系列模型:Anthropic 端点
- DeepSeek 系列模型:Anthropic 端点
说明:各家接口标准不一致,中转站虽然会自动转换,但为了获得完整能力、避免降智,最好按需指定端点类型。
下面举两个例子。添加模型后点击模型设置:
更新模型端点:
Gemini 系列端点修改:
3. 选择生图模型并添加到对话
新增生图模型 GPT-image-2,设置如下:
首先添加生图模型:
然后配置模型链接信息:
填写:https://api.neonexus.top/v1
同时设置默认模型:

使用时需要在工具栏开启生成:
效果:
QA:常见报错及其原因
1. 没有回复、回复慢,或报 500 / 400 错误
status_code=500, not implemented
status_code=400, Error from provider (Console): Upstream request failed: [invalid_request_error] Failed to deserialize the JSON body into the target type: tools[14].function: missing field name at line 1 column 17015
API Key 所属的令牌分组选错了。请到后台查看使用记录,选择与软件匹配的分组:
生成对应分组的令牌即可继续使用:
2. Cherry Studio 报错:端点类型不正确
codex channel: /v1/chat/completions endpoint not supported (request id: 202607150616095162701178268d9d6OnzYLdSu)
这里的报错与上面相反:问题出在 Cherry Studio 的端点类型上。按上文改成对应的端点类型即可解决:
请按上文调整端点类型:GPT 系列模型默认使用 OpenAI-Response 端点。
3. Codex 报错 503:找不到 GPT 模型
这是由于 Codex 的问题导致的。请更新 Codex 和 CC Switch,并按上面的要求设置模型列表,选择我们支持的模型;5.6 目前不支持。
unexpected status 503 Service Unavailable: No available channel for model gpt-5.6-sol under group codex(distributor
4. 报错 502 upstream error
近期网络线路不太稳定,如果频繁出现,请联系管理员切换备用线路,或者先使用国产模型。