使用文档工具接入

Codex CLI 接入 CoderPlan 教程

将 Codex CLI 接入 CoderPlan，按 OpenAI Compatible 方式配置 Base URL、API Key，并排查 401 unauthorized。

Codex CLI 配置

Codex CLI 接入 CoderPlan 时，使用 OpenAI Compatible 配置：OPENAI_BASE_URL 指向 CoderPlan 的 `/v1` endpoint，OPENAI_API_KEY 使用控制台生成的密钥。遇到 401 时先检查密钥、余额、模型权限和环境变量是否生效。

前置条件

先准备 CoderPlan 账号、可用余额和 `sk-` 开头的 API Key。建议用小额余额完成一次验证。

填对服务地址

Codex CLI 中的 Base URL、Endpoint 或 OpenAI Compatible URL 按工具要求填写。Codex CLI 使用 OpenAI Compatible Base URL，填写 CoderPlan 的 `/v1` endpoint。

Codex CLI 配置示例

OPENAI_BASE_URL=https://api.coderplan.ai/v1OPENAI_API_KEY=sk-your-api-key

配置步骤

  1. 1

    准备 CoderPlan API Key

    在控制台创建 API Key，并确认余额足够完成一次 Codex CLI 测试调用。

  2. 2

    设置 OpenAI Compatible 环境变量

    Codex CLI 使用 OpenAI 兼容字段时，把 OPENAI_BASE_URL 和 OPENAI_API_KEY 指向 CoderPlan。

  3. 3

    配置模型名称

    选择价格页显示可用的 OpenAI 或 Codex 相关模型，避免工具请求不存在的模型名。

  4. 4

    运行终端测试任务

    先执行一个简短解释或小修改任务。若出现 401 unauthorized，优先检查密钥和环境变量是否被旧值覆盖。

验证调用

保存配置后先发起一个简短请求，例如解释短函数。成功返回后，再交给它处理正式任务。

排查顺序

如果失败，先检查 API Key 是否完整、Base URL 是否包含 `/v1`、余额是否充足、模型是否可用。
查看排查教程选择编程模型

常见问题

Codex CLI 里的 Base URL 应该怎么填？

使用 OpenAI Compatible 配置时，Base URL 填 CoderPlan 的 `/v1` endpoint，API Key 使用 CoderPlan 控制台创建的 `sk-` 密钥。

Codex 中转具体要改什么？

Codex 中转落到配置上，就是把 OPENAI_BASE_URL 改成 CoderPlan 的 `/v1` endpoint，并把 OPENAI_API_KEY 换成 CoderPlan 控制台密钥。

codex unexpected status 401 unauthorized 是什么原因？

通常是 API Key 不完整、环境变量没有生效、余额或模型权限不可用。先重新打印当前环境变量，再到控制台确认密钥和余额。