BigBong AI 文档

CLI配置教程

环境检查(通用步骤)

（1）确认Nodejs环境已安装

  1. 在windows或MacOS终端输入以下命令
npm list -g --depth-0

正常情况应该是如下图所示（没有任何内容也没关系），如果提示“命令未找到”，则说明你没有安装Nodejs，你需要按 此教程 来安装运行Claude Code、Codex、Gemini所需的环境

  1. 如果你发现自己没有安装Nodejs，并且跟着教程目前已经安装完毕，请你重新执行上述提到的命令，如果不再提示“命令未找到”，则说明安装成功

（2）安装CLI

  1. 在windows或MacOS终端输入以下命令，一次性安装好我们目前所需的所有终端
npm i -g @anthropic-ai/claude-code@latest
npm i -g @openai/codex@latest
npm i -g @google/gemini-cli@latest

（3）测试安装成功

这一步很重要，请你务必运行命令进行测试，因为这一步运行命令后，你的用户目录下才会生成各CLI的配置目录，方便后续操作！

Claude Code

  1. 在windows或MacOS终端输入以下命令，若出现图示内容，或出现选项让你选择，则Claude code安装成功
claude

第二步十分重要，请你务必跳转链接后运行命令进行配置

  1. 点击 claude code 无法连接到 Anthropic 服务 跳转，务必根据教程运行命令，然后再继续阅读之后单独CLI的配置教程

Codex

在windows或MacOS终端输入以下命令，若出现图示内容，或出现选项让你选择，则Codex安装成功

codex

Gemini

在windows或MacOS终端输入以下命令，若出现图示内容，或出现选项让你选择，则Gemini安装成功

gemini

Claude Code配置

Windows

  1. 键盘按下“Win+R”键，输入以下内容后回车，打开Claude Code配置目录
%userprofile%\.claude
  1. 目录内容如图所示，如果目录中没有 settings.json，你需要手动创建后打开
  1. 将以下内容写入 settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.bigbong.top",
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxx",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

  1. 回顾 创建API令牌，在 BigBong AI 中创建 CC 分组的令牌，替换上方 sk-xxxxxxxx 部分

  2. 在windows终端运行 claude，出现对话界面后进行对话测试，能收到回复即表示配置成功

MacOS

  1. 在访达界面按下 “Command+Shift+G”，输入以下路径后回车，打开配置目录
~/.claude
  1. 若目录不存在 settings.json，需要你手动进行创建
  1. 将以下内容写入 settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.bigbong.top/",
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxx",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

  1. 回顾 创建API令牌，在 BigBong AI 中创建 CC 分组的令牌，替换上方 sk-xxxxxxxx

  2. 在终端运行 claude，看到对话界面并能正常回复即表示配置完成

注意，如果配置完仍然有报错问题，提示你需要登录，请看如下链接解决claude-code-无法连接到-anthropic-服务

Codex配置

Windows、macOS 和 Linux 使用同一份 config.toml。完整步骤、登录命令和错误排查请查看 OpenAI Codex 配置教程。

不要手工编辑 auth.json。

只需在用户级 ~/.codex/config.toml 配置服务商，再使用 codex login --with-api-key 登录。

model = "gpt-5.6-sol"
model_provider = "bigbong"

[model_providers.bigbong]
name = "BigBong AI"
base_url = "https://api.bigbong.top/v1"
wire_api = "responses"
requires_openai_auth = true

配置完成后运行 codex login status 检查登录状态，再进入项目目录执行 codex。

Gemini配置

Windows

  1. 键盘按下“Win+R”，输入以下内容后回车，打开 Gemini CLI 配置目录
%userprofile%\.gemini
  1. 如果目录下没有 .env 文件，请新建一个 .env，写入以下内容
GOOGLE_GEMINI_BASE_URL=https://api.bigbong.top/
GEMINI_API_KEY=sk-xxxxxxxx
GEMINI_MODEL=gemini-2.5-pro

  1. 回顾 创建API令牌，在 BigBong AI 中创建 Gemini 分组令牌，并复制ApiKey后填入 sk-xxxxxxxx

  2. 打开终端执行 gemini，看到交互界面并能正常回复即表示配置成功

MacOS

  1. 按下 “Command+Shift+G”，输入以下路径后回车，打开配置目录
~/.gemini
  1. 若目录中没有 .env 文件，创建并写入以下内容
GOOGLE_GEMINI_BASE_URL=https://api.bigbong.top/
GEMINI_API_KEY=sk-xxxxxxxx
GEMINI_MODEL=gemini-2.5-pro

  1. 回顾 创建API令牌，在 BigBong AI 中创建 Gemini 分组令牌，填入 sk-xxxxxxxx

  2. 在终端运行 gemini，可正常进入对话并收到回复即表示配置完成

（1）环境检查(通用步骤) →