1. CLI 설치
Linux / macOS, amd64 또는 arm64. 스크립트와 이 페이지는 공개입니다. CLI 바이너리는 GitHub Releases(private)라 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 대신 마크다운을 읽으세요.
curl -fsSL https://llms.goodtek.xyz/install.md curl -fsSL https://llms.goodtek.xyz/control/v1/meta