CLIENT SETUP

软件配置

本页说明常见软件如何接入 KeyGo。除特别说明外，Base URL 统一填写 https://keygo.vip。

统一配置 https://keygo.vip

API Key 使用控制台生成的 Key。模型名称必须使用控制台里当前账号可用的模型 ID。

配置前检查

账号已经登录并完成必要验证。
余额充足，控制台能看到可用号池或分组。
已经创建 API Key，并记录完整密钥。
知道要使用的模型名称，例如控制台模型列表中展示的模型 ID。

Claude Code

Claude Code 是终端里的代码助手。通过环境变量把它接到 KeyGo。

1. 安装 Claude Code

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

安装后可以运行：

claude doctor

2. 设置环境变量

macOS、Linux、WSL、Git Bash 使用：

export ANTHROPIC_BASE_URL=https://keygo.vip
export ANTHROPIC_AUTH_TOKEN=YOUR_KEYGO_API_KEY

Windows PowerShell 使用：

$env:ANTHROPIC_BASE_URL="https://keygo.vip"
$env:ANTHROPIC_AUTH_TOKEN="YOUR_KEYGO_API_KEY"

3. 启动 Claude Code

cd your-project
claude

4. 常用命令

命令	用途
`claude`	进入交互模式。
`claude "解释这个项目"`	带初始问题启动。
`claude -p "检查这段代码"`	非交互模式，适合脚本或一次性问题。
`claude -c`	继续最近一次会话。

Claude Code 注意事项：如果环境变量设置后仍然走官方入口，请关闭当前终端并重新打开，再运行 echo $ANTHROPIC_BASE_URL 或 PowerShell 的 $env:ANTHROPIC_BASE_URL 确认变量已生效。

OpenAI SDK

服务端项目可以直接使用 OpenAI 兼容 SDK。推荐把密钥放在环境变量里。

export KEYGO_API_KEY=YOUR_KEYGO_API_KEY

Python

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_KEYGO_API_KEY",
    base_url="https://keygo.vip",
)

result = client.chat.completions.create(
    model="YOUR_MODEL_NAME",
    messages=[{"role": "user", "content": "测试一下连接"}],
)

print(result.choices[0].message.content)

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.KEYGO_API_KEY,
  baseURL: "https://keygo.vip",
});

const result = await client.chat.completions.create({
  model: "YOUR_MODEL_NAME",
  messages: [{ role: "user", content: "测试一下连接" }],
});

console.log(result.choices[0].message.content);

OpenAI 兼容客户端

Chatbox、Cherry Studio、NextChat、LobeChat、Open WebUI 等客户端一般都支持自定义 OpenAI 兼容服务。不同软件名称略有差异，按下面字段填写即可。

软件字段	填写内容	备注
Provider / 服务商	OpenAI Compatible / OpenAI 兼容 / 自定义 OpenAI	不要选只支持官方登录的模式。
API Key	`YOUR_KEYGO_API_KEY`	从 KeyGo 控制台复制。
Base URL / API 地址	`https://keygo.vip`	优先使用根地址。
Model / 模型	`YOUR_MODEL_NAME`	使用控制台显示的模型 ID。

通用操作步骤

打开设置进入软件的模型、服务商、API 或 Provider 设置页面。
新增自定义服务选择 OpenAI 兼容或自定义 OpenAI，不要选择只能登录官方账号的模式。
填写连接信息Base URL 填 https://keygo.vip，API Key 填控制台密钥。
填写模型如果软件不能自动拉取模型，请手动输入控制台可用模型名。
发送测试消息先发送一句简单问题，确认响应和控制台用量记录都正常。

老软件要求 /v1 怎么办

少数软件会强制要求 Base URL 以 /v1 结尾，或者会自动拼接 /v1。处理方式如下：

软件行为	填写方式
允许填写任意 Base URL	填写 `https://keygo.vip`。
必须以 `/v1` 结尾	填写 `https://keygo.vip/v1` 作为兼容配置。
软件会自动追加 `/v1`	填写 `https://keygo.vip`，避免变成 `/v1/v1`。

配置成功的判断标准

软件能返回模型回复。
控制台用量或日志能看到对应请求。
余额有正常扣减，模型和分组与预期一致。
不会重复弹出鉴权失败、模型不存在或连接失败。