快速开始

登录客户控制台，创建 API 密钥，将 Base URL 设置为 https://www.token115.com/v1。

curl https://www.token115.com/v1/chat/completions \
  -H "Authorization: Bearer sk-token115-your-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.5","messages":[{"role":"user","content":"hello"}]}'

Claude Code

安装 Node.js 18+；Windows 用户还需要安装 Git for Windows。随后安装 Claude Code CLI，并在用户目录配置 Token115 地址和客户密钥。

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

mkdir -p ~/.claude
cat > ~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-token115-your-key",
    "ANTHROPIC_BASE_URL": "https://www.token115.com"
  }
}

首次启动前可创建 ~/.claude.json 跳过引导。进入项目目录运行 claude，对话内使用 /model 切换模型，长上下文对话可用 /compact 压缩上下文。

Roo Code

在 VS Code 或 Cursor 扩展市场安装 Roo Code。打开配置界面后，API Provider 选择 Anthropic，API Key 填 Token115 客户密钥。

API Provider: Anthropic
API Key: sk-token115-your-key
Base URL: https://www.token115.com

模型建议先选择 claude-opus-4-6 或 claude-opus-4-7。如果请求失败，优先检查 API 地址、密钥分组和模型名称是否匹配。

OpenCode

安装 OpenCode 后运行 opencode auth login，服务商选择 other。Claude 与 GPT/Codex 建议分成两个 Provider，便于模型列表和密钥分组独立管理。

curl -fsSL https://opencode.ai/install | bash

opencode auth login

# ~/.config/opencode/opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "Token115-Claude": {
      "npm": "@ai-sdk/anthropic",
      "options": {
        "apiKey": "sk-token115-your-key",
        "baseURL": "https://www.token115.com/v1"
      },
      "models": {
        "claude-opus-4-7": { "name": "claude-opus-4-7" },
        "claude-sonnet-4-6": { "name": "claude-sonnet-4-6" }
      }
    },
    "Token115-GPT": {
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "apiKey": "sk-token115-your-key",
        "baseURL": "https://www.token115.com/v1"
      },
      "models": {
        "gpt-5.5": { "name": "gpt-5.5" },
        "gpt-5.3-codex": { "name": "gpt-5.3-codex" }
      }
    }
  }
}

Codex

终端版可安装 Codex CLI，插件版可在 VS Code / Cursor 扩展市场安装。Provider 使用 OpenAI 兼容模式，Base URL 必须以 /v1 结尾。

npm install -g @openai/codex

export OPENAI_API_KEY="sk-token115-your-key"
export OPENAI_BASE_URL="https://www.token115.com/v1"

模型名称按模型广场填写，例如 gpt-5.5、gpt-5.2-codex、gpt-5.3-codex。如果使用切换工具，API 地址填写 https://www.token115.com/v1。

OpenClaw

OpenClaw 需要 Node.js 22+。运行初始化程序时选择 Custom Provider，端点兼容性选择 Anthropic-compatible。

npm install -g openclaw@latest
openclaw onboard --install-daemon

# API Base URL: https://www.token115.com/v1
# API Key: sk-token115-your-key
# Endpoint compatibility: Anthropic-compatible
# Model ID: claude-opus-4-6-thinking

初始化完成后可编辑 ~/.openclaw/openclaw.json，把 contextWindow 调整到实际模型支持范围，maxTokens 可设置为 8192 起步。

Cherry Studio

在 Cherry Studio 设置中新增自定义服务商。Claude 和 GPT 建议分开创建服务商，端点类型选择 OpenAI-Response。

OpenAI SDK

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-token115-your-key",
  baseURL: "https://www.token115.com/v1",
});

const result = await client.chat.completions.create({
  model: "gpt-5.5",
  messages: [{ role: "user", content: "hello" }],
});

密钥限制

建议为生产密钥配置 IP 白名单、有效期、额度上限和小时/日/周速率限制。

计费与日志

每次 API 请求完成后，请求日志会实时记录模型、输入、输出、缓存命中、缓存写入、倍率和最终扣费。用量统计按模型聚合展示，余额不足时 API 会返回 402。

常见问题

401 通常是密钥错误，402 是余额不足，429 是密钥或网关速率限制，5xx 通常表示服务短暂不可用。