연결
VS Code, Cursor, JetBrains에서 Claude Code 사용하기
VS Code와 Cursor에서 Claude Code는 채팅 패널 전용 확장으로 제공되고, JetBrains IDE에서는 플러그인이 명령줄 버전에 연결됩니다. 둘 다 ~/.claude/settings.json을 읽으므로 CoreCode 설정은 한 번만 작성하면 됩니다. 이 페이지는 Anthropic의 VS Code 및 JetBrains 가이드를 따릅니다.
ANTHROPIC_BASE_URL과ANTHROPIC_AUTH_TOKEN을~/.claude/settings.json의env블록에 넣으세요. 확장과 CLI가 같은 파일을 공유합니다.- VS Code는 1.94 이상이 필요합니다. 확장 설정에서 Disable Login Prompt를 체크하면 Claude 계정 로그인을 더 이상 요구하지 않습니다.
- VS Code 확장에는 자체 Claude Code가 포함되어 있습니다. 통합 터미널에서
claude를 실행하려면 CLI도 필요합니다. - JetBrains 플러그인에는 Claude Code가 포함되어 있지 않습니다. CLI를 먼저 설치하면 플러그인이 IDE 터미널에서 실행합니다.
- 설정을 바꾼 뒤에는 IDE를 완전히 종료했다가 다시 열고,
/status로 요청이https://corecode.live로 가는지 확인하세요.
1단계: 설정 파일
~/.claude/settings.json(Windows에서는 %USERPROFILE%\.claude\settings.json)을 편집하세요. 없으면 새로 만듭니다.
{
"env": {
"ANTHROPIC_BASE_URL": "https://corecode.live",
"ANTHROPIC_AUTH_TOKEN": "sk-your-key"
}
}
키는 콘솔의 API 키 페이지에서 Claude 满血(仅限CC) 그룹으로 만드세요. 확장 안의 Claude Code도 Claude Code로 집계됩니다. 더 많은 옵션은 권장 설정에 있습니다.
이 변수들을 VS Code 확장 자체의 environmentVariables 설정에 넣지 마세요. 그 설정은 확장에만 적용되며, Anthropic은 공통 구성을 Claude Code의 settings.json에 두라고 권장합니다.
VS Code와 Cursor
-
확장 설치
VS Code 1.94 이상이 필요합니다.
Ctrl+Shift+X(Mac은Cmd+Shift+X)를 눌러 "Claude Code"를 검색하고 Anthropic이 게시한 확장을 설치하세요. Cursor에서도 같은 방법으로 설치하며, VS Code 기반의 다른 에디터는 Open VSX에서 설치할 수 있습니다. -
로그인 창 끄기
Ctrl+,(Mac은Cmd+,)를 눌러 "Claude Code login"을 검색하고 Disable Login Prompt를 체크하세요. Anthropic이 서드파티 구성을 위해 제공하는 옵션으로, 켜 두면 확장이 Claude 계정 로그인 화면을 표시하지 않습니다. -
종료 후 다시 열기
설정은 시작할 때 읽힙니다. VS Code 창을 모두 닫고 다시 연 다음, Claude Code 패널을 열어 메시지를 보내 보세요.
확장은 채팅 패널을 구동하기 위해 자체 Claude Code를 포함합니다. VS Code 통합 터미널에서 claude를 실행하려면 CLI도 설치하세요. 확장의 버전 번호는 포함된 Claude Code의 버전입니다.
JetBrains (IntelliJ IDEA, PyCharm, WebStorm 등)
이 플러그인은 IntelliJ IDEA, PyCharm, Android Studio, WebStorm, PhpStorm, GoLand를 포함한 대부분의 JetBrains IDE에서 동작합니다. Claude Code를 포함하지 않고 IDE 터미널에서 CLI를 실행해 연결하므로, 둘 다 설치해야 합니다.
- Claude Code의 설명대로 CLI를 설치하고 위의 설정 파일을 작성합니다.
- JetBrains Marketplace에서 Claude Code 플러그인을 설치하고 IDE를 재시작합니다.
그런 다음 IDE 터미널에서 claude를 실행하면 diff 보기와 선택 영역 공유 등이 활성화됩니다. Ctrl+Esc(Mac은 Cmd+Esc)를 누르면 바로 열립니다. 외부 터미널에서는 /ide를 입력해 실행 중인 Claude Code를 IDE에 연결하세요. 플러그인이 "Cannot launch Claude Code"라고 하면 claude가 PATH에 없는 것이므로, 플러그인의 Claude command 설정에 전체 경로를 지정하세요.
CoreCode를 거치는지 확인
패널이나 터미널에서 /status를 입력하면 Base URL이 https://corecode.live여야 합니다. 메시지를 보내면 콘솔의 사용 로그에 요청과 과금 내역이 나타납니다.
자주 겪는 문제
| 증상 | 해결 방법 |
|---|---|
확장이 계속 로그인 화면을 표시하거나 Not logged in · Please run /login이라고 나옴 | Disable Login Prompt를 체크하고, ~/.claude/settings.json에 env가 있는지 확인한 뒤 VS Code를 완전히 종료하세요. 그래도 안 되면 명령 팔레트에서 Developer: Reload Window를 실행하세요. |
| 터미널에서 설정한 변수가 적용되지 않음 | 데스크톱에서 실행한 VS Code는 셸 환경을 상속하지 않을 수 있습니다. settings.json을 사용하거나, 터미널에서 code .로 VS Code를 실행하세요. |
| 여전히 공식 계정으로 연결됨 | 이전에 claude.ai 계정으로 로그인했다면 /logout을 실행한 뒤 위의 방법대로 다시 여세요. ANTHROPIC_API_KEY를 함께 설정하지 마세요. |
| 설치 후 패널이 나타나지 않음 | VS Code를 재시작하거나 Developer: Reload Window를 실행하세요. |
다른 오류는 오류에서 볼 수 있습니다.
FAQ
VS Code 확장은 Claude Code CLI와 같은 것인가요?
확장은 채팅 패널용으로 자체 Claude Code를 포함하며 CLI와 ~/.claude/settings.json을 공유하므로, 한 번의 설정으로 둘 다 적용됩니다. 터미널에서 claude를 실행하려면 여전히 CLI가 필요합니다.
Cursor에서도 동작하나요?
네. Cursor의 확장 보기에서 "Claude Code"를 검색하세요. 설정 방법은 VS Code와 같습니다.
JetBrains 플러그인이 Cannot launch Claude Code라고 하는 이유는 무엇인가요?
플러그인에는 Claude Code가 포함되어 있지 않습니다. CLI를 설치하고 claude가 PATH에 있는지 확인하거나, 플러그인의 Claude command 설정에 전체 경로를 지정하세요.