5 步快速开始 API 信息 可用模型 常见问题 Codex CLI VS Code Codex 插件 Codex App OpenCode Cherry Studio Idea + Kilo Code OpenClaw cc-switch 一键配置 代理与邀请返利
新用户必看 · 通用配置宝典

欢迎来到 WeClawAi · 让我们快速开始吧

本文档涵盖从注册到 8 大客户端(Codex CLI、VS Code 插件、Codex App、OpenCode、Cherry Studio、Idea + Kilo Code、OpenClaw、cc-switch)的完整接入指南。所有配置 1:1 来自原版宝典,且 Base URL 已统一更新为新域名 weclawapi.com

生图

Cherry Studio + gpt-image-2

桌面客户端直出图像。

首先在浏览器中打开我们的网址 · 获取 GPT 模型

https://weclawapi.com/register?aff=twc5&promo=PAFHVLYPV 前往注册
1

第一步:注册一个账户

根据个人喜好填写用户名和密码。注册时邀请码用 twc5,promo 码用 PAFHVLYPV,首次充值即可享加赠。

一定要记住用户名 —— 找回密码需要用到,未绑邮箱时找不回。
2

第二步:注册完之后登陆刚刚注册好的账户

用刚注册的用户名 + 密码登录控制台。

3

第三步:点击钱包管理,充值额度。充值完之后你会看到当前额度

钱包管理 · 充值额度截图
钱包管理 · 选择档位 · 输入 promo 码 PAFHVLYPV 首充加赠 20%
4

第四步:充值完之后,此时就可以在操练场体验模型了

操练场体验模型
操练场 · 选模型 · 发送消息
5

第五步:如果需要 APIKEY 链接 codex 等客户端的继续往下看

点击 令牌管理,然后点击 添加令牌

令牌分组:default 分组就足够了,为了极致稳定可以 vip 分组(vip 消耗会快一些)。

令牌管理 · 添加令牌
令牌管理 → 添加令牌
6

第六步:提交完之后能看到你的令牌 API Key(密钥)

填写名称、令牌分组、过期时间(推荐"永不过期")、新建数量、额度(无限额度推荐开启)后点击 提交,列表里就能看到 密钥 列,点击复制即可。

API 信息

Base URL 与密钥使用方式

1. 我们的 baseurl 地址:https://weclawapi.com(OpenAI 兼容端点是 /v1),apikey 就是你复制的令牌,有这两样就可以了。

2. 复制令牌的时候看看前后有没有空格,要确保没有空格,否则使用的时候会报错。
有个别用户自己手动输入的,千万别写成 http 了,我们是 https

3. 创建好密钥之后,请记住你的 API 密钥和 baseurl 地址,因为这是配置 CODEX、OpenClaw 等 AI 工具使用的。

以上就是获取 API 请求地址和密钥的获取方式。

可用模型

目前支持的模型如下

gpt-5.5 gpt-5.4 gpt-5.4-mini gpt-5.3-codex gpt-5.3-codex-spark gpt-5.2 claude-opus-4-7 claude-opus-4-6 claude-sonnet-4-6 claude-haiku-4-5-20251001 gpt-image-2

模型实时计费倍率与详细说明见 模型价格页。常用搭配:编码主力 gpt-5.5、Codex 专调 gpt-5.3-codex、Anthropic 风格 Agent claude-opus-4-7、生图 gpt-image-2

常见问题清单

遇到下面这些先排查

问题 1:遇见断流超时错误代码(CODEX CLI 以及 VS CODEX 插件表现一样)
报错:stream disconnected before completion: error sending request for url

解决方案:重新开关下魔法,检查自己的网络环境!这是因为有可能被 CF 拦截了,也有可能是因为你的魔法梯子不稳定自动切换了 IP 然后导致当前的连接丢失断流。

我们的服务器是在国外,并且走的 CF 加速线路,如果有优质的魔法梯子会速度更快一点。当然国内也能访问使用。
问题 2:遇见 429 重试错误代码(CODEX CLI 以及 VS CODEX 插件表现一样)
报错:exceeded retry limit, last status: 429 Too Many Requests, request id: ...

典型额度用完了,查看下订阅套餐,是否已经用完了!

解决方案:前往你购买的地方商家,可以充值卡增量然后在后台的账单页面填写充值卡用于增量。
第一节

一、Codex CLI 配置使用教程

配置方案分为使用工具配置(方案 1)以及手动配置(方案 2)。

1.1 Windows 工具配置方案 1

1. 安装 Windows Terminal

  • Windows 里面使用 Codex CLI 建议使用 Windows Terminal 替代终端 cmd 启动
  • Windows Terminal 在使用和多开窗口上更加舒适和方便
  • 下载地址:github.com/microsoft/terminal/releases/tag/v1.23.20211.0(需要魔法才能打开)
  • 国内免魔法网盘下载地址:www.ilanzou.com/s/MzWnpE05
  • Windows 下载 Microsoft.WindowsTerminal_1.23.20211.0_x64.zip,解压后双击 WindowsTerminal.exe 启动,建议发送到桌面快捷方式方便下次启动

2. 安装 Node.JS 配置环境

(如果已安装过可以跳过)检查是否安装命令:node -v

  • 安装 Node.js 需要 node20+ 以上版本,下载软件包:nodejs.org/en/download
  • 一路点下一步,注意勾选"Automatically install the necessary tools"
  • 安装完成后会弹出一个 CMD 终端,按任意键继续
  • 验证:node -v,看到版本号即安装成功
特殊情况:如果终端启动 codex 时出现"codex:无法加载文件,因为在此系统上禁止运行脚本",请在 PowerShell 终端运行:
PowerShell
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
然后重新打开新终端即可。

3. 安装 Codex CLI

  • 终端输入:npm i -g @openai/codex 进行安装
  • 如果安装不上或下载失败(或没魔法),切换国内镜像源:
bash
npm config set registry https://registry.npmmirror.com
npm i -g @openai/codex

验证:codex --version 显示版本号即安装成功。

4. 配置 Codex CLI

先编辑配置文件(如果没有就新建,存在就覆盖):

  • Mac/Linux:~/.codex/config.toml
  • Windows:C:\users\你的用户名\.codex\config.toml
  • 如果不生效,可以在当前工作空间 .codex 文件夹下创建或覆盖 config.tomlauth.json

🌅 config.toml 直接粘贴或者覆盖为以下配置:

config.toml
model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true
sandbox_mode = "danger-full-access"
windows_wsl_setup_acknowledged = true
approval_policy = "never"
profile = "auto-max"
file_opener = "vscode"
model_provider = "codex"
web_search = "cached"
suppress_unstable_features_warning = true

[history]
persistence = "save-all"

[tui]
notifications = true

[shell_environment_policy]
inherit = "all"
ignore_default_excludes = false

[sandbox_workspace_write]
network_access = true

[features]
plan_tool = true
apply_patch_freeform = true
view_image_tool = true
unified_exec = false
streamable_shell = false
rmcp_client = true
elevated_windows_sandbox = true

[profiles.auto-max]
approval_policy = "never"
sandbox_mode = "workspace-write"

[profiles.review]
approval_policy = "on-request"
sandbox_mode = "workspace-write"

[notice]
hide_gpt5_1_migration_prompt = true

[model_providers.codex]
name = "codex"
base_url = "https://weclawapi.com/v1"
wire_api = "responses"
requires_openai_auth = true

🚅 auth.json 直接粘贴或者覆盖为以下配置:

auth.json
{
  "OPENAI_API_KEY": "这里填入在我们后台的你自己生成的 sk- 开头的密钥"
}

🏝 然后打开就能自动登录 Codex CLI 了。

5. 启动 Codex CLI

  • 终端输入:codex --dangerously-bypass-approvals-and-sandbox
  • 或者:codex --yolo
  • 这两条命令都行,是免安全审批的 Codex 启动命令(不需要批准自动执行)
注意:家人们目前已经支持 c 系列了,但由于它还没有全面送 Codex 5.3 xhigh,很多小伙伴的 codex cli 或 codex 插件无法直接选中这个模型。
我们的工具默认配置好之后就是 GPT-5.3-xhigh。修改之后也是无法自由切换模型的,默认就是 5.3 xhigh。如果不小心切换了,请重新修改 C 盘目录下的 .codex 文件夹下面的 config 文件将模型名字换成 gpt-5.3-xhigh,重启终端或者 VS 的 CODEX 插件都是可以恢复到 gpt-5.3-xhigh 的。

2.1 MAC / LINUX 工具配置方案 1

1. Node.js 环境配置

使用 MAC 的终端 CMD 进行安装和配置启动。需要安装 Node 20+ 以上版本:nodejs.org/en/download

bash
node --version

2. 安装 Codex CLI

bash
# 海外
npm i -g @openai/codex

# 国内镜像
npm config set registry https://registry.npmmirror.com
npm i -g @openai/codex

# 验证
codex --version

3. 配置 Codex CLI

Mac/Linux 配置在 ~/.codex/config.tomlconfig.toml 内容与 Windows 完全一致(见上方 Windows 章节,base_url 同为 https://weclawapi.com/v1)。auth.json 也相同。

4. 启动 Codex CLI

  • 终端输入:codex --dangerously-bypass-approvals-and-sandbox
  • 或者:codex --yolo
第二节

二、VS Code / Cursor / Trae Codex 插件配置教程

1.1 常见报错

  • 报错:配置后发现 401 提示密钥不正确,这一定是没有 替换 或者 创建 config.tomlauth.json
  • 这两个文件导致请求的还是 OPENAI 的官方,没有请求我们中转站,或者没有重启 VS 工具重新加载配置文件
  • 请再次按照教程创建或者替换 config.tomlauth.json 这两个文件,重启 IDE 工具即可
  • 请宝子们务必细心检查!
  • 如果遇见报错,请一定要截图进行翻译,这样宝子们自己也知道是什么原因报错了!

1.2 配置方案

  • 先编辑下配置文件(如果没有就新建,存在的话就覆盖)
  • Mac/Linux:~/.codex/ 目录下,创建或覆盖 config.tomlauth.json
  • 如果没有 .codex 文件夹也可以使用终端命令创建:
bash
rm -rf ~/.codex
mkdir ~/.codex   # 创建配置目录
  • Windows:C:\users\你的用户名\.codex\ 目录下
  • 注意:若之前使用官方或其他平台登录过,请先退出账号登录,再进行配置!

config.toml 内容与第一节完全相同base_url = "https://weclawapi.com/v1")。auth.json 同样:

auth.json
{
  "OPENAI_API_KEY": "这里填入在我们后台的你自己生成的 sk- 开头的密钥"
}

然后打开 VS、Cursor、Trae 里面的 Codex 插件就能够自己登陆了。

Visual Studio Code 插件安装教程

  • 适合通过 VS Code 图形界面安装 Codex 插件的用户
  • 打开 VS Code 后先选择任意项目文件夹进入工作区。不然会提示弹窗要求你打开项目文件夹
  • 打开左侧插件扩展界面进入扩展面板
  • 搜索 Codex,选择 Codex – OpenAI's coding agent 点击安装
  • 安装完成后侧栏会出现 Codex 入口
  • 注意:若之前使用官方或其他平台登录过,请先在 Codex 面板里 Log out 退出登录,再进行重新配置!
  • 配置好后点开就出现登录界面,点击 Continue 完成登录流程
注意:5.3 的模型不会在下拉列表展示,鼠标移动到"自定义"可以看到当前正在使用的模型。或者在后台调用记录可以看到实际的请求模型。
第三节

三、Codex App 桌面客户端配置方式

👋 如果你不想安装 Codex CLI,只需要在使用 CODEX APP 桌面客户端,可以参考此方法。

如果之前你登陆过自己的账号,请先在 CODEX APP 里面退出当前账号,然后再进行重新配置。
警告:之前登陆过自己的 GPT 账号的,在更换 API 之后,历史的对话记录会不存在,因为账号类型的他的历史对话都是保留在 GPT 账号的空间里面,本地是没有的。但是更换 API 登陆之后以后所有的历史对话记录都会保存在本地,都不会丢失!

第一步:创建配置文件

  • Mac/Linux:在你的用户名目录下创建 .codex 文件夹。如果文件夹已经存在,建议先删掉里面的 auth.json config.toml 再重新创建,避免旧配置干扰。
  • 也可以使用终端命令创建:
bash
rm -rf ~/.codex
mkdir ~/.codex   # 创建配置目录

接下来在 .codex 文件夹里创建两个文件:

auth.json — 存放你的 API 密钥:

auth.json
{
  "OPENAI_API_KEY": "这里填入在我们后台的你自己生成的 sk- 开头的密钥"
}

config.toml — 配置服务提供商(内容与前两节完全相同,base_url 同为 https://weclawapi.com/v1)。

注意事项

  • 一般都在用户目录下的 .codex 文件夹内,如果在用户目录下找不到 .codex 这个文件夹,可以手动创建该文件夹,和手动创建 config.tomlauth.json 即可
  • 注意:若之前使用官方或其他平台登录过,请先退出登录,再进行配置!
  • 如果手动创建不了 .codex 文件夹,请参考第一节 Codex CLI 配置使用教程 重启 CODEX APP 也是一样的
🌵 然后重新打开 CODEX APP 就能够自己登陆了使用了。
第四节

四、OpenCode 配置使用教程

安装

OpenCode 按照官方文档安装即可:opencode.ai/docs/#安装

配置模型

安装完成后,编辑配置文件 ~/.config/opencode/opencode.json,添加模型提供商:

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "jnm": {
      "npm": "@ai-sdk/openai",
      "name": "jnm",
      "options": {
        "baseURL": "https://weclawapi.com/v1"
      },
      "models": {
        "gpt-5.3-codex": {
          "name": "GPT-5.3-codex",
          "thinking": true,
          "modalities": {
            "input": ["text", "image", "pdf"],
            "output": ["text"]
          },
          "limit": {
            "context": 400000,
            "output": 128000
          },
          "options": {
            "store": false,
            "reasoningEffort": "xhigh",
            "textVerbosity": "high",
            "reasoningSummary": "auto",
            "include": ["reasoning.encrypted_content"]
          }
        },
        "gpt-5.2-codex": {
          "name": "GPT-5.2 Codex",
          "options": {
            "include": ["reasoning.encrypted_content"],
            "store": false
          }
        }
      }
    }
  }
}

配置密钥

方式一:使用命令行(推荐)

bash
# 登录或更新某个供应商的 Key
opencode auth login

# 查看当前已配置的所有供应商和 Key 状态
opencode auth list

# 删除指定供应商的 Key
opencode auth logout <供应商名称>

方式二:手动编辑配置文件

~/.local/share/opencode/auth.json 中添加对应供应商的 API Key。

注意:auth.json 中的供应商名称必须与 opencode.json 中的供应商名称完全一致。
auth.json
{
  "jnm": {
    "type": "api",
    "key": "你的API密钥"
  }
}

小技巧:在 OpenCode 中按 Ctrl + T 可切换不同的推理强度(variants)。

第五节

五、Cherry 配置使用教程

下载

安卓下载 .apk,苹果下载 .ipa,安装方式和电脑差不多。

配置步骤

  • 下载好点击右上角的螺丝(设置),然后添加提供商
  • 提供商名称:随意(例如 weclawai
  • 提供商类型:选第二个 OpenAI-Response(注意不是第一个 OpenAI)
  • API 密钥:填你的 sk- 令牌
  • API 地址:https://weclawapi.com/v1
  • 模型:手动添加要使用的模型(按照模型中心名称一一对应),例如 gpt-5.4gpt-image-2
第六节

六、Idea 里面使用第三方插件 Kilo Code 配置教程

  • 在 IDEA 插件市场搜索安装 Kilo Code 第三方插件
  • 打开 Kilo Code Settings → Providers
  • API Provider:必须选 OpenAI Compatible (Responses)
  • Base URL:https://weclawapi.com/v1
  • API Key:你的 sk- 令牌
  • Model:模型名需要手动填写,例如 gpt-5.3-codex
Auto-Approve:建议勾选 YOLO Mode(Enable YOLO Mode - Auto-approve EVERYTHING),开启后所有操作自动通过审批,不再弹确认。
第七节

七、小龙虾 OpenClaw 安装指南

1 配置方案(手动配置)

安装过程中可以先不管模型配置,安装完成后,直接去编辑配置文件 ~/.openclaw/openclaw.json。其中模型配置部分 models 直接使用下面这个,sk-xxxx 替换成你的密钥:

openclaw.json
"models": {
  "providers": {
    "jnm": {
      "baseUrl": "https://weclawapi.com/v1",
      "apiKey": "你的密钥 sk-********************",
      "auth": "api-key",
      "api": "openai-responses",
      "authHeader": true,
      "models": [
        {
          "id": "gpt-5.3-codex",
          "name": "GPT-5.3 Codex",
          "reasoning": true,
          "input": ["text", "image"],
          "cost": {
            "input": 1.75,
            "output": 14,
            "cacheRead": 0.175,
            "cacheWrite": 0.175
          },
          "contextWindow": 400000,
          "maxTokens": 128000
        }
      ],
      "headers": {
        "User-Agent": "Mozilla/5.0 (X11; Linux x86_64) OpenClaw/2026.2.14",
        "Accept": "application/json"
      }
    }
  }
},
"agents": {
  "defaults": {
    "model": {
      "primary": "jnm/gpt-5.3-codex"
    },
    "models": {
      "jnm/gpt-5.3-codex": {
        "alias": "GPT 5.3 Codex"
      }
    },
    "workspace": "/root/.openclaw/workspace",
    "compaction": {
      "mode": "safeguard"
    },
    "maxConcurrent": 4,
    "subagents": {
      "maxConcurrent": 8
    }
  }
}
🌵 设置 OpenClaw 里面的 GPT5.3-CODEX 推理强度:
全局默认从 low 改成 xhigh 或者 high(推荐)。在 agents.defaults 里加一行(和 maxConcurrent 同级):
openclaw.json
"agents": {
  "defaults": {
    "workspace": "/root/这里需要改成你的小龙虾路径/.openclaw/workspace",
    "compaction": { "mode": "safeguard" },
    "maxConcurrent": 4,
    "subagents": { "maxConcurrent": 8 },

    "thinkingDefault": "xhigh",

    "model": { "primary": "jnm/gpt-5.3-codex" }
  }
}

改完后重启 OpenClaw gateway / 主进程生效。

第八节

八、捷径:cc-switch 自动配置 codex、claude code、openclaw

cc-switch 可以帮助你自动改配置文件。

一、codex 的配置

  1. cc-switch 顶栏选 Codex(升级后叫 openai)
  2. 预设供应商选 自定义配置
  3. 照着填好:供应商名称 / 备注 / 官网链接 https://weclawapi.com/v1 / API Key / API 请求地址 https://weclawapi.com/v1 / 模型名称 gpt-5.4
  4. 显示使用中
  5. 开始愉快使用
备注:想启用 xhigh 模式在 cc-switch 这启用 —— 编辑供应商 → Codex auth.json 配置内容 → config.toml 里把 model_reasoning_effort = "xhigh"

二、Claude code 的配置

  1. cc-switch 顶栏选 Claude,点右上 + 新建
  2. 自定义配置:供应商名称 / 备注 / 官网链接 https://weclawapi.com / API Key
  3. 请求地址:https://weclawapi.com不要以斜杠结尾
  4. API 格式:Anthropic Messages(原生)
  5. 主模型 / 推理模型(Thinking)/ Haiku 默认模型 / Sonnet 默认模型 / Opus 默认模型:都可填 gpt-5.4 或对应 claude 模型
  6. 保存使用即可

三、openclaw 的配置

  1. cc-switch 顶栏选 OpenClaw,点右上 + 新建
  2. 预设供应商选 自定义配置
  3. 供应商标识:唯一标识符(创建后无法修改,只能使用小写字母、数字和连字符,例如 weclawai
  4. 供应商名称:例如 weclawai
  5. 官网链接:https://weclawapi.com/v1
  6. API 协议:OpenAI Completions
  7. API 端点:https://weclawapi.com/v1
  8. API Key:你的 sk- 令牌
  9. 模型列表:添加 gpt-5.4(模型 ID 和显示名称都填 gpt-5.4)
  10. 配置 JSON:
JSON
{
  "api": "openai-completions",
  "apiKey": "sk-llllllllllllllllllllllllllllllllllllllll",
  "baseUrl": "https://weclawapi.com/v1",
  "models": [
    {
      "id": "gpt-5.4",
      "name": "gpt-5.4"
    }
  ]
}

之后打开大龙虾对话就行了。

第九节

九、代理合作 与 白嫖方式

  1. 代理合作(拿货返利) —— 详见首页 合伙人计划,金/银/铜 三级返利 30%/25%/20%,邀请制,由管理员发放。
  2. 白嫖方式(邀请好友,永久获得返利) —— 详见首页 推广返利,邀请好友首充 20% 加赠 + 你获 10% 持续返利。

奖励到账后在 钱包页 一键划转到账号余额。

已复制