# aublite 精简版 — 使用教程（客户对接文档）

> 版本 2026-07-22 · 面向使用者。看完能接入、知道哪些是自动的、出问题知道查哪。

## 1. 这是什么

aublite 是 Claude 订阅共享网关（精简版）。你的 Claude Code 连它，它连 Anthropic。
**防御全自动**：每个请求经过网关时自动完成指纹伪装与隐写清洗，你无感知。

```
你的 Claude Code  →  aublite 网关（防御层全自动）→  Anthropic 官方
                     · 指纹 headers 注入
                     · 隐写术洗脱
                     · 时区/语言对齐
                     · 账号池调度+拟人节律
```

## 2. 接入（30 秒）

管理员给你两样东西：**网关地址** + **key**（sk-aublite- 开头）。

### macOS / Linux

```bash
export ANTHROPIC_BASE_URL=https://你的网关地址
export ANTHROPIC_AUTH_TOKEN=sk-aublite-你的key
claude
```

写进 `~/.zshrc` 或 `~/.bashrc` 永久生效。

### Windows PowerShell

```powershell
$env:ANTHROPIC_BASE_URL="https://你的网关地址"
$env:ANTHROPIC_AUTH_TOKEN="sk-aublite-你的key"
claude
```

### 其他客户端

凡支持自定义 Base URL 的 Anthropic 客户端都能用（Cline、ChatBox、SDK 等），
认证头 `x-api-key: sk-aublite-你的key` 或 `Authorization: Bearer sk-aublite-你的key`。

### 支持的模型（按实际账号等级可用）

| 模型 | 说明 |
|------|------|
| `claude-sonnet-5` | Sonnet 最新版（主力） |
| `claude-fable-5` | Fable 创意版 |
| `claude-opus-4-8` / `claude-opus-4-7` | Opus 大杯（复杂推理） |
| `claude-opus-4-6` | Opus 中杯 |
| `claude-opus-4-5-20251101` | Opus 存档版 |
| `claude-sonnet-4-6` | Sonnet 中杯（主力推荐） |
| `claude-sonnet-4-5-20250929` | Sonnet 存档版 |
| `claude-haiku-4-5-20251001` | Haiku 轻量版（快速问答） |

> ⚠️ 模型名必须完整填写，带日期戳的版本号不要写错。使用 Sonnet 4.6 测试时确认账号支持该模型。

## 3. 防御清单：哪些自动，哪些要你动手

### ✅ 全自动（网关侧，你不用管）

| 防御 | 说明 |
|------|------|
| 指纹 headers | user-agent、x-app、x-stainless-os/arch/lang/runtime/package-version/retry-count、anthropic-beta 全家桶，与官方 CLI 逐字节对齐 |
| 隐写术洗脱 | CLI 把中国标记编码进撇号变体（U+2019/U+02BC/U+02B9）和日期分隔符——网关转发前全部归一化洗掉 |
| 时区对齐 | 请求体里 Asia/Shanghai → America/Los_Angeles |
| 请求头顺序 | 与官方 CLI 一致（header 顺序也是指纹） |
| 行为节律 | 账号按代理地区当地时间过作息（白天多/深夜停/周末少），新号自动养号爬坡 |
| 版本跟进 | 策略包每小时热更新，新版 CLI 指纹 6h 内自动同步 |

### ⚠️ 可选加强（本机侧，不强制）

**默认零本机配置**——接上就能用，网关把请求级指纹全兜住。
以下属于加强项：本机系统时区、WebRTC、DNS 在请求发出前可见，追求极致防封可跑环境脚本
（找管理员要，或仓库 `client/` 目录），不跑也能正常用：

| 系统 | 脚本 | 干什么 |
|------|------|--------|
| Windows | `aublite-env-win.ps1`（管理员 PowerShell 跑） | 改时区/语言/区域 + 禁 WebRTC + 关 IPv6 + DNS 走 8.8.8.8/1.1.1.1 + **CLI 版本审计**（2.1.91~2.1.197 带毒版本检测）+ BASE_URL 风险审计 |
| macOS | `aublite-env-mac.sh` | 时区/语言 + DNS + CLI 版本审计 + BASE_URL 风险审计 |

加 `--check`（mac）或 `-CheckOnly`（Win）参数 = 只检测不修改。

## 4. 管理员操作教程

### 4.1 入号（OAuth 授权，推荐）

控制台 →「账号池」→ 顶部 OAuth 区块：

1. 填名称（带地域：`acct-us-01`）+ 选地区时区 + 填该号专属住宅代理
2. 「1️⃣ 生成授权链接」→ 复制（30 分钟有效）
3. **干净美国环境**打开链接 → 登录授权 → 回调页拿 code
4. 粘回 →「2️⃣ 完成入号」→ 自动换 token 入池（含 refresh_token 自动续期）

入号后自动进入养号爬坡（0-3天 5% → 15天 100%），老号勾"跳过养号"。

### 4.2 发 key 给客户

控制台 →「分发密钥」→ 填使用者标记 + 每日配额 + 有效天数 → 生成。
客户超配额当天 401，次日自动恢复；到期自动失效。

### 4.3 盯盘

- 「总览」：池子可用/冷却、策略版本
- 「节律」：每个号当地时间、年龄、爬坡进度、日预算/小时配额用量
- 「密钥」：每个客户今日用量进度条、累计、最后使用时间

## 5. 排错 FAQ

**Q: Claude Code 报 401 "Invalid API key"**
A: 按顺序查：① key 复制多了空格 ② 环境变量没生效（新开终端）③ 今日配额用完（找管理员看用量）④ key 过期/被删

**Q: 报 429 / "节律限流"**
A: 触发拟人节律或账号冷却，正常现象，稍等自动恢复；持续出现找管理员查池子深度

**Q: 响应慢**
A: 首 token 5-15s 正常（账号调度+防御处理）；流式输出中卡顿多为账号冷却切换，等几秒

**Q: 一个 key 能多设备用吗**
A: 能，但共享配额；多人用找管理员各发一个 key

**Q: 报错算钱吗**
A: 401/429/5xx 不产生上游调用，不计配额

**Q: 我需要自己买 Claude 订阅吗**
A: 不用。你买的是网关的使用权，订阅是管理员池子里的

**Q: 为什么有时回答风格突然变了**
A: 池子多账号轮询调度，不同号可能有细微差异，正常现象

## 6. 使用红线（违反=连坐封号，别干）

1. key 不外传、不晒截图（key 全貌泄露=别人白用你的配额）
2. 不用网关干违反 Anthropic 政策的事（封号连累全池）
3. 本机环境脚本跑过一次后，**别再用国产 AI 客户端裸连官方**（指纹打架）
4. 收到 Anthropic 邮件不要点里面任何链接/图片（追踪像素回传真实位置）

---
*精简版定位：自用/小团队。商业化多客户付费场景请用 sub2api 完整版（计费/支付/面板）。*