Onejay Lab | Blog

nodenv 환경에서 Node 버전 상관없이 Claude Code 실행하기

Wed, 18 Mar 2026 00:00:00 GMT

내용

Claude Code 를 설치하는 방법은 여러가지가 있다. curl 로 shell script 를 실행하거나 맥이라면 homebrew 를 사용하거나 node.js 를 사용하는 유저라면 npm 을 이용하는 방법도 있다.

(이 글을 쓰는 시점에 공식사이트를 들어가보면 더 이상 npm 을 이용한 설치는 지원하지 않는 듯하다. Deprecated npm installation)

나는 node.js 가 익숙한 개발자라 npm 을 이용해 설치했었다.

https://www.npmjs.com/package/@anthropic-ai/claude-code

특히 각 프로젝트마다 node.js 의 버전이 달라서 nodenv 를 이용해 프로젝트별로 node 의 버전을 다르게 사용하고 있었다. 그래서 claude code 를 nodenv 의 global 로 설정한 node 버전에 설치를 했다.

이 경우 .node-version 파일이 없는 디렉토리나 프로젝트에서는 global 버전의 node 에서 잘 실행할 수 있는데 global 버전이 아닌 프로젝트(각 .node-version 파일에 지정한 버전)에서는 아래와 같은 에러로 실행이 되지 않았다.

$ claude
nodenv: version `22.21.1' is not installed

global 버전이 24.12.0 인데 프로젝트의 버전이 22.21.1 라서 실행이 되지 않는 것이다.

이런 경우 3가지 정도의 방법이 있다.

IDE 의 플러그인을 사용
.node-version 을 임시로 global 버전과 같은 버전으로 변경
NODENV_VERSION=글로벌버전 claude 으로 실행

1. IDE 의 플러그인을 사용

Visual Studio Code(vscode) 나 WebStorm 등의 IDE 는 Claude Code 플러그인을 지원한다. 이 플러그인들은 node 버전과 관계없이 Claude Code 를 사용할 수 있다.

2. .node-version 을 global 버전과 같은 버전으로 변경

Claude Code 를 실행하고자 하는 프로젝트의 .node-version 의 버전을 nodenv 의 global 버전으로 변경해 준다.(임시로)

nodenv 는 .node-version 파일이 있는 경우, 그 버전을 참조하여 node 를 실행한다. 따라서 임시로 node 버전을 변경해주면 Claude Code 를 실행할 수 있다.

3. `NODENV_VERSION=글로벌버전 claude` 으로 실행

nodenv 의 환경변수인 NODENV_VERSION에 버전을 지정하여 claude 를 실행하면 바로 사용할 수 있다.

NODENV_VERSION=24.12.0 claude

NODENV_VERSION 환경변수는 특정 node 의 버전을 지정할 수 있는 변수이다. 이 환경변수에 global 버전을 지정하고 claude 를 실행하면 어디에서 실행해도 동일한 node 버전으로 사용가능하다.

귀찮다면 alias 를 이용해 간략하게 설정도 가능하다.

결론

nodenv + npm 으로 설치한 claude code 는 여러 버전의 node 가 설치된 pc 에서는 사용하기 까다롭다(귀찮다).

이러한 이유로 Claude Code 측에서도 더 이상 npm 을 이용한 설치는 지원하지 않기로 한 듯하다. Claude Code 를 설치한 PC 에서 언제든지 동일하게 실행할 수 있어야 하는데 node 버전에 따라 실행할 수 없는 케이스도 생기고, 특히나 요즘은 코딩 뿐만 아니라 일반적인 PC 사용에서도 claude code 를 활용하는 경우가 많은데 node 를 따로 설치해야 하는 것은 번거롭기만 하다.

위의 3가지 방식으로 사용하다가 조만간 다른 방식으로 다시 설치해야할 듯하다.

Claude Code 에서 제공하는 마이그레이션 방식은 다음과 같다.

# Install the native binary
curl -fsSL https://claude.ai/install.sh | bash

# Remove the old npm installation
npm uninstall -g @anthropic-ai/claude-code

Refs

Route53 - DNS 레코드 추가 및 확인

Wed, 18 Feb 2026 00:00:00 GMT

author: Onejay
createdAt: 2026/02/18
updatedAt: 2026/02/18

Intro

가끔 DNS 레코드를 추가하거나 갱신하는 작업을 맡을 때가 있다. 작업 자체는 간단하지만 할 때마다 각 DNS 레코드의 역할이 자주 헷갈리고는 한다. 어떤 레코드에 어떤 값을 지정해야 하는지가 상당히 헷갈려서 매번 다시 확인하고 작업을 시작햇었다.

이번 기회에 각 레코드의 값을 정리해보고 작업 후에 확인하는 방법까지 정리해보려고 한다.

Body

Root Domain

Apex 도메인 또는 Naked Domain 이라고 한다.
example.com 과 같이 앞에 www 나 api 등이 붙지 않은 도메인을 의미한다.
CNAME 레코드의 값으로 지정할 수 없다.

A 레코드

(서버 인스턴스 등의)IP 값을 저장하는 레코드
도메인 네임(URL) -> IP 로 바꿔주는 레코드이다.
- www.example.com, api.example.com 등의 도메인에 해당하는 IP 값을 지정해두어 서버 인스턴스로 접속할 수 있도록 한다.
AWS Route53 의 경우에는 A 레코드에 IP 이외에 CloudFront URL (XXXXXX.cloudfont.com) 을 지정할 수 있다,
- alias 항목을 ON(Yes) 로 했을 경우에만 사용 가능하다.
- 구조 상 Cloudfront 를 통해 EC2 인스턴스에 액세스한다면 EC2 인스턴스의 IP 가 아닌 Cloudfront URL 을 연결하여

CNAME

서브도메인
루트 도메인으로 연결하는 일종의 alias(별칭)라고 할 수 있다.
example.com 이 루트 도메인이라면 www.example.com, api.example.com 등은 CNAME 으로 지정한 서브 도메인이다.
CNAME 레코드에는 루트 도메인을 지정할 수 없다.
- 루트 도메인으로 연결하기 위한 alias 를 지정하는 것인데 루트 도메인을 지정해버리면 의미가 없다.
- 별명으로 본명을 지어주는 격이다.

NS

네임서버정보
도메인을 관리하는 네임서버가 어느 서버인지를 지정하는 값이다.

DNS Record 확인 방법

dig 명령어

dig(Domain Information Groper): DNS 서버에 질의하여 도메인 정보를 조회할 수 있는 명령줄 도구
- 맥이라면 기본적으로 설치되어 있으나 리눅스나 윈도의 경우 별도로 설치해야할 수도 있다.
- 도메인의 IP 주소, 메일 서버, 네임서버 등 다양한 DNS 정보를 확인할 수 있다.

사용방법

dig @<네임서버> <도메인네임> <옵션>
네임서버와 옵션은 필수 항목이 아니다.

사용 예

example.com 으로 실행해보면 ;; QUESTION SECTION: 에 질의 내용이, ;; ANSWER SECTION: 에 질의 답변이 나온다.
- 질의 내용은 A 레코드를 확인한 것이고 그에 대한 값이 나왔다.

$ dig example.com

...

;; OPT PSEUDOSECTION:
; EDNS: version: 0, flags:; udp: 65494
;; QUESTION SECTION:
;example.com.      IN  A

;; ANSWER SECTION:
example.com.    172  IN  A  104.18.26.120
example.com.    172  IN  A  104.18.27.120

...

CNAME 을 확인

$ dig example.com CNAME

...

;; OPT PSEUDOSECTION:
; EDNS: version: 0, flags:; udp: 65494
;; QUESTION SECTION:
;example.com.      IN  CNAME

;; AUTHORITY SECTION:
example.com.    1220  IN  SOA  elliott.ns.cloudflare.com. dns.cloudflare.com. 2399341694 10000 2400 604800 1800

...

구글 툴 박스

toolbox.googleapps.com/apps/dig/

Conclusion(Outro)

Refs
- Route 53에 등록된 DNS 서버 정보를 dig 명령어로 확인하는 방법에 대해 알아보자!
- dig 명령어로 DNS 조회 및 진단하기

Easily Search Logs with Log Insights

Wed, 14 Aug 2024 00:00:00 GMT

Fix Code Storage Limit with Serverless Prune Plugin

Wed, 26 Jun 2024 00:00:00 GMT

Reduce Bundle Size with Webpack to Fix Upload Size Limit

Tue, 28 May 2024 00:00:00 GMT

Fix URL Path Variable Numeric Type Validation Error

Thu, 22 Sep 2022 00:00:00 GMT

Fix "adding files failed" Error Caused by Nested .git Directory

Sat, 28 May 2022 00:00:00 GMT

Fix ESLint Parsing Error — TypeScript File Lint Configuration

Sat, 28 May 2022 00:00:00 GMT

Fix iOS Build Error — Podfile.lock & Xcode Simulator Setup

Sat, 28 May 2022 00:00:00 GMT

Fix Android Build Failure — JAVA_HOME Environment Variable Setup

Fri, 27 May 2022 00:00:00 GMT

Onejay Lab | Blog

nodenv 환경에서 Node 버전 상관없이 Claude Code 실행하기

내용

1. IDE 의 플러그인을 사용

2. .node-version 을 global 버전과 같은 버전으로 변경

3. NODENV_VERSION=글로벌버전 claude 으로 실행

결론

Route53 - DNS 레코드 추가 및 확인

Intro

Body

Root Domain

A 레코드

CNAME

NS

DNS Record 확인 방법

dig 명령어

사용방법

사용 예

구글 툴 박스

Conclusion(Outro)

Easily Search Logs with Log Insights

Fix Code Storage Limit with Serverless Prune Plugin

Reduce Bundle Size with Webpack to Fix Upload Size Limit

Fix URL Path Variable Numeric Type Validation Error

Fix "adding files failed" Error Caused by Nested .git Directory

Fix ESLint Parsing Error — TypeScript File Lint Configuration

Fix iOS Build Error — Podfile.lock & Xcode Simulator Setup

Fix Android Build Failure — JAVA_HOME Environment Variable Setup

3. `NODENV_VERSION=글로벌버전 claude` 으로 실행