1. VS Code 里 Codex 面板一片空白先别急着重装你打开 VS Code点开 Codex 扩展图标右侧面板刷地弹出来——然后什么都没有。没有输入框没有历史会话没有报错弹窗连个转圈的 loading 都看不到就是纯白。关掉重开重启 VS Code甚至卸载扩展再装一遍还是白。这个场景我太熟了。Codex 扩展在 VS Code 里界面空白绝大多数情况不是扩展坏了而是它启动时依赖的后台进程没跑起来或者配置里缺了关键字段导致前端拿不到任何可渲染的数据于是干脆给你一张白纸。它不报错是因为错误发生在扩展宿主进程里普通 UI 层捕获不到。这篇文章就围绕「vs code codex 界面空白」这个具体故障把排查路径拆成可跟做的步骤。核心思路是先看输出日志定位是配置缺失还是通道不通再把settings.json里的 Base URL 和 API Key 配对最后用一条最小请求确认整条链路是通的。适合已经在用 VS Code 写代码、想接入 Codex 类能力但卡在空白面板的同学。需要先明确一点Codex 扩展本身只是个前端壳它要连到一个兼容 OpenAI 协议的服务端才能工作。你面板空白往往是这个「服务端地址 密钥」没配好或者本地CODEX_HOME目录不存在导致 app-server 启动失败。下面按顺序来。2. 前置准备TaoToken 接入信息与 Codex 运行目录在动settings.json之前有两样东西必须先备齐否则后面改了也白改。第一样是接入信息。Codex 扩展需要一个 Base URL 和一个 API Key。Base URL 指向兼容接口的服务地址API Key 用来鉴权。这里我用 TaoToken 作为接入通道来演示它的接口地址是https://taotoken.net/api密钥在控制台里生成。你需要在 TaoToken 控制台创建一个 API Key复制出来备用。注意这个 Key 只在创建时完整显示一次丢了就重新建一个。第二样是本地运行目录。Codex 扩展启动时会去找一个叫CODEX_HOME的目录默认在用户主目录下的.codex。如果这个目录不存在app-server 进程会直接以 code1 退出前端拿不到进程面板就空白。这是很多人忽略的一步尤其在服务器或容器环境里主目录可能压根没初始化过。在 Linux/macOS 上你可以这样创建mkdir -p ~/.codex mkdir -p ~/.codex/attachments chmod 700 ~/.codex在 Windows 上对应目录是%USERPROFILE%\.codex用 PowerShellNew-Item -ItemType Directory -Force -Path $env:USERPROFILE\.codex New-Item -ItemType Directory -Force -Path $env:USERPROFILE\.codex\attachments权限这块Linux 下给 700 就够别给 777Codex 对目录权限有校验太松反而可能拒绝启动。Windows 一般不用手动改权限。提示如果你是在远程服务器上通过 VS Code Remote 连接开发~/.codex指的是服务器上的主目录不是你本地机器的。这一点经常搞混导致本地建了目录、服务器上还是没有。备齐这两样再进入配置环节。顺序别反先有目录和 Key再改配置否则你改完配置重载窗口还是空白会误以为配置写错了。3. 可复制配置把 settings.json 改到 TaoTokenCodex 扩展的配置入口在 VS Code 的settings.json里。打开方式CtrlShiftPmacOS 是CmdShiftP输入Preferences: Open User Settings (JSON)回车。如果你用的是工作区配置就选Open Workspace Settings (JSON)。在打开的 JSON 里加入下面这段。注意 JSON 不允许尾随逗号如果你文件里已有其他配置把这段的字段合并进去别直接整段覆盖。{ codex.baseUrl: https://taotoken.net/api, codex.apiKey: sk-你的TaoToken密钥, codex.model: gpt-5-codex, codex.home: /root/.codex }逐字段说明一下方便你对照自己的环境改字段作用取值示例codex.baseUrl接口基地址决定请求发到哪https://taotoken.net/apicodex.apiKey鉴权密钥缺失会 401控制台生成的sk-开头串codex.model指定调用的模型 IDgpt-5-codexcodex.homeapp-server 运行目录Linux 用/root/.codexWindows 用C:\\Users\\你\\.codex这里有个坑要提醒codex.home的路径必须和你实际创建的目录一致。如果你在服务器上建的是/root/.codex配置里就写/root/.codex如果你建在/home/yourname/.codex就写那个。路径写错app-server 照样启动失败面板照样空白。另外有些版本的 Codex 扩展读取的是settings.json里的codex命名空间有些读取的是环境变量CODEX_HOME。为了稳妥两个都配上。环境变量在 Linux 下可以写进~/.bashrcexport CODEX_HOME/root/.codex export OPENAI_BASE_URLhttps://taotoken.net/api export OPENAI_API_KEYsk-你的TaoToken密钥改完~/.bashrc记得source ~/.bashrc然后重启 VS Code 的终端会话。Windows 则在「系统属性 → 环境变量」里加同名变量。配置写完后先别急着发请求做一次重载窗口CtrlShiftP输入Developer: Reload Window回车。这一步让扩展宿主重新读取配置并重启 app-server。很多人改完配置不重载以为没生效其实是旧进程还在跑。4. 三步验证重载窗口、看输出日志、发最小请求配置改完接下来用三步确认到底通没通。这三步是递进的任何一步失败都能定位到具体环节。第一步重载窗口。上面已经说了Developer: Reload Window。重载后重新点开 Codex 面板如果之前是配置缺失导致的空白这一步之后面板应该能出现输入框。如果还是空白进入第二步。第二步看输出面板日志。这是最关键的一步也是原文里反复强调的。打开View → Output在右上角的下拉框里选择Codex。这里会打印 app-server 的启动日志和请求日志。你要重点看两类信息一类是启动错误。如果看到类似Error: CODEX_HOME points to /root/.codex, but that path does not exist说明目录没建对回到第 2 节补建目录。如果看到Codex app-server process exited unexpectedly (code1)说明进程启动就挂了通常是目录或权限问题。后面跟着的Codex process is not available是连锁报错不用单独处理解决前面的根因它自然消失。另一类是请求错误。如果启动日志正常但你发消息后看到401 Unauthorized说明 API Key 不对或没带上。如果看到local proxy failed或连接超时说明 Base URL 不通检查codex.baseUrl是否写成了https://taotoken.net/api注意结尾不要多加斜杠。如果看到reading choices之类的解析错误通常是返回体不是预期的 OpenAI 格式检查 Base URL 是否指向了正确的兼容端点。第三步发一条最小请求。面板恢复后在输入框里发一句最简单的话比如「你好返回一个数字 1」。这一步的目的是确认整条链路——VS Code → app-server → TaoToken → 模型——是通的。如果返回了内容说明配置全部正确。如果转圈很久然后报错回到第二步看输出日志里对应的请求错误。如果你想绕过 UI 直接验证通道可以用 curl 发一条最小请求curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的TaoToken密钥 \ -H Content-Type: application/json \ -d { model: gpt-5-codex, messages: [{role: user, content: ping}] }返回里如果有choices字段和内容说明 Key 和 Base URL 都没问题问题就出在 VS Code 侧的配置或目录上。如果这条 curl 就报 401那先解决 Key 的问题别在 VS Code 里折腾。5. 常见报错对照排查401、local proxy failed、reading choices把上面几步里可能撞到的报错集中列一下方便你对号入座。这些都是实测中真实出现过的不是编的。401 UnauthorizedAPI Key 缺失、写错、或者带了多余空格。检查settings.json里codex.apiKey的值确认是完整的sk-开头串前后没有引号外的空格。如果你用的是环境变量方式确认OPENAI_API_KEY已经export且当前 VS Code 进程能读到——改完环境变量要完全退出 VS Code 再启动光重载窗口不够。local proxy failed这个报错通常出现在扩展尝试通过本地代理转发请求时。根因一般是 Base URL 不可达或者本地代理端口被占用。先确认codex.baseUrl写的是https://taotoken.net/api然后在浏览器或 curl 里访问一下这个地址确认网络能通。如果公司网络有出口限制可能需要走内网镜像这个得找运维确认。reading choices或cannot read property choices扩展拿到了响应但响应体里没有choices字段说明返回的不是标准 OpenAI 格式。常见原因是 Base URL 指向了错误的路径比如少写了/v1或多写了/v1。TaoToken 的兼容端点是https://taotoken.net/api扩展内部会拼/v1/chat/completions你不需要在 Base URL 里重复写/v1。CODEX_HOME points to ... but that path does not exist目录没建。回到第 2 节用mkdir -p建好权限给 700。注意远程开发场景下要在服务器上建不是本地。Codex app-server process exited unexpectedly (code1)进程启动失败绝大多数是CODEX_HOME目录问题少数是 Node 版本不兼容。确认 VS Code 用的 Node 版本在扩展要求的范围内太老的版本会导致 app-server 起不来。OAuth相关报错如果你之前登录过某个账号扩展可能缓存了旧的 OAuth 凭证和现在的 API Key 模式冲突。清理一下~/.codex下的凭证缓存文件或者直接删掉整个.codex目录重建然后重载窗口。排查顺序建议固定成先看 Output 面板的 Codex 日志 → 确认CODEX_HOME目录存在 → 确认 Base URL 和 Key → 用 curl 验证通道 → 最后才怀疑扩展本身。按这个顺序九成空白问题都能定位。6. 配好之后把 Codex 接进日常编码流面板恢复只是第一步真正省时间的是把它接进你日常的编码动作里。我自己的用法是写新函数时让 Codex 先出骨架我再改读别人代码时选中一段让它解释改 bug 时把报错和上下文一起贴进去。这些都不需要离开 VS Code省掉了切窗口的成本。如果你打算长期用 Codex 做编码和 Agent 类任务建议直接上 Coding Plan额度比按次调用划算适合每天都要跑几十次请求的场景。配置方式还是上面那套settings.json把 Key 换成 Coding Plan 对应的即可。需要生成或管理 Key 的话入口在这里API Keys 页面https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite。接入文档在https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite里面有各语言和工具的完整配置示例。想先在网页里试一下模型对话效果可以打开https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite发一条消息确认通道正常再回到 VS Code 配。最后留一个我踩过的坑改完settings.json后如果你同时开着多个 VS Code 窗口每个窗口的扩展宿主是独立的只重载当前窗口可能不够其他窗口还是旧配置。要么全部重载要么干脆退出 VS Code 再启动一次。这个细节不注意会出现「明明改对了但另一个窗口还是空白」的假象。