goodtek がホストするマルチアカウント LLM ハブです。プロバイダアカウントはサーバー側、クライアントは route URL と sk-gt だけ。

選べるルーティングは？

failover（順次）、balance（ラウンドロビン）、prefer-primary（加重 80/20）、quota-first（残 % 優先）、parallel（API キー race）です。

残クォータの見方は？

llms status でキャッシュ、llms status --refresh で Codex/Claude OAuth usage を再取得します。

Install llms

1. CLI インストール

Linux / macOS、amd64 または arm64。スクリプトとこのページは公開。CLI バイナリは private 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 キー race · OAuth は既定除外

モデル一覧: llms models <slug>（アカウント ref ではなく実モデル id）

4. 残量確認

キャッシュのみ: llms status。Codex/Claude OAuth usage 再取得: llms status --refresh。

llms status --refresh

ボードに health(●/○/✖)、quota …% バー、reset、ルート 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}'

シェル向け: llms env <slug>

機械向け原文

自動化・エージェントは HTML ではなく Markdown を読んでください。

curl -fsSL https://llms.goodtek.xyz/install.md
curl -fsSL https://llms.goodtek.xyz/control/v1/meta