Browser Use actions fail with "Codex auth token is unavailable" in API-key mode

登录后检查

codex --version
codex login

如果 CLI 显示已经登录，完全退出 Codex Desktop（包括菜单栏/托盘进程）并重新启动。不要只关闭当前会话窗口，因为浏览器桥接进程可能仍在使用旧的认证状态。

Linux 和 Windows

官方仓库提供跨平台安装脚本：

# macOS / Linux
curl -fsSL https://chatgpt.com/codex/install.sh | sh

# Windows PowerShell
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

安装后运行：

codex

然后选择 Sign in with ChatGPT。Windows 上的具体浏览器桥接问题可能还会受到桌面版、插件版本和 app-server 路径的影响；如果 CLI 登录后仍失败，先升级 Codex Desktop 和 CLI，再重新登录。

验证是否修复

重启 Codex 后按由浅到深的顺序验证：

1. 浏览器列表是否能正常返回；
2. 当前标签页的 URL 和标题是否可读；
3. DOM snapshot 或页面截图是否成功；
4. 最后再测试点击、输入和页面跳转。

如果第 1、2 步成功但第 3 步仍失败，说明浏览器发现正常，问题仍在 Browser Use/app-server 的认证或版本兼容层；如果第 1 步就失败，优先检查 CLI 是否登录到了正确的 ChatGPT 账号，以及桌面端是否已完全重启。

不建议直接修改插件源码

网上可以看到通过修改 browser-client.mjs 或 browser-service.mjs，让 Codex auth token is unavailable 降级为匿名/空结果的补丁。这类办法可能暂时绕过某个状态检查，但会带来几个问题：

• Codex 更新后补丁容易失效；
• 可能只跳过 feature/status 请求，实际页面控制仍然不可用；
• 直接改插件缓存文件会让问题难以复现和升级；
• 不应为了让浏览器继续运行而把 ChatGPT token 或第三方 API Key 写入错误的请求头。

更稳妥的顺序是：先完成 Codex CLI 登录，确认账号和版本，再考虑针对明确的版本回归提交 Issue。

结论

Codex auth token is unavailable 在 API-key 模式下通常不是目标网站故障，而是'模型 API 认证'和'浏览器控制认证'不一致造成的。最简单、可重复的修复流程是：

brew install codex
codex login

完成 ChatGPT 登录后重启 Codex Desktop，再逐步验证浏览器列表、标签页读取、截图和实际操作。这个方法让本地 CLI 认证状态补齐 Browser Use 所需的身份链路，也是我在 macOS 上验证成功的方案。