Codex 在 JetBrains IDE 怎么用？授权来源、上下文范围与改动验收

在 IntelliJ IDEA、PyCharm 或 WebStorm 中用 Codex，先打开 AI Chat，选择 Codex，再核对它实际使用的授权方式。能看到 AI Chat 不代表 Codex 已安装；浏览器登录成功，也不代表当前聊天已切换授权；回复说“改好了”，还需要打开实际文件验收。

本文按首次接入、AI Chat 看不到 Codex、登录没反应、上下文不符合预期和远程开发组织步骤。JetBrains 有自己的集成入口，OpenAI 当前 IDE 文档也明确作此区分。不要在 JetBrains 中寻找 VS Code 的 openai.chatgpt 扩展或 Codex: Open Codex Sidebar 命令。

先按现象找下一步

当前现象	先做什么	怎样确认有进展
有 AI Chat，却没有 Codex	核对 IDE build、AI Assistant 插件及组织策略	当前代理选择器能选中 Codex，而非仅选了某个模型
选了 Codex，没有登录窗口	新聊天发送一条无敏感内容的请求，查看安装或授权提示	区分下载未完成、未接受安装条款和授权未完成
登录后仍提示激活，或担心用了另一份额度	查看 Agent Authorization 和该聊天开头的授权记录	能指出此聊天使用 ChatGPT、API Key 还是 JetBrains AI
回答忽略另一个打开的文件	检查 IDE context 指示器，用 `@` 明确附加文件	看得到目标附件，并核对实际回答或文件读取证据
回答正确，却没改文件	核对 Plan/Default、操作模式和待审批动作	目标文件保存到正确路径，实际差异符合要求
本地能用，Gateway 或 WSL 不行	分清 Host/Client、插件版本及代理启动端	在同一远程项目完成一次只读和一次受限修改验证

1. 最低版本：装得上 AI Assistant，不等于支持 Codex

适用条件： 首次安装，或升级过 IDE 后仍找不到 Codex。

JetBrains 官方发布说明给出的原生集成起点是 IDE 2025.3，并安装最新的兼容 AI Assistant 插件。插件历史更新记录在 253.30387.97 下列出 Codex 和 ChatGPT 登录的加入；这是功能引入记录，不是让所有 IDE 强装同一个插件包。

要核对的版本	当前依据与操作
IDE 本体	在 Help > About（macOS 通常在应用菜单 > About）记录产品、版本和完整 build；Codex 原生集成起点为 2025.3
AI Assistant 插件	Settings > Plugins > Installed 找 JetBrains AI Assistant，记录版本、是否启用和兼容性；更新到该 IDE 支持的稳定版本，按提示重启
插件一般安装门槛	安装指南列出一般 IDE 2023.3、Community Edition 2024.1.1、PyCharm Unified 2025.1 等门槛；这些较低版本不能代替 Codex 的 2025.3 起点
远程 ChatGPT 登录	更新记录在 262.9437 下列出 Remote Development 的 ChatGPT 登录支持；需选择包含该能力且匹配远程 IDE build 的插件，不能仅凭“2025.3 以上”判断

插件版本号和 IDE build 有兼容范围。插件页显示 incompatible、没有可用更新，先按产品升级流程处理 IDE；不要下载最高编号 ZIP 强行安装。当前文档顶部的 2026.2 是帮助版本，也不能读成最低要求。

若还没有插件，可在 AI Chat 的 Install Plugin、JetBrains AI widget 或官方 Marketplace 安装。当前安装指南说明 AI Chat 工具窗口本身不是 AI Assistant 插件；单有窗口不证明代理已经就绪。公司管理的 IDE 还应核对 AI/代理是否被允许，受策略限制时由管理员处理。

预期结果： 你能同时提供 IDE build、兼容插件版本和 Codex 代理入口。如果只有 OpenAI 模型名称，没有 Codex 代理，仍停留在入口排查，不能判定安装完成。

2. 先选授权来源，再确认当前聊天实际用了哪一种

适用条件： 首次激活、ChatGPT 已登录但还要求激活，或无法解释额度消耗。

当前 Activate agents 文档提供三种 Codex 授权来源。所选方式同时决定请求处理和计费来源，不能从“电脑上有 ChatGPT Plus”或“IDE 登录了 JetBrains Account”反推当前聊天的选择。

首次验证先打开无敏感内容的练习项目，关闭 IDE context 并检查没有附件，再发送短请求，避免把真实项目的活动文件一并带入授权后的首条任务。

想用的来源	首次接入时的具体操作	验证方法
ChatGPT 账户	AI Chat 选择 Codex，发送一条无敏感请求触发激活；阅读条款后自行决定是否点 Install and Continue；在授权选择中选 ChatGPT 或 ChatGPT (device code)，完成对应授权	在下述 Agent Authorization 和新聊天授权记录中确认来源；再完成一次小请求
OpenAI API Key	同样选择 Codex 并触发安装/激活；选 API Key，设置中 Third-party AI providers 选 OpenAI，填自己的 Key，Test Connection 后 OK	连接测试是第一步，还要确认 Codex 授权为 API Key，并验证当前请求可用
JetBrains AI	按需登录 JetBrains AI subscription，选择 Codex、发送请求并完成代理安装；授权时选择个人 JetBrains 或组织提供的 Organization	核对授权项及个人/组织归属，再查看对应 JetBrains AI 用量

BYOK 当前要求 OpenAI 直接签发的 API Key；兼容 OpenAI 接口的第三方 Key 不属于此集成承诺支持的范围。ChatGPT 订阅和 API 计费也不能互相代替。不要把 Key、设备验证码、授权链接或凭据文件发进聊天、工单或截图。

完成后进入 Settings > Tools > AI Assistant > Providers & API keys > Agent Authorization，查看 Codex 的活动授权。再查看本聊天开头的 Configured authentication。文档当前界面的授权选择含 JetBrains、API Key、ChatGPT、ChatGPT (device code)；组织授权可能显示 Organization。界面语言和版本不同，以实际授权记录为准。

官方设置配图中也有 Managed by agent 这样的概括标签；它本身不足以区分 ChatGPT 与 API Key。需要结合该聊天的 Configured authentication 和实际选择核对。仍无法确定时，把来源记为未确认，先向支持核查，不把概括标签当作精确计费证明。

只使用 ChatGPT 账户可启用 AI Chat 中的该代理；其他 AI Assistant 功能可能仍不可用，不能据此断定 Codex 授权失败，也不意味着必须另买 JetBrains AI。2026 年初发布文章中的限时优惠不是当前免费额度承诺。

已有授权时，不要先清空所有登录状态

先记录当前来源、错误发生阶段和版本。若当前来源正确，只是请求失败，保留现场继续查安装、网络或具体错误。确定要换来源时，才针对 Codex 使用该设置页的 Revoke，或聊天开头的 Configured authentication > Reset，按官方流程重新选择。

切换后新建聊天验证。 官方明确已有聊天保留之前的授权方式；在旧聊天继续发消息不能证明切换成功。若设置与聊天记录互相矛盾，先暂停较大任务、保存脱敏证据，不要靠反复发送请求猜计费。

点登录没反应，按失败阶段定位

未出现激活提示： 确认选中的是 Codex 代理；在新聊天发送不含项目代码的短请求。当前官方流程需要发送消息触发，不能只等选中后的自动登录。
下载或安装失败： 记录安装阶段、IDE/插件版本和脱敏错误；检查该执行端能否下载所需文件。不通过切 Full access、关闭 TLS 校验或开放 MCP 端口解决下载。
浏览器未打开或回不到 IDE： 当前界面若提供 ChatGPT (device code)，可按官方流程完成设备授权，再回同一聊天核对结果；没有该选项时先查版本/远程条件，不手工拼授权回调地址。
浏览器成功，IDE 仍失败： 回 Agent Authorization 和聊天授权记录核对。终端 codex login 成功并不能独立证明 JetBrains 集成已授权。保留错误文本，再参考登录错误分流；其中 CLI 命令不作为 JetBrains 通用修复按钮。

旧 issue 或支持文章中的插件依赖修复只适用于相同版本和现象。检查缺失/禁用依赖，不等于开启 MCP Server 监听、传入所有自定义 MCP 或扩大代理权限。

3. 上下文范围：自动附件与代理读文件要分别确认

适用条件： Codex 回答了错误文件、忽略另一个标签页，或你想知道提交了哪些代码。

当前 Codex 专属文档说明：开启 IDE context 时，自动附加当前活动编辑文件及其中的选中文本；其他打开文件、最近编辑文件和更广的项目上下文不会自动加入。输入框的指示器可切换此状态，额外文件用 @ 明确添加。

按下面顺序验证，先用不含凭据的练习文件：

打开目标文件，保存；在其中选中一小段有辨识度的内容。发送前检查输入框的文件名、选区与 IDE context 状态。
需要第二个文件时，输入 @ 并选择该文件，检查附件确实指向预期路径。仅把文件放到另一个标签页不够。
先用 Read-only 提问，要求按可用内容引用具体行或短片段；信息不足就说明缺什么。若附加文件仍无法读，查看可见的读取失败记录，再检查路径、文件状态与实际权限。
回答后同时看附件、可见工具调用/读取记录和原文件。答对一个公开标记只能说明该信息可用，不能证明全部上下文都已送达。

关闭 IDE context 只停止自动附带编辑器上下文。 Codex 还可能通过获准的工具主动读取项目文件；没有出现在附件中的文件，不等于一定无法读取。若界面未展示完整读取记录，应将范围记为未确认，不能用模型一句“我没有读其他文件”代替审计。

另一个容易误判的边界是 .aiignore 当前不适用于 Codex，列入其中的文件仍可能被处理。真实敏感材料应按团队批准的访问与数据处理规则隔离，不依赖忽略文件或提示词充当强制访问控制。

项目规范可放在根目录 AGENTS.md；先用只读请求核对可见规则来源。详细加载与偏离排查见 AGENTS.md 不生效，可参考规则模板。不要把 AI Assistant 的所有 Project rules 行为未经核对套到 Codex 上。

4. 用一个小任务验证“能读、能改、改对了”

适用条件： 已能正常授权，希望在交付真实任务前确认流程。

先在无敏感内容、可丢弃的练习项目中新建并保存 codex-check.txt，写入：

context_marker=JB_CODEX_DEMO_A
status=before
preserve=user-added-line

打开该文件并选中第一行，检查 IDE context；也可用 @ 明确附加它。先选 Read-only，发送：

只读核对 codex-check.txt。报告 context_marker 和 status 的当前值，
引用你实际可读取的短片段。不要修改文件，不读取其他文件，不联网。
如果信息不足，说明缺少什么，不要猜。

预期： 返回 JB_CODEX_DEMO_A 与 before，文件仍保持原样。回答不符时，核对附件、保存状态和可见读取记录；不要立即尝试大范围改动。一次遵守请求的表现并不构成访问隔离证明。

读取正确后，保持范围只限这个练习文件。使用 Default 协作模式，按需逐次批准修改，或在这个练习项目选择 Workspace access，再发送：

只把 codex-check.txt 的 status=before 改成 status=after。
完整保留 context_marker 和 preserve 两行，不改其他文件，
不安装依赖、不联网、不提交、不推送。完成后列出改动和未执行的验证。

预期： 文件仍为三行，只有第二行变为 status=after。在聊天中打开修改文件查看 diff，再到编辑器打开实际路径核对并确认保存。代理回复、代码建议和落盘修改是不同结果。

当前操作模式控制可做的动作，Plan/Default 控制协作方式。Plan 用于先分析和提出方案；若还停在计划阶段，不应把没改文件认作写入失败。Read-only 下出现修改审批是预期现象。审批前读完整路径和命令，超出本任务的动作先 Reject；不需要为了练习开启 Full access。

换到真实项目后，补上 Git 和项目验收

操作前提： 已在获准使用的 Git 项目中，先保存文件，并保全自己未提交、未暂存和未跟踪的内容。以下命令在该项目终端逐条运行，只用于检查；输出含私有代码时不要直接上传：

git rev-parse --show-toplevel
git status --short
git diff --stat
git diff
git diff --cached

记录执行前结果，任务后在同一仓库重查，逐文件分辨原有修改和本次新增。git diff 看未暂存的已跟踪差异，--cached 看暂存区；未跟踪文件不会因此显示完整内容，要从 status 中找出来并打开检查。新建的练习文件若显示 ??，diff 为空不等于文件不存在。忽略文件、配置和仓库外文件也不被这组检查完整覆盖。

对已跟踪差异可再运行：

git diff --check
git diff --cached --check

无输出、退出成功只表示未发现该检查覆盖的空白等问题，不证明功能正确。根据该仓库 README、构建配置和实际改动，运行相应的测试、类型检查或构建，记录命令、目录、退出码与失败项；涉及页面或接口行为时，还需实际打开页面或验证接口结果。练习文件的三行对照不能替代真实项目测试。

若改错路径、原有修改被覆盖或无法分离，先停止继续写入、保留现场，按保留原有修改的撤销边界处理。不要默认整文件 Rollback、整库 reset/clean。提交、推送和 PR 还需分别验收，见推送与创建 PR 排查。

5. 远程开发：核对 Host、Client 和代理真正运行的位置

适用条件： Gateway/Remote Development、远程容器、WSL，或本机终端能用但 IDE 任务失败。

JetBrains 远程架构中，源码和 IDE backend 位于远端，JetBrains Client 提供本地界面。Gateway 启动器不是项目 backend。先记录连接方式、Host 和 Client 的系统/版本、远程项目路径，以及当前 Codex 是集成入口、Registry 安装的 ACP 代理还是手工自定义代理。

排查步骤	具体操作与预期结果
查插件装在哪端	在当前远程项目的 Settings > Plugins 查看 AI Assistant 的安装位置指示；官方远程插件说明区分 Host、Client 或两端，且按远程项目安装。不要以本机 Installed 列表替代远程核对
查远程授权能力	对照前面的 262.9437 更新记录和实际兼容插件。当前有 ChatGPT (device code) 时，按该远程会话的提示授权；不要把旧版“不支持浏览器登录”概括为所有当前版本均不能登录
查执行路径	在代理可见的操作记录中确认运行系统和工作目录；有终端证据时与同项目终端的仓库根对照。找不到证据就标记未确认，不能把本机成功当作远端成功
查文件和工具是否同端	远程任务需要远端可见的文件、SDK/依赖与网络。绝对路径要属于该执行端；本机目录、CLI 登录状态和终端环境不会仅因连接成功就全部传过去
查重连后是否仍可用	初次成功后，在获准结束当前任务的前提下重连同一项目，再核对代理、授权记录和练习文件；若仅重连后消失，记录前后版本与现象，不反复改凭据掩盖问题

WSL 和自定义 ACP 需要单独判断

当前 ACP 文档的 Limitations仍写明 ACP-compatible agents 不支持 WSL。它与插件中新增的 Remote Development ChatGPT 登录能力不是同一条保证。Windows IDE 直接打开 WSL 路径、backend 真正运行在 WSL 的远程会话、普通 Linux SSH 主机，不应混为一个环境。 不据此承诺所有 WSL/Codex 组合可用，也不把它扩大成所有远程开发均不支持。

如果出现 Windows 可执行文件配 Linux 工作目录、Failed to initialize ACP process 或 No such file or directory，先核对可执行文件与工作目录属于哪一端。仅自定义 ACP 的 command 配置才按该代理文档检查完整可执行路径、参数和运行环境；不要把内置 Codex 自动替换成手工下载的 CLI，也不要擅自覆盖整份 acp.json。

无法确认支持组合时，保留受影响版本和脱敏错误，向 JetBrains 支持核对。可在另一个已受支持的本地练习项目验证基础授权，但这不能证明原远程项目已修好。不要复制凭据文件、开放公网端口、关闭网络防护或绕过组织策略来“打通”。工具环境问题可继续参考任务内找不到命令和任务联网排查，仍需保留 JetBrains 的 Host/Client 区分。

交付与求助前，保留这几项证据

入口与版本： IDE 完整 build、AI Assistant 版本、Codex 代理名称/安装来源、本地或远程模式；不是只报“最新版”。
授权： Agent Authorization 和该聊天的授权类型、个人/组织来源、是否在切换后新建聊天；隐去账户标识、Key 和验证码。
上下文： 当前活动文件、选区、IDE context 状态、明确附加的文件，以及实际可见的读取记录；未观察到的范围写未确认。
执行与结果： 实际工作目录、待审批动作、完整但已脱敏的失败步骤、目标文件和 diff、项目测试命令与结果；未运行的检查如实列出。
远程对照： Host/Client 版本和插件位置、重连前后差异。若是 ACP，可按官方日志说明收集；扩展日志可能包含请求和回答，不默认开启或上传原始归档。

2026-10-22 核验了 OpenAI IDE 文档、JetBrains 当前 2026.2 帮助页、Marketplace 功能引入记录和官方授权界面配图，并在本机打开 IntelliJ IDEA 检查入口。本机为 2025.1.3，低于 Codex 集成起点，且当前停在 IDE 许可证界面，因此没有完成当前版本的代理激活、真实模型请求或远程会话实测。文中的小任务是读者验证步骤；Git 检查在隔离练习仓库核对，不能当作所有 IDE/远程组合的成功记录。