跳到主要内容

Codex

准备 API​

在配置之前,请确保你已准备好以下信息:

API Key

你创建的 API Key 字符串。

Base URL

地址:https://api.jalapeno-cloud.ai/v1

重要提示:必须包含末尾的 /v1

模型名称

从模型市场复制完整的模型名称,例如 DeepSeek-V4-Pro

安装 Codex​

通过 Codex 官方渠道下载并安装。Codex CLI

Linux / macOS / WSL2​

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

或者通过 npm 安装(需要 Node.js 22+):

npm install -g @openai/codex

Windows (PowerShell)​

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

连接 Codex​

Codex 通过用户级配置文件 ~/.codex/config.toml 中的自定义模型提供商转发请求。

重要提示: model_provider 和 model_providers 仅在 ~/.codex/config.toml 中生效。Codex 会忽略项目本地 .codex/config.toml 中的这两项。

如果你之前使用 ChatGPT 登录过,请先退出登录,以避免认证冲突:

codex logout

编辑配置文件​

创建或编辑 ~/.codex/config.toml:

model = "GLM-5.1"
model_provider = "jalapeno"

[model_providers.jalapeno]
name = "Jalapeno Cloud"
base_url = "https://api.jalapeno-cloud.ai/v1"
env_key = "JALAPENO_API_KEY"
wire_api = "responses"
requires_openai_auth = false

字段说明​

字段说明
model默认模型名称(例如 GLM-5.1 / DeepSeek-V4-Pro / MiniMax-M2.7)
model_provider提供商 ID;必须与下方的 [model_providers.<id>] 配置块一致
name提供商的显示名称
base_urlAPI 端点,必须包含末尾的 /v1
env_key存放 API key 的环境变量
wire_apiAPI 协议;第三方端点请使用 responses
requires_openai_auth对于 OpenAI 兼容的自定义 API,设置为 false

设置 API Key​

Codex 会从 env_key 指定的环境变量中读取 key。运行 Codex 前请先导出:

export JALAPENO_API_KEY="your-api-key"

将导出命令添加到你的 shell 配置文件(例如 ~/.bashrc 或 ~/.zshrc),以便在会话之间持久生效。

切换模型​

修改 ~/.codex/config.toml 中的 model 字段,例如:

model = "DeepSeek-V4-Pro"

验证连接​

导出 JALAPENO_API_KEY 后,运行:

codex exec -m GLM-5.1 --sandbox read-only "Reply with exactly one word: hello"

运行成功会打印包含 provider: jalapeno 的会话头信息,随后是模型回复 pong。

使用模型​

在项目目录下启动交互式 CLI:

codex