Nebula API
Documentation 部署指南

CodeX 部署

安装和配置 CodeX,GPT-5 架构的 AI 编程助手。

CodeX 是基于 GPT-5 架构的 AI 编程助手,本指南将帮助您在 Windows、macOS 和 Linux 上完成部署。

使用 CC-Switch 快速配置(推荐)

推荐使用 CC-Switch 快速配置工具 进行图形化配置,简单快捷无需命令行操作。

手动命令行配置

安装 CodeX

npm install -g @openai/codex-cli

配置文件

配置文件位置:

  • Windows: %USERPROFILE%\.codex\
  • macOS/Linux: ~/.codex/

创建配置文件 config.json

{
  "baseUrl": "https://ai.nebulatrip.com/v1",
  "apiKey": "your-api-key",
  "model": "gpt-5.4"
}

启动 CodeX

codex

配置参数

参数说明
Base URLhttps://ai.nebulatrip.com/v1
Modelgpt-5.4 或其他可用模型
令牌组必须使用 “codex” 专用令牌

Important Note

务必从平台创建「codex」令牌组的专用密钥,CodeX 令牌与 Claude Code 令牌不通用。

常见问题

配置不生效?

配置后需重启 CodeX 才能生效。

连接失败?

  1. 检查 API Key 是否正确
  2. 确认使用了 codex 令牌组
  3. 检查账户余额