接入教程

把这份页面发给你的 AI 助手，它能帮你完成配置。

Base URL: https://api.xucu.app

API 信息

认证: x-api-key: sk-xxx 或 Authorization: Bearer sk-xxx

端点: Claude 系列 → POST /v1/messages (Anthropic 格式)
GPT 系列 → POST /v1/responses (OpenAI Responses 格式)
模型列表 → GET /v1/models

可用模型: claude-opus-4-6 · claude-sonnet-4-6 · claude-haiku-4-5 · gpt-5.3-codex · gpt-5.4 · gpt-5.4-mini

计费: 所有模型统一 tokens, 计入 = input + output + cache_creation, 缓存命中不计

不支持 /v1/chat/completions。Claude 走 /v1/messages，GPT 走 /v1/responses。

Claude Code (终端)

设置环境变量 (加到 ~/.bashrc 或 ~/.zshrc 永久生效):

export ANTHROPIC_BASE_URL=https://api.xucu.app
export ANTHROPIC_API_KEY=sk-xxx

Windows PowerShell:

$env:ANTHROPIC_BASE_URL = "https://api.xucu.app"
$env:ANTHROPIC_API_KEY = "sk-xxx"

启动 Claude Code 后, 输入 /model 选择模型 (如 claude-opus-4-6).

Claude Code 只支持 /v1/messages (Anthropic 格式), 用 claude 系列模型.

Claude Code (VS Code 扩展)

1. 扩展市场搜索 Claude Code (ID: anthropic.claude-code), 安装.

2. VS Code settings.json 配终端环境变量:

{
  "terminal.integrated.env.windows": {
    "ANTHROPIC_BASE_URL": "https://api.xucu.app",
    "ANTHROPIC_API_KEY": "sk-xxx"
  },
  "terminal.integrated.env.linux": {
    "ANTHROPIC_BASE_URL": "https://api.xucu.app",
    "ANTHROPIC_API_KEY": "sk-xxx"
  },
  "terminal.integrated.env.osx": {
    "ANTHROPIC_BASE_URL": "https://api.xucu.app",
    "ANTHROPIC_API_KEY": "sk-xxx"
  }
}

3. 打开 Claude Code 面板, 输入 /model 选择模型.

也可以直接设系统环境变量, 重启 VS Code 生效.

OpenCode

编辑 opencode.json (项目根目录或 ~/.config/opencode/):

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "xucu": {
      "npm": "@ai-sdk/anthropic",
      "options": {
        "baseURL": "https://api.xucu.app/v1",
        "apiKey": "sk-xxx"
      },
      "models": {
        "claude-opus-4-6": {
          "name": "Claude Opus 4.6",
          "attachment": true,
          "reasoning": true,
          "tool_call": true,
          "limit": { "context": 1000000, "output": 64000 }
        },
        "claude-sonnet-4-6": {
          "name": "Claude Sonnet 4.6",
          "attachment": true,
          "reasoning": true,
          "tool_call": true,
          "limit": { "context": 1000000, "output": 64000 }
        }
      }
    }
  }
}

启动 OpenCode → /models 选择 xucu/ 开头的模型即可.

npm 用 @ai-sdk/anthropic, 走 /v1/messages. apiKey 直接写在 options 里, 不需要 /connect.

VS Code (Continue.dev)

编辑 ~/.continue/config.json, 在 models 数组里添加:

{
  "models": [
    {
      "provider": "anthropic",
      "model": "claude-opus-4-6",
      "apiBase": "https://api.xucu.app",
      "apiKey": "sk-xxx",
      "title": "Claude Opus 4.6"
    }
  ]
}

Continue.dev Anthropic provider 走 /v1/messages.

Cursor

1. 打开 Cursor Settings → Models.

2. 在 Anthropic API Key 填: sk-xxx

3. 开启 Override Anthropic Base URL, 填: https://api.xucu.app

4. 选 claude 系列模型使用.

Cursor Anthropic 模式走 x-api-key + /v1/messages, 和网关兼容. 不要用 OpenAI Base URL (走 /v1/chat/completions, 不支持).

Cherry Studio

Claude 系列

1. 打开设置 → 模型服务商.

2. 找到 Anthropic 或添加自定义服务商 (选 Anthropic 类型).

3. API 地址填: https://api.xucu.app

4. API Key 填: sk-xxx

5. 点击"获取模型"拉取模型列表, 选 claude 系列模型.

GPT 系列

1. 添加自定义服务商, 选 OpenAI 类型.

2. API 地址填: https://api.xucu.app

3. API Key 填: sk-xxx

4. 手动添加模型: gpt-5.3-codex, gpt-5.4, gpt-5.4-mini.

Claude 走 Anthropic 服务商 (/v1/messages), GPT 走 OpenAI 服务商 (/v1/responses).

OpenClaw

Claude 系列

providers:
  - name: xucu-claude
    type: anthropic
    api_key: sk-xxx
    base_url: https://api.xucu.app

GPT 系列

providers:
  - name: xucu-gpt
    type: openai
    api_key: sk-xxx
    base_url: https://api.xucu.app

cURL 测试

Claude 系列 (/v1/messages)

curl https://api.xucu.app/v1/messages \
  -H 'x-api-key: sk-xxx' \
  -H 'content-type: application/json' \
  -d '{
    "model": "claude-opus-4-6",
    "max_tokens": 100,
    "messages": [{"role": "user", "content": "hello"}]
  }'

GPT 系列 (/v1/responses)

curl https://api.xucu.app/v1/responses \
  -H 'Authorization: Bearer sk-xxx' \
  -H 'content-type: application/json' \
  -d '{
    "model": "gpt-5.4",
    "input": "hello"
  }'

额度查询: POST /v1/usage (Header: x-api-key: sk-xxx) 或主页查询框