개발자 리소스

Claude Code

Claude Code를 설치하고, RunAPI에 연결하고, 모델을 선택하고, 구성을 확인합니다.

Markdown 보기

개요

Claude Code는 터미널용 에이전틱 코딩 도구입니다. 이 가이드는 CLI를 설치하고, Anthropic 호환 요청을 RunAPI로 지정하고, RunAPI 모델을 선택하고, 연결을 확인합니다.

시작하기 전에

공식 Claude Code 설정 가이드에서 지원하는 플랫폼을 사용하십시오.
인증 가이드에서 표준 RunAPI API 키를 생성하십시오. 리포지토리에 커밋하지 마십시오.
모델 카탈로그에서 Anthropic Messages를 지원하는 모델 식별자를 복사하십시오.

설치

macOS, Linux, 또는 WSL에서 공식 네이티브 설치 프로그램을 사용한 후, 명령이 사용 가능한지 확인하세요:

SHELL

curl -fsSL https://claude.ai/install.sh | bash
claude --version

Homebrew, WinGet 및 플랫폼별 요구 사항은 공식 설치 가이드를 사용하세요.

RunAPI 구성

첫 번째 테스트를 위해 현재 셸에서 Base URL, API 키, 모델을 내보내세요:

SHELL

export ANTHROPIC_BASE_URL=https://runapi.ai
export ANTHROPIC_API_KEY=YOUR_RUNAPI_API_KEY
export ANTHROPIC_MODEL=YOUR_RUNAPI_MODEL_ID

사용자의 모든 Claude Code 세션에 값을 적용하려면 ~/.claude/settings.json의 env 객체에 추가하세요:

JSON

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://runapi.ai",
    "ANTHROPIC_API_KEY": "YOUR_RUNAPI_API_KEY",
    "ANTHROPIC_MODEL": "YOUR_RUNAPI_MODEL_ID"
  }
}

커밋될 수 있는 프로젝트 설정용 .claude/settings.json에는 실제 키를 포함하지 마세요. 구성 범위 및 우선 순위에 대해서는 Claude Code 설정 참조를 사용하세요.

모델 선택

YOUR_RUNAPI_MODEL_ID를 모델 카탈로그의 정확한 식별자로 교체하세요. ANTHROPIC_BASE_URL은 요청이 전송되는 위치를 변경하며 모델을 선택하지 않습니다. claude --model YOUR_RUNAPI_MODEL_ID로 세션을 시작하거나 세션 중에 /model을 실행할 수도 있습니다.

확인

설치 및 구성 확인을 실행한 후 짧은 프롬프트 하나를 전송하세요:

SHELL

claude --version
claude doctor
claude

Claude Code 내에서 /status를 실행하여 로드된 설정과 활성 모델을 확인하세요. Describe this repository in one sentence.에 대한 정상 응답은 RunAPI 연결이 작동함을 확인합니다.

문제 해결

claude를 찾을 수 없음: 터미널을 다시 열고 공식 설치 문제 해결을 따르세요.
설정이 로드되지 않음: claude doctor로 ~/.claude/settings.json을 검증한 후 /status를 사용하여 로드된 소스를 검사하세요.
인증 실패: ANTHROPIC_API_KEY에 활성 RunAPI 키가 포함되어 있는지 확인하세요. 인증 가이드를 통해 키를 생성하거나 교체하세요.
모델을 사용할 수 없음: Model Catalog에서 정확한 식별자를 복사한 후 새 세션을 시작하세요. 재개된 세션은 이전 모델을 유지할 수 있습니다.
요청이 다른 엔드포인트를 사용함: 환경 변수를 변경한 후 새 터미널을 시작하고 더 높은 우선순위의 Claude Code 설정이 있는지 확인하세요.

다음 단계

프로토콜 동작은 LLM API quickstart를, 요청 필드는 Anthropic Messages API Reference를 참조하세요. Claude Code에 RunAPI 도구를 추가하려면 MCP Overview로 계속 진행하세요.