[Claude Code] VS Code·JetBrains에 Claude Code 붙이기: 설치와 단축키 정리

안녕하세요, muaco입니다.

이 글로 할 수 있는 일

이 글을 따라 하면 VS Code나 JetBrains 에디터 안에서 Claude Code를 열 수 있습니다. 고칠 줄을 고른 채로 바로 질문하게 됩니다. 검은 터미널 창을 따로 띄우지 않아도 됩니다.

에디터를 글 쓰는 책상, 터미널을 옆방 작업실이라고 생각해 보세요. 지금까지는 Claude에게 일을 시키려면 옆방까지 걸어가야 했습니다. 확장을 깔면 Claude가 책상 옆자리로 옮겨 옵니다.

이런 연결을 IDE 통합이라고 부릅니다. IDE는 코드를 쓰고 고치고 실행하는 도구를 한 화면에 모은 프로그램입니다. 설치, 첫 질문, 자주 쓰는 단축키까지 차례로 다룹니다.

시작 전에 갖출 준비물

여기서 하나라도 빠지면 아래 단계가 막힙니다. 먼저 확인해 두세요.

Claude 계정: 유료 구독(Pro, Max, Team, Enterprise)이나 Claude Console 계정이면 됩니다. API 키는 따로 필요 없습니다.
VS Code를 쓴다면: 버전 1.94.0 이상이어야 합니다.
JetBrains를 쓴다면: IntelliJ IDEA, PyCharm, Android Studio, WebStorm, PhpStorm, GoLand 같은 제품이 대상입니다. 여기에 Claude Code CLI(터미널에 명령을 쳐서 쓰는 방식)를 먼저 깔아야 합니다.

두 에디터는 여기서 갈립니다. VS Code 확장은 CLI 사본을 품고 있어서 따로 깔 필요가 없습니다. JetBrains 플러그인은 내 컴퓨터에 깔린 claude 명령을 불러다 쓰므로, CLI가 없으면 아무 일도 일어나지 않습니다.

CLI 설치는 공식 빠른 시작 문서(quickstart)를 따르세요. 다 깔렸는지는 터미널에 claude --version을 쳐 보면 압니다. 버전 숫자가 나오면 준비 완료.

따라 하기: 설치부터 첫 질문까지

VS Code와 JetBrains는 설치 순서가 다릅니다. 쓰는 에디터 쪽만 따라 하면 됩니다.

VS Code에 확장 깔기

따라 하기

Cmd+Shift+X(Mac) 또는 Ctrl+Shift+X(Windows, Linux)를 눌러 확장 화면을 엽니다. 왼쪽에 검색창이 달린 목록이 뜨면 제대로 열린 상태입니다.
검색창에 "Claude Code"를 치고 Install을 누르세요. 확장은 에디터에 기능을 덧붙이는 추가 부품입니다.
설치 후 아무 변화가 없으면 명령 팔레트(Cmd+Shift+P 또는 Ctrl+Shift+P)에서 "Developer: Reload Window"를 실행합니다. 창을 새로 읽어 들여야 확장이 화면에 나타나기 때문입니다.
파일을 하나 연 다음 에디터 오른쪽 위의 Spark 아이콘을 누릅니다. 이 아이콘은 파일이 열려 있을 때만 보입니다. 창 오른쪽 아래 상태 표시줄의 ✻ Claude Code를 눌러도 같은 패널이 열립니다.
처음 열면 로그인 화면이 뜹니다. Sign in을 누르고 브라우저에서 승인을 마치세요. 패널에 Learn Claude Code 체크리스트가 보이면 로그인이 끝난 상태입니다.
코드 몇 줄을 드래그로 고르고 패널 입력창에 "이 부분이 하는 일을 설명해 줘"라고 보내 보세요. 고른 줄은 Claude가 자동으로 봅니다. 입력창 아래에 선택한 줄 수가 표시되면 제대로 넘어갔다는 뜻입니다.

Claude가 파일을 고치려 하면 어떻게 될까요? 입력창 아래 권한 모드가 Manual이면 원래 내용과 바뀔 내용을 나란히 보여 주고 허락을 구합니다. Auto나 Edit automatically 모드에서는 작업 공간의 파일 대부분을 묻지 않고 고칩니다.

이때 VS Code가 자동으로 실행할 수 있는 설정 파일(settings.json, tasks.json)까지 바뀔 수 있습니다. 남이 만든 코드나 출처를 모르는 프로젝트라면 Manual로 두고 작업 공간은 제한 모드(Restricted Mode)로 여세요.

JetBrains에 플러그인 깔기

따라 하기

터미널에서 claude --version을 실행해 CLI가 있는지 확인합니다. 버전이 나오지 않으면 빠른 시작 문서대로 먼저 설치하세요.
JetBrains Marketplace에서 Claude Code [Beta] 플러그인을 설치하고 IDE를 다시 시작합니다. 공식 문서가 설치 직후 재시작을 요구합니다.
IDE 아래쪽 내장 터미널을 열고 claude를 입력하세요. 이 터미널에서 실행해야 연결 기능이 모두 켜집니다. 처음이라면 로그인 안내가 뜨니 그대로 따르면 됩니다.
편집기에서 코드 몇 줄을 고른 뒤 Claude에게 질문합니다. 대화 기록에 ⧉ Selected N lines from으로 시작하는 줄이 보이면 선택 내용이 넘어간 상태입니다.
Claude가 제안한 수정이 IDE의 비교 화면(diff viewer)에 뜨는지 봅니다. 터미널에만 보인다면 /config를 입력하고 Diff tool을 auto로 바꾸세요.

바깥 터미널에서 이미 Claude Code를 쓰고 있다면 /ide를 입력하세요. Connected to IntelliJ IDEA. 같은 문구가 뜨면 연결 성공입니다. 이때 IDE에서 연 프로젝트 폴더에서 claude를 실행해야 둘이 같은 파일을 봅니다.

손에 익힐 단축키

단축키는 두 에디터가 비슷합니다. 칸마다 앞이 Mac, 뒤가 Windows·Linux입니다.

하고 싶은 일	VS Code	JetBrains
Claude 입력창으로 가기	`Cmd+Esc` / `Ctrl+Esc` (편집기와 오가기)	`Cmd+Esc` / `Ctrl+Esc` (Claude Code 바로 열기)
파일과 선택 줄 참조 넣기	`Option+K` / `Alt+K`	`Cmd+Option+K` / `Alt+Ctrl+K`
새 대화를 탭으로 열기	`Cmd+Shift+Esc` / `Ctrl+Shift+Esc`	문서에 없음
보내지 않고 줄 바꾸기	`Shift+Enter`	Mac은 플러그인 설정에서 `Option+Enter`를 켜고 터미널을 다시 시작합니다

참조 넣기를 누르면 입력창에 @app.ts#5-10 같은 글자가 들어갑니다. "app.ts 파일의 5번째부터 10번째 줄"이라는 주소입니다. JetBrains에서는 @src/auth.ts#L1-99처럼 줄 번호 앞에 L이 붙습니다.

막히기 쉬운 네 군데

VS Code에 Spark 아이콘이 없습니다

증상: 확장을 깔았는데 에디터 오른쪽 위가 비어 있습니다.

까닭: 아이콘은 파일이 열려 있을 때만 뜹니다. 폴더만 연 상태로는 부족합니다. 작업 공간을 신뢰하지 않는 제한 모드(Restricted Mode)에서는 확장이 아예 작동하지 않습니다.

해결: 파일을 하나 열고 VS Code 버전이 1.94.0 이상인지 보세요. 그래도 없으면 "Developer: Reload Window"를 실행하고 Cline, Continue 같은 다른 AI 확장을 잠시 끕니다. 급하면 상태 표시줄의 ✻ Claude Code로 열면 됩니다.

Mac에서 Cmd+Esc가 먹지 않습니다

증상: 단축키를 눌러도 아무 반응이 없습니다.

까닭: macOS Tahoe부터는 시스템의 Game Overlay 단축키가 Cmd+Esc에 걸려 있습니다. 에디터에 닿기 전에 운영체제가 가로챕니다.

해결: System Settings → Keyboard → Keyboard Shortcuts → Game Controllers에서 Game Overlay 체크를 풉니다. VS Code의 단축키 편집기(Cmd+K Cmd+S)에서 "Claude Code: Focus input"에 다른 키를 지정해도 됩니다.

JetBrains에서 "Cannot launch Claude Code"가 뜹니다

증상: Claude 아이콘을 누르면 실행할 수 없다는 알림이나 "command not found"가 뜹니다.

까닭: 컴퓨터는 명령을 받으면 정해 둔 서랍 몇 곳만 뒤집니다. 이 서랍 목록이 PATH입니다. 플러그인은 CLI를 품고 있지 않아서 claude가 PATH 밖에 있으면 찾지 못합니다.

해결: 먼저 claude --version으로 설치 여부를 확인하세요. 깔려 있다면 Settings → Tools → Claude Code [Beta]의 Claude command에 /usr/local/bin/claude처럼 전체 경로를 적습니다. WSL 사용자는 wsl -d Ubuntu -- bash -lic "claude"를 넣고 Ubuntu 자리를 내 배포판 이름으로 바꿉니다.

/ide를 쳤더니 "No available IDEs detected"가 뜹니다

증상: 바깥 터미널에서 연결을 시도했지만 IDE를 못 찾습니다.

까닭: 플러그인이 꺼져 있거나 IDE를 재시작하지 않은 경우가 흔합니다. WSL2에서는 WSL2의 네트워크 방식(NAT)이나 Windows 방화벽이 둘 사이 연결을 막는 일이 많습니다.

해결: 플러그인이 켜져 있는지 보고 IDE를 완전히 껐다 켜세요. 자동 연결을 기대했다면 IDE 내장 터미널에서 claude를 실행했는지 확인합니다.

WSL2라면 Windows 방화벽에 길을 터 줍니다. WSL 셸에서 hostname -I를 실행하고 주소의 앞 두 마디 뒤에 .0.0/16을 붙여 대역을 만드세요. 주소가 172.21.123.45라면 대역은 172.21.0.0/16입니다.

이어서 PowerShell을 관리자 권한으로 열고 New-NetFirewallRule -DisplayName "Allow WSL2 Internal Traffic" -Direction Inbound -Protocol TCP -Action Allow -RemoteAddress 172.21.0.0/16 -LocalAddress 172.21.0.0/16을 실행합니다. 두 주소 자리는 내 대역으로 바꾸세요. 그다음 IDE와 Claude Code를 모두 껐다 켭니다.

Windows 11 22H2 이상이라면 다른 길도 있습니다. Windows 사용자 폴더의 .wslconfig에 [wsl2] 줄과 networkingMode=mirrored 줄을 넣고 PowerShell에서 wsl --shutdown으로 WSL을 다시 시작하세요.

여기서 더 나아가려면

VS Code 입력창에서 /plan을 치면 Claude가 계획부터 보여 주고 승인을 기다립니다(Claude Code v2.1.280 이상). 큰 수정을 맡기기 전에 써 보세요. 메시지 위에 마우스를 올리면 나오는 되감기 버튼으로 파일을 이전 상태로 돌릴 수도 있습니다.

VS Code 확장은 ~/.claude/settings.json 설정을 CLI와 함께 씁니다. 한쪽에서 바꾸면 다른 쪽에도 그대로 적용됩니다.

JetBrains에서는 편집 자동 승인 모드가 IDE 설정 파일까지 고칠 수 있다고 공식 문서가 경고합니다. 그래서 문서는 Manual 모드를 권합니다.

이상으로 글 마치겠습니다.

출처

VS Code·JetBrains에 Claude Code 붙이기설치와 단축키 정리