Codex 打不开通常指三种情况:桌面应用白屏或一直转圈、CLI 在终端里无法启动、以及能打开却卡在登录或「正在重新连接」。先分清你用的是哪一种,再照下面的步骤逐一排查。多数情况下,清缓存、查端口、重载登录态就够用了。官方入口是 chatgpt.com/codex,桌面端也可用 codex app 唤起。 Codex 打不开分哪几种情况
OpenAI 的 Codex 目前有三个形态,入口和排查方式各不相同,先对号入座:
- Codex CLI:在终端里运行的本地编程智能体,命令是 codex,适合嵌进工作流。
- Codex 桌面应用:ChatGPT 桌面应用里的 Codex 模式,可用 codex app 唤起,或访问 chatgpt.com/codex?app-landing-page=true。
- Codex 云端:网页版,地址是 chatgpt.com/codex,无需安装。
注意区分入口:能联网用浏览器就选网页版或桌面端;想写代码嵌进终端就装 CLI。安装 CLI 在 Mac/Linux 执行 curl -fsSL https://chatgpt.com/codex/install.sh | sh,Windows 执行 powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"。Windows 桌面应用也可从 Microsoft Store 安装(搜索 ChatGPT 桌面应用,或用 winget install --id 9PLM9XGG6VKS -s msstore)。
桌面端打不开的排查步骤
桌面端白屏、转圈、双击没反应,按下面顺序处理:
- 先确认网络能访问 OpenAI 服务:用浏览器打开 chatgpt.com/codex,看是否正常加载;浏览器都打不开,问题在网络或账号侧。
- 清缓存后重启:备份配置后,删除本地缓存目录(macOS 在 ~/.codex,Windows 在 %APPDATA%\Codex),再重启应用。
- 检查本地端口是否被占用:桌面端内置本地服务若起不来,会一直「正在重新连接」,常见是 8080 等调试端口被占,结束占用进程后重启。
- 核对版本是否一致:ChatGPT 桌面应用和 Codex CLI 可能包含不同版本的 Codex,功能会一边先于另一边上线。CLI 版本用 codex --version 查,macOS 桌面内置版本用 /Applications/Codex.app/Contents/Resources/codex --version 查。
- 卡死时先松手:对话看起来卡住,先确认是否在等你的审批;开终端跑 git status;用更小、更聚焦的 prompt 开新对话。终端面板卡住就关掉重开(Ctrl+\`)再跑 pwd 或 git status。
CLI 无法启动的解决办法
终端里 Codex 起不来,常见原因和对应处理:
- command not found: codex:CLI 没装或不在 PATH。重装 npm install -g @openai/codex,或直接用 npx @openai/codex 临时运行。
- Node.js 未就绪:CLI 依赖 Node.js 运行环境,先确认已安装且版本可用,再重跑安装命令。
- 登录态失效:跑 codex login 重新走浏览器授权;若提示 token 过期,先 codex logout 再 codex login。
- 不要以 root/sudo 运行:CLI 不需要提权,用 sudo 反而容易引发权限与凭据写入问题。
登录失败、一直重新连接怎么办
应用能打开却卡在登录或「正在重新连接」,大多是鉴权链路的问题:
- 本地回调端口:ChatGPT 账号登录走浏览器 OAuth,CLI 默认用 localhost:1455 把 token 回传给进程。远程或无图形界面的机器浏览器登录用不了时,改用设备码登录(交互登录界面选 Sign in with Device Code),或本地登录后把 ~/.codex/auth.json 复制到目标机。
- 凭据缓存位置:登录信息缓存在 ~/.codex/auth.json 或系统凭据存储里;ChatGPT 会话 token 会在过期前自动刷新,过期则需重新登录。
- 企业网络 / 代理:若公司用私有根证书或 TLS 代理,登录前设置 CODEX_CA_CERTIFICATE 指向 PEM 包(未设会回退到 SSL_CERT_FILE)。
- 远程服务器:用 SSH 端口转发 ssh -L 1455:localhost:1455 user@remote,在远端跑 codex login,在本地浏览器完成授权后 token 经隧道回到远端进程。
日志与配置在哪里
自己排查时,这几个路径是关键线索:
| | |
|---|
| ~/Library/Logs/com.openai.codex/YYYY/MM/DD | |
| $CODEX_HOME/sessions(默认 ~/.codex/sessions) | |
| | |
| | |
配置目录默认是 ~/.codex(Mac/Linux)和 %USERPROFILE%\.codex(Windows)。提报问题时,先在 GitHub 的 Codex 仓库搜已有 issue,再带会话 ID 和日志提交新 issue,提交前记得检查日志不含敏感信息。
Codex 打不开的注意事项
- Windows 桌面端与 WSL 不共享配置:Windows 桌面应用默认用 %USERPROFILE%\.codex,而 WSL 里的 CLI 默认用 Linux 家目录的 ~/.codex,两边凭据、会话默认不通;需要互通就在 WSL 里设 export CODEX_HOME=/mnt/c/Users/<用户>/.codex 或做双向同步。
- GUI 可能读不到 shell 的环境变量:桌面应用和 IDE 扩展不一定继承终端里的环境变量,把所需值写进 ~/.codex/.env 后重启应用或扩展再试。
- 删缓存前先备份配置:清 ~/.codex 前,先保留 config.toml 等文件,避免把正常配置一起清掉。
- 认准官方入口:OpenAI 的 Codex 官方入口就是 chatgpt.com/codex 与 Codex CLI,请从官方页面直接进入,凡要求输入账号密码或付费的非官方页面都不要提交信息。
Codex 打不开常见问题
Q:桌面端白屏、一直转圈,点不开怎么办?
A:先确认浏览器能正常打开 chatgpt.com/codex;能打开就清桌面端缓存(macOS ~/.codex、Windows %APPDATA%\Codex)后重启,并检查 8080 等本地端口是否被占用。
Q:终端报 command not found: codex 怎么解决?
A:说明 CLI 没装或不在 PATH。重装 npm install -g @openai/codex,或临时用 npx @openai/codex 直接运行。
Q:能打开但一直「正在重新连接」、登录没反应?
A:多半是登录态没建立或本地回调端口被占。关掉应用,清登录缓存,跑 codex login 重新授权;远程环境改用设备码登录。
Q:远程服务器、无图形界面怎么登录 Codex?
A:用设备码登录(选 Sign in with Device Code),或本地登录后把 ~/.codex/auth.json 复制到服务器;也可用 ssh -L 1455:localhost:1455 做端口转发。
Q:公司网络下连不上、登录失败?
A:企业 TLS 代理或私有根证书会拦 OAuth 回调。登录前设 CODEX_CA_CERTIFICATE 指向公司的 PEM 证书包,未设会回退到 SSL_CERT_FILE。
Q:桌面端有某个功能,CLI 里却没有?
A:桌面应用和 CLI 可能包含不同版本的 Codex,功能会一边先于另一边上线。分别用 codex --version 和 /Applications/Codex.app/Contents/Resources/codex --version 核对版本。
Q:Windows 和 WSL 里的配置、登录态不同步?
A:两者默认用不同目录(%USERPROFILE%\.codex 与 ~/.codex),不通是默认行为。在 WSL 里设 CODEX_HOME 指向 Windows 那份目录即可互通。
Q:日志和会话记录存在哪,怎么自查?
A:应用日志在 ~/Library/Logs/com.openai.codex/ 下,会话记录在 ~/.codex/sessions,登录凭据在 ~/.codex/auth.json,排查时优先看这几处。
Q:官方入口到底是哪个,codex.openai.com 能用吗?
A:官方入口是 chatgpt.com/codex(桌面端与云端)和 Codex CLI;codex.openai.com 并不存在,网上还有不少带 codex 字样的近似站点,多数属于第三方占名、并非官方地址,请从官方页面直接进入。
Codex 的版本、安装方式与登录链路会随官方更新调整,动手前先在 chatgpt.com/codex 确认当期状态即可。想把 Codex 打不开 的排查经验沉淀下来,可以关注本站的 AI 工具栏目,遇到新坑我们会同步补充。