Codex 安装或连接失败怎么办

先别急着重装。大多数 Codex 问题都集中在 4 个点：安装包是否正常、配置文件是否放对、API Key 是否绑定到正确订阅分组、skills 是否被重新扫描。

先按这个顺序排查

1. 确认 Codex 已正常安装并能启动。
2. 确认 config.toml 和 auth.json 已按提示配置。
3. 确认 API Key 绑定的是你实际购买的订阅分组。
4. 在 Codex 中发送 hi 看是否能得到正常回复。
5. 如果是 skills 问题，重启 Codex 并重新扫描本地 skills。

故障类型与处理方法

问题	先检查什么	典型处理
安装后打不开	安装包是否完整、系统权限	重新下载安装包，检查系统安全提示
能打开但无法回复	API Key、配置文件、分组	重新检查 config.toml、auth.json 和订阅分组
看不到论文 skills	skills 安装是否完成	重启 Codex，重新扫描 ~/.codex/skills
论文工作流执行混乱	提示词和步骤顺序	回到 论文工作流 按顺序执行

看不到 skills 怎么办

如果你已经执行过技能包安装命令，但输入 / 仍看不到新 skill，优先做这三件事：

1. 重启 Codex
2. 让它重新扫描本地 skills
3. 检查技能包地址是否完整，例如 https://china-models.com/downloads/skills/thesis-proposal.json

API 无法连接时怎么判断责任点

先分清楚是“安装问题”还是“配置问题”：

• 如果客户端打不开，通常是安装问题。
• 如果客户端能打开但模型不回复，通常是配置或密钥问题。
• 如果基础回复正常但论文 skill 不可用，通常是 skills 安装或扫描问题。

最容易忽略的两个细节

• 配置内容应放在文件顶部，而不是随便插在中间
• 创建 API Key 时选择的订阅分组必须和已购买套餐一致

FAQ

为什么发 hi 就够了

因为第一步只是验证链路是否通畅。基础连通没过，后续所有复杂任务都会被误判成“模型能力问题”。

重装能解决所有问题吗

不能。很多问题出在配置和分组，不在安装包本身。

下一步

• 想重新核对配置文件，看 Codex 的 config.toml 和 auth.json 怎么配
• 想进入论文场景，看 论文工作流