Earbowe API 使用教程

按本文可在本机安装并接入 Claude Code、Gemini CLI、Codex CLI、OpenCode。结构参考常见中转站文档，内容已改为 Earbowe 域名与配置。

0. 准备工作：注册与密钥

1. 打开 注册 / 登录
2. 在控制台创建 API Key（形如 sk-...）
3. 在 模型页 或请求 GET /v1/models 确认当前可用模型

🪟 Windows 使用教程

Step 1 ｜ 安装 Node.js

Claude Code 等工具需要 Node.js。

方法一：官网下载（推荐）

1. 打开 https://nodejs.org/
2. 下载 LTS 版本
3. 运行 .msi，默认选项安装即可

方法二：包管理器

# Chocolatey
choco install nodejs
# 或 Scoop
scoop install nodejs

验证

node --version
npm --version

Step 2 ｜ 安装 AI 开发工具

按需安装：

Claude Code

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

Gemini CLI（可选）

npm install -g @google/gemini-cli
gemini --version

Codex CLI（可选）

npm install -g @openai/codex@latest
codex --version

OpenCode（可选）

npm install -g opencode@latest
opencode --version

Step 3 ｜ 配置（Windows）

Claude Code

临时（当前 PowerShell 会话）：

$env:ANTHROPIC_BASE_URL = "https://api.earbowe.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的API密钥"

永久（用户级，推荐）：

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.earbowe.com", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的API密钥", [System.EnvironmentVariableTarget]::User)

查看：

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN

VS Code / Claude 插件可写 C:\Users\你的用户名\.claude\config.json：

{
  "primaryApiKey": "sk-你的API密钥"
}

Gemini CLI

$env:GOOGLE_GEMINI_BASE_URL = "https://api.earbowe.com"
$env:GEMINI_API_KEY = "sk-你的API密钥"
$env:GEMINI_MODEL = "gemini-2.5-pro"

永久：

[System.Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "https://api.earbowe.com", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "sk-你的API密钥", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GEMINI_MODEL", "gemini-2.5-pro", [System.EnvironmentVariableTarget]::User)

Codex CLI

编辑 %USERPROFILE%\.codex\config.toml（文件开头）：

model_provider = "earbowe"
model = "gpt-5.5"
model_reasoning_effort = "high"
approval_policy = "on-failure"
sandbox_mode = "workspace-write"
preferred_auth_method = "apikey"

[model_providers.earbowe]
name = "Earbowe"
base_url = "https://api.earbowe.com/v1"
wire_api = "responses"
requires_openai_auth = true

国内直连把 base_url 换成 https://api.3861343.xyz/v1。

%USERPROFILE%\.codex\auth.json：

{
  "OPENAI_API_KEY": "sk-你的API密钥"
}

也可用环境变量：

$env:OPENAI_BASE_URL = "https://api.earbowe.com/v1"
$env:OPENAI_API_KEY = "sk-你的API密钥"

OpenCode

配置文件：C:\Users\你的用户名\.config\opencode\opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "earbowe": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Earbowe",
      "options": {
        "baseURL": "https://api.earbowe.com/v1",
        "apiKey": "sk-你的API密钥"
      },
      "models": {
        "gpt-5.5": { "name": "GPT-5.5" },
        "gpt-5.6-luna": { "name": "GPT-5.6 Luna" },
        "gpt-5.6-sol": { "name": "GPT-5.6 Sol" },
        "gpt-5.6-terra": { "name": "GPT-5.6 Terra" }
      }
    }
  }
}

验证：opencode models

Step 4 ｜ 开始使用（Windows）

🍎 macOS 使用教程

Step 1 ｜ 安装 Node.js

Homebrew（推荐）

brew update
brew install node

官网安装包

从 nodejs.org 下载 macOS LTS .pkg 安装。

node --version
npm --version

Step 2 ｜ 安装工具

npm install -g @anthropic-ai/claude-code
# 可选
npm install -g @google/gemini-cli
npm install -g @openai/codex@latest
npm install -g opencode@latest

权限不足时在命令前加 sudo。

Step 3 ｜ 配置（macOS）

Claude Code

export ANTHROPIC_BASE_URL="https://api.earbowe.com"
export ANTHROPIC_AUTH_TOKEN="sk-你的API密钥"

永久（zsh 默认）：

echo 'export ANTHROPIC_BASE_URL="https://api.earbowe.com"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的API密钥"' >> ~/.zshrc
source ~/.zshrc

~/.claude/config.json：

{
  "primaryApiKey": "sk-你的API密钥"
}

Gemini CLI

export GOOGLE_GEMINI_BASE_URL="https://api.earbowe.com"
export GEMINI_API_KEY="sk-你的API密钥"
export GEMINI_MODEL="gemini-2.5-pro"

Codex CLI

~/.codex/config.toml：

model_provider = "earbowe"
model = "gpt-5.5"
model_reasoning_effort = "high"
approval_policy = "on-failure"
sandbox_mode = "workspace-write"
preferred_auth_method = "apikey"

[model_providers.earbowe]
name = "Earbowe"
base_url = "https://api.earbowe.com/v1"
wire_api = "responses"
requires_openai_auth = true

~/.codex/auth.json：

{
  "OPENAI_API_KEY": "sk-你的API密钥"
}

OpenCode

~/.config/opencode/opencode.json 与 Windows 相同，仅路径不同。

Step 4 ｜ 开始使用（macOS）

cd /path/to/your/project
claude    # 或 gemini / codex / opencode

🐧 Linux / WSL2 使用教程

Step 1 ｜ 安装 Node.js

# 官方 NodeSource LTS（Debian/Ubuntu 常见）
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

# 或系统源
sudo apt update && sudo apt install -y nodejs npm

node --version
npm --version

Step 2 ｜ 安装工具

npm install -g @anthropic-ai/claude-code
npm install -g @google/gemini-cli   # 可选
npm install -g @openai/codex@latest # 可选
npm install -g opencode@latest      # 可选

Step 3 ｜ 配置（Linux）

Claude Code

export ANTHROPIC_BASE_URL="https://api.earbowe.com"
export ANTHROPIC_AUTH_TOKEN="sk-你的API密钥"

# 永久（bash）
echo 'export ANTHROPIC_BASE_URL="https://api.earbowe.com"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的API密钥"' >> ~/.bashrc
source ~/.bashrc

Gemini CLI

export GOOGLE_GEMINI_BASE_URL="https://api.earbowe.com"
export GEMINI_API_KEY="sk-你的API密钥"
export GEMINI_MODEL="gemini-2.5-pro"

Codex CLI / OpenCode

配置文件路径与 macOS 相同（~/.codex/...、~/.config/opencode/...）。国内网络优先：

export OPENAI_BASE_URL="https://api.3861343.xyz/v1"
export OPENAI_API_KEY="sk-你的API密钥"

Step 4 ｜ 开始使用（Linux）

cd /path/to/your/project
claude    # 或 gemini / codex / opencode

4. 通用验证（curl）

不依赖任何 CLI，先确认网关与密钥：

export OPENAI_BASE_URL="https://api.earbowe.com/v1"
export OPENAI_API_KEY="sk-你的API密钥"

curl -sS "$OPENAI_BASE_URL/models" \
  -H "Authorization: Bearer $OPENAI_API_KEY" | head

curl -sS "$OPENAI_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [{"role":"user","content":"ping"}],
    "max_tokens": 32
  }'

5. 常见问题

更新：2026-07-24 · 简体中文技术接入文 · 非营销软文