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

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

앞으로는 외부 터미널에서 /ide 명령을 사용하여 IDE에 연결할 수도 있습니다.

이 설치 지침은 Cursor 및 Windsurf와 같은 VS Code 포크에도 적용됩니다.

JetBrains IDE

마켓플레이스에서 Claude Code 플러그인을 설치하고 IDE를 다시 시작하세요.

통합 터미널에서 claude를 실행할 때 플러그인이 자동으로 설치될 수도 있습니다. 효과를 보려면 IDE를 완전히 다시 시작해야 합니다.

원격 개발 제한사항: JetBrains 원격 개발을 사용할 때는 설정 > 플러그인(호스트)를 통해 원격 호스트에 플러그인을 설치해야 합니다.

구성

두 통합 모두 Claude Code의 구성 시스템과 함께 작동합니다. IDE별 기능을 활성화하려면:

  1. 내장 터미널에서 claude를 실행하여 Claude Code를 IDE에 연결합니다
  2. /config 명령을 실행합니다
  3. 자동 IDE 감지를 위해 차이점 도구를 auto로 설정합니다
  4. 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에 확장 프로그램 설치 권한이 있는지 확인하세요

JetBrains 플러그인이 작동하지 않는 경우

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

추가 도움이 필요하면 문제 해결 가이드를 참조하거나 지원팀에 문의하세요.