---
title: "一出问题先跑 codex doctor"
summary: "环境、Git、终端、app-server、端点防护、代理、桌面端状态、更新连通性、PATH 上的影子二进制。"
category: debug
level: starter
surfaces: [cli]
tags: ["doctor", "PATH", "排错"]
canonical: /tips/codex-doctor/
---

# 一出问题先跑 codex doctor

环境、Git、终端、app-server、端点防护、代理、桌面端状态、更新连通性、PATH 上的影子二进制。

```bash
codex doctor
codex --version
npm view @openai/codex version
```

PATH 上有两份 CLI 时，升级「没生效」几乎总是这个原因。Doctor 会标出来。

它还会报告编辑器/pager 环境，并在 JSON 输出里打码敏感值。升级或迁机器之后当成体检。

## 来源

- [Blake Crosley · Codex CLI Guide](https://blakecrosley.com/guides/codex)