개발자 리소스

VS Code & Cursor의 Claude Code

VS Code 또는 Cursor에 Claude Code 확장을 설치하고, 공유 설정을 RunAPI에 연결합니다.

개요

공식 Claude Code 확장 프로그램은 VS Code와 Cursor 모두에서 실행됩니다. 두 편집기는 동일한 Claude Code 사용자 설정을 사용하므로, 이 가이드는 일치하는 확장 프로그램을 설치하고 ~/.claude/settings.json에서 RunAPI를 한 번 구성합니다.

시작하기 전에

지원되는 버전의 VS Code 또는 Cursor를 설치하십시오. 현재 VS Code 최소 버전은 공식 확장 가이드에 명시되어 있습니다.
인증 가이드에서 표준 API 키를 생성하십시오. 워크스페이스 설정이나 소스 컨트롤에 추가하지 마십시오.
모델 카탈로그에서 Anthropic Messages를 지원하는 모델 식별자를 복사하십시오.

설치

공식 anthropic.claude-code 확장을 설치하세요:

VS Code: VS Code Marketplace 목록을 열거나 Extensions에서 Claude Code를 검색하세요.
Cursor: cursor:extension/anthropic.claude-code를 열거나 Extensions에서 Claude Code를 검색하세요.

확장 프로그램에는 채팅 패널에 필요한 런타임이 포함되어 있습니다. 통합 터미널에서 claude를 실행하려는 경우에만 독립 실행형 CLI를 설치하세요.

RunAPI 구성

~/.claude/settings.json을 열고 공유 사용자 수준 환경 설정을 추가하십시오:

JSON

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

VS Code 또는 Cursor 설정에서 Claude Code login을 검색하고 이 사용자 정의 엔드포인트에 대해 Disable Login Prompt를 활성화하세요. 사용자 설정은 CLI와 공유됩니다. VS Code 확장 설정은 확장 동작만 제어합니다.

.claude/settings.json과 편집기 워크스페이스 설정에는 실제 키를 포함하지 마세요. 해당 파일들이 커밋될 수 있기 때문입니다.

모델 선택

YOUR_RUNAPI_MODEL_ID를 모델 카탈로그의 정확한 식별자로 교체하세요. Claude Code 패널에서 /model로 현재 선택을 변경하고 /status로 활성 모델을 확인합니다.

확인

확장 프로그램이나 설정을 변경한 후 편집기 창을 새로 고칩니다.
Claude Code Spark 패널을 엽니다.
/status를 실행하고 사용자 설정과 모델을 확인합니다.
Describe this repository in one sentence.를 전송하고 정상적인 응답이 오는지 확인합니다.

문제 해결

확장 프로그램이 설치되지 않음: 편집기 버전이 공식 요구 사항을 충족하는지 확인하세요.
Spark 아이콘이 없음: 편집기 창을 다시 로드한 후 편집기를 재시작하세요.
로그인 프롬프트가 계속 나타남: Claude Code 확장 프로그램 설정에서 Disable Login Prompt를 활성화하세요.
패널이 셸 변수를 상속하지 않음: ~/.claude/settings.json을 사용하거나 구성된 터미널에서 편집기를 실행하세요. GUI 애플리케이션은 종종 터미널 환경 없이 시작됩니다.
CLI는 작동하지만 패널이 작동하지 않음: 창을 다시 로드하고 독립 실행형 CLI를 사용하여 더 자세한 진단으로 요청을 재현하세요.
인증 또는 모델 선택 실패: 인증 가이드에서 키를 확인하고 Model Catalog에서 정확한 식별자를 복사하세요.

다음 단계

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