Coding Agent 설정

Claude Code 설치 및 모델 설정

BetterToken API Key, Base URL, Model ID로 Claude Code를 연결하세요. 모델 설정 후 재시작하거나 세션에서 /model로 전환하세요.

BetterToken API Key, Base URL https://bettertoken.ai, 사용할 Model ID를 설정해 Claude Code를 연결하세요. 모델 광장에서 정확한 Model ID를 복사하세요.

주요 설정

필드	값
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai`
Model	`YOUR_MODEL_ID`

준비 사항

Claude Code 설치
BetterToken 자동 설정 스크립트를 사용한다면 Node.js 설치. npm으로 설치하려면 Node.js 22 이상 필요
BetterToken API Key 생성 및 복사

가입하고 BetterToken API Key 받기

이미 계정이 있나요? 로그인하고 잔액을 충전한 다음 콘솔에서 키를 만드세요.

설치하기

Anthropic은 Node.js가 필요 없는 네이티브 설치 프로그램을 권장합니다. npm을 사용하려면 Node.js 22 이상을 설치한 다음 실행하세요.

npm install -g @anthropic-ai/claude-code

명령줄 설정

BetterToken 자동 설정 스크립트는 Claude Code 제공자 설정을 작성합니다. Node.js가 필요하며 API Key를 인수로 전달하지 않으면 직접 입력하라는 메시지가 표시됩니다.

macOS / Linux

curl -fsSL "https://bettertoken.ai/install-claudecode-provider.sh" | bash

Windows

iwr "https://bettertoken.ai/install-claudecode-provider.ps1" -OutFile "$env:TEMP\install-claudecode-provider.ps1"; powershell -ExecutionPolicy Bypass -File "$env:TEMP\install-claudecode-provider.ps1"

완료되면 ~/.claude/settings.json을 확인하세요. Windows에서는 %USERPROFILE%\.claude\settings.json을 확인합니다. 그런 다음 Claude Code를 완전히 다시 시작하세요. 각 필드를 직접 제어하려면 아래 수동 설정을 사용하세요.

수동 설정

시스템	파일
macOS / Linux	`~/.claude/settings.json`
Windows	`%USERPROFILE%\.claude\settings.json`

모델 광장에서 정확한 Model ID를 복사하세요.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://bettertoken.ai",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "API_TIMEOUT_MS": "3000000",
    "ANTHROPIC_MODEL": "YOUR_MODEL_ID",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "YOUR_MODEL_ID",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "YOUR_MODEL_ID",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "YOUR_MODEL_ID"
  }
}

YOUR_MODEL_ID를 복사한 ID로 바꾸세요. ANTHROPIC_MODEL은 기본 모델을, 세 개의 ANTHROPIC_DEFAULT_*_MODEL 변수는 Haiku, Sonnet, Opus 별칭을 설정합니다. 같은 모델이나 역할별로 다른 모델을 지정할 수 있습니다.

예제에는 선택 설정인 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1이 포함되어 있습니다. 자동 업데이트, 오류 보고, 일부 가용성 검사와 계정 기능을 끄며 인증에는 필요하지 않습니다. 수동으로 업데이트하려면 claude update를 실행하거나 설치에 사용한 패키지 관리자를 사용하세요. 업데이트 방법과 설정의 영향을 확인하세요.

VS Code 확장

확장 프로그램은 VS Code의 settings.json을 사용합니다. 별도의 claudeCode.environmentVariables 설정을 추가하세요.

{
  "claudeCode.environmentVariables": [
    {
      "name": "ANTHROPIC_BASE_URL",
      "value": "https://bettertoken.ai"
    },
    {
      "name": "ANTHROPIC_AUTH_TOKEN",
      "value": "YOUR_API_KEY"
    },
    {
      "name": "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC",
      "value": "1"
    },
    {
      "name": "API_TIMEOUT_MS",
      "value": "3000000"
    },
    {
      "name": "ANTHROPIC_MODEL",
      "value": "YOUR_MODEL_ID"
    },
    {
      "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL",
      "value": "YOUR_MODEL_ID"
    },
    {
      "name": "ANTHROPIC_DEFAULT_SONNET_MODEL",
      "value": "YOUR_MODEL_ID"
    },
    {
      "name": "ANTHROPIC_DEFAULT_OPUS_MODEL",
      "value": "YOUR_MODEL_ID"
    }
  ]
}

연결 확인

프로젝트에서 Claude Code를 시작하세요.

claude

짧은 메시지를 보내세요. 401, 연결 오류, 모델 오류 없이 정상 응답이 오면 설정이 완료된 것입니다. 대화형 세션에서 /status를 실행하고 두 항목을 확인하세요.

Anthropic base URL 행에 BetterToken의 Base URL인 https://bettertoken.ai이 표시되어야 합니다. 이 행이 없으면 변수가 현재 세션에 전달되지 않은 것입니다. settings.json 경로를 확인하고 Claude Code를 완전히 다시 시작하세요.
인증 행에는 claude.ai 계정 로그인이 아닌 ANTHROPIC_AUTH_TOKEN이 표시되어야 합니다.

스크립트에서 연결을 확인하려면 짧은 프롬프트를 보내세요.

claude -p "Reply with only: OK"

정상적으로 OK가 반환되면 연결이 작동하는 것입니다.

기존 로그인과의 충돌

환경 변수의 인증 정보는 저장된 claude.ai 로그인보다 우선합니다. 시작할 때 인증 정보 출처가 두 개라는 경고가 표시되면 하나를 해제하세요. BetterToken API Key만 유지하려면 /logout을 실행하세요. 셸에 ANTHROPIC_API_KEY도 설정되어 있다면 먼저 해제하세요.

모델 전환

설정에서 Model ID를 변경하고 Claude Code를 다시 시작하세요. 세션 중에는 /model YOUR_MODEL_ID로 전환하세요.

ANTHROPIC_DEFAULT_FABLE_MODEL로 설정하는 fable 등 다른 별칭은 공식 별칭 매핑에 따라 사용 가능한 Model ID를 지정하세요. Claude Code가 사용자 지정 ID의 컨텍스트 창을 잘못 판단하면 사용자 지정 모델 창 설정 안내에 따라 모델의 확인된 한도를 설정하세요.

/model에 BetterToken 모델 표시하기(선택 사항)

최신 Claude Code 버전을 사용하세요. ~/.claude/settings.json의 기존 env 블록에 "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1"을 추가한 뒤 Claude Code를 완전히 다시 시작하세요. 시작할 때 Claude Code가 https://bettertoken.ai의 /v1/models에 요청하여 사용 가능한 모델을 조회합니다. 공식 게이트웨이 설정 가이드를 참고하세요.

모델 검색이 성공했는지 확인하려면 claude --debug를 실행하고 ~/.claude/debug/<session-id>.txt에서 [gatewayDiscovery]가 포함된 로그를 찾으세요. 모델이 캐시되었다는 로그가 있으면 검색에 성공한 것입니다.

Claude Code는 게이트웨이 프로토콜에 설명된 대로 Model ID에 claude 또는 anthropic이 포함된 게이트웨이 모델만 표시합니다(대소문자 구분 없음). /v1/models에서 반환된 다른 모델은 GPT 모델을 포함해 BetterToken에서 제공하더라도 /model에 표시되지 않습니다. Model ID를 직접 설정하면 Claude Code에서 이러한 모델을 호출할 수 있습니다. Claude Code 2.1.309 테스트에서는 이 방식으로 지정한 GPT 모델이 Anthropic Messages를 통해 텍스트 요청과 파일 읽기 요청에 응답했습니다.

흔한 오류

오류	해결 방법
`401` 또는 인증 실패	`ANTHROPIC_AUTH_TOKEN`을 확인하고 API Key 앞뒤의 공백을 제거하세요.
`ConnectionRefused`	`https://bettertoken.ai`을 정확히 사용하고 `/v1`을 추가하지 마세요.
Model ID	모델 광장에서 정확한 Model ID를 확인하고 클라이언트의 모델 설정에 입력하세요.
설정이 적용되지 않음	파일 경로를 확인하고 충돌하는 환경 변수를 제거한 뒤 Claude Code를 완전히 다시 시작하세요.
시작할 때 두 인증 정보 출처가 충돌한다는 경고	하나를 해제하거나 `/logout`을 실행하세요.
인증서 / TLS 오류, 기업 프록시에서 자주 발생	`NODE_EXTRA_CA_CERTS`를 CA 인증서 파일 경로로 설정하고 Claude Code를 다시 시작하세요.
`400`과 함께 `Extra inputs are not permitted` 등 알 수 없는 필드에 대한 메시지	`env`에 `"CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"`을 추가하고 Claude Code를 완전히 다시 시작하세요. 오류가 계속되면 지원팀에 문의하세요.
긴 세션에서 컨텍스트가 너무 길다는 메시지	`/compact`를 실행하여 세션을 압축하세요.

API Key 사용 시 이용할 수 없는 기능

원격 제어(Remote Control)와 음성 입력에는 claude.ai 계정 로그인이 필요합니다. BetterToken API Key와 사용자 지정 Base URL을 사용하면 이용할 수 없습니다. 이는 Claude Code 클라이언트의 제한이며 일반적인 코딩 대화에는 영향을 주지 않습니다.