用熟悉的接口，
连接你的 AI 应用。

API Key 放在请求头：Authorization: Bearer YOUR_API_KEY

from openai import OpenAI
import os

client = OpenAI(
    api_key=os.environ["CODEX_API_KEY"],
    base_url="https://codex-api1.com/v1",
)

response = client.chat.completions.create(
    model="gpt-6-sol",
    messages=[{"role": "user", "content": "你好！"}],
)
print(response.choices[0].message.content)

安装依赖：pip install openai

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.CODEX_API_KEY,
  baseURL: "https://codex-api1.com/v1",
});

const result = await client.chat.completions.create({
  model: "gpt-6-sol",
  messages: [{ role: "user", content: "你好！" }],
});
console.log(result.choices[0].message.content);

安装依赖：npm install openai

1. 从 CC Switch 官方发布页下载适合系统的版本。在本站控制台创建 API Key，选择有目标模型权限的分组。
2. 打开 CC Switch，选择顶部的 Codex，点击 ＋ → 自定义。供应商名称填 Codex API，API Key 填刚创建的本站密钥。
3. 请求地址（Base URL）填写 https://codex-api1.com/v1。默认模型填写你的密钥可用的完整模型 ID，可在本站模型列表或 GET /v1/models 的返回结果里查询。
4. 在高级选项里选择上游格式。模型支持 /v1/responses 时选 Responses。模型仅支持 /v1/chat/completions 时，选 Chat Completions 并开启 CC Switch 的本地路由及 Codex 路由。
5. 保存后，将 Codex API 切换为当前供应商。重新启动 Codex，发送一条简短消息，然后到本站的调用日志确认请求和模型。

遇到 401 时检查密钥和分组权限。遇到 404 时检查 Base URL 是否重复填写了 /v1 或附带了完整接口路径，再核对模型 ID 和上游格式。通过本地路由接入时，请保持 CC Switch 的路由服务运行。

CC Switch 官方路由说明

1. 在本站创建 API Key，确认分组有目标模型权限。在运行 OpenClaw Gateway 的机器上设置环境变量 CODEX_API_KEY，让 Gateway 进程能够读取它。
2. 把以下字段合并到 ~/.openclaw/openclaw.json。已有的 models 和 agents 配置应合并到原有对象中。两处 YOUR_MODEL_ID 都替换为本站返回的同一个完整模型 ID。

{
  "models": {
    "mode": "merge",
    "providers": {
      "codex-api": {
        "baseUrl": "https://codex-api1.com/v1",
        "apiKey": "${CODEX_API_KEY}",
        "api": "openai-completions",
        "models": [{ "id": "YOUR_MODEL_ID", "name": "Codex API" }]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": { "primary": "codex-api/YOUR_MODEL_ID" }
    }
  }
}

保存后运行 openclaw gateway restart（如果 Gateway 由其他方式启动，按原方式重启）。运行 openclaw models list，确认出现 codex-api/YOUR_MODEL_ID。新建对话，发送一条简短消息，并在本站调用日志核对请求。

OpenClaw 官方自定义供应商文档

1. 在本站创建 API Key，选择有目标模型权限的分组。
2. 在运行 Hermes Agent 的终端执行 hermes model，选择 Custom endpoint。
3. API Base URL 填 https://codex-api1.com/v1，API Key 填本站密钥，Model name 填你的密钥有权调用的完整模型 ID。
4. 完成向导后运行 hermes，发送一条简短消息，再到本站调用日志确认请求和模型。若已运行 Hermes Gateway，请重启该服务以加载更新后的配置。

两套配置均使用 Chat Completions。若返回 401，检查密钥及其分组。若返回 404，核对模型 ID 和 Base URL，地址末尾保留 /v1 即可。需要调用工具时，请确认所选模型和渠道支持工具调用。

Hermes Agent 官方供应商文档