IDEA2026.1中配置Codex(非官方订阅-针对国内走中转路线NewApi)

一：背景

在IDEA 里配置Codex，国内走中转路线使用 Codex（无订阅）

本文介绍的是Codex 中转在 IDEA 2026.1 中通过 ACP 协议接入的配置流程。

二：配置前提

需要提前在本地先安装Codex，关于本地 Codex 的安装步骤，具体可以参考：newApiUrl

三：配置步骤

1.安装 codex-acp 插件

全局安装@zed-industries/codex-acp

npm install -g @zed-industries/codex-acp-win32-x64 --registry=https://registry.npmmirror.com --force

查看是否安装成功

npm list -g

2.配置 acp.json 文件

在IDEA中参考下图打开，会是一个空的acp.json

将下述配置好的acp.json内容提前替换好，再复制进去

{ "default_mcp_settings":{}, "agent_servers": { "Codex (Local)": { "command": "npx.cmd", "args": [ "@zed-industries/codex-acp-win32-x64@0.9.5", "-c", "model_providers.custom.base_url=http://XXXX/v1", "-c", "model_providers.custom.wire_api=responses", "-c", "model=gpt-5.4" ], "env": { "ACP_PERMISSION_MODE": "bypassPermissions" }, "use_idea_mcp": true, "use_custom_mcp": true } } }

需要替换的配置介绍：

base_url=http://XXXX/v1" 相应中转的API地址

"-c", "model=gpt-5.4" 指定模型（可以不指定）

3.重启 IDEA

4.启用 CodeX 对话引擎

打开 AI Chat 窗口，在引擎选择列表中找到 Codex (Local) 并选中。

随后即可在对话框内进行交互。

​ ​