nodenv 환경에서 Claude Code 실행하는 방법

Overview

nodenv로 여러 Node.js 버전을 쓰는 환경에서 특정 버전의 Node.js에서는 npm으로 설치한 Claude Code가 실행되지 않을 수 있다.

How to

프로젝트마다 .node-version이 다르면 아래처럼 실행 에러가 날 수 있다.

$ claude
nodenv: version `22.21.1' is not installed

이런 경우 보통 선택지는 세 가지다.

1. IDE 플러그인을 사용한다.
2. .node-version을 임시로 global 버전과 같게 바꾼다.
3. NODENV_VERSION=글로벌버전 claude로 실행한다.

여러 Node.js 버전을 함께 쓰는 환경이라면 보통 3번 방법이 가장 간단하다. 여러 프로젝트를 오갈 때는 이 방법만 기억해도 충분하다.

Example

NODENV_VERSION=24.12.0 claude

이렇게 실행하면 현재 디렉토리의 .node-version과 무관하게 지정한 Node.js 버전으로 claude를 실행할 수 있다.

이를 alias로 등록해 놓는다면 매번 Node.js 버전을 지정하지 않고 사용할 수 있다.

---

Notes

1) 이 문서에서 권장하는 방법

• 여러 프로젝트에서 Node.js 버전이 다르면 NODENV_VERSION=글로벌버전 claude 방식이 가장 단순하다.

2) alias로 등록하기

alias claude-global='NODENV_VERSION=24.12.0 claude'

• 자주 쓴다면 셸 설정 파일에 등록해 두고 사용할 수 있다.
• bash면 ~/.bashrc 또는 ~/.bash_profile, zsh면 ~/.zshrc에 추가한다.
• 설정 파일을 수정한 뒤에는 source ~/.zshrc 또는 source ~/.bashrc로 다시 읽는다.
• 등록 후에는 아래처럼 실행하면 된다.

claude-global

3) 참고 문서

• Migrate from npm to native