开发工具 / 四客户端统一管理

NewBee Developer Manager

统一配置 Codex、Claude Code、WorkBuddy 和 Grok,登录 NewBee、同步模型并安装共享 Media MCP。

推荐协议

Responses API

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

四客户端统一管理与 NewBee API

NewBee Developer Manager 是 Codex、Claude Code、WorkBuddy 和 Grok 的统一配置与启动层;NewBee API 统一提供 Base URL、Device Token、模型路由、模型列表、额度和调用记录。它不替代客户端,而是负责把四个客户端连接到同一套 NewBee 能力。

NewBee账号 / Device Token / 模型
→
NewBee Developer Manager统一配置与启动
→
四个客户端Codex / Claude Code / WorkBuddy / Grok

下载 NewBee Developer Manager

当前版本:0.2.5。统一管理 Codex、Claude Code、WorkBuddy 和 Grok,按系统选择对应安装包或压缩包。

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 调用额度是两套概念,不要混淆。

四客户端配置步骤

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

Windows

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

macOS

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

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。

高级用户手工配置

普通用户优先使用 NewBee Developer Manager。需要直接维护 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 ~/.bashrc 或 source ~/.zshrc。

旧 Codex 登录凭据冲突

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

524、502 或 stream disconnected

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