Codex 一键安装配置指南

本文用于引导用户通过安装页生成命令，并把命令导入自己的 Windows、macOS 或 Linux 系统。

安装入口：

text

https://open-codex.com/install/

默认 Base URL：

text

https://api.open-codex.com/v1

先注册账号并订阅 1 元体验卡

新用户建议先注册账号，再到钱包页面订阅 20刀体验卡。体验卡价格为 ¥1，有效期 1 day，总额度 ¥20.00，每个账号限购一次。

1. 打开注册页

访问：

text

https://api.open-codex.com/register

填写 Username、Password、Confirm Password，然后点击 Sign up。如果页面出现 Cloudflare 人机验证，按页面提示完成验证。

如果注册页提示管理员关闭新用户注册，请联系管理员开通账号；拿到账号后从登录和钱包步骤继续。

2. 登录后进入钱包页面

注册完成后登录账号，再访问：

text

https://api.open-codex.com/console/topup

也可以从左侧菜单进入：

text

Personal Center -> Wallet Management

3. 选择 20 刀体验卡

在 Subscription Plans 里找到 20刀体验卡，确认价格为 ¥1，有效期为 1 day，总额度为 ¥20.00，然后点击 Subscribe now。

4. 确认支付

弹窗里再次确认：

text

Plan Name：20刀体验卡
Validity：1 day
Total quota：¥20.00
Amount Due：¥1

选择支付方式后点击 Pay，按支付页面提示完成支付。支付完成后回到钱包页面，刷新后可以看到订阅状态。

安装页截图

打开安装页后，页面会自动加载当前站点的默认 Base URL。用户只需要填写卡密、选择模型和系统，再复制页面生成的命令。

1. 打开安装页

在浏览器访问：

text

https://open-codex.com/install/

如果你已经登录，并且账号下有卡密，安装页会自动填入可用卡密。没有自动填入时，手动把自己的卡密粘贴到 卡密 输入框即可。

同一台电脑、同一个浏览器里，页面会记住你上次填写的卡密；如果你手动改了卡密，下次再打开会继续使用你改后的值。

2. 确认 Base URL 和模型

Base URL 默认已经填好：

text

https://api.open-codex.com/v1

普通用户保持默认即可。如果你需要自定义服务地址，可以直接编辑 Base URL 输入框。

默认模型为：

text

gpt-5.5

如需使用 gpt-5.4，在模型选项里切换即可。

3. 选择系统并复制命令

安装页会根据系统生成不同命令。请按自己的设备选择：

Windows 用户选择 Windows。
macOS 用户选择 macOS。
Linux / 服务器用户选择 Linux。

操作顺序：

text

选择系统标签
  -> 检查卡密、Base URL、模型
  -> 点击复制命令
  -> 粘贴到对应系统的终端执行

4. Windows 导入方式

在安装页选择 Windows。
点击 复制 Windows 命令。
在 Windows 开始菜单搜索 PowerShell。
右键选择 以管理员身份运行。没有管理员权限时，也可以先用普通 PowerShell 尝试。
粘贴安装页复制的命令。
按回车执行，等待安装完成。

text

开始菜单
  -> 搜索 PowerShell
  -> 以管理员身份运行
  -> 粘贴命令
  -> Enter

如果 PowerShell 提示是否允许脚本执行，安装命令里已经包含临时放行策略，完整粘贴执行即可。

5. macOS 导入方式

在安装页选择 macOS。
点击 复制 macOS 命令。
打开 终端 或 iTerm2。
粘贴命令。
按回车执行。
如果系统要求输入开机密码，正常输入即可；输入密码时终端通常不会显示字符。

text

打开终端
  -> 粘贴命令
  -> Enter
  -> 按提示输入系统密码

6. Linux 导入方式

在安装页选择 Linux。
点击 复制 Linux 命令。
打开本机终端，或用 SSH 登录服务器。
粘贴命令。
按回车执行。
如果提示输入 sudo 密码，输入当前用户密码后继续。

text

SSH 登录服务器
  -> 粘贴 Linux 命令
  -> Enter
  -> 按提示输入 sudo 密码

7. 安装完成后验证

安装命令会自动安装 Node.js、安装 Codex，并写入 ~/.codex 配置。完成后可以检查版本：

bash

codex --version

检查配置目录：

bash

ls -la ~/.codex

启动 Codex：

bash

codex --dangerously-bypass-approvals-and-sandbox

Windows 用户如果当前窗口找不到 codex，关闭 PowerShell 后重新打开，再执行 codex --version。

gpt-5.5 default 验证提示

安装完成后，可以在 Codex 里输入：

text

你是什么模型

官方 Plus 账号在 Codex 中会回答类似：

text

我是 Codex，基于 GPT-5 的编码代理。

再输入：

text

/status

状态里应显示当前模型为 gpt-5.5。如果客户需要进一步确认，可以让客户提供自己的 Plus 账号充值后测试，检查 /status 中的模型、账号和额度信息。

参考截图如下：

NewAPI 额度和使用日志查询

用户可以在 NewAPI 后台查看自己的月卡、剩余额度和调用日志。

1. 登录 NewAPI 后台

访问：

text

https://api.open-codex.com

使用自己的账号登录。登录后进入 Console。

2. 查看月卡和剩余额度

进入 Personal Center 里的 Wallet Management，页面会显示当前绑定的月卡、重置时间、总额度、剩余额度和已使用比例。

示例中测试账号已经绑定 VIP月卡，每日额度为 50 USD：

3. 查看使用日志

进入 Console 里的 Usage Logs，可以按时间、令牌名称、模型名称、分组、请求 ID 查询调用记录。

页面顶部会显示当前筛选范围内的已用额度、RPM 和 TPM；表格里可以查看时间、模型、输入、输出、花费和详情。

Codex WebSocket 重连优化

如果每次执行 /new 都要等待多次重连，通常是 Codex 先尝试 WebSocket，失败后才切换到 HTTP。可以在 ~/.codex/config.toml 里关闭当前 provider 的 WebSocket。

OpenCodex 一键安装生成的配置里，找到这一段：

toml

[model_providers.codex]
name = "codex"
base_url = "https://api.open-codex.com/v1"
wire_api = "responses"
env_key = "CODEX_API_KEY"

在这个 provider 下面追加一行：

toml

supports_websockets = false

最终类似这样：

toml

model_provider = "codex"

[model_providers.codex]
name = "codex"
base_url = "https://api.open-codex.com/v1"
wire_api = "responses"
env_key = "CODEX_API_KEY"
supports_websockets = false

保存后重启 Codex 即可。

如果使用的是官方 Plus 登录态，也可以单独新增一个 HTTP provider：

toml

model_provider = "openai_https"

[model_providers.openai_https]
name = "OpenAI"
wire_api = "responses"
requires_openai_auth = true
supports_websockets = false

注意：切换到新的 provider 名称后，旧历史记录可能会暂时不可见。记录没有被删除，移除这段配置或切回原 provider 后可以重新看到。参考 issue：https://github.com/openai/codex/issues/14297

OpenClaw 配置教程

如果你使用 OpenClaw，把 OpenClaw 的配置文件改成当前站点的 Base URL 和你的卡密即可。

1. 打开 OpenClaw 配置文件

配置文件位置如下。没有这个文件时，先创建目录和文件。

macOS / Linux：

text

~/.openclaw/config.json

Windows：

text

%USERPROFILE%\.openclaw\config.json

2. 写入 Base URL 和卡密

把 YOUR_KEY 替换成你自己的卡密，Base URL 保持下面这个值：

text

https://api.open-codex.com/v1

可复制配置如下：

json

{
  "baseUrl": "https://api.open-codex.com/v1",
  "apiKey": "YOUR_KEY",
  "api": "openai-responses",
  "model": "gpt-5.5",
  "models": [
    {
      "id": "gpt-5.5",
      "name": "gpt-5.5",
      "contextWindow": 1047576,
      "maxTokens": 65536
    },
    {
      "id": "gpt-5.4",
      "name": "gpt-5.4",
      "contextWindow": 1047576,
      "maxTokens": 65536
    }
  ]
}

3. 重启 OpenClaw

保存配置文件后，完全退出 OpenClaw，再重新打开。新会话会使用新的 Base URL 和卡密。

如果仍然请求失败，优先检查三项：

apiKey 是否已经替换成自己的卡密。
baseUrl 是否为 https://api.open-codex.com/v1。
配置文件是否保存到了 OpenClaw 实际读取的位置。

CCSwitch 配置教程

如果你使用 CCSwitch 管理 Codex 配置，需要把 Provider 的 Base URL 配置成当前站点的 API 根地址。注意：CCSwitch 里的 Base URL 不要带 /v1。

1. 打开 CCSwitch

启动 CCSwitch 后，进入 Provider / 供应商配置页面，选择新增或编辑 Codex 使用的 Provider。

2. 填写 Provider 信息

按下面内容填写：

text

名称：OpenCodex
Base URL：https://api.open-codex.com
API Key：你的卡密
模型：gpt-5.5

Base URL 必须填写为：

text

https://api.open-codex.com

不要填写成：

text

https://api.open-codex.com/v1

3. 保存并切换

保存 Provider 后，在 CCSwitch 中切换到刚创建的 OpenCodex 配置，再重新打开或重启 Codex。

如果切换后请求失败，优先检查三项：

API Key 是否已经替换成自己的卡密。
Base URL 是否为 https://api.open-codex.com，并且没有 /v1。
当前启用的 Provider 是否为刚创建的 OpenCodex。

free-claude-code 接入教程

free-claude-code 是 Claude Code 的本地代理项目，不是 Codex。它把 Claude Code 发出的 Anthropic Messages 请求转换到后端模型。项目地址：

text

https://github.com/Alishahryar1/free-claude-code

当前版本没有提供 NVIDIA_NIM_BASE_URL 环境变量；如果要接入本站 OpenAI 兼容接口，需要把它的 NVIDIA NIM 默认地址改成本站 Base URL。

1. 下载项目

bash

git clone https://github.com/Alishahryar1/free-claude-code.git
cd free-claude-code
cp .env.example .env

Windows PowerShell：

powershell

Copy-Item .env.example .env

2. 修改默认 Base URL

打开：

text

config/provider_catalog.py

找到：

python

NVIDIA_NIM_DEFAULT_BASE = "https://integrate.api.nvidia.com/v1"

改成：

python

NVIDIA_NIM_DEFAULT_BASE = "https://api.open-codex.com/v1"

3. 修改 `.env`

把 YOUR_KEY 换成自己的卡密：

dotenv

NVIDIA_NIM_API_KEY="YOUR_KEY"
MODEL="nvidia_nim/gpt-5.5"
MODEL_OPUS="nvidia_nim/gpt-5.5"
MODEL_SONNET="nvidia_nim/gpt-5.5"
MODEL_HAIKU="nvidia_nim/gpt-5.5"
ANTHROPIC_AUTH_TOKEN="freecc"

ANTHROPIC_AUTH_TOKEN 是本地代理密码，可以自己改。后面启动 Claude Code 时要填写同一个值。

4. 启动代理

bash

uv run uvicorn server:app --host 0.0.0.0 --port 8082

5. 启动 Claude Code

ANTHROPIC_BASE_URL 指向本地代理根地址，不要加 /v1：

bash

ANTHROPIC_AUTH_TOKEN="freecc" ANTHROPIC_BASE_URL="http://localhost:8082" claude

PowerShell：

powershell

$env:ANTHROPIC_AUTH_TOKEN="freecc"; $env:ANTHROPIC_BASE_URL="http://localhost:8082"; claude

如果请求失败，优先检查三项：

NVIDIA_NIM_DEFAULT_BASE 是否已经改成 https://api.open-codex.com/v1。
.env 里的 NVIDIA_NIM_API_KEY 是否为自己的卡密。
ANTHROPIC_BASE_URL 是否为 http://localhost:8082，并且没有 /v1。

GPT Image 2 图片生成教程

完成 Codex 安装配置后，如果你还需要调用图片生成接口，可以继续按下面步骤操作。

1. 准备卡密

把示例里的 YOUR_KEY 替换成你的卡密。不要把卡密发给别人，也不要写进公开代码仓库。

2. 确认调用地址

Base URL：

text

https://api.open-codex.com/v1

图片生成接口：

text

POST /images/generations

请求头：

text

Authorization: Bearer YOUR_KEY
Content-Type: application/json

常用参数：

model：填写 gpt-image-2。
prompt：你想生成的图片描述，写得越具体越稳定。
size：可用 1024x1024、1536x1024、1024x1536 或 auto。
quality：可用 low、medium、high 或 auto。
output_format：可用 png、jpeg 或 webp。
n：生成张数，默认 1。

3. 用 curl 生成图片

bash

BASE_URL="https://api.open-codex.com/v1"
API_KEY="YOUR_KEY"

curl "$BASE_URL/images/generations" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一张极简科技产品海报，白色背景，中心是一台半透明的未来感设备，柔和棚拍光",
    "size": "1024x1024",
    "quality": "high",
    "output_format": "png",
    "n": 1
  }' \
  -o image-response.json

python3 - <<'PY'
import base64
import json

with open("image-response.json", "r", encoding="utf-8") as f:
    payload = json.load(f)

image_base64 = payload["data"][0]["b64_json"]
with open("image.png", "wb") as f:
    f.write(base64.b64decode(image_base64))
PY

运行成功后，当前目录会生成：

image-response.json：接口原始返回。
image.png：解码后的图片文件。

4. 用 Python 生成图片

先安装依赖：

bash

pip install requests

保存为 generate_image.py：

python

import base64
import requests

base_url = "https://api.open-codex.com/v1"
api_key = "YOUR_KEY"

response = requests.post(
    f"{base_url}/images/generations",
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    json={
        "model": "gpt-image-2",
        "prompt": "一张电商主图风格的咖啡杯产品照，干净背景，真实摄影质感",
        "size": "1024x1024",
        "quality": "high",
        "output_format": "png",
        "n": 1,
    },
    timeout=120,
)
response.raise_for_status()

image_base64 = response.json()["data"][0]["b64_json"]
with open("image.png", "wb") as f:
    f.write(base64.b64decode(image_base64))

运行：

bash

python3 generate_image.py

GPT Image 2 图片编辑教程

图片编辑接口用于在已有图片基础上按提示词修改内容，例如高清修复、去噪、细节增强、改颜色、替换文字、增加或删除元素。

1. 准备输入图片

准备一张本地图片，例如：

text

input.png

建议使用 png、jpeg 或 webp。图片越清晰，提示词越具体，编辑结果越稳定。

2. 确认调用地址

Base URL：

text

https://api.open-codex.com/v1

图片编辑接口：

text

POST /images/edits

请求格式必须使用 multipart/form-data，因为需要上传图片文件。

常用参数：

model：填写 gpt-image-2。
image：要编辑的本地图片文件。
prompt：你希望如何编辑图片，例如“把蓝色方块改成红色，并把文字改成 EDITED”。
size：可用 1024x1024、1536x1024、1024x1536 或 auto。
n：生成张数，默认 1。

当前本站会对外保持 OpenAI 兼容的 /v1/images/edits 调用方式，内部自动完成上游图片编辑接口所需的格式转换。编辑成功后通常返回 data[0].url，可直接下载保存。

3. 用 curl 编辑图片

bash

BASE_URL="https://api.open-codex.com/v1"
API_KEY="YOUR_KEY"

curl "$BASE_URL/images/edits" \
  -H "Authorization: Bearer $API_KEY" \
  -F "model=gpt-image-2" \
  -F "prompt=把图片中的蓝色方块改成红色，并把文字改成 EDITED，保持白色背景" \
  -F "size=1024x1024" \
  -F "image=@input.png;type=image/png" \
  -o image-edit-response.json

接口成功时会返回 data[0].url 或 data[0].b64_json。如果返回的是 url，可以继续下载图片：

bash

python3 - <<'PY'
import json
import urllib.request

with open("image-edit-response.json", "r", encoding="utf-8") as f:
    payload = json.load(f)

item = payload["data"][0]
if "url" in item:
    urllib.request.urlretrieve(item["url"], "edited-image.png")
elif "b64_json" in item:
    import base64
    with open("edited-image.png", "wb") as f:
        f.write(base64.b64decode(item["b64_json"]))
else:
    raise RuntimeError("response does not contain url or b64_json")
PY

运行成功后，当前目录会生成：

image-edit-response.json：接口原始返回。
edited-image.png：编辑后的图片。

4. 用 Python 编辑图片

先安装依赖：

bash

pip install requests

保存为 edit_image.py：

python

import base64
import requests
import urllib.request

base_url = "https://api.open-codex.com/v1"
api_key = "YOUR_KEY"

with open("input.png", "rb") as image_file:
    response = requests.post(
        f"{base_url}/images/edits",
        headers={"Authorization": f"Bearer {api_key}"},
        data={
            "model": "gpt-image-2",
            "prompt": "把图片中的蓝色方块改成红色，并把文字改成 EDITED，保持白色背景",
            "size": "1024x1024",
        },
        files={"image": ("input.png", image_file, "image/png")},
        timeout=240,
    )

response.raise_for_status()
item = response.json()["data"][0]

if "url" in item:
    urllib.request.urlretrieve(item["url"], "edited-image.png")
elif "b64_json" in item:
    with open("edited-image.png", "wb") as f:
        f.write(base64.b64decode(item["b64_json"]))
else:
    raise RuntimeError("response does not contain url or b64_json")

运行：

bash

python3 edit_image.py

常见问题

页面里没有自动填卡密怎么办？

手动把你的卡密粘贴到 卡密 输入框，然后再复制命令。页面会记住你这次填写的卡密。

Base URL 可以改吗？

可以编辑，但普通用户建议保持默认：

text

https://api.open-codex.com/v1

已经安装过，还能重新运行吗？

可以。重新运行安装页生成的命令会覆盖本机旧的 Codex 配置，用新的卡密、Base URL 和模型生效。

运行后应用里还是旧配置怎么办？

完全退出 Codex、VSCode 或 JetBrains IDE，再重新打开。终端里也建议新开一个窗口。

Codex 一键安装配置指南 ​

先注册账号并订阅 1 元体验卡 ​

1. 打开注册页 ​

2. 登录后进入钱包页面 ​

3. 选择 20 刀体验卡 ​

4. 确认支付 ​

安装页截图 ​

1. 打开安装页 ​

2. 确认 Base URL 和模型 ​

3. 选择系统并复制命令 ​

4. Windows 导入方式 ​

5. macOS 导入方式 ​

6. Linux 导入方式 ​

7. 安装完成后验证 ​

gpt-5.5 default 验证提示 ​

NewAPI 额度和使用日志查询 ​

1. 登录 NewAPI 后台 ​

2. 查看月卡和剩余额度 ​

3. 查看使用日志 ​

Codex WebSocket 重连优化 ​

OpenClaw 配置教程 ​

1. 打开 OpenClaw 配置文件 ​

2. 写入 Base URL 和卡密 ​

3. 重启 OpenClaw ​

CCSwitch 配置教程 ​

1. 打开 CCSwitch ​

2. 填写 Provider 信息 ​

3. 保存并切换 ​

free-claude-code 接入教程 ​

1. 下载项目 ​

2. 修改默认 Base URL ​

3. 修改 .env ​

4. 启动代理 ​

5. 启动 Claude Code ​

GPT Image 2 图片生成教程 ​

1. 准备卡密 ​

2. 确认调用地址 ​

3. 用 curl 生成图片 ​

4. 用 Python 生成图片 ​

GPT Image 2 图片编辑教程 ​

1. 准备输入图片 ​

2. 确认调用地址 ​

3. 用 curl 编辑图片 ​

4. 用 Python 编辑图片 ​

常见问题 ​

页面里没有自动填卡密怎么办？ ​

Base URL 可以改吗？ ​

已经安装过，还能重新运行吗？ ​

运行后应用里还是旧配置怎么办？ ​

Codex 一键安装配置指南

先注册账号并订阅 1 元体验卡

1. 打开注册页

2. 登录后进入钱包页面

3. 选择 20 刀体验卡

4. 确认支付

安装页截图

1. 打开安装页

2. 确认 Base URL 和模型

3. 选择系统并复制命令

4. Windows 导入方式

5. macOS 导入方式

6. Linux 导入方式

7. 安装完成后验证

gpt-5.5 default 验证提示

NewAPI 额度和使用日志查询

1. 登录 NewAPI 后台

2. 查看月卡和剩余额度

3. 查看使用日志

Codex WebSocket 重连优化

OpenClaw 配置教程

1. 打开 OpenClaw 配置文件

2. 写入 Base URL 和卡密

3. 重启 OpenClaw

CCSwitch 配置教程

1. 打开 CCSwitch

2. 填写 Provider 信息

3. 保存并切换

free-claude-code 接入教程

1. 下载项目

2. 修改默认 Base URL

3. 修改 `.env`

4. 启动代理

5. 启动 Claude Code

GPT Image 2 图片生成教程

1. 准备卡密

2. 确认调用地址

3. 用 curl 生成图片

4. 用 Python 生成图片

GPT Image 2 图片编辑教程

1. 准备输入图片

2. 确认调用地址

3. 用 curl 编辑图片

4. 用 Python 编辑图片

常见问题

页面里没有自动填卡密怎么办？

Base URL 可以改吗？

已经安装过，还能重新运行吗？

运行后应用里还是旧配置怎么办？