1、背景：

我最近在JetBrains AI Assistant中使用codex的时候一直遇到下面的这个错误，弄了半天也没解决，头都大了，最主要的错误就是这个-4058，最开始和Gemini对话解决这个问题，给我浪费了半天的时间，还有网站搜索的一些也是半吊子，都是让我删除acp-agents这个文件夹，我反复删除了多次，idea自动下载后还是会一直报这个错误，真是头大， 最后终于找到了解决办法，特此来记录一下，看看能不能帮助到需要的人

2、错误信息：

ACP process exited unexpectedly. Exit code: -4058. Process output:
npm warn Unknown env config "min-release-age". This will stop working in the next major version of npm.

npm error code ENOENT

npm error syscall open
npm error path C:\Users\Admin\AppData\Local\JetBrains\IntelliJIdea2026.1\acp-agents\.runtimes\node\24.13.0\npm-cache\_npx\18dd321ac7067500\package.json

npm error errno -4058

npm error enoent Could not read package.json: Error: ENOENT: no such file or directory, open 'C:\Users\海岛\AppData\Local\JetBrains\IntelliJIdea2026.1\acp-agents\.runtimes\node\24.13.0\npm-cache\_npx\18dd321ac7067500\package.json'

npm error enoent This is related to npm not being able to find a file.
npm error enoent

npm error A complete log of this run can be found in: C:\Users\Admin\AppData\Local\JetBrains\IntelliJIdea2026.1\acp-agents\.runtimes\node\24.13.0\npm-cache\_logs\2026-07-16T02_12_04_895Z-debug-0.log

3、问题原因：

问题不是 Codex 账号、ChatGPT 登录、API Key、项目代码或者 npm 仓库无法访问。

日志中 npm 已经能够正常访问 npm 官方仓库，并返回 HTTP 200。真正的问题是 IDEA 使用 npm exec 临时安装 Codex ACP 时，生成了一个不完整的 _npx 缓存目录。

检查结果如下：

PackageJson     False
NodeModules     True
PackageLockJson False

也就是说：

_npx\4bd2a453afc08379\
├─ node_modules\       已存在
├─ package.json        不存在
└─ package-lock.json   不存在

下一次 IDEA 再启动 Codex 时，npm 会尝试读取：

_npx\4bd2a453afc08379\package.json

由于文件不存在，因此报：

ENOENT
Exit Code: -4058

反复删除 .runtimes 或 npm-cache 或acp-agents无法根治，因为 IDEA 每次都会重新下载同一套 Node/npm，并再次使用相同的 npm exec 临时安装流程。

4、解决方案：

再让 IDEA 使用有问题的 npm exec → _npx 临时安装方式，而是把 codex-acp 固定安装到本地目录，然后在 IDEA 中添加为自定义 ACP 智能体。

固定安装目录： C:\Tools\codex-acp

这样 IDEA 会直接运行已经安装好的 Codex ACP，不再依赖 _npx 临时缓存。

5、具体操作步骤：

注意下面的命令在一个powershell窗口中完成，不要新开窗口

第一步：找到 IDEA 内置的 Node 和 npm

在 PowerShell 中执行：

$rt = "$env:LOCALAPPDATA\JetBrains\IntelliJIdea2026.1\acp-agents\.runtimes\node\24.13.0"
$node = "$rt\bin\node.exe"
$npm = "$rt\bin\node_modules\npm\bin\npm-cli.js"

检查路径是否存在：

Test-Path $node
Test-Path $npm

正常应返回：

True
True

第二步：创建固定安装目录

$installDir = "C:\Tools\codex-acp"
New-Item $installDir -ItemType Directory -Force | Out-Null

写入基础 package.json：

[System.IO.File]::WriteAllText(
    "$installDir\package.json",
    '{"name":"codex-acp-local","version":"1.0.0","private":true}',
    (New-Object System.Text.UTF8Encoding($false))
)

进入目录：

Set-Location $installDir

第三步：固定安装 Codex ACP

执行：这个地方要等一会它安装完成，我本机是等了3分钟才完成

& "$node" "$npm" install --save-exact "@agentclientprotocol/codex-acp@1.1.2"

本次实际安装结果：

added 19 packages, and audited 20 packages in 3m

13 packages are looking for funding
found 0 vulnerabilities

这说明安装成功。

第四步：检查安装结果

执行：

Get-ChildItem "C:\Tools\codex-acp" -Force

正常应看到：

node_modules
package-lock.json
package.json

检查启动文件：

Test-Path "C:\Tools\codex-acp\node_modules\@agentclientprotocol\codex-acp\dist\index.js"

正常应返回：

True

Codex ACP 启动文件为：

C:\Tools\codex-acp\node_modules\@agentclientprotocol\codex-acp\dist\index.js

6、在 IDEA 2026.1 中添加自定义智能体

打开 IDEA 的 AI Chat 菜单。

在中文版 IDEA 2026.1 中，对应入口不是英文的 Add Custom Agent，而是：

添加自定义智能体 Beta

如下图所示（没有这个功能的就是idea版本过老，更新吧）

点击后IDEA 会打开或创建：

C:\Users\Admin\.jetbrains\acp.json

7、查询系统 Node 路径

在 PowerShell 中执行：

(Get-Command node.exe).Source

示例结果：

C:\Program Files\nodejs\node.exe

实际配置时，应使用自己电脑返回的真实路径。

注意：此处有个小坑，因为我本机使用了nvm来进行的node版本的管理，所以我这个地方返回的是

D:\\Soft\\nvm4w\\nodejs\\node.exe

这个node版本最好是20+的版本，我考虑到我可能要换版本，就写了固定的D:\Soft\nvm\v24.15.0这个目录，但是写了后是不行的，必须用上面命令返回的目录才可以，环境我也懒得折腾了，就这样用了。

8、配置 acp.json

在C:\Users\Admin\.jetbrains\acp.json中填写：

{
  "default_mcp_settings": {
    "use_idea_mcp": true,
    "use_custom_mcp": true
  },
  "agent_servers": {
    "Codex Fixed": {
      "command": "C:\\Program Files\\nodejs\\node.exe",
      "args": [
        "C:\\Tools\\codex-acp\\node_modules\\@agentclientprotocol\\codex-acp\\dist\\index.js"
      ]
    }
  }
}

注意：

• command 必须替换成 (Get-Command node.exe).Source 得到的真实 Node 路径。

• Windows JSON 路径中的反斜杠需要写成 \\。

9、重新启动idea后就可以使用了，折腾吧，祝好运

10、修复前后的启动链路

修复前

IDEA
  ↓
npm exec
  ↓
npm-cache\_npx
  ↓
临时 package.json 缺失
  ↓
ENOENT
  ↓
Exit Code -4058

修复后

IDEA
  ↓
系统 node.exe
  ↓
C:\Tools\codex-acp\node_modules\@agentclientprotocol\codex-acp\dist\index.js
  ↓
Codex ACP 正常启动