Claude Code 설치됨
공식 소스에서 Claude Code를 설치하고 터미널에서 claude --version으로 실행되는지 확인하십시오. 해당 명령에서 오류가 발생하면 API 키를 설정하기 전에 설치 문제를 해결하십시오.
Claude Code
Claude Code API 키 설정
Claude Code는 요청을 어디로든 라우팅하기 위해 두 개의 환경 변수 ANTHROPIC_BASE_URL과 ANTHROPIC_API_KEY를 읽습니다. 이를 RunAPI로 지정하면 모든 Claude 모델을 공식 요금의 절반으로 실행할 수 있습니다. 이 가이드는 Mac, Linux, Windows용 정확한 명령을 보여줍니다.
June 18, 2026 업데이트
RunAPI 편집팀
한눈에 보기
Claude Code에서 커스텀 API 키를 어떻게 설정하나요?
Claude Code는 요청이 어디로 가고 어떻게 인증되는지 결정하기 위해 두 개의 환경 변수를 사용합니다. ANTHROPIC_BASE_URL과 ANTHROPIC_API_KEY를 RunAPI 값으로 설정하면 모든 요청이 50% 할인으로 RunAPI를 통해 라우팅됩니다. 완전히 다른 제공업체를 사용하고 싶습니까? RunAPI는 드롭인 게이트웨이로도 작동하므로 직접 Anthropic 계정 없이 Claude 모델을 실행할 수 있습니다.
두 변수
ANTHROPIC_BASE_URL은 엔드포인트를 설정합니다. ANTHROPIC_API_KEY는 키를 설정합니다. 이것이 전체 config입니다 — 두 변수만 있으면 되고 다른 변경은 없습니다.
엔드포인트 값
Claude Code가 RunAPI를 통해 라우팅되도록 ANTHROPIC_BASE_URL을 https://api.runapi.ai로 설정하세요.
지속하기
매 세션마다 다시 설정하지 않도록 두 export를 셸 프로필(.zshrc 또는 .bashrc)에 추가하십시오. Windows 사용자는 PowerShell에서 설정하고 새 창을 여십시오.
50% 할인
모든 Claude 모델이 공식 Anthropic 요금의 절반으로 청구됩니다. 구독 없음, 한도 없음.
시작하기 전에
Claude Code를 설정하기 전에 무엇이 필요한가요?
설정은 몇 분 정도 걸립니다. Claude Code 설치, RunAPI 계정, 터미널이 필요합니다. API 키 구성을 건드리기 전에 먼저 claude --version을 실행하여 Claude Code가 작동하는지 확인하십시오.
RunAPI 계정
runapi.ai에서 가입하세요. 무료 티어에는 잔액을 충전하기 전에 모든 Claude 모델을 테스트할 수 있는 크레딧이 포함됩니다.
API 키
Dashboard → API Keys에서 키를 만드십시오. 한 번 복사하십시오 — 전체 키는 생성 시에만 표시됩니다. 공개 repos에 붙여넣거나 스크린샷으로 공유하지 마십시오.
터미널 접근
환경 변수를 설정하려면 셸이 필요합니다. macOS와 Linux는 .zshrc 또는 .bashrc를 사용합니다. Windows 사용자는 PowerShell을 사용할 수 있습니다 — 변수를 설정한 다음, 적용되도록 새 터미널 창을 여십시오.
단계별
RunAPI로 Claude Code API 키를 설정하는 방법
이 명령들을 순서대로 실행하십시오. 엔드포인트와 키를 설정하고, 셸 프로필에 유지하며, Claude Code가 이를 인식하는지 확인합니다. placeholder를 실제 RunAPI 키로 바꾸십시오. CLAUDE_API_KEY가 아니라 ANTHROPIC_API_KEY를 사용하십시오 — 이것이 Claude Code가 실제로 읽는 변수입니다.
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
두 변수 지속하기
두 export를 ~/.zshrc(또는 ~/.bashrc)에 추가하여 새 터미널 세션에서도 유지되도록 합니다. source ~/.zshrc로 다시 로드하십시오. Windows에서는 PowerShell에서 설정하고 변경 사항이 적용되도록 새 터미널 창을 여십시오.
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는 엔드포인트, 인증, 모델, 출력 길이를 제어하기 위해 작은 변수 집합을 읽습니다. 표에는 커스텀 엔드포인트 설정에 중요한 변수와 각 변수의 역할이 나와 있습니다. 참고: CLAUDE_API_KEY가 아니라 ANTHROPIC_API_KEY를 사용하십시오 — 이것이 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를 허용합니다. 작업에 따라 선택하십시오: 일상적인 편집에는 빠르고 저렴한 모델, 매일의 코딩에는 균형 잡힌 모델, 어려운 문제에는 가장 강력한 모델을 사용합니다. 기본값을 변경하려면 ANTHROPIC_MODEL을 설정하거나 Claude Code 안에서 모델을 전환하십시오 — 청구는 실제로 호출하는 모델을 따릅니다.
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 키가 작동하지 않는 이유는 무엇인가요?
대부분의 설정 문제는 세 가지 중 하나에서 발생합니다: 잘못된 env var 이름(CLAUDE_API_KEY가 아니라 ANTHROPIC_API_KEY를 사용), 프로필 변경을 아직 반영하지 않은 오래된 셸 세션, 또는 키의 오타입니다. 표에는 일반적인 오류와 각 해결 방법이 나와 있습니다.
| 오류 또는 증상 | 가능한 원인 | 수정 방법 |
|---|---|---|
| 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
두 변수 지속하기
두 export를 ~/.zshrc 또는 ~/.bashrc에 추가하고 source ~/.zshrc로 다시 로드하여 새 세션에서도 유지되도록 합니다. Windows에서는 PowerShell에서 설정하고 새 터미널 창을 여십시오.
4
Claude Code 실행하기
claude --version을 실행하여 설치를 확인한 다음, 프로젝트에서 claude를 실행하십시오. 이제 요청은 공식 요금의 50% 할인으로 RunAPI를 통해 라우팅됩니다.
자주 묻는 질문
Claude Code API 키 FAQ
Claude Code에 API 키를 추가하는 방법은 무엇인가요?
두 개의 환경 변수를 설정합니다. ANTHROPIC_BASE_URL을 https://api.runapi.ai로, ANTHROPIC_API_KEY를 귀하의 RunAPI 키로 내보내십시오. 두 변수를 셸 프로필(.zshrc 또는 .bashrc)에 추가하여 세션 간에 유지되도록 합니다. Claude Code는 시작 시 이를 읽고 모든 요청을 RunAPI를 통해 라우팅합니다.
Claude Code API 키는 어디서 얻을 수 있나요?
runapi.ai에서 하나를 만드십시오. 가입하고 Dashboard → API Keys를 연 다음 키를 생성합니다. 즉시 복사하십시오 — 전체 키는 생성 시에만 표시됩니다. 무료 티어에는 잔액을 충전하기 전에 모든 Claude 모델을 테스트할 수 있는 크레딧이 포함됩니다.
ANTHROPIC_BASE_URL은 무엇을 위한 것인가요?
요청을 보낼 엔드포인트를 Claude Code에 알려줍니다. 기본적으로 Claude Code는 Anthropic에 직접 호출합니다. https://api.runapi.ai로 설정하면 모든 요청이 대신 RunAPI를 통해 라우팅되어, 공식 요금의 50%로 동일한 모델을 청구합니다.
Claude Code를 OpenAI 같은 다른 API 제공업체와 함께 사용할 수 있습니까?
Claude Code를 OpenAI 같은 다른 API 제공업체와 함께 사용할 방법이 있습니까? 예 — Claude Code는 ANTHROPIC_BASE_URL을 통해 모든 OpenAI 호환 엔드포인트를 지원합니다. RunAPI는 호환 게이트웨이를 제공하므로 코드를 변경하지 않고 제공업체를 전환할 수 있으며, 하나의 키로 Claude, GPT 및 기타 모델을 사용할 수 있습니다.
Claude Code가 여전히 정가로 청구되는 이유는 무엇입니까?
터미널에서 echo $ANTHROPIC_BASE_URL을 실행하십시오. 아무것도 출력되지 않으면 export가 유지되지 않은 것입니다. 두 export를 ~/.zshrc 또는 ~/.bashrc에 추가하고 source ~/.zshrc를 실행한 다음, 새 터미널을 열어 다시 확인하십시오. Windows 사용자는 env vars를 설정한 후 새 PowerShell 창을 열어야 합니다.
키를 config 파일에 저장할 수 있습니까?
예. 매 세션마다 export하는 대신 홈 또는 프로젝트 디렉터리의 .claude.json 파일에 값을 넣으십시오. 두 방법 모두 작동합니다 — 파일은 프로젝트별 키에 편리하고, export는 단일 전역 설정에 더 간단합니다.
설정 후 비용을 어떻게 모니터링합니까?
RunAPI 대시보드를 여십시오. 키별 및 요청별 지출을 실시간으로 표시합니다. 출력 비용을 제한하려면 CLAUDE_CODE_MAX_OUTPUT_TOKENS를 설정하여 각 응답을 제한하고, 일상적인 편집에는 claude-haiku-4-5를 사용하십시오.
이것이 Claude Code의 동작 방식을 변경합니까?
아니요. RunAPI는 요청을 기본 Claude 모델로 직접 프록시합니다. 출력, 도구 사용, 동작은 Anthropic을 직접 호출하는 것과 동일합니다. 요청이 어디로 가는지와 어떻게 청구되는지만 변경되며 — 코딩 경험은 그대로 유지됩니다.
관련 콘텐츠
더 알아보기
두 개의 명령으로 Claude Code를 RunAPI로 연결하세요.
무료 RunAPI 계정을 만들고, 셸 프로필에 ANTHROPIC_BASE_URL과 ANTHROPIC_API_KEY를 설정한 다음, Claude Code에서 모든 Claude 모델을 공식 Anthropic 가격의 50% 할인으로 실행하십시오.