Claude Code는 터미널이 있는 모든 통합 개발 환경(IDE)에서 훌륭하게 작동합니다. 단순히 claude를 실행하면 바로 사용할 수 있습니다.

또한 Claude Code는 인기 있는 IDE들을 위한 전용 통합 기능을 제공하며, 이는 대화형 diff 보기, 선택 컨텍스트 공유 등의 기능을 제공합니다. 이러한 통합 기능은 현재 다음과 같은 IDE에서 사용할 수 있습니다:

  • Visual Studio Code (Cursor, Windsurf, VSCodium과 같은 인기 있는 포크 포함)
  • JetBrains IDE들 (IntelliJ, PyCharm, Android Studio, WebStorm, PhpStorm, 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의 진단 오류(lint, 구문 등)가 작업하는 동안 자동으로 Claude와 공유됩니다

​
설치

VS Code와 Cursor, Windsurf, VSCodium과 같은 인기 있는 포크에 Claude Code를 설치하려면:

  1. VS Code를 엽니다
  2. 통합 터미널을 엽니다
  3. claude를 실행합니다 - 확장 프로그램이 자동으로 설치됩니다

​
사용법

​
IDE에서

IDE의 통합 터미널에서 claude를 실행하면 모든 기능이 활성화됩니다.

​
외부 터미널에서

외부 터미널에서 /ide 명령을 사용하여 Claude Code를 IDE에 연결하고 모든 기능을 활성화하세요.

Claude가 IDE와 동일한 파일에 액세스하도록 하려면, IDE 프로젝트 루트와 동일한 디렉토리에서 Claude Code를 시작하세요.

​
구성

IDE 통합은 Claude Code의 구성 시스템과 함께 작동합니다:

  1. claude를 실행합니다
  2. /config 명령을 입력합니다
  3. 기본 설정을 조정합니다. diff 도구를 auto로 설정하면 자동 IDE 감지가 활성화됩니다

​
JetBrains 플러그인 설정

**설정 → 도구 → Claude Code [Beta]**로 이동하여 Claude Code 플러그인 설정을 구성할 수 있습니다. 사용 가능한 설정은 다음과 같습니다:

​
일반 설정

  • Claude 명령: Claude 아이콘을 클릭할 때 실행할 사용자 정의 명령을 지정합니다 (예: claude, /usr/local/bin/claude, 또는 npx @anthropic/claude)
  • Claude 명령을 찾을 수 없음 알림 억제: Claude 명령을 찾을 수 없다는 알림을 건너뜁니다
  • 다중 행 프롬프트에 Option+Enter 사용 활성화 (macOS만 해당): 활성화하면 Option+Enter가 Claude Code 프롬프트에서 새 줄을 삽입합니다. Option 키가 예기치 않게 캡처되는 문제가 발생하는 경우 이를 비활성화하세요 (터미널 재시작 필요)
  • 자동 업데이트 활성화: 플러그인 업데이트를 자동으로 확인하고 설치합니다 (재시작 시 적용)

WSL 사용자의 경우: wsl -d Ubuntu -- bash -lic "claude"를 Claude 명령으로 설정하는 것이 유용할 수 있습니다 (Ubuntu를 WSL 배포판 이름으로 바꾸세요)

​
ESC 키 구성

JetBrains 터미널에서 ESC 키가 Claude Code 작업을 중단하지 않는 경우:

  1. 설정 → 도구 → 터미널로 이동합니다
  2. 다음 중 하나를 선택합니다:
    • “Escape로 에디터에 포커스 이동” 체크 해제, 또는
    • “터미널 키바인딩 구성”을 클릭하고 “에디터로 포커스 전환” 단축키를 삭제
  3. 변경사항을 적용합니다

이렇게 하면 ESC 키가 Claude Code 작업을 제대로 중단할 수 있습니다.

​
문제 해결

​
VS Code 확장 프로그램이 설치되지 않음

  • VS Code의 통합 터미널에서 Claude Code를 실행하고 있는지 확인하세요
  • IDE에 해당하는 CLI가 설치되어 있는지 확인하세요:
    • VS Code의 경우: code 명령이 사용 가능해야 합니다
    • Cursor의 경우: cursor 명령이 사용 가능해야 합니다
    • Windsurf의 경우: windsurf 명령이 사용 가능해야 합니다
    • VSCodium의 경우: codium 명령이 사용 가능해야 합니다
    • 설치되지 않은 경우, Cmd+Shift+P (Mac) 또는 Ctrl+Shift+P (Windows/Linux)를 사용하고 “Shell Command: Install ‘code’ command in PATH”를 검색하세요 (또는 IDE에 해당하는 명령)
  • VS Code가 확장 프로그램을 설치할 권한이 있는지 확인하세요

​
JetBrains 플러그인이 작동하지 않음

  • 프로젝트 루트 디렉토리에서 Claude Code를 실행하고 있는지 확인하세요
  • IDE 설정에서 JetBrains 플러그인이 활성화되어 있는지 확인하세요
  • IDE를 완전히 재시작하세요. 여러 번 재시작해야 할 수도 있습니다
  • JetBrains 원격 개발의 경우, Claude Code 플러그인이 클라이언트가 아닌 원격 호스트에 설치되어 있는지 확인하세요

WSL 또는 WSL2를 사용하고 있고 IDE가 감지되지 않는 경우, 네트워킹 구성 및 방화벽 설정에 대한 WSL2 문제 해결 가이드를 참조하세요.

추가 도움이 필요한 경우 문제 해결 가이드를 참조하세요.

​
보안

Claude Code가 자동 편집 권한이 활성화된 IDE에서 실행될 때, IDE에서 자동으로 실행될 수 있는 IDE 구성 파일을 수정할 수 있습니다. 이는 자동 편집 모드에서 Claude Code를 실행하는 위험을 증가시키고 bash 실행에 대한 Claude Code의 권한 프롬프트를 우회할 수 있게 할 수 있습니다. IDE에서 실행할 때는 IDE 보안 기능(VS Code 제한 모드 등)을 활성화하거나, 편집에 대한 수동 승인 모드를 사용하거나, Claude가 신뢰할 수 있는 프롬프트에서만 사용되도록 각별히 주의하는 것을 고려하세요.