常见问题

CODEX_HOME 没有输出正常吗？

正常。变量为空表示 Codex 使用默认目录：

C:\Users\你的用户名\.codex

Codex 必须用管理员权限运行吗？

不需要。安装和日常运行都建议使用普通 PowerShell。只有修复 Windows 文件权限时才临时打开管理员 PowerShell。

Base URL 为什么必须加 /v1？

OpenAI 兼容接口通常把 API 路由放在 /v1 下。只填写域名可能返回网页或 404。

为什么 codex --version 正常，codex 却打不开？

版本命令只说明程序已安装。启动时还会读取配置、检查认证并连接 API，因此配置权限或接口地址错误仍会导致启动失败。

可以把 API Key 发给客服排查吗？

不要发送完整 Key。提供错误文字、HTTP 状态码和已遮住 Key 的配置截图即可。Key 一旦泄露，应立即撤销并重新生成。