Claude Code 설치됨
공식 소스에서 Claude Code를 설치하고 터미널의 claude 명령으로 실행되는지 확인하세요.
Claude Code
Claude Code API 키 설정
Claude Code는 두 개의 환경 변수로 요청을 어디로든 라우팅합니다: ANTHROPIC_BASE_URL과 ANTHROPIC_API_KEY. RunAPI로 설정하면 공식 요금의 절반으로 모든 Claude 모델을 실행합니다. 이 가이드는 정확한 명령을 보여줍니다.
June 18, 2026 업데이트
RunAPI 편집팀
한눈에 보기
Claude Code에서 커스텀 API 키를 어떻게 설정하나요?
Claude Code는 두 개의 환경 변수를 사용하여 요청이 어디로 가고 어떻게 인증하는지 결정합니다. RunAPI 값으로 설정하면 모든 요청이 50% 할인으로 RunAPI를 통해 라우팅됩니다. 아래 카드는 전체 안내 전에 필수 사항을 다룹니다.
두 변수
ANTHROPIC_BASE_URL이 엔드포인트를 설정합니다. ANTHROPIC_API_KEY가 키를 설정합니다. 이것이 전체 설정입니다.
엔드포인트 값
Claude Code가 RunAPI를 통해 라우팅되도록 ANTHROPIC_BASE_URL을 https://api.runapi.ai로 설정하세요.
지속하기
매 세션마다 재설정하지 않도록 두 내보내기를 셸 프로파일 또는 .claude.json에 추가하세요.
50% 할인
모든 Claude 모델이 공식 Anthropic 요금의 절반으로 청구됩니다. 구독 없음, 한도 없음.
시작하기 전에
Claude Code를 설정하기 전에 무엇이 필요한가요?
설정은 몇 분이 걸립니다. Claude Code가 설치되어 있고, RunAPI 계정과 터미널이 필요합니다. 아래 목록은 첫 번째 명령 전에 필요한 모든 것을 다룹니다.
RunAPI 계정
runapi.ai에서 가입하세요. 무료 티어에는 잔액을 충전하기 전에 모든 Claude 모델을 테스트할 수 있는 크레딧이 포함됩니다.
API 키
대시보드 → API 키에서 키를 생성하세요. 한 번만 복사하세요 — 생성 시에만 전체 키가 표시됩니다.
터미널 접근
환경 변수를 설정하려면 셸이 필요합니다. macOS, Linux, Windows의 WSL 모두 동일하게 작동합니다.
단계별
RunAPI로 Claude Code API 키를 설정하는 방법
순서대로 이 명령을 실행하세요. 엔드포인트와 키를 설정하고, 셸 프로파일에 지속시키며, Claude Code가 이를 선택하는지 확인합니다. 플레이스홀더를 실제 RunAPI 키로 교체하세요.
1
기본 URL 설정하기
이것은 Claude Code가 기본 Anthropic 엔드포인트 대신 RunAPI로 요청을 보내도록 알려줍니다.
export ANTHROPIC_BASE_URL=https://api.runapi.ai
2
API 키 설정하기
플레이스홀더 대신 RunAPI 키를 붙여넣으세요. Claude Code는 이를 사용하여 모든 요청을 인증합니다.
export ANTHROPIC_API_KEY=sk-your-runapi-key
3
두 변수 지속하기
새 터미널 세션에서 유지되도록 두 내보내기를 ~/.zshrc (또는 ~/.bashrc)에 추가하세요. source ~/.zshrc로 다시 로드하세요.
echo 'export ANTHROPIC_BASE_URL=https://api.runapi.ai' >> ~/.zshrc
4
설정 확인하기
변수가 RunAPI URL을 출력하는지 확인하세요. 비어 있으면 셸 프로파일을 다시 로드하거나 새 터미널을 여세요.
echo $ANTHROPIC_BASE_URL
5
Claude Code 실행하기
프로젝트에서 Claude Code를 실행하세요. 이제 공식 요금의 50% 할인으로 RunAPI를 통해 라우팅됩니다.
claude환경 변수
Claude Code가 읽는 환경 변수는 무엇인가요?
Claude Code는 엔드포인트, 인증, 모델, 출력 길이를 제어하는 소수의 변수를 읽습니다. 표는 커스텀 엔드포인트 설정에 중요한 변수와 각각의 역할을 나열합니다.
| 변수 | 목적 | 예시 값 |
|---|---|---|
| ANTHROPIC_BASE_URL | Claude Code가 요청을 보내는 커스텀 엔드포인트 | https://api.runapi.ai |
| ANTHROPIC_API_KEY | 요청 인증에 사용되는 키 | sk-your-runapi-key |
| ANTHROPIC_MODEL | 새 세션의 기본 모델 | claude-sonnet-4-6 |
| CLAUDE_CODE_MAX_OUTPUT_TOKENS | 응답당 반환되는 토큰 한도 | 8192 |
매 세션마다 내보내는 대신 홈 또는 프로젝트 디렉토리의 .claude.json 설정 파일에 이를 저장할 수도 있습니다.
모델 선택하기
Claude Code에서 어떤 Claude 모델을 실행해야 하나요?
Claude Code는 RunAPI를 통해 모든 Claude 모델 ID를 허용합니다. 작업별로 선택하세요: 루틴 편집에는 빠르고 저렴한 모델, 일상 코딩에는 균형 잡힌 모델, 어려운 문제에는 가장 강력한 모델.
claude-haiku-4-5
RunAPI를 통해 입력 $1/M, 출력 $5/M으로 가장 빠르고 저렴합니다. 루틴 편집과 빠른 조회에 최적.
claude-sonnet-4-6
RunAPI를 통해 입력 $3/M, 출력 $15/M으로 일상 코딩의 균형 잡힌 기본값. 대부분의 개발자가 이것을 사용합니다.
claude-opus-4-7
RunAPI를 통해 입력 $5/M, 출력 $25/M으로 어려운 문제에 가장 강력합니다. 복잡한 리팩토링과 검토에 사용하세요.
언제든지 전환하기
ANTHROPIC_MODEL을 설정하거나 Claude Code 내에서 모델을 변경하세요. 청구는 실제로 호출하는 모델을 따르며, 모두 50% 할인입니다.
일반적인 오류 수정하기
Claude Code API 키가 작동하지 않는 이유는 무엇인가요?
대부분의 설정 문제는 설정되지 않은 변수, 오래된 셸, 또는 키의 오타에서 발생합니다. 표는 일반적인 오류와 각각의 수정 방법을 나열합니다.
| 오류 또는 증상 | 가능한 원인 | 수정 방법 |
|---|---|---|
| 401 Unauthorized | 잘못되거나 만료된 API 키 | ANTHROPIC_API_KEY를 다시 확인하고 필요한 경우 RunAPI 대시보드에서 새 키를 생성하세요 |
| 요청이 여전히 Anthropic에 도달 | 이 셸에서 ANTHROPIC_BASE_URL이 설정되지 않음 | echo $ANTHROPIC_BASE_URL을 실행하고; 비어 있으면 프로파일을 다시 로드하거나 새 터미널을 여세요 |
| 404 Not Found | 기본 URL의 뒤쪽 슬래시 또는 잘못된 경로 | 기본 URL을 정확히 https://api.runapi.ai로 설정하고 뒤쪽 경로 없이 설정하세요 |
| 모델을 찾을 수 없음 | 잘못되거나 잘못 입력된 모델 ID | claude-sonnet-4-6 또는 claude-opus-4-7 같은 유효한 ID를 사용하세요 |
| 재시작 시 변수 손실 | 셸 프로파일에 내보내기가 작성되지 않음 | 두 내보내기를 ~/.zshrc 또는 ~/.bashrc에 추가하고 다시 로드하세요 |
빠른 버전
네 단계로 Claude Code API 키 설정하기
1
기본 URL 설정하기
ANTHROPIC_BASE_URL=https://api.runapi.ai를 내보내 RunAPI를 통해 요청을 라우팅하세요.
2
API 키 설정하기
대시보드 → API 키에서 RunAPI 키로 ANTHROPIC_API_KEY를 내보내세요.
3
두 변수 지속하기
두 내보내기를 ~/.zshrc 또는 ~/.bashrc에 추가하고 다시 로드하여 새 세션에서 유지되도록 하세요.
4
Claude Code 실행하기
프로젝트에서 claude를 실행하세요. 이제 요청이 공식 요금의 50% 할인으로 RunAPI를 통해 라우팅됩니다.
자주 묻는 질문
Claude Code API 키 FAQ
Claude Code에 API 키를 추가하는 방법은 무엇인가요?
두 환경 변수를 설정하세요. ANTHROPIC_BASE_URL을 https://api.runapi.ai로, ANTHROPIC_API_KEY를 RunAPI 키로 내보내세요. 두 가지 모두 셸 프로파일에 추가하여 지속되도록 하세요. Claude Code는 시작 시 이를 읽고 모든 요청을 RunAPI를 통해 라우팅합니다.
Claude Code API 키는 어디서 얻을 수 있나요?
runapi.ai에서 생성하세요. 가입하고 대시보드 → API 키를 열고 키를 생성하세요. 전체 키는 생성 시에만 표시되므로 즉시 복사하세요. 무료 티어에는 잔액을 충전하기 전에 모든 Claude 모델을 테스트할 수 있는 크레딧이 포함됩니다.
ANTHROPIC_BASE_URL은 무엇을 위한 것인가요?
요청을 보낼 엔드포인트를 Claude Code에 알려줍니다. 기본적으로 Claude Code는 Anthropic에 직접 호출합니다. https://api.runapi.ai로 설정하면 모든 요청이 대신 RunAPI를 통해 라우팅되어, 공식 요금의 50%로 동일한 모델을 청구합니다.
Claude Code가 여전히 전체 요금으로 청구되는 이유는 무엇인가요?
아마도 현재 셸에 기본 URL이 설정되어 있지 않을 것입니다. echo $ANTHROPIC_BASE_URL을 실행하세요 — 비어 있으면 내보내기가 지속되지 않은 것입니다. ~/.zshrc 또는 ~/.bashrc에 추가하고 source로 다시 로드한 다음, 새 터미널을 열고 다시 확인하세요.
키를 설정 파일에 저장할 수 있나요?
네. 매 세션마다 내보내는 대신 홈 또는 프로젝트 디렉토리의 .claude.json 파일에 값을 넣으세요. 두 방법 모두 작동합니다. 파일은 프로젝트별 키에 더 편리하고, 내보내기는 단일 전역 설정에 더 간단합니다.
설정 후 비용을 모니터링하는 방법은 무엇인가요?
RunAPI 대시보드를 여세요. 키별 및 요청별 지출을 실시간으로 보여줍니다. 출력 비용을 제한하려면 CLAUDE_CODE_MAX_OUTPUT_TOKENS를 설정하여 각 응답을 제한하고, 루틴 편집에는 Haiku 같은 저렴한 모델을 선택하세요.
이것이 Claude Code의 동작 방식을 변경하나요?
아니요. RunAPI는 기본 Claude 모델로 요청을 직접 프록시합니다. 출력, 도구 사용, 동작은 기본 설정과 동일합니다. 요청이 가는 곳과 청구 방식만 변경됩니다 — 코딩 경험은 그대로입니다.
기본 모델로 어떤 모델을 설정해야 하나요?
대부분의 개발자는 일상 코딩에 ANTHROPIC_MODEL을 claude-sonnet-4-6으로 설정합니다. 빠르고 저렴한 편집에는 claude-haiku-4-5를, 어려운 리팩토링에는 claude-opus-4-7을 사용하세요. 언제든지 Claude Code 내에서 모델을 전환할 수 있으며, 청구는 실제로 호출하는 모델을 따릅니다.
두 개의 명령으로 Claude Code를 RunAPI로 연결하세요.
무료 RunAPI 계정을 만들고, ANTHROPIC_BASE_URL과 ANTHROPIC_API_KEY를 설정하여 공식 Anthropic 가격의 50% 할인으로 Claude Code에서 모든 Claude 모델을 실행하세요.