1. Codex Chrome 扩展显示未连接，先别急着重装

Codex Chrome 扩展显示未连接，是很多人在把 Codex 接入浏览器自动化流程时遇到的第一个拦路虎。它的典型表现是：扩展图标已经出现在 Chrome 工具栏，点开却提示连接失败，Codex 无法接管当前标签页，重装扩展、重启浏览器都无济于事。这个问题的本质，通常不是扩展没装好，而是扩展与本地 Codex 客户端之间的通信通道没有建立起来，或者建立之后因为 Key、API 地址、Profile 上下文不一致而断开。

这篇文章聚焦一个更具体的场景：当你使用 TaoToken 统一 Key 来驱动 Codex 时，扩展侧和本地 settings.json 骨架如果配置不一致，就会出现"扩展显示未连接"的假象。我会从扩展侧配置和本地 settings.json 两个入口入手，给出可复制的配置片段和逐项验证动作，让你在本地复现并确认连接恢复。适合已经装好 Codex 客户端、拿到 TaoToken Key、但卡在扩展连接状态这一步的开发者。

需要先明确一个概念：Codex Chrome 扩展的"已连接"状态，依赖三个条件同时成立——本地 Codex 客户端在运行、扩展与客户端之间的本地通信端口可达、以及客户端使用的模型通道配置正确。前两个条件决定了"能不能连上"，第三个条件决定了"连上之后能不能正常干活"。很多人只排查了前两个，忽略了第三个，于是扩展显示已连接，但一发请求就报错，或者干脆回退到未连接状态。

TaoToken 在这里的角色是统一模型入口。你不需要在 Codex 客户端、扩展、以及各种脚本里分别维护不同的 Key 和 Base URL，而是让它们都指向同一个 API 地址和同一把 Key。这样排查连接问题时，变量就少了很多。下面按步骤来。

2. TaoToken 前置：统一 Key 与 API 通道准备

在动 settings.json 之前，先把 TaoToken 侧的准备工作做完。这一步的目标是拿到一把可用的 Key，并确认 API 地址。

打开 TaoToken 官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，注册或登录后进入控制台。控制台地址是 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console 。在控制台里找到 API Keys 管理页，路径是 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys ，新建一把 Key 并复制保存。这把 Key 就是后面 settings.json 里要填的凭证。

API 的基础地址是 https://taotoken.net/api ，注意这个地址不带任何查询参数，直接作为 Base URL 使用。如果你用的是 Anthropic 兼容通道，Codex 相关的接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc ，里面有不同客户端的配置示例，建议对照着看一遍。

注意：Key 只在创建时完整显示一次，复制后妥善保存。如果怀疑泄露，直接在控制台删除重建，不要试图找回旧 Key。

拿到 Key 和 Base URL 之后，先别急着改 Codex 的配置。用一条 curl 命令验证这把 Key 是否可用，能省掉后面很多来回。命令如下：

curl -s https://taotoken.net/api/v1/models \ -H "Authorization: Bearer sk-你的Key" \ -H "Content-Type: application/json"

如果返回一个包含模型列表的 JSON，说明 Key 和 API 通道都是通的。如果返回 401，检查 Key 是否复制完整、有没有多余空格；如果返回 404，检查 Base URL 是否写成了带路径的形式。这一步通过之后，再进入 Codex 侧的配置。

3. 可复制配置：settings.json 骨架与扩展侧对齐

Codex 客户端的本地配置文件通常位于用户目录下的.codex文件夹，文件名是settings.json。不同版本路径略有差异，Windows 一般在C:\Users\你的用户名\.codex\settings.json，macOS 和 Linux 在~/.codex/settings.json。如果文件不存在，手动创建即可。

下面是一份可以直接复制修改的 settings.json 骨架，重点是模型通道部分要和 TaoToken 对齐：

{ "model_provider": "taotoken", "model": "claude-sonnet-4-20250514", "providers": { "taotoken": { "base_url": "https://taotoken.net/api", "api_key": "sk-你的Key", "wire_api": "chat" } }, "browser_extension": { "enabled": true, "connection_mode": "local", "reconnect_on_start": true } }

几个关键字段说明一下。model_provider指向taotoken，和providers里的键名一致，这样客户端才知道用哪套通道。base_url必须是https://taotoken.net/api，不要多加/v1或斜杠，具体路径由客户端拼接。api_key填你在控制台创建的那把 Key。wire_api用chat表示走 Chat Completions 兼容格式，如果你的客户端版本要求responses，按文档调整。

browser_extension这一段是扩展连接相关的开关。connection_mode设为local表示走本机通信，reconnect_on_start设为true让客户端启动时主动重建连接。这两个字段能显著减少"扩展显示未连接"的概率。

改完 settings.json 后，扩展侧也要对齐。打开 Chrome，进入扩展管理页，找到 Codex 扩展，点开详情，确认它安装在你当前正在使用的 Profile 下。Chrome 右上角头像可以切换 Profile，如果你有多个 Profile，扩展只装在 A 而你在用 B，那扩展永远连不上。确认 Profile 一致后，在扩展的选项页里检查它指向的本地端口或客户端地址，默认情况下不需要改，但如果你的客户端改过端口，这里要同步。

提示：修改 settings.json 后必须完全退出 Codex 客户端再重新启动，托盘图标右键退出不算完全退出，要在任务管理器或活动监视器里确认进程结束。

4. 验证请求：确认连接恢复的完整动作

配置改完，接下来是逐项验证。不要跳步，每一步都有明确的预期结果。

第一步，重启 Codex 客户端。启动后观察托盘或菜单栏图标，确认客户端处于运行状态。如果客户端启动就报配置错误，说明 settings.json 的 JSON 格式有问题，用python -m json.tool settings.json检查一下语法。

第二步，在客户端里发一条最简单的模型请求，确认 TaoToken 通道可用。如果客户端有内置的对话入口，直接发"你好"即可。如果没有，用 curl 再验证一次：

curl -s https://taotoken.net/api/v1/chat/completions \ -H "Authorization: Bearer sk-你的Key" \ -H "Content-Type: application/json" \ -d '{ "model": "claude-sonnet-4-20250514", "messages": [{"role": "user", "content": "ping"}] }'

返回正常内容，说明模型通道没问题。这一步和扩展连接是独立的，但通道不通时扩展即使显示已连接也无法工作，所以必须先过。

第三步，回到 Chrome，新建一个全新标签页，点击 Codex 扩展图标。预期结果是状态变为"已连接"。如果仍然是未连接，打开扩展的后台页面看日志。Chrome 扩展管理页开启"开发者模式"，找到 Codex 扩展，点"背景页"或"Service Worker"，在控制台里看有没有连接被拒绝、端口不可达之类的报错。

第四步，让 Codex 实际接管一个页面做一次操作，比如读取当前标签页标题。这一步是端到端验证，能确认扩展和客户端之间的通信链路完整。如果这一步成功，说明连接彻底恢复。

我试过在多个 Profile 之间来回切换后扩展状态错乱的情况，最后就是靠"完全退出客户端 + 新建标签页 + 确认 Profile"这三步组合解决的。顺序很重要，先退客户端再新建标签页，让扩展重新走一遍初始化。

5. 本篇常见错排查

即使按上面的步骤走，还是可能遇到一些具体报错。下面按现象归类。

扩展显示已连接但请求报 401。这说明扩展和客户端的通信是通的，但客户端用的 Key 不对。检查 settings.json 里的api_key是否和 TaoToken 控制台里的一致，注意有没有换行符或引号问题。如果 Key 刚重建过，旧 Key 会立即失效，必须同步更新。

扩展一直显示未连接，客户端日志报端口占用。Codex 客户端默认监听一个本地端口，如果这个端口被其他程序占用，扩展就连不上。在客户端设置里换一个端口，同时确认扩展侧指向的端口同步更新。Windows 上用netstat -ano | findstr 端口号可以查占用。

settings.json 改了但客户端不生效。最常见的原因是客户端没有完全退出，或者存在多个 settings.json（比如项目级和用户级各一份）。确认你改的是客户端实际读取的那一份，改完后彻底重启。

扩展在无痕窗口或新 Profile 里不可用。Chrome 默认不允许扩展在无痕模式运行，需要在扩展详情里手动开启"在无痕模式下启用"。新 Profile 则需要重新安装扩展，因为扩展是按 Profile 隔离的。

企业环境扩展被策略禁用。如果 Chrome 显示"此扩展程序由您的组织管理"且无法启用，说明有企业策略限制。这种情况需要联系 IT 把 Codex 扩展加入允许列表，不是本地配置能解决的。

模型名写错导致连接后立即断开。settings.json 里的model字段必须是 TaoToken 支持的模型名。写错时客户端可能在建立连接后立即收到错误并断开，表现和"未连接"很像。对照接入文档里的模型列表核对。

排查时建议按"通道 → 客户端 → 扩展"的顺序，先确认 curl 能通，再确认客户端能发请求，最后确认扩展能连上。倒过来排查容易在扩展侧绕圈子。

6. 继续用 TaoToken 统一管理你的模型通道

Codex Chrome 扩展显示未连接，绝大多数情况下不是扩展本身的问题，而是本地客户端与扩展之间的通信状态、以及模型通道配置的一致性出了问题。把 TaoToken 作为统一入口之后，你只需要维护一把 Key 和一个 Base URL，settings.json 和扩展侧都指向它，变量少了，排查路径就清晰了。

如果你还在配置阶段，建议先去控制台把 Key 建好：https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys 。接入细节对照文档：https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc 。想先验证模型通道是否正常，可以直接用模型对话页试一条请求：https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_content=chat 。如果你打算长期用 Codex 做编码和 Agent 任务，Coding Plan 会更省心：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan 。

最后留一个实用习惯：每次改完 settings.json，先跑一遍第 2 节那条 curl，确认通道通，再去动浏览器。这个顺序能帮你把"通道问题"和"扩展问题"彻底分开，少走很多弯路。