Cursor에서 Claude Code 사용하기: 설정, 모델, 확인
Cursor 안에서 Claude Code 확장을 AI in IDE API 키 하나로 실행하고, Cursor 자체 AI 기능과 청구는 분리해 둡니다.
Cursor는 VS Code 포크라서 확장과 설정 파일이 VS Code와 같습니다. 다른 점은 Cursor의 확장 레지스트리, 설정 동기화, 내장 AI입니다. 전체 참고 자료는 Cursor에서 Claude Code 사용하기를 보세요.
빠른 설정
- Cursor 빌드 확인. Cursor → About Cursor에 VS Code 기반 버전이 나옵니다. 1.94.0 이상이어야 합니다.
- 확장 설치. 직접 링크,
Cmd+Shift+X/Ctrl+Shift+X에서 Claude Code 검색, 또는 마켓 보기가 필터링되어 있으면 Open VSX Registry에서 설치합니다. Spark 아이콘이 보이지 않으면 Developer: Reload Window를 실행하세요. - API 키 만들기. API Keys에서 키를 만들고 AWSQ 또는 CCMAX를 고릅니다. Codex나 Gemini 키는 다른 엔드포인트로 인증하므로 여기서 실패합니다.
- 연결 설정 작성.
~/.claude/settings.json(macOS/Linux) 또는C:/Users/<UserName>/.claude/settings.json(Windows)을 만들거나 기존 내용에 병합합니다.
1 {2 "$schema": "https://json.schemastore.org/claude-code-settings.json",3 "env": {4 "ANTHROPIC_BASE_URL": "https://api.aiinide.com",5 "ANTHROPIC_AUTH_TOKEN": "YOUR_DASHBOARD_API_KEY",6 "API_TIMEOUT_MS": "600000",7 "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"8 }9 }
베이스 URL은 호스트 이름만 넣습니다. Cursor와 CLI가 모두 이 파일을 읽고, Cursor 업데이트와 프로필 전환, 창 새로고침을 거쳐도 유지됩니다.
- 로그인 화면 끄기. Cursor 사용자
settings.json에"claudeCode.disableLoginPrompt": true를 추가합니다. - 확인. 키와
anthropic-version: 2023-06-01로GET /v1/models를 호출합니다. 200은 모델 목록, 401은 잘못된 키, 400은 다른 채널입니다. 패널을 열어/status를 실행하고 짧은 프롬프트를 보낸 뒤 Usage에서 해당 키 사용량을 확인합니다.
Cursor 내부의 차이
- 두 패널, 두 청구 경로. Cursor의 내장 채팅과 탭 완성은 별도 제품이라 이 키를 공유하지 않습니다. Cursor 자체 Claude 접근은 Cursor가 청구하고, Claude Code 패널은 AI in IDE가 키 쿼터로 청구합니다. 작업마다 하나로 통일하지 않으면 두 대시보드의 사용량이 모두 어긋납니다.
- 프로필 설정이 사라질 수 있습니다. Cursor는 확장 설정을 자체 프로필에 저장하므로 프로필을 바꾸면
claudeCode.*값이 조용히 빠질 수 있습니다. 전환 후 다시 확인하세요. - 프록시 설정이 분리됩니다. Cursor의 HTTP 프록시와
HTTPS_PROXY는 따로 설정되어 한 AI 클라이언트만 동작할 수 있습니다. - 업데이트로 확장이 초기화될 수 있습니다. Cursor 업데이트 후 확장이 사라지면 확장 보기에서 다시 설치하고
claudeCode.*설정을 다시 넣으세요. - 인덱서가 자원을 차지합니다. 첫 응답만 아주 느리고 이후 정상이라면 Cursor 인덱서가 CPU와 네트워크를 포화시킨 것입니다.
지원 모델
| 모델 | 채널 | 적합한 용도 |
|---|---|---|
claude-opus-5-5(별칭 claude-opus-5.5) | AWSQ, CCMAX | 복잡한 리팩터링, 긴 자율 실행 |
claude-sonnet-5-5(별칭 claude-sonnet-5.5) | AWSQ, CCMAX | 일상 기본 |
claude-haiku-4-5-20251001 | AWSQ, CCMAX | 빠른 수정, 저렴한 확인 |
model을 생략하면 선택기를 쓰고 /model로 바꿀 수도 있습니다. GET /v1/models의 정확한 ID를 사용하세요. 잘못된 claude-* 이름은 기본 Claude 모델로 해석되어 그 요율로 청구될 수 있습니다. 플랜과 현재 요율은 요금을 보세요.
문제 해결 요점
API Error: 404—ANTHROPIC_BASE_URL에/v1이 들어 있습니다. 호스트 이름만 쓰세요.API Error: 400— Cursor가 오래된 빌드를 설치했거나settings.json이 깨졌습니다. Cursor는 깨진 파일을 경고 없이 무시합니다. Cursor에서 열어$schema줄로 검증 오류를 확인하세요.- 로그인 화면이 다시 나옴 —
/logout으로 로그아웃하고disableLoginPrompt를 설정한 뒤 새로고침합니다. - 오래된 토큰이 우선 — Cursor 통합 터미널에서
echo $ANTHROPIC_AUTH_TOKEN을 실행합니다. 오래된 값이 나오면 그것이 우선입니다.
자주 묻는 질문
확장이 Cursor에서 공식 지원되나요?
Anthropic은 Visual Studio Marketplace와 Open VSX에 배포하고 Cursor를 지원 설치 대상으로 문서화합니다. 다만 설치는 Anthropic이 운영하지 않는 마켓을 거칩니다.
Cursor의 Claude 접근과 이 확장을 둘 다 설치해야 하나요?
두 청구 경로를 모두 원할 때만 그렇습니다. 사용량을 일관되게 보려면 작업마다 하나만 쓰세요.
VS Code의 키와 설정을 재사용할 수 있나요?
됩니다. Cursor는 같은 확장을 실행하므로 같은 키, settings.json, claudeCode.* 설정이 적용됩니다. 차이는 Cursor의 프로필 처리와 자체 AI 기능입니다.
Cursor의 탭 완성이 이 키를 쓰나요?
아닙니다. Cursor 내장 AI와 Claude Code 확장은 별도 제품이고 청구도 따로입니다.