Claude Code

Claude Code는 터미널에서 코드베이스를 읽고 고치며 명령을 실행하는 코딩 에이전트입니다. ANTHROPIC_BASE_URL만 PleumRouter로 바꾸면 Claude Code는 평소처럼 Anthropic Messages 프로토콜(/v1/messages)로 요청하고, PleumRouter가 이를 받아 모델로 보냅니다. 별도 프록시는 필요 없습니다. 데스크톱 앱은 Claude Desktop을 보세요.

빠른 시작#

1. 1

   Claude Code 설치

   이미 설치했다면 건너뛰세요. 네이티브 설치를 권장하며, npm 설치는 Node.js가 필요합니다.

   네이티브 (권장)npm

   install.sh복사

   macOS·Linux·WSL은 curl, Windows는 PowerShell 명령을 쓰세요.

   # macOS · Linux · WSL
   curl -fsSL https://claude.ai/install.sh | bash
   
   # Windows PowerShell
   irm https://claude.ai/install.ps1 | iex
   
   claude --version

2. 2

   API 키 발급

   대시보드의 API 키 페이지에서 plm_로 시작하는 키를 만들어 복사하세요. 처음에는 일·주·월 예산을 함께 걸어 두는 것을 권장합니다.

3. 3

   PleumRouter로 연결

   세 가지 중 하나만 고르세요. 필요한 값은 주소(ANTHROPIC_BASE_URL), 키(ANTHROPIC_AUTH_TOKEN), 그리고 반드시 비워 둘 ANTHROPIC_API_KEY 세 개입니다. 모델은 따로 정하지 않아도 Claude Code의 기본 Claude 모델로 동작합니다.

   pleum launch (자동)셸 프로필settings.json

   pleum launch복사

   설정 파일을 건드리지 않고 이번 실행에만 적용합니다.

   npm i -g pleumrouter
   pleum login            # sign in with the browser
   pleum launch claude    # runs Claude Code pointed at PleumRouter

4. 4

   저장된 Claude 로그인 지우기

   예전에 Claude 계정으로 로그인한 적이 있다면 /logout을 한 번 실행하고 Claude Code를 다시 시작하세요. 로그인 정보와 PleumRouter 키가 함께 있으면 인증 충돌 경고가 뜨고 모델을 찾지 못하는 오류로 이어질 수 있습니다. 로그인한 적이 없다면 건너뛰세요.

   Claude Code복사

   > /logout
   
   # then quit and start claude again

5. 5

   실행하고 확인

   /status에 Auth token: ANTHROPIC_AUTH_TOKEN과 PleumRouter 주소가 보이면 연결된 것입니다. Login method에 Claude 계정이 보이면 환경변수가 적용되지 않은 것이니 터미널을 새로 열어 다시 실행하세요. 요청 내역은 사용량에서 바로 확인할 수 있습니다.

   Terminal복사

   cd your-project
   claude
   
   > /status
   Auth token: ANTHROPIC_AUTH_TOKEN
   Anthropic base URL: https://apirouter.pleum.ai

Claude Code에서 PleumRouter를 쓰는 이유#

• 선불 크레딧으로 사용한 만큼만 결제합니다. 도구 제작사의 구독과 별개로 크레딧이 차감됩니다.
• 키마다 예산과 한도를 겁니다. API 키별 일·주·월 예산과 모델 허용 목록, 팀 예산으로 에이전트의 비용을 관리합니다.
• 한 키로 여러 모델을 씁니다. Claude·GPT·Gemini·오픈 모델을 골라 쓰고, 공급자 장애 시 자동 재시도·폴백이 동작하며, 사용량은 대시보드에서 봅니다.

작동 방식#

Claude Code는 ANTHROPIC_BASE_URL이 가리키는 서버에 Anthropic Messages 형식(POST /v1/messages)으로 요청합니다. PleumRouter는 이 형식을 그대로 받아 스트리밍(SSE)·도구 호출·이미지·캐시 표시·생각 강도(/effort)를 고른 모델의 공급자 형식으로 바꿔 보내고, 응답을 다시 Anthropic 형식으로 돌려줍니다. 인증에는 ANTHROPIC_AUTH_TOKEN(Authorization: Bearer)을 씁니다. ANTHROPIC_API_KEY를 비워 두는 이유는, 값이 있으면 Claude Code가 이를 Anthropic 직접 키(x-api-key)로 다뤄 저장된 로그인과 충돌할 수 있기 때문입니다. 사용한 만큼 PleumRouter 크레딧에서 차감되며, 사고(thinking) 토큰도 출력 토큰에 포함돼 청구됩니다.

설정 레퍼런스#

모델 선택#

따로 정하지 않으면 Claude Code는 자기 기본 Claude 모델 ID로 요청하고, PleumRouter가 이를 카탈로그의 같은 모델로 연결합니다. 다른 모델을 쓰거나 버전을 고정하려면 슬롯 변수에 모델 카탈로그의 ID를 넣으세요. claude-sonnet-latest처럼 -latest를 붙이면 그 계열의 최신 릴리스로, claude-opus-5-5@anthropic처럼 @공급자를 붙이면 그 공급자로만 보냅니다(이때는 다른 공급자로의 자동 폴백이 꺼집니다). 1M 컨텍스트 모델이라면 ID 끝에 [1m]을 붙이세요. 이 표시가 없으면 Claude Code는 200K로 가정해 대화를 일찍 압축합니다. PleumRouter는 이 표시를 떼고 라우팅합니다.

# Optional — catalog IDs from router.pleum.ai/models
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-5-5"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5[1m]"   # [1m] = 1M context
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"
export ANTHROPIC_DEFAULT_FABLE_MODEL="claude-fable-5-1"
export CLAUDE_CODE_SUBAGENT_MODEL="claude-sonnet-5"

# Newest release of a family, or one provider only:
# export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-latest"
# export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-5-5@anthropic"

지원 범위#

- name: Run Claude Code
  uses: anthropics/claude-code-action@v1
  with:
    anthropic_api_key: ${{ secrets.PLEUM_API_KEY }}
  env:
    ANTHROPIC_BASE_URL: https://apirouter.pleum.ai
    ANTHROPIC_AUTH_TOKEN: ${{ secrets.PLEUM_API_KEY }}

문제 해결#

비용·보안 팁#

• 키에 예산을 걸어 두세요. 코딩 에이전트는 한 작업에서 모델을 여러 번 호출하고 긴 컨텍스트를 반복해 보냅니다. API 키에 일·주·월 예산을 설정하면 비용을 예측하기 쉽습니다.
• 키는 git에 올리지 마세요. 셸 프로필이나 설정 파일에 넣은 키가 저장소에 커밋되지 않게 하고, 유출이 의심되면 대시보드에서 바로 폐기한 뒤 새로 발급하세요.
• 민감한 코드라면 처리 위치를 확인하세요. 프롬프트와 코드는 고른 모델의 공급자에게 전달됩니다. 데이터 처리 위치와 개인정보 마스킹으로 범위를 정할 수 있습니다.