# Codex 常见问题

> Codex 接入 Passion8 排错 —— 未认证、/v1、Responses 接口、模型不可用。

URL: https://docs.passion8.cc/docs/codex/troubleshooting
Language: zh-CN
Publisher: Passion8

Codex 的接入问题大多集中在 **认证文件、Base URL 带不带 `/v1`、通道是否支持 Responses** 三处。

## 接入排错表

| 现象 | 优先检查 | 处理方式 |
| --- | --- | --- |
| 未认证 / `401` | `~/.codex/auth.json` 是否有 `OPENAI_API_KEY` | 写入 auth.json(不是 config.toml),Key 填完整。 |
| 连不上 / 报错指向地址 | `base_url` 是否漏了 `/v1` | 应为 `https://passion8.cc/v1`,**带** `/v1`。 |
| `404 /v1/responses` | 通道是否支持 Responses API | 切换到支持 Codex 的通道,或先升级后台 / 通道配置。 |
| model not found | 配置里的 `model` 名 | 改成 [模型广场](https://passion8.cc) 里实际支持 Codex / Responses 的模型 ID。 |
| `command not found` | Node / npm 是否安装、PATH 是否生效 | 确认 `node -v`、`npm -v`;装完新开终端。 |
| `余额不足` / 配额相关 | 钱包余额 | 见 [充值与账单](https://docs.passion8.cc/docs/billing) 补充余额。 |




两点记牢:**Base URL → `https://passion8.cc/v1`(带 `/v1`)**;**Key 放 `~/.codex/auth.json` 的 `OPENAI_API_KEY`,不写在 `config.toml`**。




## 还是不行?

带上具体报错信息(去掉 Key 等敏感内容)联系客服,见 [充值与账单 → 售后](https://docs.passion8.cc/docs/billing#售后与直充)。