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_url | API 端点,必须包含末尾的 /v1 |
env_key | 存放 API key 的环境变量 |
wire_api | API 协议;第三方端点请使用 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