IDEA + Codex · 32ai 零魔法直连各模型
先说明一下,这篇文章的目标非常直接:帮助你在 IntelliJ IDEA 中安装 Codex 插件,再通过名为 32ai 的中转服务平台,无缝接入 OpenAI 的 GPT-5-Codex 模型。整个流程无需科学上网,配置步骤也不复杂。如果你正在寻找类似的集成解决方案,可以参考下面这个完整的操作流程。
我们从零开始。
安装 Codex
首先将 Codex 安装到全局环境中。这一步需要 Node.js 运行环境,在命令行终端执行:
npm install -g @openai/codex
IDEA 插件搜索 & 安装
启动 IntelliJ IDEA,在插件市场中搜索 “Codex”,找到后直接安装。这一步没有任何特殊要求,安装完成后重启 IDE 即可生效。
修改配置文件 config.toml
Codex 的配置加载遵循优先级顺序,从高到低依次为:CLI 参数 > 剖面值(--profile)> 项目级配置文件 > 用户级配置 > 系统级配置 > 内置默认值。我们只需配置用户级即可。
Windows 用户,配置文件路径为~/.codex/config.toml。若该文件不存在,手动创建即可。
直接复制以下内容到 config.toml:
model_provider = "32ai"
model = "gpt-5-codex"
model_reasoning_effort = "medium"
model_reasoning_summary = "auto"
model_verbosity = "medium"
model_supports_reasoning_summaries = false
disable_response_storage = true
preferred_auth_method = "apikey"
approval_policy = "on-request"
[model_providers]
[model_providers.32ai]
name = "32ai"
base_url = "https://32ai.uk/v1"
wire_api = "responses"
requires_openai_auth = true
request_max_retries = 4
stream_max_retries = 5
stream_idle_timeout_ms = 300000
[profiles]
[profiles.32ai]
model = "gpt-5-codex"
model_provider = "32ai"
approval_policy = "on-request"
sandbox_mode = "read-only"
model_reasoning_effort = "medium"
model_reasoning_summary = "auto"
model_verbosity = "medium"
personality = "friendly"
include_apply_patch_tool = false
experimental_use_unified_exec_tool = false
experimental_use_freeform_apply_patch = false
tools.web_search = false
[notice.model_migrations]
gpt-5-codex = "gpt-5.3-codex"
"gpt-5.2-codex" = "gpt-5.3-codex"
配置参考自 OpenAI 官方文档(已针对 32ai 的端点设置进行调整)。
获取 32ai API Key
前往中转平台 32ai.uk 注册账号,登录后在后台生成 API 密钥。该平台的亮点在于价格低廉、连接稳定,且无需魔法即可直连。
价格大约是 0.56 : 1 的比例,具体信息可自行查看。
修改认证文件 auth.json
在 Codex 配置目录(即~/.codex/)下,创建或编辑auth.json文件,将刚刚获取的 API key 填入:
{
"auth_mode": "apikey",
"OPENAI_API_KEY": "你的32ai_api_key_粘贴在此"
}
IDEA 中启动 Codex
回到 IntelliJ IDEA,找到 Codex 插件的图标(通常位于右侧边栏或工具窗口中),点击启动即可。
验证模型 & 配置文件生效
启动后,查看当前使用的模型,应该显示为gpt-5-codex。
任务测试 · 完成集成
随意给它一个代码任务或指令,测试整个链路是否正常运行。如果一切顺利,说明你已经成功在 IDEA 中接入 GPT-5-Codex 模型。
配置备忘
- 使用用户级配置(
~/.codex/config.toml)全局生效。 [model_providers.32ai]中定义了 base_url 为 32ai.uk/v1,wire_api 设为 responses。- 通过
[profiles.32ai]将提供商与模型关联起来,personality 可选 friendly 或 pragmatic。 - 迁移通知:gpt-5-codex 会自动映射到 gpt-5.3-codex。
- 更多高级参数(日志、上下文窗口)可按需取消注释。
整个操作流程下来,相当于通过一套配置串联了 IDEA 后端、Codex 插件和 32ai 的中转接口。虽然步骤较多,但每一步都清晰明确,复制粘贴即可完成。这套方案的最大优势在于——无需魔法,直连稳定,且价格确实便宜。
如果遇到问题,可以检查配置文件是否生效、API Key 是否正确,或者查看模型映射是否正常。
