1. 安装 CLI
Linux / macOS，amd64 或 arm64。本页与脚本公开。CLI 二进制位于私有 GitHub Releases，需要 gh 登录或 GH_TOKEN。
推荐
# gh auth status OK
curl -fsSL https://llms.goodtek.xyz/install.sh | bash
仅有令牌时
export GH_TOKEN=ghp_xxxxxxxx curl -fsSL https://llms.goodtek.xyz/install.sh | bash
仅二进制
OS=$(uname -s | tr '[:upper:]' '[:lower:]')
ARCH=$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/')
gh release download v0.1.0 -R goodtekxyz/llms -p "llms_${OS}_${ARCH}"
chmod +x "llms_${OS}_${ARCH}"
sudo mv "llms_${OS}_${ARCH}" /usr/local/bin/llms
验证：llms --help
2. 登录
llms login
批准 GitHub device code 后，sk-gt 会写入 ~/.config/llms/credentials.json。默认 API 为 https://llms.goodtek.xyz。
llms status
3. 账户与路由
llms add llms route create llms route key <slug> llms status --refresh
- Claude / Codex — 浏览器/设备登录或 API 密钥
- DeepSeek · OpenAI · Kimi · GLM — API 密钥（OpenRouter 等可用
openai+ Base URL）
路由预设
failover顺序。1 失败则 2 (sequential)balance均衡分散 (round_robin)prefer-primary主账户加权 80/20 (weighted)quota-first优先剩余 % 更高 (quota_aware)parallelAPI 密钥竞速 · 默认排除 OAuth模型列表：llms models <slug>（真实模型 id，非账户 ref）
4. 查看剩余量
仅缓存：
llms status。重新读取 Codex/Claude OAuth usage：llms status --refresh。llms status --refresh
看板显示账户 health(●/○/✖)、quota …% 条、重置时间与路由 strategy。429 显示为 cooldown 并短暂移出池。
5. 接入客户端
不必事先决定用哪款应用。只要工具接受 OpenAI 兼容（或 Anthropic Messages）Base URL，用法相同。
| 设置 | 值 |
|---|---|
| Base URL | https://llms.goodtek.xyz/r/<slug>/v1 |
| API Key | llms route key → sk-gt-… |
curl -sS https://llms.goodtek.xyz/r/<slug>/v1/chat/completions \
-H "Authorization: Bearer sk-gt-…" \
-H "Content-Type: application/json" \
-d '{"model":"<model-id>","messages":[{"role":"user","content":"ping"}],"max_tokens":16}'
Shell：llms env <slug>
机器可读原文
自动化与代理应读取 Markdown，而非 HTML。
curl -fsSL https://llms.goodtek.xyz/install.md curl -fsSL https://llms.goodtek.xyz/control/v1/meta