Codex VS Code 插件不显示、一直转圈、failed to start app-server 怎么解决？

30 秒诊断：先按你看到的现象走，不要直接清缓存

最快的判断方法不是“重装一遍”，而是保留完整错误，确认扩展运行在哪个环境，再对照日志中的第一条明确错误。

只有中文界面或回答语言不对？进入 Codex IDE localeOverride、App Language 与中文失效排查。

Codex VS Code 插件安装后不显示：先用官方命令打开

OpenAI 当前 IDE 文档说明，VS Code、Cursor 和 Windsurf 使用 Codex 扩展。安装后应选择 Codex 图标；如果图标不可见，打开命令面板并运行：

Codex: Open Codex Sidebar

1. 核对官方扩展

   从 OpenAI 官方 IDE 页面进入 Marketplace，确认发布者为 OpenAI，扩展 ID 为 openai.chatgpt。不要安装名称相近、要求粘贴 Session 或账号密码的第三方扩展。

2. 确认扩展已启用

   在 Extensions 中打开 Codex 详情，检查不是 Disabled、Disabled (Workspace) 或被当前工作区信任策略停用。

3. 检查 Activity Bar

   右键左侧活动栏，确认 Codex 入口没有被手动隐藏；也可直接使用上面的命令，不依赖图标位置。

4. 确认安装在正确环境

   Remote WSL、SSH 和 Codespaces 会区分 Local 与远端扩展。在哪一侧运行 Codex，就在那一侧确认扩展状态。

官方参考：Codex IDE extension。

Codex VS Code 一直转圈、空白或没有输入框

Google 中文结果里，“一直转圈”“加载不出来”“打不开”通常被混成一个问题；实际至少要区分 UI 没刷新、Extension Host 卡住、认证请求失败和 app-server 进程失败。按以下顺序做一次最小恢复：

1. 保存现场

   记下编辑器版本、Codex 扩展版本、发生时间、Local/WSL/SSH 环境，并截取完整错误。不要先删除日志和配置。

2. 重新加载窗口

   在命令面板运行 Developer: Reload Window。如果恢复，仍应查看 Output 中刚才的错误，判断是否会复发。

3. 更新并重启

   更新 VS Code 或兼容编辑器与 Codex 扩展；关闭全部相关编辑器窗口后再打开项目。版本差异可能让 CLI 正常而 IDE 仍失败。

4. 做最小对话

   新建一个空对话，只请求解释当前打开的小文件。若旧会话转圈而新会话正常，更像会话状态；若所有会话都失败，继续看日志。

5. 检查是否等待审批

   如果界面停在 thinking，确认是否有权限批准、终端命令或文件写入提示。不要把等待用户操作误判成模型无响应。

WSL、Remote SSH、Codespaces：CLI 正常不等于扩展所在环境正常

VS Code Remote 会把界面和 Extension Host 分到不同机器或系统。先看编辑器左下角，再在同一个窗口的集成终端确认环境：

Windows 与 WSL 的安装、PATH 和 home 目录互不自动共享。需要完整安装路线时，查看Codex Windows / WSL2 指南。代理或网络问题也必须在扩展实际运行的那一侧验证；不要把关闭 TLS 校验、来源不明证书或全局放宽安全策略当作常规解法。

failed to start codex app-server：它是什么，应该怎么查？

OpenAI 官方 App Server 文档说明，codex app-server 是 Codex 用来驱动 VS Code 扩展等富客户端的接口，负责认证、会话历史、审批和流式事件。因此 failed to start codex app-server 表示扩展所需的本地服务没有正常建立，它本身不是“Plus 到期”或“Codex 额度用完”的同义词。

先记录完整错误后做三组检查：

# 在扩展实际运行环境的集成终端执行
codex --version
codex login status

# 如果当前安装支持 app-server，可只验证命令是否存在
codex app-server --help

• 命令找不到：检查扩展运行侧、安装来源和 PATH；不要随手设置一个来自网上的可执行文件路径。
• CLI 版本正常但扩展失败：继续比较 IDE 扩展版本、运行环境和 Output 日志。CLI 与扩展可能包含或调用不同版本。
• 日志明确是路径或权限错误：保留实际路径和错误码，核对安装是否完整、文件是否被安全软件或企业策略阻止。
• 更新后突然发生：查看 OpenAI Codex changelog 与官方仓库是否出现同版本、同错误字符串的 issue，再决定等待更新、回退扩展或临时使用 CLI。

“重新安装扩展”只有在文件缺失或安装损坏时才可能直接解决；认证、项目配置、远端环境或官方回归不会因为重复安装自动消失。若 CLI 在同一环境稳定可用，可暂时从集成终端继续工作，同时提交可复现报告。

官方参考：Codex App Server、openai/codex issues。

401、403、404、429：不要继续当成“插件加载失败”处理

CLI 与 IDE 扩展会共享 Codex 登录缓存，因此退出其中一个可能影响另一个。应先保存错误与 codex login status，再使用官方 codex logout、codex login 或需要时的 device auth；不要复制别人的 auth.json，也不要把自己的文件交给所谓“远程修复”。

CLI 和 IDE 扩展共享 config.toml：坏配置会让两边一起异常

OpenAI 官方 Developer settings 文档说明，CLI 与 IDE 扩展共享用户级 ~/.codex/config.toml 和可信项目中的 .codex/config.toml。因此以下变更都可能让扩展加载失败或请求异常：

• 固定了已弃用或当前账号不可用的模型；
• 自定义 model_provider、base_url 或认证变量不匹配；
• MCP server 启动命令不存在、超时或输出了不符合协议的内容；
• 项目级配置覆盖用户级配置；
• 企业 managed policy 要求与本地配置冲突。

先备份自己写的配置，再查看有效配置层。当前 Codex 支持在交互界面使用：

/status
/debug-config

如果问题只在某个项目出现，新建一个没有项目级 .codex/config.toml 的空目录做对照；如果所有项目都出现，再检查用户级配置。每次只改一处并保留差异，不要一次删除配置、凭证、插件和编辑器缓存，否则无法知道真正原因。

官方参考：Developer settings。

日志在哪里看？怎样提交一份可用的故障报告？

1. 在 VS Code 打开 View → Output，依次查看 Codex、Extension Host 或窗口里实际出现的相关通道。
2. 命令面板运行 Developer: Show Running Extensions，确认 Codex 是否启动、运行在 Local 还是 Remote。
3. 需要检查 UI 错误时运行 Developer: Toggle Developer Tools，记录第一条相关异常，不要只复制后续重复堆栈。
4. 在同一环境保存 codex --version、编辑器版本、扩展版本、发生时间和时区。
5. 用空目录、最小对话和无私密内容的测试文件确认能否复现。

提交到 OpenAI 官方仓库或支持渠道时，说明：

• 操作系统，以及 Local、WSL2、Remote SSH、Codespaces 或容器；
• VS Code / Cursor / Windsurf 版本和 Codex 扩展版本；
• ChatGPT 登录还是 API Key；
• 完整但已脱敏的错误、request ID、退出码和相关日志片段；
• 问题是首次安装、更新后、只在某项目还是所有项目出现；
• 同环境 CLI 是否可用，以及已经做过哪些最小排查。

Codex VS Code 插件常见问题

Codex VS Code 插件安装后为什么不显示图标？

先确认安装的是 OpenAI 发布、扩展 ID 为 openai.chatgpt 的官方扩展。在命令面板运行 Codex: Open Codex Sidebar；再检查扩展是否在当前 Local、WSL、SSH 或 Codespaces 环境中启用。

Codex VS Code 一直转圈、没有输入框怎么办？

先执行 Developer: Reload Window，更新编辑器和扩展，并在 Output 中查看 Codex 与 Extension Host 日志。然后按日志分流登录、app-server、网络、配置或远程环境问题，不要直接清空全部 VS Code 缓存。

failed to start codex app-server 是套餐或额度问题吗？

通常不是。OpenAI 官方说明 app-server 是为 VS Code 扩展等富客户端提供能力的本地接口；启动失败发生在客户端服务建立阶段。应先检查扩展版本、运行环境、日志和本地 Codex 状态，而不是重复充值。

Codex CLI 正常，VS Code 插件为什么仍打不开？

CLI 和 IDE 可能运行在不同环境或使用不同的打包版本。尤其在 WSL、Remote SSH 和 Codespaces 中，应在扩展实际运行的一侧检查版本、PATH、配置和登录；CLI 正常只能证明那一个终端环境可用。

为什么 VS Code WSL 中 Codex 找不到或无法加载？

Windows 和 WSL 是两个独立环境。确认 VS Code 左下角所示远程环境、扩展安装位置与集成终端一致，并在同一 WSL 环境检查 Codex。不要用 Windows 终端成功来证明 WSL Extension Host 一定正常。

Codex VS Code 插件 401 或 403 怎么办？

401 更接近认证未被接受，403 还可能涉及工作区、组织策略、地区或账号状态。先保存完整错误和时间，检查登录状态，再按官方 logout、login 或 device auth 流程处理，不要复制他人的 auth.json。

可以删除 auth.json 或整个 .codex 修复插件吗？

不建议。auth.json 可能含访问令牌，整个 .codex 目录还可能包含配置和会话。先使用官方命令退出登录、备份配置并做最小变更；不要把 auth.json、Session、API Key 或完整日志交给第三方。

Codex IDE 扩展和 CLI 会共用 config.toml 吗？

会。OpenAI 官方 Developer settings 文档说明 CLI 与 IDE 扩展共享用户和项目级 config.toml 配置层。错误的模型、provider、MCP 或项目配置可能同时影响两者。

Codex 卡在 thinking 是扩展坏了吗？

不一定。先确认是否在等待审批，尝试新建一个最小对话，并查看 Output 日志。若出现 429、401、403、404 或明确网络错误，应转到对应分支，不要只凭转圈动画判断。

提交 Codex VS Code 插件故障需要哪些信息？

提供发生时间和时区、编辑器与扩展版本、操作系统、Local/WSL/SSH/Codespaces 环境、认证方式、脱敏后的完整错误、相关日志片段和最小复现步骤。公开前删除账号、令牌、仓库代码和私密路径。