Claude Code / Codex · 中转站小白接入指南
AI API 中转站使用文档:从购买、安装到 Base URL 配置与 FAQ 排查
这里整理了 Claude Code、Codex 和 OpenAI 兼容客户端的常用配置方式。你可以直接复制 Base URL 示例,按步骤完成安装、配置、验证和常见错误排查。
配置前准备
在账户页面生成或查看,示例统一写成 sk-xxxxxxxx。不要写进公开仓库、截图、README 或聊天记录。
Claude Code 通常填写 https://www.aigcwuji.com;Codex、OpenAI 兼容 SDK 和 OpenClaw 通常使用 https://www.aigcwuji.com/v1。
以账户页面展示为准,不猜测官方 model id。Claude Code 和 Codex 的字段名不同。
配置后完全关闭工具和终端,重开后发送“请回复配置已生效”。
Claude Code 地址:https://www.aigcwuji.com
Codex / OpenAI / OpenClaw 兼容地址:https://www.aigcwuji.com/v1
示例 Key:sk-xxxxxxxxxxxxxxxx
验证消息:请回复“配置已生效” 服务入口
中转站地址
客户端配置统一使用这个地址。Claude Code 使用根域名,Codex / OpenAI 兼容 SDK 通常使用 /v1。
https://www.aigcwuji.com/v1 →服务入口
在线购买兑换码
链动小店支持在线购买兑换码。新用户建议先小额测试,跑通后再追加。
立即购买 →服务入口
QQ 售后交流群
遇到配置、额度、连接失败或使用问题,可以加入群内咨询售后。
加入交流群 →服务入口
TG 售后群
Telegram 用户可以加入 TG 群,反馈配置、额度、线路和客户端接入问题。
加入 TG 群 →服务入口
TG 订阅频道
订阅 Telegram 频道,获取线路通知、使用说明更新和服务公告。
订阅频道 →Start by situation
按你的情况开始
第一次使用、已有 Key、VS Code / Cursor 插件、手动配置、排错都可以从这里进入。
第一次使用
先确认余额/倍率/线路、API Key 和目标客户端,再选择自动导入、插件接入或手动配置。
进入路径 → 02Claude Code
VS Code / Cursor 里优先看插件入口;手动配置则检查 settings.json 的 env 和编辑器重启。
进入路径 → 03Codex
VS Code / Cursor 扩展与 CLI 共用配置;config.toml 写 provider,auth.json 写 API Key。
进入路径 → 04OpenClaw
按官方结构配置 models.providers、auth.profiles、agents.defaults,并确认 Think 已真正开启。
进入路径 → 05配置失败
按 Key、线路、模型、旧登录态、进程重启、JSON/TOML 格式六类排查。
进入路径 →Quick Start
新机器推荐路径
读购买需知
先弄清额度、倍率、线路和要用的客户端。新用户建议小额测试,跑通后再追加。
选客户端路径
如果你主要在 VS Code / Cursor 里写代码,优先看插件入口;纯终端再走手动配置。
导入、插件或手动配置
能用 ccswitch 就先导入;用扩展时再看 VS Code / Cursor 插件说明;都不行再改配置文件。
发送测试消息
只发短消息验证 Key、Base URL、模型、余额和线路,不要一上来跑长任务。
ccswitch
已安装工具时,优先用 ccswitch 导入
ccswitch 适合已经装好 Claude Code 或 Codex 的用户。它可以帮助管理 API Key 和 Base URL,减少手动编辑 JSON/TOML 的出错概率。导入后仍要完全关闭客户端和终端再验证。
在账户页面准备 API Key 和 Base URL
允许浏览器打开 ccswitch
确认供应商、端点和打码后的 Key
在 ccswitch 列表确认 Base URL 和当前配置
Claude Code
Claude Code 插件 / 手动配置
如果你主要在 VS Code / Cursor 里使用 Claude Code,优先看插件入口;自动导入不可用时,再手动修改 settings.json。重点是先备份、只合并 env 字段、不要清空已有配置。
%USERPROFILE%\.claude\settings.json
~/.claude/settings.json
ANTHROPIC_API_KEY、ANTHROPIC_BASE_URL
CLAUDE_AUTOCOMPACT_PCT_OVERRIDE=78,用于提前触发压缩,适合长任务。
{
"env": {
"ANTHROPIC_API_KEY": "sk-xxxxxxxxxxxxxxxx",
"ANTHROPIC_BASE_URL": "https://www.aigcwuji.com",
"CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "78"
}
}保存后完全关闭 Claude Code 和终端,重新打开执行 claude,再发送测试消息。认证失败优先查 Key;连接失败优先查 Base URL 和线路。
Codex
Codex 插件 / 手动配置
Codex 在 VS Code / Cursor 里更常见的入口是 IDE 扩展,且扩展与 CLI 共用配置;需要精确控制 Base URL、provider 和 Key 时,再检查 config.toml 与 auth.json。
%USERPROFILE%\.codex\config.toml 与 %USERPROFILE%\.codex\auth.json
~/.codex/config.toml 与 ~/.codex/auth.json
model_provider、model、[model_providers.custom]、base_url、wire_api。
OPENAI_API_KEY 字段,只放在用户目录,不放进项目。
# ~/.codex/config.toml
model_provider = "custom"
model = "gpt-5.4"
[model_providers.custom]
name = "custom"
base_url = "https://www.aigcwuji.com/v1"
wire_api = "responses"
requires_openai_auth = true
# ~/.codex/auth.json
{
"OPENAI_API_KEY": "sk-xxxxxxxxxxxxxxxx"
}验证:重开终端后执行 codex login status,再进入 codex 发送测试消息。
OpenClaw
OpenClaw API 中转站配置:Base URL、Provider 与 Think 排查
OpenClaw 新版配置建议按官方结构拆分:models.providers 定义中转站,auth.profiles 声明鉴权方式,agents.defaults 选择默认模型。若中转站支持 /v1/responses,优先使用 openai-responses;只支持 /v1/chat/completions 时再用 openai-completions。
OpenClaw 走 OpenAI 兼容入口时,通常填写 https://www.aigcwuji.com/v1,不是根域名。
models.providers 管上游,auth.profiles 管鉴权模式,agents.defaults.model.primary 选择默认模型。
支持 /v1/responses 优先 openai-responses;遇到 404 或 endpoint 不兼容时切回 openai-completions。
模型声明支持思考后,还要在 UI 选择 Think 档位或使用 /reasoning,再用 /status 验证。
以下为首页节选,用于说明 provider 与默认模型写法;完整 SOP、auth-profiles.json、Responses / Completions 选择和 Think off 排查请查看 OpenClaw 配置指南。
{
"models": {
"mode": "merge",
"providers": {
"api-proxy-claude": {
"baseUrl": "https://www.aigcwuji.com/v1",
"apiKey": "sk-xxxxxxxxxxxxxxxx",
"api": "openai-responses",
"models": [
{
"id": "gpt-5.4",
"name": "gpt-5.4",
"api": "openai-responses",
"reasoning": true,
"contextWindow": 200000,
"maxTokens": 8192
}
]
}
}
},
"agents": {
"defaults": {
"model": { "primary": "api-proxy-claude/gpt-5.4" }
}
}
}此代码块是节选,不建议直接复制到生产配置;完整可复制配置、错误排查表和 auth-profiles.json 示例见 /openclaw-api-config。真实 Key 请使用占位替换,不要公开。
Advanced
长对话、缓存与记忆文件
上下文窗口
历史消息、文件和工具结果都会占上下文。窗口大小随模型和线路变化,建议以当前模型说明为准。
自动压缩
长任务可能触发压缩,早期细节变模糊,缓存重新建立,下一次请求费用可能上升。
记忆文件
Claude Code 用 CLAUDE.md,Codex 用 AGENTS.md。只写长期规则、命令和业务约束,不写 Key、Cookie、Token。
Troubleshooting
先做三步:确认 Key、确认线路、重启工具
401 / Unauthorized / invalid key
Key 错、复制多了空格、写错字段或客户端读了旧配置。重新生成或复制 Key,确认字段名,重启终端。
连接失败 / timeout
Base URL 错、线路不可用、本地代理冲突或网络阻断。换线路,确认 URL 没有多余路径或末尾斜杠问题。
model not found
模型名拼写、provider 或账户权限不匹配。只使用账户页面展示的 model id。
429 / rate limit
并发过高、余额不足、RPM/TPM 限制或上游限流。降低并发,短 prompt 复测,设置退避重试。
改完没变化
旧终端或旧工具进程仍在,或者改错配置文件。完全退出 Claude Code / Codex 和终端后重开。
JSON / TOML 报错
settings.json、auth.json 或 config.toml 格式不合法。检查双引号、逗号、表头和缩进。
Topic Cluster
按客户端和错误类型查看专题
首页讲完整路径,专题页提供更具体的客户端配置、错误码排查和安全清单。
VS Code / Cursor 插件接入
Claude Code、Codex、插件安装、登录、中转站、审批模式与排错。
查看专题 →Claude Code 手动配置
settings.json、ANTHROPIC_API_KEY、ANTHROPIC_BASE_URL、压缩阈值与排错。
查看专题 →Codex 手动配置
config.toml、auth.json、model_provider、OPENAI_API_KEY 与验证流程。
查看专题 →OpenAI 兼容 API
base_url、/v1、SDK 迁移、Cursor / Cline / Roo Code 通用配置。
查看专题 →OpenClaw 中转站配置
models.providers、auth.profiles、agents.defaults、Responses 和思考模式。
查看专题 →API Key 安全清单
Key 分组、预算、日志、敏感数据和团队权限。
查看专题 →401 Invalid Key 排查
API Key、Header、字段名、旧登录态和项目权限。
查看专题 →Model Not Found 排查
模型名、provider、路径、账户权限和上游状态。
查看专题 →429 与余额排查
并发、余额、RPM/TPM、上游限流和退避重试。
查看专题 →FAQ
常见问题
这个站应该承接哪些搜索?
核心解答 Claude Code 中转站、Codex API 配置、VS Code 插件、中转站 Cursor 配置、OpenAI compatible base_url、API Key 配置、401/model not found/429 排查等实际使用问题。
为什么统一使用 531288 中转地址?
本站统一使用 https://www.aigcwuji.com 作为根域名;Codex 与 OpenAI 兼容客户端按页面示例加 /v1。若服务地址后续调整,会在官网同步更新。
Claude Code 应该用 ANTHROPIC_API_KEY 还是 ANTHROPIC_AUTH_TOKEN?
不同版本和接入方式可能读取字段不同。通用文档优先写 settings.json 的 env,并提醒以客户端当前文档和账户页面显示为准;如果已有配置,不要清空整文件,只合并 env 字段。
VS Code / Cursor 装了插件,为什么还是没走中转?
常见原因是扩展仍在读旧登录态、编辑器没有继承新的环境变量、配置文件改错目录,或者你改的是 Cursor 原生 API 而不是 Claude Code / Codex 插件本身。
Codex 的 Key 写在哪里?
写在用户目录的 ~/.codex/auth.json 或 Windows 用户目录对应文件里,不要写入项目仓库。字段通常是 OPENAI_API_KEY。
OpenClaw 怎么配置中转站?
按官方结构在 models.providers 写 baseUrl、apiKey、api 和模型列表,在 auth.profiles 绑定 provider,在 agents.defaults.model.primary 选择 api-proxy-claude/gpt-5.4。
OpenClaw 思考模式怎么开启?
模型条目先声明 reasoning: true,然后在 UI 选择 Think 档位或使用 /reasoning;只改配置不一定会打开当前会话开关。
ccswitch 导入后为什么没生效?
常见原因是浏览器没拉起 ccswitch、导入的是旧 Key、工具进程没完全退出,或 Claude Code / Codex 实际读取了另一个配置文件。
缓存和压缩会影响费用吗?
会。长对话可能触发压缩,旧缓存失效后下一次请求费用可能升高。推荐把长期项目规则写进 CLAUDE.md 或 AGENTS.md。
为什么有时显示的模型和我选的不一样?
客户端可能对标题、辅助任务或轻量步骤使用不同模型。正式任务仍应按主模型策略与账户记录判断。
服务全部不可用怎么办?
先等几分钟并换线路复测;如果多个客户端都失败,可能是上游官方 API、线路或网关波动。不要无限重试,先看公告或联系支持。
生产环境怎么更安全?
按成员、项目、环境拆 Key;设置日/月预算和速率限制;日志只保留必要计费与错误信息;定期轮换 Key。
还是解决不了怎么办?
整理系统、工具、配置方式、错误截图、最后 20 行终端输出、是否换过线路,再发给支持或客服,排查效率最高。