Claude Code / Codex · 中转站小白接入指南

AI API 中转站使用文档:从购买、安装到 Base URL 配置与 FAQ 排查

这里整理了 Claude Code、Codex 和 OpenAI 兼容客户端的常用配置方式。你可以直接复制 Base URL 示例,按步骤完成安装、配置、验证和常见错误排查。

配置文档

配置前准备

API Key

在账户页面生成或查看,示例统一写成 sk-xxxxxxxx。不要写进公开仓库、截图、README 或聊天记录。

Base URL

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
验证消息:请回复“配置已生效”

Start by situation

按你的情况开始

第一次使用、已有 Key、VS Code / Cursor 插件、手动配置、排错都可以从这里进入。

Quick Start

新机器推荐路径

01

读购买需知

先弄清额度、倍率、线路和要用的客户端。新用户建议小额测试,跑通后再追加。

02

选客户端路径

如果你主要在 VS Code / Cursor 里写代码,优先看插件入口;纯终端再走手动配置。

03

导入、插件或手动配置

能用 ccswitch 就先导入;用扩展时再看 VS Code / Cursor 插件说明;都不行再改配置文件。

04

发送测试消息

只发短消息验证 Key、Base URL、模型、余额和线路,不要一上来跑长任务。

ccswitch

已安装工具时,优先用 ccswitch 导入

ccswitch 适合已经装好 Claude Code 或 Codex 的用户。它可以帮助管理 API Key 和 Base URL,减少手动编辑 JSON/TOML 的出错概率。导入后仍要完全关闭客户端和终端再验证。

01

在账户页面准备 API Key 和 Base URL

02

允许浏览器打开 ccswitch

03

确认供应商、端点和打码后的 Key

04

在 ccswitch 列表确认 Base URL 和当前配置

Claude Code

Claude Code 插件 / 手动配置

如果你主要在 VS Code / Cursor 里使用 Claude Code,优先看插件入口;自动导入不可用时,再手动修改 settings.json。重点是先备份、只合并 env 字段、不要清空已有配置。

Windows 路径

%USERPROFILE%\.claude\settings.json

macOS / Linux 路径

~/.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。

Windows 路径

%USERPROFILE%\.codex\config.toml 与 %USERPROFILE%\.codex\auth.json

macOS / Linux 路径

~/.codex/config.toml 与 ~/.codex/auth.json

config.toml

model_provider、model、[model_providers.custom]、base_url、wire_api。

auth.json

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。

1. Base URL 填哪里?

OpenClaw 走 OpenAI 兼容入口时,通常填写 https://www.aigcwuji.com/v1,不是根域名。

2. 新版先看三层

models.providers 管上游,auth.profiles 管鉴权模式,agents.defaults.model.primary 选择默认模型。

3. Responses 还是 Completions?

支持 /v1/responses 优先 openai-responses;遇到 404 或 endpoint 不兼容时切回 openai-completions。

4. reasoning true 但 Think off

模型声明支持思考后,还要在 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

按客户端和错误类型查看专题

首页讲完整路径,专题页提供更具体的客户端配置、错误码排查和安全清单。

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 行终端输出、是否换过线路,再发给支持或客服,排查效率最高。

下一步:选择你的客户端配置方式

继续查看 Claude Code、Codex、OpenAI 兼容 API、错误排查和 API Key 安全专题,按自己的客户端选择对应配置方式。

打开中转站