llms 시작 가이드
여러 LLM 계정을 서버에 묶고, 쓰는 도구에는 route URL과 sk-gt만 남깁니다. goodtek이 호스팅합니다. https://llms.goodtek.xyz
이런 때 씁니다
Claude·Codex·OpenRouter처럼 계정이 여러 개인데, IDE·CLI·봇마다 설정을 다시 적기 싫을 때 씁니다. 계정 시크릿은 서버에만 두고, 클라이언트에는 고정 route URL과 sk-gt만 남깁니다. 셀프호스트가 기본이 아니라 https://llms.goodtek.xyz 호스팅이 제품입니다.
CLI 설치
1. https://llms.goodtek.xyz/install 사람용 안내를 먼저 읽습니다. 2. 터미널에서 `curl -fsSL https://llms.goodtek.xyz/install.sh | bash` 로 CLI를 설치합니다. (GitHub Releases 접근이 필요할 수 있습니다. 자세한 조건은 install.md에 있습니다.) 3. `llms --help` 로 설치를 확인합니다. 기계가 읽기 좋은 문서는 https://llms.goodtek.xyz/install.md 입니다.
로그인과 계정 연결
1. `llms login` 으로 goodtek 세션을 만듭니다. 터미널에 나온 URL에서 GitHub device code를 승인하면 됩니다. 2. `llms add` 로 OAuth 또는 API 키 계정을 등록합니다. 시크릿은 서버 볼트에만 남습니다. 3. `llms status` 로 계정 상태와 잔여량을 확인합니다. 프로바이더 usage를 다시 읽으려면 `llms status --refresh` 를 씁니다.
라우트 만들기
`llms route create` 위저드에서 프리셋을 고르면 고정 URL이 생깁니다. • failover. 계정 순서대로 시도 • balance. 요청마다 돌아가며 사용 • prefer-primary. 주 계정을 더 자주 • quota-first. 잔여 %가 높은 계정 우선 • parallel. API 키 계정을 동시에 치고 첫 TTFT 채택 (옵트인) 정책이 바뀌어도 클라이언트에 넣은 Base URL은 그대로 둘 수 있습니다.
잔여량 보기
홈과 `llms status` 보드에 계정별 잔여 %·리셋 시각·쿨다운이 보여요. 429 등으로 막힌 계정은 잠시 풀에서 빠집니다. 라우팅 전에 한도를 보고, 소진되면 다른 계정으로 넘어가게 프리셋을 고르면 됩니다.
도구에 붙이기
OpenAI 호환(또는 Anthropic Messages) Base URL을 받는 IDE·CLI·봇·스크립트면 됩니다. • Base URL: `https://llms.goodtek.xyz/r/<slug>/v1` • API Key: `sk-gt-…` (route key) 특정 IDE에 묶여 있지 않습니다. 사람용 설치는 /install, 기계용은 /install.md · /install.sh 를 보면 됩니다.
자주 묻는 질문
셀프호스트가 필요한가요? 아니요. 기본 제품은 https://llms.goodtek.xyz 호스팅입니다. 어떤 클라이언트에 붙이나요? Base URL과 API 키를 받는 도구면 됩니다. 다른 질문은 hello@goodtek.xyz 또는 문의 페이지로 보내 주세요.