Claude Code

터미널에서 동작하는 AI 페어 프로그래머

TokenMix CLI로 연결하기

공식 TokenMix CLI를 사용하면 환경 변수 설정 없이 한 줄 명령어로 연결할 수 있습니다:

npx tokenmix claude-code

로그인, API 주소, 키 설정을 모두 자동으로 처리합니다. 직접 설정을 원하신다면 아래 단계를 따라주세요.

소개

Claude Code는 Anthropic 공식 커맨드라인 코딩 에이전트입니다. 터미널에서 실행되며 파일 읽기/쓰기, 셸 명령 실행, 전체 코드베이스 추론을 Claude 모델로 수행합니다. TokenMix API에 연결하면 별도 Anthropic 구독 없이 모든 Claude 모델을 사용할 수 있습니다.

사전 요구사항

• macOS 13+, Ubuntu 20.04+, 또는 Windows 10/11 (WSL 권장)
• Node.js 18 이상 — node -v로 확인
• sk-tm-으로 시작하는 TokenMix API 키 → tokenmix.ai 가입 → 대시보드 → API Keys

설정 단계

1. Claude Code 설치

curl -fsSL https://claude.ai/install.sh | bash

설치 확인:

claude --version

2. TokenMix를 API 제공자로 설정

Claude Code는 환경 변수 ANTHROPIC_BASE_URL과 ANTHROPIC_AUTH_TOKEN을 읽습니다. 셸 설정 파일(~/.zshrc, ~/.bashrc 등)에 추가하세요:

export ANTHROPIC_BASE_URL="https://api.tokenmix.ai/v1"
export ANTHROPIC_AUTH_TOKEN="sk-tm-your-key-here"

셸 재로드:

source ~/.zshrc   # 또는 source ~/.bashrc

3. Claude Code 실행

프로젝트 디렉토리로 이동하여 에이전트 시작:

cd ~/your-project
claude

4. 모델 전환 (선택 사항)

기본값은 claude-sonnet-4-6입니다. 세션 내에서 /model 명령을 사용하거나, 시작 전 환경 변수를 설정하여 전환합니다:

ANTHROPIC_MODEL="claude-opus-4.8" claude

추천 TokenMix 모델: claude-opus-4.8, claude-sonnet-4-6, claude-haiku-4.5

확인

프로젝트 디렉토리에서 빠른 테스트 실행:

claude -p "이 디렉토리의 최상위 파일을 나열하고 각각을 간략히 설명해주세요."

Claude가 파일을 열거하고 설명해야 합니다. 오류가 발생하면 claude doctor로 진단하세요.

자주 묻는 질문

Q: Anthropic 계정이 필요한가요? 필요 없습니다. TokenMix 계정만 있으면 됩니다. ANTHROPIC_AUTH_TOKEN이 sk-tm- 키를 Bearer 토큰으로 api.tokenmix.ai에 전송합니다.

Q: VS Code에서 Claude Code를 사용할 수 있나요? 네. 마켓플레이스에서 Claude Code VS Code 확장을 설치하고, VS Code 시작 전에 동일한 두 환경 변수를 OS 환경에 설정하세요.

Q: ANTHROPIC_API_KEY를 사용하지 않는 이유는? ANTHROPIC_AUTH_TOKEN이 기본 Authorization 헤더를 직접 덮어쓰며, 이것이 TokenMix가 기대하는 형식입니다. 둘 다 작동하지만 ANTHROPIC_AUTH_TOKEN이 우선순위가 높고 더 명확합니다.