与智能体集成

本章节从普通用户视角，介绍如何在常见智能体和开发工具中接入「站点地址」，包括 API BaseURL、API Key、模型名和常见客户端配置。

统一规则：

API BaseURL：参考「概览」章节中的「API BaseURL」小节，例如 CN2 区为 https://cn-api.tokenfor.me
OpenAI / xAI 兼容接口：通常使用 <API BaseURL>/v1
Anthropic / Claude Code：通常填写 <API BaseURL>，由客户端补 /v1/messages
Gemini 兼容接口：通常使用 <API BaseURL>/v1beta
API Key / Token：在「站点地址」控制台中创建并复制的 Key
一个 Key 绑定一个供应商分组。GPT、Claude、Gemini、Grok 分组不同的时候，请分别使用对应 Key

本文示例默认使用：

GPT：gpt-5.6-sol
Claude：claude-opus-5
Gemini：gemini-3-pro-preview

通用配置模板

如果工具支持 OpenAI 兼容接口，可以先用下面的请求验证 Key 和模型是否可用：

http

POST <API BaseURL>/v1/chat/completions
Authorization: Bearer <Your_API_Key>
Content-Type: application/json

{
  "model": "gpt-5.6-sol",
  "messages": [
    { "role": "user", "content": "你好，测试一下站点地址是否可用。" }
  ]
}

如果你在 CN2 区，上面的请求地址就是：

text

https://cn-api.tokenfor.me/v1/chat/completions

Codex（ChatGPT）配置

Codex 使用 ~/.codex/config.toml 配置模型供应商。TokenFor 的 Codex 推荐走 OpenAI Responses wire API。

macOS

编辑配置文件：

bash

nano ~/.codex/config.toml

写入或追加：

toml

model_provider = "tokenforme"
model = "gpt-5.6-sol"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.tokenforme]
name = "tokenfor.me"
base_url = "https://cn-api.tokenfor.me/v1"
wire_api = "responses"
requires_openai_auth = false
env_key = "Tokenforme_KEY"

再把 Key 写入 shell 环境变量：

bash

nano ~/.zshrc

bash

export Tokenforme_KEY="sk-your-key"

使配置生效并启动 Codex：

bash

source ~/.zshrc
codex

如果你使用的不是 CN2 区，把 base_url 中的 https://cn-api.tokenfor.me 替换为「概览」页对应的 API BaseURL。

Windows

编辑：

text

%USERPROFILE%\.codex\config.toml

内容与 macOS 相同：

toml

model_provider = "tokenforme"
model = "gpt-5.6-sol"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.tokenforme]
name = "tokenfor.me"
base_url = "https://cn-api.tokenfor.me/v1"
wire_api = "responses"
requires_openai_auth = false
env_key = "Tokenforme_KEY"

PowerShell 中设置用户环境变量：

powershell

[Environment]::SetEnvironmentVariable("Tokenforme_KEY", "sk-your-key", "User")
$env:Tokenforme_KEY = "sk-your-key"
codex

配置后建议重新打开终端，确保 Codex 读取到新的环境变量。

Claude Code 配置

Claude Code 走 Anthropic Messages 风格接口。这里的 BaseURL 推荐填写不带 /v1 的 API BaseURL，例如 https://cn-api.tokenfor.me，避免客户端再拼接路径后出现 /v1/v1/messages。

macOS

方式一：写入 shell 环境变量。

bash

nano ~/.zshrc

bash

export ANTHROPIC_BASE_URL="https://cn-api.tokenfor.me"
export ANTHROPIC_AUTH_TOKEN="sk-your-key"
export ANTHROPIC_MODEL="claude-opus-5"

bash

source ~/.zshrc
claude

方式二：写入 Claude Code 设置文件。

bash

mkdir -p ~/.claude
nano ~/.claude/settings.json

json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://cn-api.tokenfor.me",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-key",
    "ANTHROPIC_MODEL": "claude-opus-5"
  }
}

Windows

PowerShell 中设置用户环境变量：

powershell

[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://cn-api.tokenfor.me", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-your-key", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-opus-5", "User")

$env:ANTHROPIC_BASE_URL = "https://cn-api.tokenfor.me"
$env:ANTHROPIC_AUTH_TOKEN = "sk-your-key"
$env:ANTHROPIC_MODEL = "claude-opus-5"
claude

也可以编辑：

text

%USERPROFILE%\.claude\settings.json

json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://cn-api.tokenfor.me",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-key",
    "ANTHROPIC_MODEL": "claude-opus-5"
  }
}

如果你的 Claude Code 版本只识别 ANTHROPIC_API_KEY，可以把同一个 Key 改填到 ANTHROPIC_API_KEY。同一台机器上不要混用多个不同的 Claude Key。

CC Switch 配置

CC Switch 适合同时管理 Claude Code、Codex、Gemini CLI、OpenClaw、Hermes 等工具的供应商配置。建议先分别把单个工具跑通，再用 CC Switch 管理切换。

在 CC Switch 中新增 TokenFor provider：

打开 CC Switch，点击右上角 +
优先选择 App-specific provider
为当前工具选择自定义 provider
填入 API Key 和 endpoint
点击获取模型或手动填写模型名
保存后切换到该 provider
重新打开目标工具所在终端

常用填写方式：

目标工具	Endpoint	模型	API 格式
Codex	`https://cn-api.tokenfor.me/v1`	`gpt-5.6-sol`	OpenAI Responses
Claude Code	`https://cn-api.tokenfor.me`	`claude-opus-5`	Anthropic Messages
Gemini	`https://cn-api.tokenfor.me/v1beta`	`gemini-3-pro-preview`	Gemini

如果使用 CC Switch 的 Codex 自定义格式，请确认生成后的 ~/.codex/config.toml 中：

toml

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

[model_providers.tokenforme]
base_url = "https://cn-api.tokenfor.me/v1"
wire_api = "responses"
requires_openai_auth = false
env_key = "Tokenforme_KEY"

如果使用 CC Switch 的 Claude 自定义格式，请确认写入的环境变量包含：

json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://cn-api.tokenfor.me",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-key",
    "ANTHROPIC_MODEL": "claude-opus-5"
  }
}

Hermes 配置

Hermes 的主要配置位于 ~/.hermes/config.yaml，密钥建议放在 ~/.hermes/.env。如果只想先接通 GPT 模型，可以按 OpenAI-compatible / Responses 方式配置。

编辑密钥：

bash

nano ~/.hermes/.env

bash

OPENAI_API_KEY=sk-your-key

编辑模型配置：

bash

nano ~/.hermes/config.yaml

yaml

model:
  provider: openai
  default: gpt-5.6-sol
  base_url: "https://cn-api.tokenfor.me/v1"
  api_mode: responses

也可以在 Hermes 中使用模型切换命令临时切换：

text

/model gpt-5.6-sol

如果你要在 Hermes 中使用 Claude 或 Gemini 模型，请在 Hermes 的模型设置中选择对应 provider 类型，并分别使用：

Claude：claude-opus-5
Gemini：gemini-3-pro-preview

配置变更通常对新会话生效；已经打开的 Hermes 会话可能需要重新启动或在会话内重新选择模型。

Cherry Studio 配置

Cherry Studio 支持添加自定义模型服务商。配置入口通常是：

text

设置 -> 模型服务 -> 添加

OpenAI-compatible / GPT

新增自定义服务商：

字段	填写
提供商类型	OpenAI 或 OpenAI Compatible
API 地址	`https://cn-api.tokenfor.me`
API Key	`sk-your-key`
模型	`gpt-5.6-sol`

Cherry Studio 的部分版本会自动拼接 /v1/chat/completions。如果你填了完整地址或重复填 /v1 后连接失败，请检查实际请求地址是否变成了 /v1/v1/chat/completions。

Claude

新增 Anthropic 类型服务商：

字段	填写
提供商类型	Anthropic
API 地址	`https://cn-api.tokenfor.me`
API Key	`sk-your-key`
模型	`claude-opus-5`

Gemini

新增 Gemini 类型服务商：

字段	填写
提供商类型	Gemini
API 地址	`https://cn-api.tokenfor.me/v1beta`
API Key	`sk-your-key`
模型	`gemini-3-pro-preview`

保存后点击检查或测试连接。如果模型列表没有自动出现，可以手动添加模型 ID。

OpenClaw 配置

OpenClaw 可以为 GPT / Claude / Gemini / Grok 分别添加 provider。一个 Key 绑定一个供应商分组，因此不同分组请使用不同 Key。

GPT

json

{
  "models": {
    "providers": {
      "tokenforme-gpt": {
        "baseUrl": "<API BaseURL>/v1",
        "apiKey": "sk-your-key",
        "models": [
          {
            "id": "gpt-5.6-sol",
            "name": "gpt-5.6-sol",
            "api": "openai-responses",
            "reasoning": true,
            "input": ["text"]
          }
        ]
      }
    }
  }
}

Claude

json

{
  "models": {
    "providers": {
      "tokenforme-claude": {
        "baseUrl": "<API BaseURL>/v1",
        "apiKey": "sk-your-key",
        "models": [
          {
            "id": "claude-opus-5",
            "name": "claude-opus-5",
            "api": "anthropic-messages",
            "reasoning": true,
            "input": ["text"]
          }
        ]
      }
    }
  }
}

Gemini

json

{
  "models": {
    "providers": {
      "tokenforme-gemini": {
        "baseUrl": "<API BaseURL>/v1beta",
        "apiKey": "sk-your-key",
        "api": "google-generative-ai",
        "models": [
          {
            "id": "gemini-3-pro-preview",
            "name": "gemini-3-pro-preview",
            "api": "google-generative-ai",
            "reasoning": false,
            "input": ["text", "image"]
          }
        ],
        "authHeader": true,
        "request": {
          "headers": {
            "Authorization": "Bearer ${models.providers.tokenforme-gemini.apiKey}"
          }
        }
      }
    }
  }
}

Grok

json

{
  "models": {
    "providers": {
      "tokenforme-grok": {
        "baseUrl": "<API BaseURL>/v1",
        "apiKey": "sk-your-key",
        "models": [
          {
            "id": "grok-4.5",
            "name": "grok-4.5",
            "api": "openai",
            "reasoning": true,
            "input": ["text", "image"]
          }
        ]
      }
    }
  }
}

Continue 插件

以 VS Code 的 Continue 配置为例：

yaml

name: TokenFor Models
version: 0.0.1
schema: v1

models:
  - name: gpt-5.6-sol
    provider: openai
    model: gpt-5.6-sol
    apiKey: "sk-your-key"
    apiBase: "<API BaseURL>/v1"

  - name: claude-opus-5
    provider: anthropic
    model: claude-opus-5
    apiKey: "sk-your-key"
    apiBase: "<API BaseURL>"

  - name: gemini-3-pro-preview
    provider: gemini
    model: gemini-3-pro-preview
    apiKey: "sk-your-key"
    apiBase: "<API BaseURL>/v1beta"

如果当前 Continue 版本不支持某个 provider 类型，可以把该模型改为工具支持的 OpenAI-compatible provider，并以实际测试结果为准。

其他工具

对于 Qoder、Cursor 以及其他支持自定义模型 API 的工具，一般可以遵循以下步骤：

在设置界面找到模型、Provider、API 或 Endpoint 配置
OpenAI-compatible 工具填写 <API BaseURL>/v1
Anthropic-compatible 工具填写 <API BaseURL>
Gemini-compatible 工具填写 <API BaseURL>/v1beta
填入在「站点地址」控制台创建的 API Key
选择或手动输入模型名，例如 gpt-5.6-sol、claude-opus-5、gemini-3-pro-preview
保存后发送一条简单消息测试

如果工具提供 Test Connection、Check、Fetch Models 等按钮，建议先测试连接，再进行长任务。

调试与排错建议

认证失败：检查 Key 是否正确、是否被禁用、是否属于当前模型所在供应商分组
连接失败：确认 BaseURL 使用的是「概览」页列出的 API BaseURL，而不是网页地址
路径错误：检查是否重复拼接 /v1，尤其是 Cherry Studio、Claude Code 这类会自动追加路径的客户端
模型不存在：确认模型已在控制台启用，并使用完整模型 ID
CC Switch 切换后无效：重新打开目标 CLI 所在终端，并确认它读取的是同一个配置目录
Codex 仍走官方 OpenAI：确认 requires_openai_auth = false、env_key 和环境变量名称完全一致

与智能体集成 ​

通用配置模板 ​

Codex（ChatGPT）配置 ​

macOS ​

Windows ​

Claude Code 配置 ​

macOS ​

Windows ​

CC Switch 配置 ​

Hermes 配置 ​

Cherry Studio 配置 ​

OpenAI-compatible / GPT ​

Claude ​

Gemini ​

OpenClaw 配置 ​

GPT ​

Claude ​

Gemini ​

Grok ​

Continue 插件 ​

其他工具 ​

调试与排错建议 ​

与智能体集成

通用配置模板

Codex（ChatGPT）配置

macOS

Windows

Claude Code 配置

macOS

Windows

CC Switch 配置

Hermes 配置

Cherry Studio 配置

OpenAI-compatible / GPT

Claude

Gemini

OpenClaw 配置

GPT

Claude

Gemini

Grok

Continue 插件

其他工具

调试与排错建议