跳转到主要内容

​
一、概览

Codex 是一款面向终端的编程 Agent。通过接入 Nebula Api（OpenAI 兼容接口），你可以用一套 Key 访问多种主流模型（GPT / Claude / Gemini 等）。

​
二、准备工作

  • 在 Nebula Api 控制台 创建并复制 API Key
  • 在本地安装 Codex（按你的操作系统参考 Codex 官方安装说明）

​
三、配置 Nebula Api

Codex 需要配置 OpenAI 兼容的 API Key 与 Base URL。
Base URL 建议使用 https://llm.ai-nebula.com/v1（必须以 /v1 结尾）。

​
方式 1：环境变量（推荐）

  • OPENAI_API_KEY：你的 Nebula Api Key
  • OPENAI_BASE_URL：https://llm.ai-nebula.com/v1
macOS / Linux: 
export OPENAI_API_KEY="sk-xxxxxxxxxxxxxxxx"
export OPENAI_BASE_URL="https://llm.ai-nebula.com/v1"
Windows（PowerShell）: 
$env:OPENAI_API_KEY="sk-xxxxxxxxxxxxxxxx"
$env:OPENAI_BASE_URL="https://llm.ai-nebula.com/v1"

​
方式 2：TOML 配置（示例）

如果你使用的是 TOML 配置并且通过自定义 Provider 接入，可按下面示例配置 Nebula（Base URL 指向 /v1）。 
model = "gpt-5.2"
model_provider = "openai-custom"
personality = "pragmatic"
model_reasoning_effort = "high"

[model_providers.openai-custom]
name = "Nebula"
base_url = "https://llm.ai-nebula.com/v1"
wire_api = "responses"

# 如果你的 Codex 配置对自定义 Provider 不会自动注入 API Key，可手动加 Header：
[model_providers.openai-custom.http_headers]
Authorization = "Bearer YOUR_API_KEY"
Content-Type = "application/json"
  • wire_api = "responses" 适用于需要走 Responses API 的模型/渠道。
  • 不要把真实 API Key 提交到 git；建议用环境变量或仅本地保存配置。

​
四、选择模型

模型 ID 请以 Nebula 模型列表 为准。
部分客户端使用 GPT 系列模型时需要加 openai/ 前缀（例如 openai/gpt-5.4）。

​
五、常见问题

  • 401 / Invalid API key：检查 Key 是否复制正确，是否包含多余空格
  • 404 / 接口路径错误：确认 Base URL 以 /v1 结尾
  • Model not found：确认模型 ID 在 Nebula 模型列表中存在