Agent / 工具接入

TokenAPIBay 兼容 OpenAI API 格式，所有支持 OpenAI 协议的第三方工具均可通过简单配置接入。以下是各主流工具的配置方法：

Claude Code 接入

Claude Code 是 Anthropic 官方 CLI 开发工具，需先安装 Node.js。

安装 Claude Code

平台	安装方式
Windows	以管理员身份运行 PowerShell： `npm install -g @anthropic-ai/claude-code` 或通过 WSL 安装（推荐）
macOS	终端执行： `brew install node@20 && npm install -g @anthropic-ai/claude-code`
Linux	`sudo apt install nodejs && npm install -g @anthropic-ai/claude-code`

一键安装脚本

bash

# macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

安装 Node.js（如未安装）

平台	命令
macOS	`brew install node@20`
Windows	下载 nodejs.org LTS 版 .msi 安装包
Linux	`curl -fsSL https://deb.nodesource.com/setup_20.x \| sudo -E bash - && sudo apt-get install -y nodejs`

配置 TokenAPIBay 接入

方式一：环境变量（临时）

bash

# macOS / Linux
export ANTHROPIC_AUTH_TOKEN=sk-你的API密钥
export ANTHROPIC_BASE_URL=https://www.tokenapibay.com/v1/messages
export ANTHROPIC_MODEL=DeepSeek-V4-Pro
export ANTHROPIC_DEFAULT_HAIKU_MODEL=DeepSeek-V4-Flash
export ANTHROPIC_DEFAULT_SONNET_MODEL=DeepSeek-V4-Pro
export ANTHROPIC_DEFAULT_OPUS_MODEL=DeepSeek-V4-Pro
export CLAUDE_CODE_SUBAGENT_MODEL=DeepSeek-V4-Flash
claude

# Windows PowerShell
$env:ANTHROPIC_AUTH_TOKEN="sk-你的API密钥"
$env:ANTHROPIC_BASE_URL="https://www.tokenapibay.com/v1/messages"
$env:ANTHROPIC_MODEL="DeepSeek-V4-Pro"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="DeepSeek-V4-Flash"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="DeepSeek-V4-Pro"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="DeepSeek-V4-Pro"
$env:CLAUDE_CODE_SUBAGENT_MODEL="DeepSeek-V4-Flash"
claude

方式二：永久配置（推荐）

创建 settings.json
Mac/Linux: ~/.claude/settings.json
Windows: C:\Users\你的用户名\.claude\settings.json

JSON

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-你的API密钥",
    "ANTHROPIC_BASE_URL": "https://www.tokenapibay.com/v1/messages",
    "ANTHROPIC_MODEL": "DeepSeek-V4-Pro",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "DeepSeek-V4-Flash",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "DeepSeek-V4-Pro",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "DeepSeek-V4-Pro",
    "CLAUDE_CODE_SUBAGENT_MODEL": "DeepSeek-V4-Flash"
  }
}

同时创建 .claude.json
Mac/Linux: ~/.claude.json
Windows: C:\Users\你的用户名\.claude.json

JSON

{
  "hasCompletedOnboarding": true
}

Haiku/Subagent 用 DeepSeek-V4-Flash（轻量），Sonnet/Opus 用 DeepSeek-V4-Pro（主力）。可根据需要调整，模型列表见模型广场。

方式三：VS Code 插件

VS Code 设置 → 搜索 claude-code.environmentVariables → 添加：

JSON

"claude-code.environmentVariables": [
  { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-你的API密钥" },
  { "name": "ANTHROPIC_BASE_URL", "value": "https://www.tokenapibay.com/v1/messages" },
  { "name": "ANTHROPIC_MODEL", "value": "DeepSeek-V4-Pro" },
  { "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL", "value": "DeepSeek-V4-Flash" },
  { "name": "ANTHROPIC_DEFAULT_SONNET_MODEL", "value": "DeepSeek-V4-Pro" },
  { "name": "ANTHROPIC_DEFAULT_OPUS_MODEL", "value": "DeepSeek-V4-Pro" },
  { "name": "CLAUDE_CODE_SUBAGENT_MODEL", "value": "DeepSeek-V4-Flash" }
]

npm 镜像加速（国内用户）

bash

npm config set registry https://registry.npmmirror.com

Claude Code IDE 接入

Claude Code VS Code 扩展可在 IDE 中使用 Claude Code 全部功能。

方式一：VS Code 设置

VS Code 设置 → 搜索 claude-code.environmentVariables → 添加：

JSON

"claude-code.environmentVariables": [
  { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-你的API密钥" },
  { "name": "ANTHROPIC_BASE_URL", "value": "https://www.tokenapibay.com/v1/messages" },
  { "name": "ANTHROPIC_MODEL", "value": "DeepSeek-V4-Pro" },
  { "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL", "value": "DeepSeek-V4-Flash" },
  { "name": "ANTHROPIC_DEFAULT_SONNET_MODEL", "value": "DeepSeek-V4-Pro" },
  { "name": "ANTHROPIC_DEFAULT_OPUS_MODEL", "value": "DeepSeek-V4-Pro" },
  { "name": "CLAUDE_CODE_SUBAGENT_MODEL", "value": "DeepSeek-V4-Flash" }
]

方式二：~/.claude/settings.json 配置（推荐）

Mac/Linux: ~/.claude/settings.json
Windows: C:\Users\你的用户名\.claude\settings.json

JSON

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-你的API密钥",
    "ANTHROPIC_BASE_URL": "https://www.tokenapibay.com/v1/messages",
    "ANTHROPIC_MODEL": "DeepSeek-V4-Pro",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "DeepSeek-V4-Flash",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "DeepSeek-V4-Pro",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "DeepSeek-V4-Pro",
    "CLAUDE_CODE_SUBAGENT_MODEL": "DeepSeek-V4-Flash"
  }
}

VS Code 扩展 v2.0.0+ 可能忽略 environmentVariables 设置。推荐使用 ~/.claude/settings.json 并添加 "claudeCode.disableLoginPrompt": true。

Codex 接入

Codex 是 OpenAI 开源的终端 AI 编码 Agent。

安装 Codex

平台	安装方式
macOS	`brew install codex`
Windows	`winget install OpenAI.Codex`
Linux	从 GitHub Releases 下载二进制
npm	`npm install -g @openai/codex`

配置 TokenAPIBay 接入

方式一：配置 config.toml
Mac/Linux: ~/.codex/config.toml
Windows: C:\Users\你的用户名\.codex\config.toml

TOML

model = "Qwen-Max"
openai_base_url = "https://www.tokenapibay.com/v1/chat/completions"
sandbox_mode = "workspace-write"

设置环境变量：

bash

# macOS / Linux
export OPENAI_API_KEY="sk-你的API密钥"

# Windows PowerShell
$env:OPENAI_API_KEY="sk-你的API密钥"

方式二：自定义 Provider（支持多 Provider）

TOML

model_provider = "tokenapibay"
model = "Qwen-Max"

[model_providers.tokenapibay]
name = "TokenAPIBay"
base_url = "https://www.tokenapibay.com/v1/chat/completions"
env_key = "TOKENAPIB_API_KEY"

设置对应环境变量：export TOKENAPIB_API_KEY="sk-你的API密钥"

Codex 默认使用 OpenAI Responses API。如遇兼容性问题，可在配置中添加 wire_api = "chat.completions"。

WorkBuddy 接入

WorkBuddy 是企业级 AI Agent 工作流平台。

配置 API 连接

打开 WorkBuddy 界面 → 点击左下角头像 → 设置 → 模型 → 添加模型
模型列表拉到最下面，点击 添加自定义
填写：

字段	值
名称	TokenAPIBay
接口地址	`https://www.tokenapibay.com/v1/chat/completions`
API Key	`sk-你的API密钥`
模型列表	添加所需模型（如 `deepseek-v4-flash` 名称可以去首页模型广场找）

在 Agent 工作流中使用

创建或编辑 Agent → 模型配置
选择提供商 自定义
选择模型（如 deepseek-v4-flash）
保存后，Agent 将通过 TokenAPIBay 调用模型

OpenClaw（大龙虾）接入

OpenClaw 是一款开源的 AI Agent 框架，支持全平台部署。

系统要求

平台	要求
Windows	Windows 10+，推荐 PowerShell 管理员权限
macOS	macOS 12+，推荐安装 Homebrew
Linux	Ubuntu 22.04+ 或同等发行版
Node.js	≥ v22（一键脚本会自动安装）

安装 OpenClaw

方式一：一键脚本（新手推荐）

bash

# macOS / Linux
curl -fsSL https://openclaw.ai/install.sh | bash

# Windows（PowerShell 管理员）
iwr -useb https://openclaw.ai/install.ps1 | iex

方式二：npm 全局安装（有 Node.js 环境）

bash

# 全局安装
npm install -g openclaw@latest

# 启动初始化向导
openclaw onboard --install-daemon

初始化配置

运行 openclaw onboard 按向导提示完成配置，选择 QuickStart 模式快速开始。

配置 TokenAPIBay 模型

编辑配置文件 openclaw.json
Mac/Linux: ~/.openclaw/openclaw.json
Windows: C:\Users\你的用户名\.openclaw\openclaw.json

JSON

{
  "models": {
    "providers": {
      "tokenapibay": {
        "baseUrl": "https://www.tokenapibay.com/v1/chat/completions",
        "apiKey": "sk-你的API密钥",
        "auth": "api-key",
        "api": "openai-completions",
        "models": [
          {
            "id": "Qwen-Max",
            "name": "Qwen-Max",
            "contextWindow": 128000,
            "maxTokens": 64000
          },
          {
            "id": "DeepSeek-V3",
            "name": "DeepSeek-V3",
            "contextWindow": 128000,
            "maxTokens": 64000
          },
          {
            "id": "GLM-4",
            "name": "GLM-4",
            "contextWindow": 128000,
            "maxTokens": 32768
          }
        ]
      }
    }
  }
}

配置默认 Agent 模型

JSON

{
  "agents": {
    "defaults": {
      "model": { "primary": "tokenapibay/Qwen-Max" },
      "models": {
        "tokenapibay/Qwen-Max": { "alias": "Qwen-Max" }
      },
      "workspace": "~/.openclaw/workspace",
      "maxConcurrent": 4,
      "subagents": { "maxConcurrent": 8 }
    }
  }
}

验证配置

bash

openclaw gateway restart   # 重启网关
openclaw doctor            # 健康检查
openclaw models list       # 查看模型列表

常用命令

命令	说明
openclaw onboard	初始化配置向导
openclaw gateway status	查看网关状态
openclaw tui	启动 TUI 聊天界面
openclaw dashboard	打开 Web 控制面板

OpenCode 接入

OpenCode 是终端 AI 编码 Agent，支持 OpenAI 兼容协议。

配置 opencode.json
Mac/Linux: ~/.config/opencode/opencode.json
Windows: C:\Users\你的用户名\.config\opencode\opencode.json

JSON

{
  "$schema": "https://opencode.ai/config.json",
  "model": "tokenapibay/Qwen-Max",
  "provider": {
    "tokenapibay": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "TokenAPIBay",
      "options": {
        "baseURL": "https://www.tokenapibay.com/v1/chat/completions",
        "apiKey": "sk-你的API密钥"
      },
      "models": {
        "Qwen-Max": { "name": "Qwen-Max" },
        "DeepSeek-V3": { "name": "DeepSeek-V3" },
        "GLM-4": { "name": "GLM-4" }
      }
    }
  }
}

使用环境变量（推荐）

JSON

"apiKey": "{env:TOKENAPIB_API_KEY}"

然后设置：export TOKENAPIB_API_KEY="sk-你的API密钥"

运行：

bash

opencode run -m tokenapibay/Qwen-Max "你的问题"

Cline 接入

Cline 是 VS Code 中 AI 编码 Agent 插件，提供独立侧边栏面板。

安装 Cline

在 VS Code 扩展市场搜索 Cline 并安装
安装后左侧侧边栏出现 Cline 图标

配置 TokenAPIBay 接入

点击 Cline 面板顶部的设置图标
API Provider 选择 OpenAI Compatible
填写以下字段：

字段	值
Base URL	`https://www.tokenapibay.com/v1/chat/completions`
API Key	`sk-你的API密钥`
Model ID	如 `Qwen-Max`

注意：Base URL 末尾不要包含 /chat/completions，Cline 会自动拼接。如使用 Cline v3.34.0+，务必选择 OpenAI Compatible 而非 OpenAI，否则 Base URL 字段可能不显示。

Grok CLI 接入

Grok CLI 是 xAI 官方的终端 AI 工具，也支持社区版本（如 superagent-ai/grok-cli）。

环境变量配置

bash

export XAI_API_KEY="sk-你的API密钥"
export XAI_BASE_URL="https://www.tokenapibay.com/v1/chat/completions"

用户设置文件 user-settings.json
Mac/Linux: ~/.grok/user-settings.json
Windows: C:\Users\你的用户名\.grok\user-settings.json

JSON

{
  "apiKey": "sk-你的API密钥",
  "baseURL": "https://www.tokenapibay.com/v1/chat/completions"
}

Gemini CLI 接入

Gemini CLI 是 Google 官方终端 AI 助手。

OpenAI 兼容模式

Gemini 官方提供 OpenAI 兼容端点，可通过环境变量配置：

bash

export OPENAI_API_KEY="sk-你的API密钥"
export OPENAI_BASE_URL="https://www.tokenapibay.com/v1/chat/completions"

Python 调用示例：

Python

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的API密钥",
    base_url="https://www.tokenapibay.com/v1/chat/completions"
)

response = client.chat.completions.create(
    model="Qwen-Max",
    messages=[{"role": "user", "content": "你好"}]
)
print(response.choices[0].message.content)

AutoClaw 接入

AutoClaw 是 OpenClaw 生态的自动化工具，配置方式与 OpenClaw 完全兼容。

配置 openclaw.json
Mac/Linux: ~/.openclaw/openclaw.json
Windows: C:\Users\你的用户名\.openclaw\openclaw.json

与 OpenClaw 使用相同的配置格式：

JSON

{
  "models": {
    "providers": {
      "tokenapibay": {
        "baseUrl": "https://www.tokenapibay.com/v1/chat/completions",
        "apiKey": "sk-你的API密钥",
        "auth": "api-key",
        "api": "openai-completions",
        "models": [
          {
            "id": "Qwen-Max",
            "name": "Qwen-Max",
            "contextWindow": 128000,
            "maxTokens": 64000
          }
        ]
      }
    }
  }
}

验证配置：

bash

openclaw gateway restart
openclaw doctor
openclaw models list

Cursor 接入

Cursor 是 AI-first 代码编辑器，VS Code 用户可无缝切换。

安装 Cursor

平台	安装方式
Windows	下载 `.exe` 安装包，双击安装
macOS	下载 `.dmg`，拖入 Applications 文件夹
Linux	下载 `.AppImage` 或 `.deb` 安装包

下载地址：cursor.com/downloads

配置 TokenAPIBay 接入

打开 Cursor → Settings（Mac/Linux: Cmd + ,，Win/Linux: Ctrl + ,）
左侧菜单选择 Models
关闭默认模型开关（可选），避免误选官方模型
打开 OpenAI API Key 开关，填入 API Key
打开 Override OpenAI Base URL 开关，填写 API 地址
点击 + Add model，添加模型 ID（如 Qwen-Max）
点击 Verify 验证连接

字段	值
Base URL	`https://www.tokenapibay.com/v1/chat/completions`
API Key	`sk-你的API密钥`
Model ID	如 `Qwen-Max`、`DeepSeek-V3`

验证通过后，按 Cmd + L（Mac）或 Ctrl + L（Win/Linux）打开 Chat 面板，选择刚添加的模型测试。

Windsurf 接入

Windsurf 是 AI 驱动的 IDE。

打开 Windsurf → 设置 → API 配置
选择 OpenAI Compatible
填写：

字段	值
Base URL	`https://www.tokenapibay.com/v1/chat/completions`
API Key	`sk-你的API密钥`
Model	如 `Qwen-Max`

ChatBox 接入

ChatBox 是轻量级桌面 AI 客户端。

打开 ChatBox → 设置 → 模型提供商
选择 OpenAI API
填写：

字段	值
API 域名	`https://www.tokenapibay.com/v1/chat/completions`
API Key	`sk-你的API密钥`
模型	手动输入模型名称

Cherry Studio 接入

Cherry Studio 支持多模型管理的桌面客户端。

打开 Cherry Studio → 设置 → 模型服务
点击添加 → 选择 OpenAI 兼容协议
填写：

字段	值
名称	TokenAPIBay
API 地址	`https://www.tokenapibay.com/v1/chat/completions`
API Key	`sk-你的API密钥`
模型	从管理中手动添加模型名称

点击连通性检测，显示「连接成功」即可。

其他工具

任何支持 OpenAI API 兼容协议的工具均可通过以下三要素接入：

要素	值
API Key	`sk-你的API密钥`
Base URL（OpenAI 协议）	`https://www.tokenapibay.com/v1/chat/completions`
Base URL（Anthropic 协议）	`https://www.tokenapibay.com/v1/messages`
Model	在模型广场查看可用模型列表

常见兼容工具：NextChat、LobeChat、Dify、FastGPT、LangChain、AutoGPT 等。