Codex

准备 API

在配置之前，请确保已获取以下信息

API Key

以 sk- 开头的字符串。

Base URL (接口地址)

地址：https://api.magikcloud.cn/v1

重要：务必包含末尾的 /v1

模型名称

请在模型广场复制完整模型名称，如：DeepSeek-V4-Pro

---

安装 Codex

通过 OpenAI Codex 官网 下载并安装。

macOS / Linux：

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

Windows PowerShell：

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

也可通过 npm 安装（需 Node.js 18+）：

npm install -g @openai/codex

注意： 包名是 @openai/codex，不要安装无 scope 的 codex 包。

安装完成后，运行 codex --version 验证是否安装成功。

---

接入 Codex

编辑配置文件

编辑用户级配置文件 ~/.codex/config.toml（若不存在则新建）：

openai_base_url = "https://api.magikcloud.cn/v1"
model = "GLM-5.1"

注意： openai_base_url、model_provider 等提供商相关配置只能写在用户级 ~/.codex/config.toml 中，项目级 .codex/config.toml 不会生效。

配置 API Key

设置环境变量（推荐写入 ~/.bashrc 或 ~/.zshrc）：

export OPENAI_API_KEY="sk-你的API密钥"

使用自定义 Provider（可选）

如需更灵活的配置（例如自定义环境变量名），可使用自定义 Provider：

model_provider = "magik"
model = "GLM-5.1"

[model_providers.magik]
name = "MagikCloud"
base_url = "https://api.magikcloud.cn/v1"
env_key = "MAGICK_API_KEY"
requires_openai_auth = false

同时设置环境变量：

export MAGICK_API_KEY="sk-你的API密钥"

关键字段说明

字段	说明
openai_base_url	覆盖内置 OpenAI Provider 的接口地址
model	默认使用的模型名称
model_provider	指定使用的 Provider（使用自定义 Provider 时填写）
base_url	自定义 Provider 的接口地址，需包含 /v1
env_key	读取 API Key 的环境变量名
requires_openai_auth	设为 false，因为 MagikCloud 的 Key 不以 sk- 开头

切换模型

修改 config.toml 中的 model 字段为目标模型名称（如 DeepSeek-V4-Pro / MiniMax-M2.7），保存后重新启动 Codex 即可。

使用模型

在项目目录下运行 codex 启动，即可使用已配置的模型进行编码任务。