AI 编程 / Codex++

NewBee Codex++

普通用户优先使用 Codex++,用图形界面配置 NewBee Provider、同步模型并启动官方 Codex。

推荐协议

Responses API

示例模型仅用于说明配置方式,当前可用模型请以 NewBee 模型广场为准。

Codex、Codex++ 与 NewBee API

Codex 是官方编码 Agent / 工作环境;Codex++ 是 Codex 的外部启动、供应商配置和增强管理层;NewBee API 统一提供 Base URL、API Key、模型路由、模型列表、额度和调用记录。Codex++ 不是大模型。

NewBee账号 / API Key / 模型
Codex++配置与启动
官方 Codex项目 / 会话 / 编码

下载 NewBee Codex++

当前版本:0.1.0。按系统选择对应安装包或压缩包。

Windows x64

普通 Intel / AMD 电脑优先使用安装包。

下载安装包下载 ZIP

macOS Apple Silicon

Apple M1 / M2 / M3 / M4 / M5 选择 ARM64。

下载 ARM64 DMG下载 ARM64 ZIP

macOS Intel

Intel Mac 选择 x64 版本。

下载 x64 DMG下载 x64 ZIP
不知道选哪个?
Windows Intel/AMD 选 Windows x64 安装包;Apple Silicon 选 ARM64 DMG;Intel Mac 选 Intel x64 DMG;ZIP 主要用于便携运行或高级用户。

两种使用模式

模式适合用户增强模式
官方登录 + NewBee API保留官方登录状态,同时通过 NewBee 使用 API 模型。兼容增强
纯 NewBee API模型请求主要通过 NewBee API 完成,不依赖官方刷新 token。完整增强
优先建议
普通 NewBee 用户优先推荐 API 模式。官方登录与 API 调用额度是两套概念,不要混淆。

Codex++ 配置步骤

按系统分开准备
Windows 和 macOS 都需要先安装官方 ChatGPT 桌面应用,再使用 Codex++ 管理 NewBee Provider。macOS 用户请先从官方 ChatGPT 下载页获取桌面应用。

Windows

  1. 安装官方 ChatGPT 桌面应用,确认能看到 Codex。
  2. 下载并安装 NewBee Codex++,打开管理工具。
  3. 登录 NewBeeAPI 控制台,在“API 密钥”中点击“新建 API 密钥”,分组选择 default 默认分组,创建并复制 API 密钥。
  4. 在 Codex++ 中打开“供应商”,新增 NewBee API。
  5. Base URL 填写 https://api.newbeeapi.com/v1,协议选择 Responses API。
  6. 填入 API 密钥,点击“从上游获取”,以实际返回的模型列表为准。
  7. 保存配置,根据使用模式选择兼容增强或完整增强。
  8. 保存后点击“重启 Codex++”,从 Codex++ 入口启动官方 Codex。

macOS

  1. 先打开官方 ChatGPT 下载页,按 Mac 芯片选择 Apple Silicon 或 Intel 版本并完成安装。
  2. 打开 ChatGPT,确认能看到 Codex。
  3. 下载并安装 NewBee Codex++,打开管理工具。
  4. 在 NewBeeAPI 控制台的“API 密钥”中点击“新建 API 密钥”,分组选择 default 默认分组,创建并复制 API 密钥。
  5. 在 Codex++ 中新增 NewBee API Provider,Base URL 填写 https://api.newbeeapi.com/v1,协议选择 Responses API。
  6. 填入 API 密钥,点击“从上游获取”同步实际可用模型,保存后重启 Codex++。

Windows 或 macOS 完成后,选择项目和模型,发送一次低风险测试请求,并到 NewBee 使用日志核对调用。

Provider 参数示例
Provider: NewBee API
Base URL: https://api.newbeeapi.com/v1
API Key: sk-your-newbee-api-key
Protocol: Responses API
Model: 从上游获取
API Key 安全
登录密码不是 API Key。API Key 不得发群聊、放公开截图、上传公开 GitHub 或写进公开文档。泄露后先在控制台撤销旧 Key,再创建新 Key。

高级用户手工配置

普通用户优先使用 Codex++。需要直接维护 TOML、接入脚本或服务器环境的用户,可手工编辑 Codex 配置。Codex++ 与手工 TOML 只建议选择一种作为主要配置来源,避免相互覆盖。

配置文件路径

系统路径
Windows%USERPROFILE%\.codex\config.toml
macOS / Linux~/.codex/config.toml

config.toml 示例

下面只放占位符,不要把真实 API Key 写进配置文件或提交到代码仓库。

config.toml
model = "YOUR_MODEL_ID"
model_provider = "newbee"

[model_providers.newbee]
name = "NewBee API"
base_url = "https://api.newbeeapi.com/v1"
wire_api = "responses"
env_key = "NEWBEE_API_KEY"

Windows

  1. 创建目录 %USERPROFILE%\.codex(如果还不存在)。
  2. 用文本编辑器创建或打开 %USERPROFILE%\.codex\config.toml,粘贴上面的配置。
  3. 在 PowerShell 中设置当前用户 API Key:[Environment]::SetEnvironmentVariable("NEWBEE_API_KEY","sk-your-newbee-api-key","User")
  4. 重新打开终端,在项目目录运行 codex

macOS

  1. 打开终端,创建配置目录:mkdir -p ~/.codex
  2. 编辑文件:nano ~/.codex/config.toml,粘贴配置并保存。
  3. 设置当前用户 API Key:export NEWBEE_API_KEY="sk-your-newbee-api-key";需要长期保存时写入 ~/.zshrc~/.bashrc 后重新加载。
  4. 进入项目目录运行 codex

Linux

  1. 确认已安装 Node.js 和 npm,然后安装 Codex CLI:npm install -g @openai/codex
  2. 确认命令可用:codex --version
  3. 创建配置目录:mkdir -p ~/.codex
  4. 创建配置文件:nano ~/.codex/config.toml,粘贴配置并保存。
  5. 设置当前用户 API Key:export NEWBEE_API_KEY="sk-your-newbee-api-key"。想让之后每个终端都可用,可执行 printf '\nexport NEWBEE_API_KEY="sk-your-newbee-api-key"\n' >> ~/.bashrc,然后执行 source ~/.bashrc
  6. 进入项目目录,用 codex 启动并先执行一个只读任务。
Linux 快速配置
npm install -g @openai/codex
codex --version
mkdir -p ~/.codex
nano ~/.codex/config.toml
export NEWBEE_API_KEY="sk-your-newbee-api-key"
codex
验证顺序
先确认模型 ID 与 NewBee 模型广场一致,再发送小请求,最后到 NewBee 控制台查看使用日志。不要把 401、404 和模型不支持混为一类问题。

常见问题

401 Unauthorized / Invalid token

重新复制 API Key,确认令牌仍启用、没有过期,并且 Base URL 包含 /v1

无法获取模型列表 / 模型不存在

确认协议选择 Responses API,点击“从上游获取”,模型 ID 以 NewBee 模型广场实际显示为准。

手工配置后 Codex 没有读取

检查文件路径、TOML 缩进和环境变量名称;Windows 重新打开终端,macOS / Linux 执行 source ~/.bashrcsource ~/.zshrc

旧 Codex 登录凭据冲突

如果旧会话异常,进入 Codex++ 会话管理,检查历史会话与供应商模式是否选错。

524、502 或 stream disconnected

先换一个已知可用模型做小请求,查看 NewBee 使用日志,再区分网络、上游状态和模型兼容性。