CoreCode文档

接入

Codex（GPT）

最后更新：2026 年 10 月 28 日

把 OpenAI 的 Codex CLI 接到 CoreCode 的 GPT 分组。Codex 的配置写在 config.toml 里，加一个自定义模型提供方即可。配置项来自 OpenAI 的 Codex 高级配置说明。

接口地址
https://corecode.live/v1
协议
OpenAI Responses（wire_api = "responses"）
密钥
控制台 API 密钥 页创建，分组选「GPT」或「auto」
模型
如 gpt-6.1-sol、gpt-6-sol，完整列表见 支持的模型

安装

已安装可以跳过这一步。

curl -fsSL https://chatgpt.com/codex/install.sh | sh

装好后运行 codex --version，能打印版本号就说明装好了。安装方式见 Codex 仓库。

创建密钥

在 API 密钥 页点「创建 API 密钥」，分组选「GPT」，其余保持默认。「Claude 满血」分组的密钥调不了 GPT 模型。想用一把密钥同时给 Claude Code 和 Codex 用，分组选「auto」，见 auto 分组。

配置

写入 config.toml

编辑 ~/.codex/config.toml（Windows 是 %USERPROFILE%\.codex\config.toml），没有就新建。已有内容时，把 model 和 model_provider 两行放在文件开头，表头之前：

model = "gpt-6.1-sol"
model_provider = "corecode"

[model_providers.corecode]
name = "CoreCode"
base_url = "https://corecode.live/v1"
env_key = "CORECODE_API_KEY"
wire_api = "responses"
配置作用
model默认模型，换成 GPT 分组 里的任意一个
model_provider指向下面定义的提供方。不能叫 openai，那是 Codex 内置的名字
base_url必须带 /v1
env_keyCodex 从这个环境变量读密钥

设置密钥环境变量

export CORECODE_API_KEY=sk-你的密钥
codex

想永久生效，把 export 那一行加进 ~/.zshrc 或 ~/.bashrc；Windows 用 setx CORECODE_API_KEY sk-你的密钥，然后重开终端。

写在用户目录下的 config.tomlCodex 会忽略项目里 .codex/config.toml 中的 model_provider 和 model_providers，启动时打印警告。提供方必须写在 ~/.codex/config.toml。

检查是否生效

codex exec "回复 ok"

返回 ok 即接通。控制台「使用日志」里会出现这次请求，分组是 GPT。

换模型

只换这一次，启动时用 codex --model gpt-6-sol；长期换，改 config.toml 里的 model。GPT 分组的模型和单价见 价格表，按单价从低到高大致是 luna、terra、sol、astra。

常见问题

401 或提示没有登录

检查运行 codex 的终端里有没有 CORECODE_API_KEY（echo $CORECODE_API_KEY），以及 config.toml 里 env_key 的名字和它一致。用 setx 设置后要重开终端。

404 或连不上

base_url 要写 https://corecode.live/v1，不要漏掉 /v1。

模型不存在或无可用渠道

密钥的分组要是「GPT」或「auto」，模型名要和 模型价格 页一致。