快速开始
Codex CLI 快速接入 OfApp.cn
Codex CLI 快速接入 OfApp.cn 教程，讲清 API Key 登录、openai_base_url、config.toml、Base URL、模型配置、最小验证和常见错误。
Codex CLI 适合把 AI 代理带进真实项目：读取代码、修改文件、运行命令、排查 Bug、补测试、整理文档或完成自动化脚本。把它接到 OfApp.cn 时，核心不是在 每个 Prompt 里写服务商名称，而是让 Codex 使用正确的 API Key、Base URL 和 模型配置。
本文是一条快速接入路径，适合已经有 OfApp.cn Key、想先让 Codex 在本机跑起
来的人。更完整的 profile、自定义 provider、CI 和项目 .env 分层，请继续
看 Codex CLI 接入 OfApp.cn。
| 项目 | 说明 |
|---|---|
| 阅读时间 | 约 5 分钟 |
| 更新时间 | 2026-07-03 |
| 适合读者 | 开发者、独立开发者、产品经理、正在学习 Codex 的用户 |
| 适合任务 | 配置 Codex CLI、验证 OfApp.cn Key、切换 Base URL、排查登录和模型问题 |
你要准备什么
Section titled “你要准备什么”在动 Codex 配置前，先准备三项信息。缺任何一项，都不要急着让 Codex 修改项 目。
| 信息 | 从哪里来 | 用在哪里 | 容易出错的地方 |
|---|---|---|---|
| API Key | OfApp.cn 控制台创建 | codex login --with-api-key 或本机密钥管理 |
把真实 Key 写进 Prompt、README、截图或日志 |
| Base URL | OfApp.cn 官方文档 | openai_base_url 或 provider base_url |
漏写 /v1，或被客户端重复拼接 |
| 模型名 | OfApp.cn 控制台或官方文档 | model 配置 |
凭旧教程猜模型，或使用当前账号不可用模型 |
本站示例使用 https://api.ofapp.cn/v1 作为 OpenAI 兼容入口。具体模型、端点
能力、额度、价格和套餐请以 OfApp.cn 控制台或官方文档为准。
这条路径的重点是“先让 Codex 自己能调用模型，再让它处理仓库”。如果登录和 Base URL 没跑通，后面的代码任务会把配置问题伪装成项目问题。
安装后先确认版本
Section titled “安装后先确认版本”Codex CLI 支持 macOS、Windows 和 Linux。安装方式可能随版本变化，建议以 OpenAI Codex 官方 Quickstart 或 OfApp.cn 官方接入页为准。安装后先确认当前 命令可用：
codex --versioncodex --helpcodex login --help如果 codex login --help 里能看到 --with-api-key，就可以用标准输入传入
API Key。不要把真实 Key 直接粘进命令历史、Issue、聊天记录或截图。
推荐的快速配置
Section titled “推荐的快速配置”Codex 当前文档说明，用户级配置位于 ~/.codex/config.toml。如果只是把内置
OpenAI provider 指向兼容入口，使用 openai_base_url 即可，不需要先创建自
定义 provider。
model = "以控制台可用模型为准"model_provider = "openai"openai_base_url = "https://api.ofapp.cn/v1"这段配置应该放在用户级 ~/.codex/config.toml。不要把 provider、Base URL
和认证相关配置提交到不受信任项目的 .codex/config.toml，因为这些配置会
影响 Codex 如何发送请求和使用凭证。
用 API Key 登录
Section titled “用 API Key 登录”把 OfApp.cn Key 放进本机环境变量或密钥管理工具，再通过标准输入交给 Codex。 下面的变量名只是本机习惯，不是必须写进项目代码。
export OFAPP_API_KEY="sk-xxxx"printf '%s' "$OFAPP_API_KEY" | codex login --with-api-keycodex login status如果登录失败，先不要改项目。按顺序确认：
| 检查项 | 怎么看 |
|---|---|
| 参数是否存在 | codex login --help 里是否有 --with-api-key |
| Key 是否完整 | 只检查长度和前缀，不打印完整 Key |
| Base URL 是否写入 | 打开 ~/.codex/config.toml 查看 openai_base_url |
| 当前终端是否重开 | 登录或 PATH 变更后，新开终端再试 |
API Key 登录适合本地 Codex CLI 工作流。某些依赖 ChatGPT 工作区、云端能力或 账号权限的功能，可能仍有不同限制；这类差异请以 OpenAI Codex 官方文档和当 前客户端提示为准。
先跑一个只读任务
Section titled “先跑一个只读任务”第一次验证不要让 Codex 改大量文件。先让它读取当前目录并总结，不写文件、 不运行危险命令。
codex "请只阅读当前目录结构和 package.json，列出项目类型、可用脚本和建议的验证命令。不要修改文件。"能正常返回后，再把任务缩小到一个具体目标：
| 任务类型 | 推荐起步 Prompt |
|---|---|
| 改页面 | 请只优化某一个页面，修改前说明范围，修改后运行构建。 |
| 修 Bug | 请复现报错，定位最小原因，只改必要文件。 |
| 写测试 | 请先阅读现有测试风格，再补一个覆盖当前问题的测试。 |
| 整理文档 | 请保持事实准确，不编造价格、模型和能力。 |
任务越明确，Codex 越容易交付可验收结果。让它“随便优化整个项目”通常会产生 难以审查的 diff。
项目环境变量和 Codex 配置不是一回事
Section titled “项目环境变量和 Codex 配置不是一回事”很多 401、404 或模型不可用问题，来自把两层配置混在一起。
| 场景 | 应该配置 | 说明 |
|---|---|---|
| Codex CLI 自己调用模型 | ~/.codex/config.toml 和登录凭证 |
决定 Codex 这个代理怎么连 API |
| 项目代码调用 API | .env、部署 Secret、CI Secret |
决定你的应用运行时怎么连 API |
| Codex 帮你写接入代码 | .env.example 和服务端封装 |
让 Codex 写占位变量，不写真实 Key |
| 自动化运行 Codex | 单次命令的受控 Secret | 不要在不受信任 runner 暴露长期密钥 |
项目 .env.example 可以写成这样：
OPENAI_BASE_URL=https://api.ofapp.cn/v1OPENAI_API_KEY=sk-xxxxOPENAI_MODEL=以控制台可用模型为准.env.example 给项目代码看，不等于 Codex CLI 已经完成登录。Codex 自己的
provider 配置仍应按当前 CLI 文档处理。
最小接入 Prompt
Section titled “最小接入 Prompt”下面这段适合交给 Codex，让它在不泄露密钥的前提下把项目接到兼容接口：
目标：让当前项目通过 OpenAI-compatible API 调用 AI 能力，示例 Base URL 使用 https://api.ofapp.cn/v1。
范围：- 只修改服务端 API 封装、环境变量示例和必要文档。- 不修改真实 .env，不提交 API Key，不输出完整 Authorization header。- 模型名使用 OPENAI_MODEL，占位值写“以控制台可用模型为准”。
配置：- 项目代码读取 OPENAI_BASE_URL、OPENAI_API_KEY、OPENAI_MODEL。- OfApp.cn 的具体模型、额度、价格和能力不要写死，统一提示以控制台或官方文档为准。
验证：- 先读取 package.json 和现有脚本。- 修改后运行项目已有构建或测试命令。- 交付时列出改动文件、验证结果和需要人工确认的配置项。这段 Prompt 的作用是给 Codex 边界：可以改代码和文档，但不能替你暴露 Key、 承诺未确认能力或跳过验证。
常见错误怎么分流
Section titled “常见错误怎么分流”| 现象 | 优先检查 | 继续阅读 |
|---|---|---|
| 登录命令失败 | codex login --help、Key 是否完整、终端是否读取到变量 |
Codex CLI 接入 OfApp.cn |
| 401 Unauthorized | API Key、登录凭证、Bearer 鉴权和账号项目 | 401 鉴权失败排查 |
| 404 Not Found | Base URL 是否重复或缺少 /v1 |
404 Not Found 错误排查 |
| model not found | 模型名是否来自控制台，当前账号是否可用 | model not found 错误排查 |
| 项目代码仍走旧接口 | 项目 .env、部署 Secret、SDK baseURL/base_url |
如何配置 Base URL |
| Codex 改动太散 | Goal 是否写清范围、验证命令和禁区 | Codex Goal 提示词模板 |
如果 OfApp.cn 的 /v1/models 能通过，但 Codex 仍失败，通常要回到 Codex
登录、config.toml、profile 和当前 CLI 版本里排查。
- OfApp.cn：创建 Key、查看 Base URL、进入天才游乐场。
- OfApp.cn API 文档：查看 Codex 安装配置、
/v1/models、Responses、Chat Completions 和 Messages 示例。 - OpenAI Codex Quickstart：确认 Codex CLI 安装、运行和登录入口。
- OpenAI Codex Authentication：理解 ChatGPT 登录、API Key 登录和凭证缓存差异。
- OpenAI Codex Config basics：确认
~/.codex/config.toml、项目配置和优先级。 - OpenAI Codex Advanced Configuration：确认
openai_base_url和项目级配置边界。
Codex CLI 必须知道真实 Key 吗？
Section titled “Codex CLI 必须知道真实 Key 吗？”Codex 登录时需要能访问 Key，但你不需要把真实 Key 写进 Prompt、仓库、截图 或 README。更稳妥的方式是从本机环境变量、系统凭证或可信 Secret 传入。
OPENAI_BASE_URL 会自动配置 Codex CLI 吗？
Section titled “OPENAI_BASE_URL 会自动配置 Codex CLI 吗？”不要默认假设。项目代码常用 OPENAI_BASE_URL，但 Codex CLI 自身更应按当
前文档配置 ~/.codex/config.toml、openai_base_url、profile 或 provider。
Base URL 一定要写 /v1 吗？
Section titled “Base URL 一定要写 /v1 吗？”本站 Codex 示例使用 https://api.ofapp.cn/v1。如果某个客户端会自动追加
/v1，就要按客户端文档填写，避免最终请求变成 /v1/v1/...。
可以把 OfApp.cn Key 放进项目 .env 吗？
Section titled “可以把 OfApp.cn Key 放进项目 .env 吗？”可以给项目代码使用，但不要提交真实 .env。同时要分清：项目 .env 不会
自动替 Codex CLI 完成登录，Codex 自己仍需要登录凭证和配置。
Codex 接入成功后怎么验收？
Section titled “Codex 接入成功后怎么验收？”用低风险任务验收：只读仓库结构、列出脚本、解释项目入口。等这一步稳定后， 再让 Codex 做小范围修改，并运行构建或测试命令。
什么时候该看完整教程？
Section titled “什么时候该看完整教程？”当你需要自定义 provider、多个 profile、CI 自动化、团队规范、权限策略或项
目 .env 分层时，阅读 Codex CLI 接入 OfApp.cn 会更合适。
- Codex CLI 接入 OfApp.cn：完整配置、provider、profile 和排错路径。
- 如何获取 OfApp.cn API Key：创建、保存、验证和轮换 Key。
- 如何配置 Base URL：避免漏写或重复拼接
/v1。 - OpenAI-compatible API 快速开始：用 cURL 验证 Key、Base URL 和模型。
- Codex Goal 提示词模板：把任务写成可执行、可验收的目标。
- 常见错误排查：按 API Key、Base URL、模型、SDK 和 Codex 分层定位。
在 Codex CLI 中使用 OfApp.cn，关键是把“Codex 自己的配置”和“项目运行时配
置”分开：Codex 用 ~/.codex/config.toml、openai_base_url 和登录凭证连
到 OfApp.cn；项目代码用 .env 或部署 Secret 读取 Base URL、API Key 和模型
名。先跑通只读任务，再把真实开发任务交给 Codex。