TokenMix CLI

TokenMix 공식 CLI — 한 줄 명령으로 모든 AI 코딩 에이전트를 TokenMix에 연결

개요

TokenMix CLI는 TokenMix 공식 커맨드라인 도구입니다. Claude Code, Aider, OpenCode, Codex, Qwen Code, Goose, OpenHands, 그리고 4개의 VS Code 확장(Kilo Code, Cline, Roo Code, Continue)을 TokenMix 계정에 설정 없이 연결할 수 있습니다. 환경 변수를 수동으로 설정하거나 설정 파일을 편집할 필요가 없습니다. 하나의 API 키로 OpenAI Chat Completions, Anthropic Messages, Responses API 세 가지 프로토콜을 모두 지원합니다.

사전 요구 사항

• Node.js 18 이상. node --version으로 확인하고, 없으면 nodejs.org에서 설치하세요.
• TokenMix 계정. tokenmix.ai에서 가입하세요. 신규 계정에는 $1 무료 크레딧이 제공됩니다(Qwen Flash 등 대부분의 비프리미엄 모델에서 사용 가능).

설치

방법 A — 전역 설치(일상적인 사용에 권장):

npm install -g tokenmix

방법 B — 설치 없이 실행(npx):

npx tokenmix <명령>

로그인

tokenmix login

브라우저가 열리면 TokenMix 계정에 로그인하고 터미널에 표시된 짧은 코드를 확인하세요. 브라우저를 사용할 수 없는 환경에서는:

tokenmix login --paste          # 대화형 키 붙여넣기, 브라우저 불필요
tokenmix login --key sk-tm-...  # API 키 직접 전달(CI용)

인증 정보는 macOS에서는 ~/Library/Application Support/tokenmix/config.json, Linux에서는 ~/.config/tokenmix/config.json, Windows에서는 %APPDATA%/tokenmix/config.json에 권한 0600으로 저장됩니다.

에이전트 원클릭 실행

첫 실행 시 에이전트를 자동 설치(지원되는 경우)하고 TokenMix를 가리키도록 설정합니다:

npx tokenmix opencode       # OpenCode — 자동 설치
npx tokenmix claude         # Claude Code — 자동 설치
npx tokenmix aider          # Aider — pip install aider-chat 필요
npx tokenmix codex          # Codex — 자동 설치
npx tokenmix qwen           # Qwen Code — 자동 설치
npx tokenmix goose          # Goose — 먼저 Goose 본체 설치 필요
npx tokenmix openhands      # OpenHands — Python 3.12+, uv tool install openhands 필요

VS Code 확장 설정(스니펫을 출력하여 확장 설정에 붙여넣기):

npx tokenmix kilo           # Kilo Code
npx tokenmix cline          # Cline
npx tokenmix roo            # Roo Code
npx tokenmix continue       # Continue(VS Code / JetBrains)

$1 무료 체험 사용하기

무료 크레딧은 비프리미엄 모델에서 사용 가능합니다. 비용 없이 체험하려면 qwen-flash를 지정하세요:

TOKENMIX_DEFAULT_MODEL=qwen-flash npx tokenmix opencode

tokenmix models로 모든 사용 가능한 모델과 가격을 확인할 수 있습니다.

확인

tokenmix balance   # 실시간 잔액, 증정 크레딧, 총 지출 표시
tokenmix doctor    # 키 유효성 및 각 에이전트의 설치/설정 상태 진단

balance에 잔액이 표시되고 doctor에 오류가 없으면 준비 완료입니다.

자주 묻는 질문

tokenmix login 실행 시 브라우저가 열리지 않았습니다. 서버, 컨테이너, SSH 환경에서는 정상적인 동작입니다. 터미널에 URL과 짧은 코드가 표시되므로, 어떤 기기에서든 URL을 열어 코드를 입력하세요. tokenmix login --paste로 키를 붙여넣거나, CI에서는 tokenmix login --key sk-tm-...를 사용하세요.

기본 모델을 변경하려면? 에이전트는 claude-sonnet-4.6을 기본으로 사용합니다. TOKENMIX_DEFAULT_MODEL 환경 변수로 재정의할 수 있습니다. tokenmix models로 전체 모델 목록을 확인하세요. tokenmix claude와 tokenmix codex는 Claude 계열 모델이 필요하며, 다른 에이전트는 모든 채팅 모델을 지원합니다.

로그아웃하거나 제거하려면? tokenmix logout으로 저장된 키를 삭제하고 CLI가 변경한 에이전트 설정을 되돌립니다. 전역 설치된 경우 npm uninstall -g tokenmix로 완전히 제거할 수 있습니다.