[claude-code 번역] IDE 통합 (IDE integrations)

출처: https://docs.anthropic.com/en/docs/claude-code/ide-integrations

Claude Code

IDE 통합

Claude Code를 선호하는 개발 환경(IDE)과 통합하세요

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 버튼을 클릭하세요.
Diff 보기: 코드 변경 사항을 터미널 대신 IDE의 diff 뷰어에서 직접 확인할 수 있습니다. /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를 완전히 재시작해야 적용됩니다.

원격 개발(Remote Development) 제한사항: JetBrains 원격 개발 환경에서는 Settings > Plugin (Host)에서 원격 호스트에 플러그인을 설치해야 합니다.

설정 방법

두 통합 모두 Claude Code의 설정 시스템과 연동됩니다. IDE별 기능을 활성화하려면:

내장 터미널에서 claude를 실행해 Claude Code를 IDE에 연결합니다.
/config 명령을 실행합니다.
diff 도구를 auto로 설정해 IDE 자동 감지를 활성화합니다.
Claude Code가 IDE에 맞는 뷰어를 자동으로 사용합니다.

IDE의 내장 터미널이 아닌 외부 터미널을 사용하는 경우에도, Claude Code를 실행한 후 /ide 명령으로 IDE에 연결할 수 있습니다. 이를 통해 외부 터미널에서도 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가 확장 프로그램 설치 권한을 가지고 있는지 확인하세요.