AI 小家 API 接入中心

Codex CLI

安装与检查

Codex CLI 官方支持 macOS 和 Linux，Windows 支持仍偏实验，建议使用 WSL2。

# macOS / Linux
npm install -g @openai/codex

# 检查安装
codex --version
codex

# 更新
codex --upgrade

接入本站时，继续使用下方 Codex 配置，把 `base_url` 改成你选定站点的 `/v1` 地址。

Claude Code

安装与检查

标准安装方式是 npm，需要 Node.js 18 或更高版本。Windows 建议使用 WSL 或 Git for Windows。

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

# 检查安装
claude --version
claude doctor

接入本站时，Claude Code 使用选定站点根地址，不要加 `/v1`。

Gemini CLI

安装与检查

Gemini CLI 官方要求 Node.js 20 或更高版本，可用 npm 或 Homebrew 安装。

# npm
npm install -g @google/gemini-cli

# macOS / Linux Homebrew
brew install gemini-cli

# 不全局安装，临时运行
npx @google/gemini-cli

# 检查安装
gemini --version
gemini

Gemini CLI 官方认证使用 Google 登录、Gemini API Key 或 Vertex AI。不要把本站 API Key 填到 `GEMINI_API_KEY`。

通用准备

安装前检查

• Windows 建议准备 PowerShell、Git for Windows 或 WSL2。
• npm 安装前先检查 `node --version` 和 `npm --version`。
• 装完后先运行版本检查，再配置 Base URL 和 API Key。
• 只从官方包名安装：`@openai/codex`、`@anthropic-ai/claude-code`、`@google/gemini-cli`。

卡密 ≠ API Key

卡密是购买后得到的激活码，可在任意同步站点兑换充值。

API Key 形如 `sk-xxxx`，可配合任意同步站点的 Base URL 使用。

同步站点规则

OpenAI 兼容客户端：`https://站点域名/v1`

Claude Code：`https://站点域名`

Claude Code

使用当前线路的站点根地址，不要加 `/v1`。下面以主站为例。

export ANTHROPIC_BASE_URL=https://us.apihoter.com
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1

Codex

编辑 `~/.codex/config.toml`，`base_url` 换成你注册站点的 `/v1` 地址：

model = "gpt-5"
model_provider = "ai-home"

[model_providers.ai-home]
base_url = "https://us.apihoter.com/v1"
env_key = "XYZ_API_KEY"

Cursor

Settings → Models → Override OpenAI Base URL。下面以主站为例。

Base URL: https://us.apihoter.com/v1
API Key: YOUR_API_KEY

Cherry Studio

服务商管理里选择 OpenAI 兼容接入。下面以主站为例。

名称: AI 小家
Base URL: https://us.apihoter.com/v1
API Key: YOUR_API_KEY

NextChat

环境变量中的地址按当前网络选择站点即可，API Key 可通用。

OPENAI_API_KEY=YOUR_API_KEY
BASE_URL=https://us.apihoter.com
CUSTOM_MODELS=gpt-4o,gpt-4o-mini,gpt-4-turbo

Open WebUI

下面以主站为例，其他站点请替换为对应域名。

OPENAI_API_BASE_URL=https://us.apihoter.com/v1
OPENAI_API_KEY=YOUR_API_KEY

账户与余额

• 账号、余额和 API Key 已在任意同步站点可见
• 卡密已兑换成功
• 后台可见余额
• API Key 已创建且未删除

地址与格式

• OpenAI 兼容客户端地址带 `/v1`
• Claude Code 地址不带 `/v1`
• API Key 没有空格和换行

Python

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://us.apihoter.com/v1"
)

response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "Hello"}]
)

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

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "YOUR_API_KEY",
  baseURL: "https://us.apihoter.com/v1"
});

const response = await client.chat.completions.create({
  model: "gpt-4o-mini",
  messages: [{ role: "user", content: "Hello" }]
});