Claude Code & Agent Tools 연동

Claude Code, OpenClaw, Cline, Roo Code 및 모든 Anthropic-protocol 클라이언트를 TokenHub에 연결하세요.

Anthropic-Native다중 제공자 폴백하나의 Key, 두 프로토콜

1. TokenHub가 Anthropic와 통신하는 방식

TokenHub는 두 프로토콜을 동시에 제공합니다. 동일한 th- key가 둘 다에서 동작하며, 과금, 사용량, 지출 한도, provider fallback이 통합되어 있습니다.

프로토콜	엔드포인트	Base URL(클라이언트에 붙여넣으세요)	대표 클라이언트
OpenAI-compatible	POST /v1/chat/completions	https://tokenhub.store/api/v1	openai SDK, LiteLLM, LangChain
Anthropic-native	POST /v1/messages	https://tokenhub.store/api	Claude Code, OpenClaw, Cline, Roo Code, anthropic SDK

2. 사용 가능한 Claude 모델

아래 ID 중 하나를 ANTHROPIC_MODEL 또는 model 필드로 사용하세요. anthropic/ 접두사는 선택 사항이며, TokenHub는 두 형식을 모두 지원합니다.

모델 ID	티어	입력 ($/1M)	출력 ($/1M)
claude-opus-4-7	가장 강력함	$5.00	$25.00
claude-opus-4-6	주력 flagship	$5.00	$25.00
claude-sonnet-4-6	운영 기본값	$3.00	$15.00
claude-haiku-4-5	경량, 고QPS	$1.00	$5.00
claude-opus-4-5	주력 flagship	$5.00	$25.00
claude-sonnet-4-5	운영 기본값	$3.00	$15.00

3. 3단계 빠른 시작

지원되는 모든 클라이언트는 결국 이 세 값으로 설정됩니다. 이 페이지의 나머지 내용은 어디에 입력하는지만 안내합니다.

1
Base URL → https://tokenhub.store/api
2
인증 헤더 → TokenHub th- key(Anthropic key 아님)
3
ANTHROPIC_API_KEY=""SDK가 api.anthropic.com으로 폴백하지 않도록 ANTHROPIC_API_KEY=""를 명시적으로 설정하세요

4. 클라이언트별 설정

설치

# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# or via npm
npm install -g @anthropic-ai/claude-code

옵션 A — 셸 환경 변수(전역)

# ~/.zshrc or ~/.bashrc
export ANTHROPIC_BASE_URL="https://tokenhub.store/api"
export ANTHROPIC_AUTH_TOKEN="th-your-tokenhub-key"
export ANTHROPIC_MODEL="claude-opus-4-6"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"
export ANTHROPIC_API_KEY=""    # must be empty, otherwise SDK falls back to api.anthropic.com

# then reopen the terminal and run:
cd /path/to/your/project
claude

옵션 B — 프로젝트 수준 설정

.claude/settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://tokenhub.store/api",
    "ANTHROPIC_AUTH_TOKEN": "th-your-tokenhub-key",
    "ANTHROPIC_MODEL": "claude-opus-4-6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5",
    "ANTHROPIC_API_KEY": ""
  }
}

/status로 확인

> /status
Auth token:        ANTHROPIC_AUTH_TOKEN
Anthropic base URL: https://tokenhub.store/api

기본 URL이 계속 api.anthropic.com으로 표시되면 — ANTHROPIC_API_KEY가 비어 있지 않거나, 터미널을 다시 시작하지 않았거나, VSCode 통합 터미널이 이전 env를 상속한 것입니다.

5. curl 자체 테스트

비스트리밍

curl -sS https://tokenhub.store/api/v1/messages \
  -H "x-api-key: th-your-tokenhub-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4-6",
    "max_tokens": 128,
    "messages": [{"role":"user","content":"say hi"}]
  }'

스트리밍 SSE

curl -N -sS https://tokenhub.store/api/v1/messages \
  -H "x-api-key: th-your-tokenhub-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-opus-4-6","stream":true,"max_tokens":128,"messages":[{"role":"user","content":"count 1 to 3"}]}'

이벤트 순서: message_start → content_block_start → content_block_delta* → content_block_stop → message_delta → message_stop.

저장소 스모크 테스트 스크립트

한 번에 6개 검증을 실행합니다(비-stream / Bearer / SSE 순서 / 인증 오류 / 지원되지 않는 model / function calling).

BASE_URL=https://tokenhub.store TOKENHUB_API_KEY=th-xxxx \
  bash scripts/test-messages-api.sh

6. 문제 해결 치트시트

증상	가장 가능성 높은 원인	해결 방법
401 / authentication_error	x-api-key가 전송되지 않았거나, Anthropic 공식 key가 전달됨	TokenHub th- key를 사용하세요
402 / permission_error	계정 잔액이 0이거나 key의 spend cap이 소진됨	Dashboard → Billing에서 충전하거나 key의 spend cap을 제거하세요
400 'model not supported'	Model ID 오타 / 대소문자 오류	§2를 확인하세요 — bare 또는 anthropic/ 접두사 모두 허용됩니다
503 'No upstream API key'	이 model의 upstream key가 아직 프로비저닝되지 않았습니다	지원팀에 문의하세요
stream이 중간에 끊김	클라이언트 HTTP 유휴 타임아웃이 너무 짧음	유휴 타임아웃을 ≥ 120s로 늘리세요
/status에 여전히 api.anthropic.com이 표시됨	ANTHROPIC_API_KEY가 해제되지 않았거나, 터미널을 다시 시작하지 않음	export ANTHROPIC_API_KEY=""를 실행한 뒤 터미널을 다시 여세요
도구 호출이 일반 텍스트를 반환함	tool_use 지원이 약한 upstream으로 라우팅됨	claude-opus-4-6 / claude-sonnet-4-6로 전환하거나 지원팀에 문의하세요

7. FAQ

다른 내용을 찾고 계신가요?

openai SDK로 Claude를 호출하는 경우에는 OpenAI-compatible 가이드를 사용하세요.

Claude API (OpenAI-compatible) →