在 intellij idea 2026 中，通过 acp 注册表可一键安装、切换和更新 codex、claude 或本地大模型；进入 settings → tools → ai assistant → agents，点击 acp registry 标签页搜索并安装，无需重启或手动配置 api key；本地模型需按 acp 协议添加，注意路径末尾必须带 /v1；管理智能体可通过启用、重载或卸载操作完成。
你需要在 IntelliJ IDEA 2026 中快速装好 Codex、Claude 或本地大模型这类 AI 智能体，不是翻文档猜配置，也不是手动改 JSON 文件——而是用官方 ACP 注册表一键完成安装、切换和更新，让 AI 助手真正变成你写代码时伸手就来的工具。
从 ACP 注册表安装 AI 智能体
第一步：打开 Settings → Tools → AI Assistant → Agents。
第二步：点击右上角 【ACP Registry】 标签页，等待列表加载完成（首次加载需联网，约 8～12 秒）。
第三步：在搜索框输入 codex 或 claude，找到对应条目后，点击右侧 【Install】 按钮。
第四步：安装完成后，状态变为 “Ready”，此时可直接在 AI Chat 窗口右上角下拉菜单中选择该智能体——无需重启 IDE，也无需额外配置 API Key（Codex 和 Claude Code 已预置认证流程）。
手动添加本地大模型（ACP 协议方式）
方法一：使用已部署的本地模型服务
确保你的本地模型服务（如 Ollama + llama3:70b 或 vLLM 启动的 Qwen2.5-72B）正在运行，并监听 http://localhost:11434 或 http://localhost:8000/v1。
在 Settings → Tools → AI Assistant → Agents 页面，点击 【+ Add Agent】 → 选择 【Custom ACP Server】。
填入服务地址（例如 http://localhost:11434/v1），模型名称填 llama3:70b（必须与 Ollama 中 ollama list 输出一致），点击 OK。
注意：路径末尾必须带 /v1，否则连接会静默失败且无报错提示。
方法二：通过 CLI 启动 Codex 本地代理（适用于调试或离线环境）
先在终端执行：npm install -g @jetbrains/codex-cli，再运行 codex serve --port 3000。
然后在 Custom ACP Server 中填入 http://localhost:3000，模型名填 codex-local。
这一步启动的是轻量级代理，不依赖云端 Token，但要求 Node.js 20.12+；若提示 npm 找不到命令，请先确认是否勾选了安装时的“Add to PATH”选项。
管理已安装的智能体
在 Agents 页面，每个智能体右侧有三个操作图标：
✅ 点击绿色对勾图标启用/禁用该智能体（禁用后不会出现在 Chat 下拉菜单中）；
? 点击循环箭头图标强制重新下载并覆盖本地运行时（适用于修复 -4058 错误或升级 Node 运行时）；
?️ 点击垃圾桶图标卸载——【卸载会同时清除 .runtimes/node/ 目录下的对应版本，不可逆】。
若发现某个智能体始终显示 “Initializing…” 超过 90 秒，直接点击 ? 图标重试，不要反复删 acp-agents 文件夹——那只是治标，IDEA 会原样重建损坏缓存。
