ByteGo AI 中转站使用教程

适用于：

• OpenAI API
• Claude Code CLI
• OpenAI Codex CLI

官方站点

• 官网：https://www.bytego.team
• API 请求地址：https://www.bytego.team/v1
• 令牌管理：https://www.bytego.team/console/token
• 兑换中心：https://www.bytego.team/console/topup
• 卡网：https://pay.ldxp.cn/shop/ZZ7M6TE0
• 🪜魔法传送门：https://91unicorn.cloud/#/register?code=0x9aKfbo

交流群（均在 QQ 客户端搜索群号加入）

• 客服QQ：794918122、3668451954、3963085485
• QQ 群：222679593

目录

• 一、开始前准备
  • 1. 注册并登录
  • 2. 购买 Token
  • 3. 创建 API Key（令牌）
• 二、OpenAI API 配置
• 三、Windows 环境变量
• 四、macOS 环境变量
• 五、Claude Code
• 六、Codex CLI
• 七、推荐客户端
• 八、常见问题
• 九、最佳实践
• 十、交流群与支持
• 更新记录

一、开始前准备

1. 注册并登录

访问 https://www.bytego.team 注册并登录账号。

2. 购买 Token

1. 在 卡网 购买兑换码
2. 打开 兑换中心 输入兑换码充值

3. 创建 API Key（令牌）

1. 进入 令牌管理
2. 点击 添加令牌，创建新的 API Key
3. 创建完成后复制保存

建议：

• 不同工具使用不同分组
• 不同设备单独创建 Key
• 不要泄露自己的 API Key

二、OpenAI API 配置

适用于 Cherry Studio、LobeChat、Open WebUI、Chatbox、NextChat 等 OpenAI 兼容客户端。

地址速查

填错 /v1 是最常见的连接失败原因之一，请对照上表。

基础配置

请求地址（Base URL）

https://www.bytego.team/v1

API Key：在 令牌管理 页面创建。

配置示例

OPENAI_API_KEY=sk-xxxxxxxx
OPENAI_BASE_URL=https://www.bytego.team/v1

三、Windows 环境变量

通过环境变量配置后，本机 OpenAI 兼容 CLI / 工具可共用同一套 Key。

临时配置（仅当前终端有效）

set OPENAI_API_KEY=你的APIKey
set OPENAI_BASE_URL=https://www.bytego.team/v1

永久配置

setx OPENAI_API_KEY "你的APIKey"
setx OPENAI_BASE_URL "https://www.bytego.team/v1"

配置完成后 关闭并重新打开 CMD / PowerShell 后生效。

四、macOS 环境变量

临时配置

export OPENAI_API_KEY="你的APIKey"
export OPENAI_BASE_URL="https://www.bytego.team/v1"

永久配置

编辑 ~/.zshrc，添加：

export OPENAI_API_KEY="你的APIKey"
export OPENAI_BASE_URL="https://www.bytego.team/v1"

保存后执行：

source ~/.zshrc

五、Claude Code

Claude Code CLI 使用 Anthropic 兼容 环境变量，Base URL 不含 /v1。

1. 安装 Claude Code

macOS

brew install anthropic/tap/claude

Windows

推荐使用 WSL、Git Bash 或 PowerShell。安装 Node.js 后执行：

npm install -g @anthropic-ai/claude-code

2. 配置 Claude Code

Windows — 临时

set ANTHROPIC_BASE_URL=https://www.bytego.team
set ANTHROPIC_AUTH_TOKEN=你的APIKey

Windows — 永久

setx ANTHROPIC_BASE_URL "https://www.bytego.team"
setx ANTHROPIC_AUTH_TOKEN "你的APIKey"

macOS

在 ~/.zshrc 中添加：

export ANTHROPIC_BASE_URL="https://www.bytego.team"
export ANTHROPIC_AUTH_TOKEN="你的APIKey"

执行 source ~/.zshrc 或重启终端。

3. 启动

claude

4. 推荐使用 CC Switch（可选）

CC Switch 是跨平台桌面工具，用于多账号管理、多环境切换，以及 Claude / Codex 等配置管理。

1. 从 Releases 下载并安装对应系统版本
2. 打开 令牌管理，使用 快速导入 将配置写入 CC Switch

六、Codex CLI

Codex CLI 为 OpenAI 官方本地编码代理工具。

1. 安装

npm install -g @openai/codex

macOS 也可使用 Homebrew：

brew install --cask codex

2. 创建配置文件

新建 ~/.codex/config.toml。

3. 配置示例

model_provider = "bytego"
model = "gpt-5"
model_reasoning_effort = "high"

disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.bytego]
name = "ByteGo"
base_url = "https://www.bytego.team/v1"

wire_api = "responses"
requires_openai_auth = true

env_key = "BYTEGO_API_KEY"

model 字段请按 ByteGo 控制台当前支持的模型名称填写；若启动报错，可在控制台或群内确认最新可用模型。

4. 配置环境变量

Windows — 临时

set BYTEGO_API_KEY=你的APIKey

Windows — 永久

setx BYTEGO_API_KEY "你的APIKey"

macOS

在 ~/.zshrc 中添加 export BYTEGO_API_KEY="你的APIKey"，然后执行 source ~/.zshrc。

5. 启动

codex

首次启动选择 Sign in with API key。

七、推荐客户端

支持 OpenAI API 的工具一般可直接使用第二节中的 Base URL 与 Key。

八、常见问题

1. 提示 401 / Unauthorized？

请检查：

• API Key 是否正确、是否已充值
• Base URL 是否与工具类型匹配（见 地址速查）
• Key / URL 首尾是否有多余空格

OpenAI 兼容客户端正确地址：

https://www.bytego.team/v1

2. Claude Code 无法连接？

请检查：

• ANTHROPIC_BASE_URL 是否为 https://www.bytego.team（无 /v1）
• ANTHROPIC_AUTH_TOKEN 是否为有效 API Key
• 是否已重启终端

3. OpenAI 和 Claude 的 Base URL 为何不同？

两者协议路径不同，混用会导致 401 或连接失败。

4. Codex CLI 认证失败？

请确认 config.toml 正确、BYTEGO_API_KEY 已生效，且首次登录选择了 Sign in with API key。

5. macOS 配置后不生效？

执行 source ~/.zshrc 或重启终端。

6. Windows setx 后不生效？

关闭当前终端，重新打开 CMD / PowerShell。

九、最佳实践

• OpenAI / Claude 分开创建 Key
• 不同设备单独配置
• 使用 CC Switch 管理多套配置
• 不要把 API Key 提交到 GitHub 或发给他人
• 网络不稳定时可开启系统代理 / TUN 提升连通性

十、交流群与支持

遇到问题可在 QQ 群内咨询（群号见文首 交流群）。

相关链接见文首 官方站点 与 卡网 列表。

更新记录