服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务，不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动，严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外，不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- 官方 2026 年 10 月 29 日的 CLI 0.166.0 更新列出 --network-only；先确认正在运行的版本和帮助信息，不能仅凭下载过新版判断。
- 聚焦报告只覆盖有效配置、网络环境、提供方 HTTP 可达性和 Responses WebSocket，不包含数据库或 MCP 扫描。
- 配置加载失败时，命令报告脱敏错误并停止，不会猜测网络目标继续探测；成功加载时保留配置警告和加载耗时。
- HTTP 与 WebSocket 是不同检查。全部通过仍不代表实际任务、工具权限、账号额度或集成协议已验收。
先在真正失败的 CLI 环境运行
先执行 codex --version，再用 codex doctor --help 确认当前安装识别 --network-only。官方更新记录将此功能列入 2026 年 10 月 29 日发布的 CLI 0.166.0；相关代码前一天合并，但合并日期不能替代发布记录。
随后在出问题的同一终端、主机和用户环境运行 codex doctor --network-only。若失败发生在远程开发机，就在那台机器的实际 CLI 环境核对；本机浏览器能打开网页，不能证明远程进程使用相同配置或网络路径。
四项检查分别回答什么
有效配置说明诊断读取到什么运行设置，并保留可恢复的配置警告与加载耗时。网络环境、提供方 HTTP 可达性和 Responses WebSocket 则分别提供连接路径的诊断线索；Responses WebSocket 是与模型服务通信的一种持续连接。
--network-only 会跳过完整 doctor 中与此目标无关的检查，例如数据库和 MCP 扫描。不要把一份简短网络报告当成安装、全部工具或整个项目的健康证明，也不要据此判定 MCP 服务已正确启动。
配置加载失败，为什么看不到网络探测结果
这是明确设计的停止条件：若配置加载失败，命令输出脱敏的配置失败信息，说明无法获得有效网络配置，然后返回；它不会用猜测的地址继续探测。因此“没有后续连接结果”不等于所有网络目标都不可达。
先按错误中实际提供的文件位置、行列或错误类型检查配置，再重跑相同命令。不要为了得到一份绿色报告随意删除配置或改成另一套提供方；否则比较的已经不是原来失败的环境。
HTTP 通过，WebSocket 失败，下一步查什么
两项结果应分开看。HTTP 可达不保证持续的 WebSocket 连接也能成功；反过来，某一项失败也不能单独证明是代理、账号、服务故障或额度用尽。先保存具体检查名、时间和错误，再对照当前提供方与组织网络要求。
例如，假设同一环境中 HTTP 检查通过，Responses WebSocket 检查失败，可以请网络管理员核对这条实际传输路径、代理认证和组织策略。这个例子用于说明排查顺序，不是已经确认的故障原因；不要关闭 TLS 校验或绕过组织控制来试通。
需要交接时，保留可比较的报告
如需机器可读输出，可使用 codex doctor --network-only --json。官方命令参考将 JSON 报告描述为脱敏输出；发送给同事或公开工单前，仍应检查是否包含内部路径、域名或其他不宜公开的信息，不要附带真实令牌、代理凭据或完整配置。
记录 CLI 版本、操作系统、发生问题的主机、检查时间和每项结果。一次只改一个与错误有关的设置，再在同一环境重跑；原报告与修改后的报告一起保留，比只截取“通过”更方便判断变化。
报告通过后，再验证原来失败的任务
重新执行一个有权限、范围受控的原任务，核对实际完成状态。网络报告通过不会补齐工具权限、修复 MCP 或 App Server 协议，也不会证明任务输出正确；额度、计费、套餐与地区资格仍按服务自己的规则判断。
如果仍失败，把具体任务错误与网络报告放在同一时间线上，继续查对应层。本文依据官方发布说明、命令参考及合并代码解释诊断范围，没有执行真实账号请求，也不承诺该命令自动修复连接或重置额度。
资料来源
常见问题
提示 unknown argument --network-only，应该怎么处理？
先核对 codex --version 和 codex doctor --help，确认实际运行的安装是否包含 0.166.0 的功能。同一台机器可能有多个安装位置；按已有安装方式核对或更新，不要把参数不识别误当成网络故障。
完整 doctor 与 --network-only 应该选哪个？
当问题集中在配置和连接路径时，聚焦模式可以减少无关检查。若需要查看安装、运行环境、数据库或 MCP 等其他范围，应按当前命令帮助选择完整诊断；聚焦报告没有覆盖的项目保持未检查。
把报告发出去，就能确认服务端故障吗？
不能。它提供某一版本、某一环境和某个时点的诊断线索，需要结合原任务错误及官方状态判断。单个失败或一次全部通过，都不足以证明全体用户的服务状态。