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

程序猿七度2026-05-26 8:43

一：背景

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

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

二：配置前提

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

三：配置步骤

1.安装 codex-acp 插件

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

bash 复制代码

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

查看是否安装成功

bash 复制代码

npm list -g

2.配置 acp.json 文件

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

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

java 复制代码

{
  "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) 并选中。

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