接入文档

快速开始

Claude Code 接入

Anthropic 官方 CLI。设置两个环境变量即可指向 HopBase。

方式一：临时设置（当前终端会话有效）

export ANTHROPIC_BASE_URL=https://api.hop-base.com
export ANTHROPIC_AUTH_TOKEN=sk-你的密钥

# 然后正常启动
claude

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

# 写入 ~/.zshrc 或 ~/.bashrc
echo 'export ANTHROPIC_BASE_URL=https://api.hop-base.com' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN=sk-你的密钥' >> ~/.zshrc
source ~/.zshrc

Codex CLI 接入

OpenAI 官方编程代理。配置 ~/.codex/config.toml 指向 HopBase。

# ~/.codex/config.toml
model_provider = "hopbase"
model = "gpt-5.5"

[model_providers.hopbase]
name = "HopBase"
base_url = "https://api.hop-base.com/v1"
wire_api = "chat"

# 设置密钥环境变量后启动
export OPENAI_API_KEY=sk-你的密钥
codex

OpenAI SDK 接入

现有 OpenAI 代码只需改 base_url 一行。

Python

from openai import OpenAI

client = OpenAI(
    base_url="https://api.hop-base.com/v1",
    api_key="sk-你的密钥",
)

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

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.hop-base.com/v1",
  apiKey: "sk-你的密钥",
});

const resp = await client.chat.completions.create({
  model: "gpt-5.5",
  messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);

Anthropic SDK 接入

调用 Claude 模型，改 base_url 即可。

from anthropic import Anthropic

client = Anthropic(
    base_url="https://api.hop-base.com",
    api_key="sk-你的密钥",
)

msg = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好"}],
)
print(msg.content[0].text)

通用调用 / curl

OpenAI 协议（GPT 模型）

curl https://api.hop-base.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [{"role": "user", "content": "你好"}]
  }'

Anthropic 协议（Claude 模型）

curl https://api.hop-base.com/v1/messages \
  -H "x-api-key: sk-你的密钥" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "你好"}]
  }'

流式输出（加 "stream": true）

curl https://api.hop-base.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-5.5", "stream": true,
    "messages": [{"role": "user", "content": "你好"}]}'

第三方客户端

Cherry Studio、NextChat、LobeChat 等客户端，在设置里填入：

可用模型

不同套餐密钥返回的模型列表不同；完整列表以控制台为准，也可使用对应套餐密钥调用 GET /v1/models 获取。当前 OpenAI / Codex 与 Claude 套餐按协议和用途分为：

Claude 套餐需使用 Claude 分组密钥查询；Codex / OpenAI 密钥不会返回 Claude 模型。

常见问题