IDE에 Claude Code 추가하기
좋아하는 IDE에 Claude Code를 추가하는 방법을 알아보세요
Claude Code는 인기 있는 통합 개발 환경(IDE)과 원활하게 통합되어 코딩 워크플로우를 향상시킵니다. 이 통합을 통해 선호하는 개발 환경에서 직접 Claude의 기능을 활용할 수 있습니다.
지원되는 IDE
Claude Code는 현재 두 가지 주요 IDE 계열을 지원합니다:
- Visual Studio Code (Cursor 및 Windsurf와 같은 인기 있는 포크 포함)
- JetBrains IDE (PyCharm, WebStorm, IntelliJ, GoLand 포함)
기능
- 빠른 실행:
Cmd+Esc
(Mac) 또는Ctrl+Esc
(Windows/Linux)를 사용하여 에디터에서 직접 Claude Code를 열거나, UI에서 Claude Code 버튼을 클릭하세요 - 차이점 보기: 코드 변경 사항을 터미널 대신 IDE 차이점 뷰어에서 직접 표시할 수 있습니다.
/config
에서 이를 구성할 수 있습니다 - 선택 컨텍스트: IDE의 현재 선택/탭이 자동으로 Claude Code와 공유됩니다
- 파일 참조 단축키:
Cmd+Option+K
(Mac) 또는Alt+Ctrl+K
(Linux/Windows)를 사용하여 파일 참조를 삽입하세요(예: @File#L1-99) - 진단 공유: IDE의 진단 오류(린트, 구문 등)가 작업하는 동안 자동으로 Claude와 공유됩니다
설치
VS Code
- VSCode를 엽니다
- 통합 터미널을 엽니다
claude
를 실행하면 확장 프로그램이 자동으로 설치됩니다
앞으로는 외부 터미널에서 /ide
명령을 사용하여 IDE에 연결할 수도 있습니다.
이 설치 지침은 Cursor 및 Windsurf와 같은 VS Code 포크에도 적용됩니다.
JetBrains IDE
마켓플레이스에서 Claude Code 플러그인을 설치하고 IDE를 다시 시작하세요.
통합 터미널에서 claude
를 실행할 때 플러그인이 자동으로 설치될 수도 있습니다. 효과를 보려면 IDE를 완전히 다시 시작해야 합니다.
원격 개발 제한사항: JetBrains 원격 개발을 사용할 때는 설정 > 플러그인(호스트)
를 통해 원격 호스트에 플러그인을 설치해야 합니다.
구성
두 통합 모두 Claude Code의 구성 시스템과 함께 작동합니다. IDE별 기능을 활성화하려면:
- 내장 터미널에서
claude
를 실행하여 Claude Code를 IDE에 연결합니다 /config
명령을 실행합니다- 자동 IDE 감지를 위해 차이점 도구를
auto
로 설정합니다 - Claude Code는 IDE에 따라 적절한 뷰어를 자동으로 사용합니다
외부 터미널(IDE의 내장 터미널이 아닌)을 사용하는 경우에도 Claude Code를 실행한 후 /ide
명령을 사용하여 IDE에 연결할 수 있습니다. 이를 통해 별도의 터미널 애플리케이션에서 Claude를 실행하더라도 IDE 통합 기능의 이점을 누릴 수 있습니다. 이는 VS Code와 JetBrains IDE 모두에서 작동합니다.
외부 터미널을 사용할 때 Claude가 IDE와 동일한 파일에 기본적으로 액세스할 수 있도록 하려면 IDE 프로젝트 루트와 동일한 디렉터리에서 Claude를 시작하세요.
문제 해결
VS Code 확장 프로그램이 설치되지 않는 경우
- VS Code의 통합 터미널에서 Claude Code를 실행하고 있는지 확인하세요
- IDE에 해당하는 CLI가 설치되어 있는지 확인하세요:
- VS Code의 경우:
code
명령을 사용할 수 있어야 합니다 - Cursor의 경우:
cursor
명령을 사용할 수 있어야 합니다 - Windsurf의 경우:
windsurf
명령을 사용할 수 있어야 합니다 - 설치되지 않은 경우
Cmd+Shift+P
(Mac) 또는Ctrl+Shift+P
(Windows/Linux)를 사용하고 “Shell Command: Install ‘code’ command in PATH”(또는 IDE에 해당하는 명령)를 검색하세요
- VS Code의 경우:
- VS Code에 확장 프로그램 설치 권한이 있는지 확인하세요
JetBrains 플러그인이 작동하지 않는 경우
- 프로젝트 루트 디렉터리에서 Claude Code를 실행하고 있는지 확인하세요
- IDE 설정에서 JetBrains 플러그인이 활성화되어 있는지 확인하세요
- IDE를 완전히 다시 시작하세요. 여러 번 수행해야 할 수도 있습니다
- JetBrains 원격 개발의 경우 Claude Code 플러그인이 클라이언트에 로컬로 설치된 것이 아니라 원격 호스트에 설치되어 있는지 확인하세요
추가 도움이 필요하면 문제 해결 가이드를 참조하거나 지원팀에 문의하세요.