메인 콘텐츠로 건너뛰기
Claude Code는 Anthropic의 에이전트 코딩용 CLI 도구입니다. 이 가이드는 Venice AI를 통해 토큰 단위 결제로 Claude Opus 4.5/4.6 및 Sonnet 4.5/4.6을 사용하는 방법을 보여줍니다.

토큰 단위 결제

구독 없이 사용한 만큼만 지불

Claude 모델

Venice를 통해 Opus 4.5/4.6 및 Sonnet 4.5/4.6에 접근

Prompt 캐싱

Venice 캐싱이 Claude Code와 함께 작동

​
라우터가 필요한 이유

Claude Code는 기본적으로 Anthropic API에 직접 연결됩니다. Venice와 함께 사용하려면 다음 작업을 수행하는 오픈소스 로컬 프록시인 claude-code-router가 필요합니다:

가로채기

Claude Code의 outgoing 요청이 Anthropic에 도달하기 전에 잡아냅니다

변환

요청 포맷을 변환하고 모델 ID(예: claude-opus-4-5)를 매핑합니다

리다이렉트

요청을 Venice의 api.venice.ai/api/v1/chat/completions로 전달합니다

​
사전 요구사항

Venice 계정

API 크레딧이 있는 계정

Node.js

v18 이상

Claude Code

npm으로 설치된 상태

​
설정

1

Claude Code 설치

아직 설치하지 않았다면 Anthropic의 Claude Code CLI를 설치하세요:
npm install -g @anthropic-ai/claude-code
2

라우터 설치

npm install -g @musistudio/claude-code-router
3

API 키 발급

venice.ai/settings/api에서 키를 생성하세요. 다음 단계에서 설정 파일에 직접 붙여넣게 됩니다.
4

설정 파일 생성

config 디렉터리를 만드세요:
mkdir -p ~/.claude-code-router
그런 다음 원하는 에디터로 ~/.claude-code-router/config.json을 만드세요:
# nano 사용
nano ~/.claude-code-router/config.json

# 또는 VS Code 사용
code ~/.claude-code-router/config.json
다음 설정을 붙여넣으세요:
{
  "APIKEY": "",
  "LOG": true,
  "LOG_LEVEL": "info",
  "API_TIMEOUT_MS": 600000,
  "HOST": "127.0.0.1",
  "Providers": [
    {
      "name": "venice",
      "api_base_url": "https://api.venice.ai/api/v1/chat/completions",
      "api_key": "your-venice-api-key-here",
      "models": [
        "claude-opus-4-5",
        "claude-sonnet-4-5",
        "claude-opus-4-6",
        "claude-opus-4-6-fast",
        "claude-sonnet-4-6"
      ],
      "transformer": {
        "use": ["anthropic"]
      }
    }
  ],
  "Router": {
    "default": "venice,claude-opus-4-5",
    "think": "venice,claude-opus-4-5",
    "background": "venice,claude-opus-4-5",
    "longContext": "venice,claude-opus-4-5",
    "longContextThreshold": 100000
  }
}
라우터 실행 중에 config.json을 수정한 경우 ccr restart로 재시작해 변경 사항을 적용하세요.
5

실행

라우터를 시작한 다음 Claude Code를 실행하세요:
ccr start
ccr code
또는 activate 방식을 사용하세요:
eval "$(ccr activate)" && claude

​
지원 모델

ModelVenice IDBest For
Claude Opus 4.5claude-opus-4-5복잡한 추론, 대규모 리팩토링
Claude Sonnet 4.5claude-sonnet-4-5빠른 반복, 일상적인 코딩
Claude Opus 4.6claude-opus-4-6복잡한 추론, 대규모 리팩토링
Claude Opus 4.6 Fastclaude-opus-4-6-fast더 낮은 지연 시간으로 복잡한 추론
Claude Sonnet 4.6claude-sonnet-4-6빠른 반복, 일상적인 코딩
Claude Code는 Claude 모델에 최적화되어 있습니다. Venice를 통해 제공되는 다른 모델(GPT, DeepSeek, Grok 등)도 동작할 수 있지만, Claude Code는 extended thinking 등 Claude 고유 기능에 의존하므로 동일한 경험을 보장할 수는 없습니다. 다른 모델의 경우 Venice의 표준 API 사용을 고려하세요.

​
라우터 기능

라우터는 기본 라우팅 외에도 몇 가지 유용한 기능을 제공합니다:
Claude Code 내부에서 /model 명령으로 재시작 없이 모델을 전환할 수 있습니다:
/model venice,claude-sonnet-4-5
복잡한 작업에는 Opus, 빠른 반복에는 Sonnet 같은 식으로 활용하기 좋습니다.
GUI를 선호하시나요? 웹 기반 설정 편집기를 실행하세요:
ccr ui
파일을 직접 만지지 않고 config.json을 편집할 수 있는 브라우저 인터페이스가 열립니다.
Router 설정 섹션은 어떤 모델이 어떤 작업 유형을 처리할지 제어합니다:
ScenarioWhen it’s used
default일반 요청
think추론이 많은 작업(Plan Mode)
background백그라운드 작업
longContextcontext가 longContextThreshold 토큰을 초과할 때
각 시나리오를 다른 모델로 라우팅할 수 있습니다. 예를 들어 백그라운드 작업에는 Sonnet을 사용해 비용을 절약할 수 있습니다.
동작이 잘 안 된다면 로그를 확인하세요:
# 서버 로그 (HTTP, API 호출)
~/.claude-code-router/logs/ccr-*.log

# 애플리케이션 로그 (라우팅 결정)
~/.claude-code-router/claude-code-router.log
더 자세한 출력을 보려면 설정에서 "LOG_LEVEL": "debug"로 설정하세요.

​
캐싱 동작

Venice prompt 캐싱은 Claude Code의 네이티브 캐시 마커와 함께 동작합니다. Venice는 Claude Code가 cache_control 필드를 보낼 때 이를 자동으로 감지하고 캐싱 전략을 그에 맞게 조정합니다.
ScenarioCache TTLWho Controls
기본(권장)5분Claude Code + Venice
cleancache transformer 사용1시간Venice 단독
기본 설정은 두 시스템이 협력하도록 합니다:
  • Claude Code가 네이티브 cache_control 마커를 전송
  • Venice가 5분 TTL로 그 주변에 캐싱을 추가
  • 두 시스템이 4블록 캐시 한도를 공유
빈번한 요청이 발생하는 활발한 코딩 세션에 잘 맞습니다.
다음 경우에는 transformer에 cleancache를 추가하세요:
  • 4블록 캐시 한도 에러를 만나는 경우
  • 이상한 캐싱 동작을 경험하는 경우
  • 더 긴 세션을 위해 Venice의 1시간 TTL을 선호하는 경우
"transformer": {
  "use": ["anthropic", "cleancache"]
}
이렇게 하면 Claude Code의 캐시 마커가 제거되고 Venice가 더 긴 TTL로 완전한 제어권을 갖습니다.

​
리소스

Venice API 문서

전체 API 레퍼런스

claude-code-router

소스 코드 및 이슈