Claude Code를 LLM 게이트웨이에 연결

​

기존 구성 확인

​

Claude Code 직접 구성

• 게이트웨이의 기본 URL
• 자격 증명: 키 또는 토큰 문자열, 또는 하나를 가져오는 명령
  • 게이트웨이 팀이 어떤 종류의 자격 증명인지 말하지 않았다면, 아래의 자격 증명 변수 섹션에서 시도할 것을 다룹니다.

• 자격 증명 변수 설정 및 기본 URL 설정: 모든 게이트웨이 연결에 필요한 두 변수
• 연결 확인: 무엇이든 유지하기 전에 작동하는지 확인
• 각 표면 구성: Claude Code CLI 외에 VS Code와 같은 다른 표면을 사용하는 경우, 게이트웨이 자격 증명으로 구성하는 방법을 참조하세요.
• 추가 구성: 기본 URL과 자격 증명 외에 일부 게이트웨이가 필요로 하는 변수(예: 사용자 정의 헤더, 자격 증명 도우미, 모델 검색, 제공자 형식 기본 URL 또는 게이트웨이 경로 외부의 트래픽 끄기). 관리자가 명시한 경우에만 이를 설정하거나 네트워크가 송신을 제한합니다.

​

자격 증명 변수 설정

​

기본 URL과 자격 증명 설정

​

셸 환경 변수로 설정

export ANTHROPIC_BASE_URL=https://llm-gateway.example.com
export ANTHROPIC_AUTH_TOKEN=sk-gateway-key

$env:ANTHROPIC_BASE_URL = "https://llm-gateway.example.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-gateway-key"

​

설정 파일에서 설정

• ~/.claude/settings.json은 모든 프로젝트에 적용됩니다. Windows에서 경로는 %USERPROFILE%\.claude\settings.json입니다.
• .claude/settings.local.json은 한 프로젝트에 적용됩니다. Claude Code는 파일을 생성할 때 이를 gitignore에 추가합니다. 직접 생성하는 경우, 자격 증명을 실수로 커밋하지 않도록 먼저 gitignore에 수동으로 추가합니다.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://llm-gateway.example.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-gateway-key"
  }
}

​

연결 확인

curl -X POST "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "claude-sonnet-4-6", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

Invoke-RestMethod -Method Post -Uri "$env:ANTHROPIC_BASE_URL/v1/messages" `
  -Headers @{ "Authorization" = "Bearer $env:ANTHROPIC_AUTH_TOKEN"; "anthropic-version" = "2023-06-01" } `
  -ContentType "application/json" `
  -Body '{"model": "claude-sonnet-4-6", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

​

Claude Code에서 확인

​

자격 증명 변수가 헤더에 매핑되는 방식

​

기존 로그인과의 충돌

​

각 표면 구성

​

VS Code 확장

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://llm-gateway.example.com" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-gateway-key" }
  ]
}

​

데스크톱 앱

• 관리자가 배포함: 조직이 구성을 배포한 경우, 데스크톱 앱은 설정 없이 게이트웨이를 통해 라우팅합니다
• 로컬로 구성됨: 관리자가 배포한 구성이 없는 기기의 경우, 도움말 → 문제 해결 → 개발자 모드 활성화를 열면 앱이 개발자 메뉴와 함께 다시 시작됩니다. 그런 다음 개발자 → 타사 추론 구성 및 게이트웨이 기본 URL을 입력합니다. 관리자가 배포한 구성이 우선하며 이 양식을 읽기 전용으로 만듭니다

​

GitHub Actions

env:
  ANTHROPIC_BASE_URL: https://llm-gateway.example.com

steps:
  - uses: anthropics/claude-code-action@v1
    with:
      anthropic_api_key: ${{ secrets.GATEWAY_API_KEY }}

env:
  ANTHROPIC_BASE_URL: https://llm-gateway.example.com
  ANTHROPIC_AUTH_TOKEN: ${{ secrets.GATEWAY_API_KEY }}

steps:
  - uses: anthropics/claude-code-action@v1
    with:
      anthropic_api_key: ${{ secrets.GATEWAY_API_KEY }}

​

Agent SDK

• TypeScript: 생성된 프로세스는 기본적으로 부모 환경을 상속하지만, options.env를 설정하면 환경을 완전히 바꿉니다. 게이트웨이 변수를 유지하려면 process.env를 이에 펼치세요.
• Python: ClaudeAgentOptions(env=...)는 상속된 환경 위에 병합되므로, 부모 프로세스에서 설정된 게이트웨이 변수는 펼칠 필요 없이 통과합니다.

const result = query({
  prompt: "...",
  options: {
    env: {
      ...process.env,
      ANTHROPIC_BASE_URL: "https://llm-gateway.example.com",
      ANTHROPIC_AUTH_TOKEN: process.env.GATEWAY_KEY,
    },
  },
})

options = ClaudeAgentOptions(
    env={
        "ANTHROPIC_BASE_URL": "https://llm-gateway.example.com",
        "ANTHROPIC_AUTH_TOKEN": os.environ["GATEWAY_KEY"],
    }
)

​

Slack, 웹 및 Remote Control

• 음성 받아쓰기: 게이트웨이 자격 증명 설정 해제
• Remote Control: 게이트웨이 자격 증명 및 ANTHROPIC_BASE_URL 설정 해제

​

추가 구성

​

추가 헤더 전송

export ANTHROPIC_CUSTOM_HEADERS="X-Org-Route: prod"

$env:ANTHROPIC_CUSTOM_HEADERS = "X-Org-Route: prod"

{
  "env": {
    "ANTHROPIC_CUSTOM_HEADERS": "X-Org-Route: prod\nX-Tenant: example"
  }
}

​

게이트웨이 모델을 모델 선택기에 추가

​

apiKeyHelper로 자격 증명 회전

#!/bin/bash
vault kv get -field=api_key secret/llm-gateway/claude-code

{
  "apiKeyHelper": "~/bin/get-gateway-key.sh"
}

vault kv get -field=api_key secret/llm-gateway/claude-code

{
  "apiKeyHelper": "powershell -NoProfile -File C:\\scripts\\get-gateway-key.ps1"
}

​

게이트웨이 경로 외부의 트래픽 끄기

export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC = "1"

• 자동 업데이트를 비활성화하므로 패키지 관리자 또는 관리되는 배포와 같은 다른 업데이트 경로를 계획합니다.
• 빠른 모드 가용성 확인을 억제합니다. 이전 확인이 이미 머신에서 빠른 모드를 활성화하지 않은 한, /fast는 빠른 모드를 사용할 수 없다고 보고합니다.
• 게이트웨이 모델 검색을 끕니다. 검색이 게이트웨이 자체를 쿼리하더라도 말입니다. 이전에 검색된 모델은 로컬 캐시에서 사용 가능하게 유지되지만 목록은 새로 고쳐지지 않습니다.
• WebFetch 도구의 도메인 안전 확인은 영향을 받지 않으며 여전히 api.anthropic.com을 호출합니다. 네트워크가 해당 호스트를 차단하는 경우 설정에서 skipWebFetchPreflight: true로 별도로 끕니다.
• 각 원격 분석 스트림 및 이를 제어하는 변수는 원격 분석 서비스를 참조하세요.

​

게이트웨이를 통해 클라우드 제공자로 라우팅

​

Amazon Bedrock

export ANTHROPIC_BEDROCK_BASE_URL=https://llm-gateway.example.com/bedrock
export CLAUDE_CODE_SKIP_BEDROCK_AUTH=1
export CLAUDE_CODE_USE_BEDROCK=1

$env:ANTHROPIC_BEDROCK_BASE_URL = "https://llm-gateway.example.com/bedrock"
$env:CLAUDE_CODE_SKIP_BEDROCK_AUTH = "1"
$env:CLAUDE_CODE_USE_BEDROCK = "1"

​

Google Cloud의 Agent Platform

export ANTHROPIC_VERTEX_BASE_URL=https://llm-gateway.example.com/vertex
export ANTHROPIC_VERTEX_PROJECT_ID=your-gcp-project-id
export CLAUDE_CODE_SKIP_VERTEX_AUTH=1
export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=us-east5

$env:ANTHROPIC_VERTEX_BASE_URL = "https://llm-gateway.example.com/vertex"
$env:ANTHROPIC_VERTEX_PROJECT_ID = "your-gcp-project-id"
$env:CLAUDE_CODE_SKIP_VERTEX_AUTH = "1"
$env:CLAUDE_CODE_USE_VERTEX = "1"
$env:CLOUD_ML_REGION = "us-east5"

​

Microsoft Foundry

export ANTHROPIC_FOUNDRY_BASE_URL=https://llm-gateway.example.com/foundry
export ANTHROPIC_FOUNDRY_API_KEY=sk-gateway-key
export CLAUDE_CODE_USE_FOUNDRY=1

$env:ANTHROPIC_FOUNDRY_BASE_URL = "https://llm-gateway.example.com/foundry"
$env:ANTHROPIC_FOUNDRY_API_KEY = "sk-gateway-key"
$env:CLAUDE_CODE_USE_FOUNDRY = "1"

​

AWS의 Claude Platform

export ANTHROPIC_AWS_BASE_URL=https://llm-gateway.example.com/anthropic-aws
export ANTHROPIC_AWS_WORKSPACE_ID=wrkspc_01ABCDEFGHIJKLMN
export CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH=1
export CLAUDE_CODE_USE_ANTHROPIC_AWS=1

$env:ANTHROPIC_AWS_BASE_URL = "https://llm-gateway.example.com/anthropic-aws"
$env:ANTHROPIC_AWS_WORKSPACE_ID = "wrkspc_01ABCDEFGHIJKLMN"
$env:CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH = "1"
$env:CLAUDE_CODE_USE_ANTHROPIC_AWS = "1"

​

게이트웨이 오류 문제 해결

​

관련 리소스

• LLM 게이트웨이 개요: 게이트웨이가 무엇이고 claude.ai 구독과 어떻게 상호 작용하는지
• 조직을 위해 LLM 게이트웨이 배포: 게이트웨이 배포 및 배포 구성을 위한 관리자 대면 체크리스트
• 게이트웨이 프로토콜 참조: Claude Code가 게이트웨이에 전송하는 것(게이트웨이가 전달해야 하는 헤더 및 필드 포함)
• 설정: 설정 파일이 있는 위치 및 env 블록이 읽히는 방식
• 인증: 자격 증명 변수, apiKeyHelper 및 OAuth 로그인이 상호 작용하는 방식