ChatGPT Codex

几步配置,连接 Codex CLI

把 Codex 的 OpenAI 兼容请求地址指向 MoonGPT,使用控制台生成的 API Key,在终端中完成代码理解、修改与调试。

终端即用Codex CLI 工作流
项目上下文适合代码协作
独立 Key便于用量追踪

Overview

让 Codex 进入日常开发

Codex CLI 可以在终端中读取项目文件、执行经过授权的开发操作并生成代码修改。通过 openai_base_url 配置 OpenAI 兼容地址,可以让模型请求经过 MoonGPT。

Codex 的配置能力会随客户端版本更新。本页提供核心接入方式;安装、登录和更多配置项请同时参考 OpenAI 官方 Codex 文档,并以 MoonGPT 控制台展示的可用模型和密钥说明为准。

适合这样接入

  • 已经安装 Codex CLI,并能在终端运行 codex 命令
  • 创建了支持 OpenAI 兼容协议的 API Key
  • 希望为不同开发项目区分密钥和用量
  • 理解 AI 工具执行命令和修改文件前仍需检查风险

Why MoonGPT

配置集中,也保留工程边界

01

兼容标准入口

通过 openai_base_url 指向兼容服务地址,无需修改 Codex 客户端代码。

02

按项目管理 Key

为个人项目、团队仓库或临时任务分配不同凭证和额度。

03

请求用量可追踪

在 MoonGPT 控制台查看对应 Key 的请求与消费明细。

04

支持 config.toml

在用户级配置中保存默认值,可信项目也可以使用项目级配置覆盖。

05

保留安全确认

API 接入不改变本地工具的权限边界,高风险操作仍需人工检查。

06

便于排查问题

从客户端版本、连接地址、认证、分组和用量逐项定位配置故障。

API example

配置 API Key 与 OpenAI 兼容地址

示例包含两处配置:在终端中使用 OPENAI_API_KEY 登录,openai_base_url 写入 ~/.codex/config.toml。不要把真实 API Key 提交到仓库。

查看认证与错误处理说明
Shell + config.toml · CodexMoonGPT API
# Shell:仅作用于当前终端会话
export OPENAI_API_KEY="YOUR_API_KEY"
printenv OPENAI_API_KEY | codex login --with-api-key

# ~/.codex/config.toml:配置 OpenAI 兼容地址
openai_base_url = "https://api.moongpt.icu/v1"

# 然后在项目目录启动
codex

Getting started

三步完成接入

账户操作仍在独立的 控制台完成,SEO 官网不复制登录、充值或 Key 管理功能。

复制控制台密钥

在密钥页面创建支持 OpenAI 兼容协议的 API Key。

登录并配置地址

通过 API Key 登录 Codex,并将 openai_base_url 指向 https://api.moongpt.icu/v1。

在测试项目启动

运行 codex,先从非敏感项目验证问答、读取与小范围代码修改。

Use cases

常见使用场景

理解陌生项目

让 Codex 梳理代码结构、依赖关系和关键入口,再由开发者核对结论。

修复与重构

基于测试与报错定位问题,分步骤修改并保持可审查的变更范围。

生成测试和文档

补充单元测试、接口说明和迁移文档,减少重复性工程工作。

请注意:Codex 与 OpenAI 是其各自权利人的商标。MoonGPT 不是 OpenAI 官方产品,仅提供 OpenAI 兼容的 API 接入地址;客户端能力与安全模型以 OpenAI 官方说明为准。

FAQ

关于 ChatGPT Codex

Codex 的 Base URL 应该填什么?

在 ~/.codex/config.toml 中把 openai_base_url 设置为 https://api.moongpt.icu/v1,并保留末尾的 /v1。

API Key 应该如何登录?

把控制台生成的 Key 设置为 OPENAI_API_KEY,再运行 printenv OPENAI_API_KEY | codex login --with-api-key。不要把真实 Key 直接写入仓库或提交到 Git。

用户配置和项目配置有什么区别?

个人默认配置位于 ~/.codex/config.toml;可信项目也可以使用仓库内的 .codex/config.toml 覆盖部分设置。连接地址和认证等敏感配置更适合保存在用户级配置中。

为什么配置后仍然无法调用?

请依次确认 Codex CLI 版本、API Key 状态、Key 所属分组、账户余额、openai_base_url 是否包含 /v1,以及控制台当前可用的模型名称。

Start building

为 Codex 创建独立 API Key

从测试项目开始,先验证配置,再逐步接入日常开发。