코딩 도구
Claude Code
TokenLab을 Anthropic의 Claude Code CLI와 함께 사용하기
에이전트에게 설정 맡기기
이미 컴퓨터에서 실행 중인 에이전트에 다음 작업을 복사하여 붙여넣으세요:
Read this guide and help me connect Claude Code to TokenLab:
https://tokenlab.sh/docs/ko/integrations/claude-code
Check my installed version and active configuration first.
Preserve existing accounts, providers, permissions and other settings.
Back up local files and show proposed changes.
Have me enter any API key locally; never ask for, print or paste it in chat.
Check configuration loading first.
Explain any paid request test separately before running it.개요
Claude Code는 TokenLab API 키와 Claude 모델용 TokenLab Messages API를 사용할 수 있습니다.
설치
Anthropic은 현재 네이티브 설치 프로그램을 권장합니다. npm 패키지도 여전히 작동하지만, Anthropic은 해당 설치 방식을 더 이상 권장하지 않습니다(deprecated).
curl -fsSL https://claude.ai/install.sh | bashnpm 패키지가 반드시 필요한 경우 다음을 사용하세요:
npm install -g @anthropic-ai/claude-code@2.1.263Claude Code 설치 시 sudo npm install -g를 사용하지 마세요.
구성
macOS, Linux, WSL 또는 Windows PowerShell용 퀵스타트 터미널 지침을 사용하여 TOKENLAB_API_KEY를 설정하세요. 이때 키가 명령 기록(command history)에 남지 않도록 주의해야 합니다. 해당 터미널에서 Claude Code를 실행하세요. 지속적인 사용을 위해서는 로컬 보안 관리자(secret manager)를 사용하고, 셸 프로필에 일반 텍스트 키를 추가하지 마세요.
이 변수들은 현재 실행에만 적용되며, 저장된 계정, 기본 모델 및 권한 설정은 그대로 유지됩니다. 이전 설정을 사용하려면 변수 없이 평소처럼 실행하세요. 셸 프로필에 해당 변수를 영구적으로 저장하지 마세요.
이 세션 경로는 Claude Code 2.1.263과 ANTHROPIC_AUTH_TOKEN을 통한 Bearer 인증을 사용합니다. Base URL은 /v1을 제외하고 유지하세요. 기존 설정 파일의 env 값, 자격 증명 도우미, 클라우드 제공업체 전환 또는 관리형 정책이 인증에 영향을 줄 수 있으므로 실행 전에 확인하세요. 충돌이 발생하면 계정 데이터를 삭제하거나 정책을 약화시키는 대신 아래의 설정 도우미를 사용하세요. 선택된 모델과 권한은 /status에서 확인하세요.
ANTHROPIC_BASE_URL=https://api.tokenlab.sh ANTHROPIC_AUTH_TOKEN="${TOKENLAB_API_KEY:?Set TOKENLAB_API_KEY first}" ANTHROPIC_API_KEY= claude --model claude-sonnet-4-6선택 사항: 가역적 Claude Code 설정 도우미는 Python 3.11+ 환경에서 미리보기, 적용 및 원본 파일 복원 기능을 제공합니다. TokenLab Skills 플러그인 0.1.2 버전에는 이러한 스크립트가 포함되어 있으며, 해당 스크립트가 포함된 버전으로 업데이트한 후 독립형 Skill 설치를 사용할 수도 있습니다. 기존 플러그인이나 독립형 Skill 설치의 경우 README 업데이트 지침을 따르고 스크립트가 존재하는지 확인하세요. 수동 구성 방식도 도우미 없이 그대로 사용할 수 있습니다.
설정을 저장하거나 모델을 나열하는 것만으로는 키가 검증되거나 요청이 완료되지 않습니다. 프롬프트 사용 시 TokenLab 잔액이 차감됩니다. 도구를 사용하기 전에 응답과 해당 요청 기록을 확인하세요. 보조 요청(auxiliary requests) 또한 비용이 청구될 수 있습니다.
사용법
구성 후에는 평소처럼 Claude Code를 사용하세요:
# 대화형 세션 시작
ANTHROPIC_BASE_URL=https://api.tokenlab.sh ANTHROPIC_AUTH_TOKEN="${TOKENLAB_API_KEY:?Set TOKENLAB_API_KEY first}" ANTHROPIC_API_KEY= claude --model claude-sonnet-4-6
# 단일 명령 실행
ANTHROPIC_BASE_URL=https://api.tokenlab.sh ANTHROPIC_AUTH_TOKEN="${TOKENLAB_API_KEY:?Set TOKENLAB_API_KEY first}" ANTHROPIC_API_KEY= claude --model claude-sonnet-4-6 "Explain this code" < main.py필요한 경우 설치를 확인하세요:
claude --version
claude doctor모델 선택
모델 페이지에서 현재 Claude 모델 ID를 복사한 후 --model 옵션과 함께 전달하세요:
ANTHROPIC_BASE_URL=https://api.tokenlab.sh ANTHROPIC_AUTH_TOKEN="${TOKENLAB_API_KEY:?Set TOKENLAB_API_KEY first}" ANTHROPIC_API_KEY= claude --model claude-sonnet-4-6 "Review this PR"확장된 사고 (Extended Thinking)
복잡한 추론 작업에는 확장된 사고(extended thinking) 기능을 갖춘 모델을 사용하세요:
ANTHROPIC_BASE_URL=https://api.tokenlab.sh ANTHROPIC_AUTH_TOKEN="${TOKENLAB_API_KEY:?Set TOKENLAB_API_KEY first}" ANTHROPIC_API_KEY= claude --model claude-opus-4-6 "Design a microservices architecture for..."동일한 에이전트에서 이미지 및 비디오 생성
Claude Code는 TokenLab MCP 서버를 사용하여 이미지와 짧은 비디오를 생성할 수도 있습니다. 각 생성 작업은 동일한 TokenLab 잔액에서 차감됩니다. TOKENLAB_API_KEY가 설정된 터미널에서 다음을 실행하세요:
claude mcp add \
--env TOKENLAB_MCP_TOOL_PROFILE=core \
--env TOKENLAB_API_KEY="$TOKENLAB_API_KEY" \
--scope user \
tokenlab -- \
npx -y @tokenlabai/mcp-server@0.6.48claude mcp list를 실행하여 tokenlab이 Connected로 표시되는지 확인하세요. 그런 다음 다음을 시도해 보세요:
Call get_model_pricing for nano-banana-2, then use create_image with nano-banana-2 at 1k to make a photo of a matte black coffee mug on a white desk.create_video는 작업 ID를 반환합니다. 에이전트는 비디오가 준비될 때까지 get_task_status를 호출합니다.