Skip to main content
Claude Code는 요청을 보낼 위치를 결정하기 위해 두 가지 환경 변수를 읽습니다. ANTHROPIC_BASE_URL를 Tokios로 지정하고 Tokios API 키를 설정하면 Claude Code는 Ollama, LM Studio, llama.cpp, vLLM의 로컬 모델을 대상으로 실행됩니다. 모델을 실행 중인 머신뿐 아니라 어느 머신에서든, 모든 요청은 프라이빗 터널을 통해 사용자 자신의 하드웨어로 전달됩니다.

​
전제 조건

  • A running Tokios Connector paired with your local model — see Connector Install
  • A registered model deployment name — see Register a Model
  • A Tokios API key — see API Keys
  • Claude Code가 설치되어 있어야 합니다.

​
환경 설정

claude-code-windows.cmd
항상 --model를 등록된 모델 이름과 함께 전달하세요. Claude Code의 모델 선택기는 claude* ID만 나열하므로 Tokios 모델이 표시되지 않습니다. 이름을 명시적으로 지정하면 요청이 배포로 라우팅됩니다.

​
구성 저장

새 터미널 세션마다 변수를 내보내지 않으려면, 변수를 Claude Code 자체 설정 파일, 셸 프로필 또는 .env 파일에 추가하세요. ~/.claude/settings.json 가장 이식성이 높은 옵션으로, 셸이 아닌 Claude Code 구성과 함께 이동하기 때문입니다. 프로젝트 내에서 .claude/settings.json를 사용하면 해당 프로젝트로 범위를 지정할 수 있습니다.
~/.claude/settings.json
Claude Code는 시작 시 이 파일을 읽으므로, 이미 열려 있는 세션은 다시 시작하기 전까지 편집 내용을 반영하지 않습니다. 여기서 키가 거부되면 ANTHROPIC_API_KEY을(를) ANTHROPIC_AUTH_TOKEN(으)로 교체하세요. 그러면 자체 키를 발급하는 양식 게이트웨이가 기대하는 원시 Authorization: Bearer 값이 설정됩니다.
~/.bashrc 또는 ~/.zshrc 셸 프로필을 열고 다음을 추가하세요.
그런 다음 다시 불러오세요.
.env 파일 워크플로가 .env 파일을 지원하는 경우(예: direnv 또는 셸 플러그인을 통해), 프로젝트 루트에 .env를 생성하세요.
.env
Claude Code를 시작하기 전에 로드하세요.

​
연결 확인

Claude Code가 Tokios를 통해 로컬 모델에 도달하는지 확인하려면 간단한 일회성 프롬프트를 실행하세요.
예상 출력
응답이 표시되면 요청이 Tokios 게이트웨이를 통해 로컬 모델로 성공적으로 전달되고 있는 것입니다.
Claude Code는 Anthropic messages 형식으로 요청을 전송합니다. Tokios는 이를 로컬 백엔드가 기대하는 형식으로 변환하고 응답을 다시 스트리밍합니다.