GPT Codex 上使用 MindCraft API

在 GPT Codex 上使用 MindCraft API

通过配置 MindCraft 平台作为 API 提供商，GPT Codex CLI 可以使用平台上的所有 OpenAI responses接口的模型。

前置条件

安装 Codex CLI

获取 API Key

配置方式

步骤一：config.toml

编辑 ~/.codex/config.toml：

model = "gpt-5.4"
model_provider = "openai"

[providers.openai]
name = "MindCraft"
base_url = "https://api.mindcraft.com.cn/v1"
env_key = "OPENAI_API_KEY"

[features]
goals = true
collaboration_modes = true

全局配置（model、model_provider）必须写在所有 [section] 之前，否则 Codex 会忽略。

步骤二：设置 API Key

方式一：auth.json（推荐）

编辑 ~/.codex/auth.json：

{
  "OPENAI_API_KEY": "MC-你的API Key"
}

方式二：环境变量

可用模型

配置完成后，可在 config.toml 中修改 model 字段切换模型。Codex 使用 OpenAI Responses 接口（/v1/responses），目前支持以下模型：

模型名	说明
`gpt-5.5`	OpenAI 最新旗舰
`gpt-5.4`	GPT-5.4
`gpt-5.3-codex`	Codex 专用模型

完整模型列表以 GET /v1/models 接口实际返回为准。后续新增支持 responses 接口的模型会自动生效。

注意事项

base_url 需要带 /v1（与 Claude Code 不同，Codex 不会自动拼接）

API Key 格式为 MC- 开头的 32 位字符串

Codex 启动时会先尝试 WebSocket 连接，连不上会自动 fallback 到 HTTPS，这是正常行为

积分按实际调用模型的定价扣除

GPT Codex 上使用 MindCraft API

在 GPT Codex 上使用 MindCraft API#

前置条件#

安装 Codex CLI#

获取 API Key#

配置方式#

步骤一：config.toml#

步骤二：设置 API Key#

可用模型#

注意事项#