IntelliJ IDEA에서 Claude Code 플러그인이 보이지 않는 경우, Claude Code 설치 후 claude 명령어를 찾을 수 없을 때 해결법

설치 지식은 "https://twoweekhee.tistory.com/17" 참고 하세요 

집에서는 잘되는데 회사에서 아래와 같은 문제가 발생해서 정리해 봤습니다.

저와 같은 문제가 있는 분들에게  좋은 정보가 되었으면 합니다.

IntelliJ IDEA에서 Claude Code 플러그인이 보이지 않는 경우

터미널에서 Claude Code가 정상 작동하더라도, IntelliJ IDEA에서 "Claude Code [Beta]" 플러그인이 플러그인 목록에 나타나지 않는 경우가 있습니다.

문제 상황

• IntelliJ IDEA에서 Settings → Plugins → Marketplace에서 "Claude Code" 검색
• "Claude Code [Beta]" 플러그인이 검색 결과에 나타나지 않음
• 이미 Claude Code CLI는 정상 설치되어 터미널에서 작동하는 상태

Claude Code [Beta] 안보이는 경우 , 화면은 정상인 경우

해결 방법

이 문제는 IntelliJ IDEA 버전 호환성 문제입니다. Claude Code 플러그인은 최신 버전의 IntelliJ IDEA에서만 지원됩니다.

해결책: IntelliJ IDEA 2025.1 버전 설치

1. JetBrains 공식 웹사이트(https://www.jetbrains.com/idea/)에 접속
2. IntelliJ IDEA 2025.1 버전을 다운로드
3. 기존 버전을 완전히 제거하고 새 버전으로 설치
4. 설치 완료 후 Settings → Plugins → Marketplace에서 "Claude Code" 검색
5. "Claude Code [Beta]" 플러그인이 정상적으로 표시되는지 확인

신규 버전 확인후 설치

주의사항

• 기존 IntelliJ 설정을 백업해두는 것을 권장합니다
• 프로젝트 설정이나 플러그인 목록을 미리 내보내기 해두세요
• 라이센스 정보도 함께 백업해두시기 바랍니다

이렇게 하면 IntelliJ IDEA에서도 Claude Code를 완전히 활용할 수 있습니다.

 

Claude Code 설치 후 claude 명령어를 찾을 수 없을 때 해결법

개발자들 사이에서 화제가 되고 있는 Anthropic의 Claude Code를 설치했는데, 정작 터미널에서 claude 명령어가 작동하지 않는 경험을 하신 분들이 많을 것입니다. 오늘은 이 문제의 원인과 해결방법을 단계별로 알아보겠습니다.

문제 상황

Claude Code를 npm으로 설치했음에도 불구하고 다음과 같은 에러가 발생하는 경우가 있습니다:

 

bash

~% npm install -g @anthropic-ai/claude-code
# 설치 완료 후
~% claude
zsh: command not found: claude

분명히 npm list -g @anthropic-ai/claude-code로 확인하면 패키지가 설치되어 있는데, 왜 명령어를 찾을 수 없는 걸까요?

근본 원인 분석

이 문제의 주요 원인은 PATH 환경변수 설정과 npm global 설치 경로 문제입니다. npm이 global 패키지를 설치하는 위치와 시스템이 실행 파일을 찾는 PATH가 일치하지 않기 때문에 발생합니다.

특히 macOS에서 npm의 global prefix가 기본값이 아닌 사용자 정의 경로로 설정되어 있는 경우 이런 문제가 자주 발생합니다.

단계별 해결 방법

1단계: npm 설정 확인

먼저 npm의 global 설치 경로를 확인해보겠습니다:

 

bash

npm config get prefix

만약 결과가 /Users/username/.npm-global 같은 사용자 정의 경로라면, 이것이 문제의 원인입니다.

2단계: 현재 PATH 확인

현재 시스템의 PATH 환경변수를 확인해보세요:

 

bash

echo $PATH

npm global bin 디렉토리가 PATH에 포함되어 있는지 확인합니다.

3단계: claude 바이너리 존재 확인

실제로 claude 실행 파일이 설치되었는지 확인해봅시다:

 

bash

ls -la $(npm config get prefix)/bin/

만약 claude 파일이 없다면, 심볼릭 링크가 제대로 생성되지 않은 것입니다.

4단계: 심볼릭 링크 수동 생성

claude 바이너리가 없는 경우, 수동으로 심볼릭 링크를 생성합니다:

 

bash

ln -sf $(npm config get prefix)/lib/node_modules/@anthropic-ai/claude-code/bin/claude $(npm config get prefix)/bin/claude

5단계: PATH 환경변수 설정

가장 중요한 단계입니다. zsh를 사용하는 경우 다음과 같이 PATH를 설정합니다:

 

bash

# .zshrc 파일에 PATH 추가
echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.zshrc

# 변경사항 즉시 적용
source ~/.zshrc

bash를 사용한다면 .bashrc 또는 .bash_profile에 추가하면 됩니다.

6단계: 권한 문제 해결

npm 설치 과정에서 권한 문제가 발생했다면, 다음 명령어로 해결할 수 있습니다:

 

bash

# npm 캐시 소유권 수정
sudo chown -R $(id -u):$(id -g) "$(npm config get prefix)"

# npm 디렉토리 소유권 수정
sudo chown -R $(whoami) ~/.npm

검증 및 테스트

모든 설정이 완료되면 다음 명령어로 Claude Code가 정상적으로 설치되었는지 확인해보세요:

 

bash

# 버전 확인
claude --version

# 도움말 확인
claude --help

추가 팁

임시 해결책

위 방법이 복잡하다면, 임시로 현재 터미널 세션에서만 사용할 수 있습니다:

 

bash

export PATH="$(npm config get prefix)/bin:$PATH"
claude --version

영구 해결책

앞으로 이런 문제를 방지하려면 npm의 global 설치 경로를 표준 위치로 변경하는 것도 좋은 방법입니다:

 

bash

npm config set prefix /usr/local

단, 이 경우 sudo 권한이 필요할 수 있습니다.

 

Claude Code는 터미널뿐만 아니라 IDE 통합을 통해 개발자의 생산성을 크게 향상시킬 수 있는 강력한 도구입니다. PATH 설정 문제와 IntelliJ 버전 호환성 문제는 한 번만 해결하면 되므로, 위의 단계를 따라 차근차근 설정해보시기 바랍니다.

만약 여전히 문제가 발생한다면, Anthropic의 공식 문서(https://docs.anthropic.com)를 참고하거나, npm과 Node.js 환경을 재설정하는 것을 고려해보세요.