企业官网建设流程全解析

这个问题很典型，核心原因在于：命令行和 IDE 插件调用的是两个不同“身份”的 Codex。

你在终端使用的是全局安装的@openai/codexCLI 工具；而 IDEA 的 Codex 插件，特别是通过 AI Assistant 集成的版本，调用的是 IDE 自己管理的、专为内部使用的 ACP 代理。它被安装在 IDEA 的私有缓存目录下，不会读取你终端的环境变量。

因此，即使终端配置正确，插件也可能因为找不到自己的那份配置而无法工作。

🛠️ 解决方案

1. 升级 IDEA 到最新版

首先，请确保你的 IntelliJ IDEA 版本为2026.1 或更高。新版本对 Codex 等 AI 智能体有更好的内置支持。

2. 启用并配置 MCP Server

这是让插件与 Codex “对话”的关键服务。

• 打开Settings/Preferences(Cmd + ,)。

• 进入Tools>MCP Server。

• 勾选Enable MCP Server。

• 确保服务类型为streamable-http，URL 为http://127.0.0.1:64342/stream。

3. 通过 ACP 协议配置自定义 Codex（最关键）

这是解决插件与终端配置不一致的核心方法。

• 在 IDEA 中，打开 AI Chat 窗口 (View>Tool Windows>AI Chat)。

• 点击右上角的+，选择Install From ACP Registry...或Add Custom ACP Server

• 在弹出的acp.json配置文件中，添加或编辑以下内容：

{ "default_mcp_settings": {}, "agent_servers": { "Codex (Custom)": { "command": "npx", "args": [ "-y", "@zed-industries/codex-acp", "-c", "model_providers.custom.base_url=https://api.deepseek.com/v1", "-c", "model_providers.custom.env_key=OPENAI_API_KEY", "-c", "model_providers.custom.wire_api=responses" ], "env": { "OPENAI_API_KEY": "你的DeepSeek API Key" }, "use_idea_mcp": true, "use_custom_mcp": true } } }

• 注意：这里以 DeepSeek 为例。务必替换base_url和OPENAI_API_KEY为你的实际服务地址和密钥。

4. 重启 IDEA 并选择 Codex 引擎

• 保存acp.json文件并完全重启 IntelliJ IDEA。

• 重启后，打开 AI Chat 窗口，在引擎选择列表中找到并选中你刚刚配置的Codex (Custom)。

📌 其他辅助检查项

• 确认插件已启用：检查Settings>Plugins，确保MCP Server和AI Assistant插件都已启用。

• 尝试重置 ACP 运行时：如果问题依旧，可在Settings>Tools>AI Assistant中，尝试“Clear Downloaded ACP Runtimes”。

IntelliJ IDEA 里其实**没有一个由 OpenAI 官方发布的独立“Codex 插件”**需要到插件市场搜索安装。官方集成方式是：Codex 作为 JetBrains AI

Assistant 里的一个智能体（agent）直接内置使用，这与 VS Code 里的 Codex 扩展是不同形态。所以安装流程是“装 AI Assistant → 在 AI Chat 里激

活 Codex”，而不是“装 Codex 插件”。

需要满足的前提：IntelliJ IDEA 2025.3 或更高版本，并安装最新版 JetBrains AI Assistant 插件。

具体步骤：

1. 安装 AI Assistant 插件

如果界面上没有 AI 入口：打开 Settings/Preferences → Plugins → Marketplace，搜索 AI Assistant 并安装，然后重启 IDE。

如果右上角能看到 JetBrains AI 小部件，点击它 → Let's Go，按提示安装 AI Assistant 插件即可。

2. 打开 AI Chat

通过右侧工具窗口打开 AI Chat（或使用 JetBrains AI 小部件进入），在顶部 agent 选择器里选 Codex。

3. 激活 Codex

发送任意一条消息触发激活，会弹出安装/服务条款提示，点击 Install and Continue 接受条款。这一步会真正把 Codex agent 安装到 IDE 里。

4. 选择登录/计费方式

激活时可以三选一：

- JetBrains AI：使用 JetBrains AI 订阅登录。

- ChatGPT：跳转到 OpenAI 页面，用你的 ChatGPT 账号授权登录。

- API Key（BYOK）：选择 Provider 为 OpenAI，粘贴你自己的 OpenAI API Key，点 Test Connection 验证后保存。

5. 开始使用

完成后在 AI Chat 里确认当前 agent 是 Codex，发一条消息即可开始对话。也可以在 Settings → Tools → AI Assistant → Agent Authorization 里

检查或更换当前的授权方式。

需要提醒的一点：如果你在 JetBrains 插件市场搜到名字带“Codex”的第三方插件，那是社区维护的旧方案（通常只是把 Codex CLI 包装进 IDE），不是

OpenAI 官方产物，功能和安全更新都不如上面这条官方集成路径。

参考来源：OpenAI 官方文档中 JetBrains 集成入口在 Codex IDE extension (https://developers.openai.com/codex/ide/)（点击“JetBrains

IDEs”会跳转到 JetBrains 的 Codex 使用说明 (https://www.jetbrains.com/help/ai-assistant/codex-agent.html)）。

5、底层模型用DEEPSEEK

直接回答：不能替换。在 IntelliJ 的 AI Chat 里，Codex 那个“粘贴 OpenAI API Key”的入口是 JetBrains 官方 Codex 集成，不是通用的“OpenAI 兼容API”入口。

JetBrains 官方文档明确写了这个限制：

> Codex 集成通过 BYOK 配置时，要求使用 OpenAI 直接签发的 API Key；第三方 API Key 目前不支持，即使它能访问 OpenAI 模型也不行。

所以 DeepSeek key（以及其他中转/兼容平台的 key）粘进去后，Test Connection 会失败，模型列表里也不会有 DeepSeek，底层模型换不过来。不过分两种情况，各有可行的路：

1. 如果你想要的是“Codex agent 跑在 DeepSeek 模型上”

DeepSeek 现在官方支持把 Codex 接入 DeepSeek（它们原生兼容了 Codex 用的 Responses API），有一键脚本：

bash <(curl -fsSL https://cdn.deepseek.com/api-docs/codex-deepseek-setup-en.sh)

但这个官方接入方案覆盖的客户端是：Codex CLI、ChatGPT 桌面版、VS Code 的 Codex 扩展——不包括 JetBrains AI Chat 里的 Codex 集成。

所以在 IntelliJ 里最接近的做法是：跑完上面的配置脚本后，直接在 IDEA 的内置 Terminal 里运行 codex 命令，就会用 DeepSeek 作为底层模型工作，但这是终端里的 Codex，不是右上角 AI Chat 那个界面。

2. 如果你只是想在 IDEA 的 AI 对话里用 DeepSeek

可以不走 Codex agent，而是用 AI Assistant 自己的OpenAI-compatible接入：

Settings → Tools → AI Assistant → Providers & API keys → Third-party AI providers：

- Provider 选OpenAI-compatible

- URL 填 DeepSeek 的接口地址（https://api.deepseek.com）

- API Key 填你的 DeepSeek key

- Test Connection，然后到 AI Chat 的模型选择器里选用它

注意这条路用的是 JetBrains AI Assistant 的对话能力，不是 Codex agent，部分 JetBrains 专属功能也会受限。

参考：JetBrains Codex 官方说明（含限制） (https://www.jetbrains.com/help/ai-assistant/codex-agent.html)、DeepSeek 接入 Codex 官方指南

(https://api-docs.deepseek.com/quick_start/agent_integrations/codex/)。

AI Chat 入口消失，先分清楚是整个 AI 入口都没了，还是AI Chat 窗口还在但 Codex 不见了——这两种的原因和修法不一样。

如果是整个右上角的 AI 入口不见了

最常见原因是入口被隐藏、项目被禁用或插件被关闭：

1. 误点隐藏/移除了入口

恢复方法：顶部菜单 View → Tool Windows → AI Chat 可以直接重新打开 AI Chat 窗口。

如果连右上角那个 JetBrains AI 小部件也没了：在顶部工具栏空白处右键 → Customize Main Toolbar…，在对话框里把 JetBrains AI（AI

Assistant）部件加回去。

2. AI Assistant 被针对当前项目禁用了

检查项目根目录有没有 .noai 文件（有就删掉）。另外之前如果在 AI 小部件里点过 Disable AI Assistant → Disable for This Project，图标会变成禁用状态，需要在同一个菜单里重新启用。

3. AI Assistant 插件被禁用了

打开 Settings (⌘,) → Plugins → Installed，确认 AI Assistant 是启用状态；如果被 Disable 了，重新 Enable 并重启 IDE。

4. 注意 IDEA 的 Toolbar 本身被隐藏了

如果 View → Appearance → Toolbar 没勾选，窗口标题栏里的小部件也可能一起不显示。

如果是 AI Chat 窗口还在、但里面找不到 Codex那多半和刚才配置 DeepSeek/API Key 有关：

- 激活没完成或授权被撤销：打开 Settings → Tools → AI Assistant → Providers & API keys，看 Agent Authorization 里 Codex 还有没有授权。没有的话，回到 AI Chat 顶部把 agent 切到 Codex，随便发一条消息会重新触发安装/登录流程。

- 顶部选择器停在 Chat 模式而不是 Agent 模式：AI Chat 左上角有个模式选择器，需要从 Chat 切到 Codex。

- 之前把 DeepSeek key 填进了 OpenAI 的 BYOK 校验失败，JetBrains 不会保存这个 key，Codex 也就处于未激活状态——回到上面重新走一次授权即可。

› Failed to initialize ACP process. You're using a third-party AI provider.

To use Codex, set an OpenAI API key in "Settings | Tools | AI Assistant | Models and API keys", or disable the third-party provider

(requires JetBrains AI or a ChatGPT account).

• 这条报错正好印证了前面说的限制。我查一下 JetBrains 对“Models and API keys”页面和第三方提供商配置的准确说明，然后把解决步骤给你。

◦ Searching the web

• Searched the web for site:jetbrains.com/help/ai-assistant "Models and API keys" Codex third-party AI provider disable ...

• 这个报错说明：你之前配置的那个第三方 AI provider（比如 DeepSeek/OpenAI-compatible 端点）和 JetBrains 里的 Codex agent 不能共存。Codex 初

始化时检测到你走的是第三方 provider，就直接拒绝启动了——因为它只接受两种身份：OpenAI 直接签发的 API key，或者 JetBrains AI / ChatGPT 账号。

你面前有两个方向：

方向一：让右上角 AI Chat 里的 Codex 恢复可用（回到 OpenAI）

打开 Settings → Tools → AI Assistant → Models and API keys（旧版本叫 Providers & API keys），在 Third-party AI providers 里删掉/禁用你之

前加的第三方 provider（就是指向 DeepSeek 那个）。然后对 Codex 重新激活，三选一：

- 有 JetBrains AI 订阅：用 JetBrains 账号登录；

- 有 ChatGPT 账号：选 ChatGPT 登录；

- 想用 API key：必须填 OpenAI 官方签发的 key（platform.openai.com 创建），Provider 选 OpenAI。

之后新建一个聊天，把 agent 切到 Codex，发一条消息重新触发初始化。

方向二：坚持底层用 DeepSeek

那就别用右上角这个 Codex agent，它是换不了 DeepSeek 的。可选的替代是：

- 跑 DeepSeek 官方提供的 Codex 接入脚本，然后在 IDEA 内置 Terminal 里用 codex CLI——底层是 DeepSeek，但不在 AI Chat 界面里；

- 或者保留第三方 provider，在 AI Chat 里用普通 Chat 模式（不选 Codex agent）接 DeepSeek 模型。

简单说：错误提示里的两种做法对应两个结果——移除第三方 provider = Codex 恢复（OpenAI 模型）；保留第三方 provider = 不要选 Codex，只用 AIChat 的普通对话模式。你想走哪条？

› 保留第三方 provider = 不要选 Codex，只用 AIChat 的普通对话模式。你想走哪条？

• 既然你的目标是底层用 DeepSeek，那答案很明确：走“保留第三方 provider、用 AI Chat 普通对话模式”这条路，不要再去激活/选择 Codex agent。这样既能用 DeepSeek，也不会再看到 ACP 初始化报错。

具体操作：

1. 打开 Settings → Tools → AI Assistant → Models and API keys（旧版本叫 Providers & API keys），找到 Third-party AI providers。

2. 确认你的 DeepSeek 配置是这样的：

- Provider：OpenAI-compatible（如果你之前选的是 DeepSeek 预设选项，效果相同）

- URL：https://api.deepseek.com

- API Key：填 DeepSeek 官方平台的 key

- Tool calling：如果选项存在，建议开启（DeepSeek 支持工具调用）

- 点 Test Connection，通过后保存

3. 回到 AI Chat，看左上角的模式选择器，确保是 Chat（普通对话）模式，而不是 Codex。Codex 项现在会继续报错，别选它。

4. 在模型选择器里把模型切成 DeepSeek 的模型（通常是 deepseek-chat 或你配置时填写的模型名）。如果模型列表里没有出现，去 Settings → Tools

→ AI Assistant → Model Assignment，把 Core features 的默认模型手动指定为 DeepSeek，并填好上下文窗口大小，再回来刷新 AI Chat。

5. 发一条消息验证：如果能正常回复，就说明 DeepSeek 已经通过 AI Assistant 的普通对话模式工作了。

两条路的功能差异也顺便说清楚：

普通 Chat 模式适合提问、改代码、解释报错这类交互；它不像 Codex agent 那样能自动改文件、执行命令、独立跑完整任务。如果你以后想要“DeepSeek 驱动的完整 agent”，还得用我前面说的方案——在 IDEA 内置终端里跑 DeepSeek 官方配置好的 codex CLI。

底层用DEEPSEEK，这里不要选其他的如CODEX等，选择CHAT,然后右侧选DEEPSEEK的模型。