AI 코드 툴 터미널 메모리 사용량 제한 방법(CLAUDE)

 

클로드, Gemini, ChatGPT Code CLI를 사용하는 개발자들을 위한 작은 꿀팁

 

 

AI 코드 툴을 CLI 형태로 사용하는 개발자가 많아졌다.

 

특히 Claude Code, Gemini CLI, OpenAI Codex CLI 같은 도구들은

대형 코드베이스를 읽거나 긴 세션을 유지하면서 생각보다 많은 RAM을 사용한다.

 

특히 노트북 환경에서는 CLI AI 도구 하나가 2GB 이상 메모리를 사용하는 경우도 흔하다.
그래서 개발 환경을 안정적으로 유지하려면 Node 기반 CLI의 메모리를 제한하는 방법을 알아두면 좋다.

 

메모리 절약(이라기보다는 강제 제한)을 통해 컴퓨터를 오래 사용해보자.

 

내가 본체가 맞는걸까 클로드가 본체는 아닐까?

 

개발 환경 : Windows 11
대상 AI Tool : CLAUDE CODE

 

Wrapper Script 방식 (가장 안전한 방법)

가장 추천되는 방식은 wrapper script를 사용하는 것이다.
즉 claude 실행 전에 Node 메모리 제한 옵션을 설정하는 작은 실행 스크립트를 만드는 방법이다.

 

wrapper script 생성

claude.cmd 파일을 만든다.

@echo off
set NODE_OPTIONS=--max-old-space-size=1024
claude %*

설명

• NODE_OPTIONS : Node 실행 옵션
• --max-old-space-size : 최대 heap 메모리 (MB)
• %* : CLI 인자 전달

위 예시는 최대 1GB 메모리 제한을 의미한다.

 

추천 메모리 설정

• 8GB : 512MB
• 16GB : 1024MB
• 32GB : 2048MB

 

설정 방법(예)

--max-old-space-size=1024

 

PATH에 등록

이 파일을 다음 위치 중 하나에 둔다.

예

C:\Users\<username>\bin

또는

C:\Users\<username>\AppData\Roaming\npm

 

그 후 PATH에 포함되도록 설정하면

claude

 

입력 시

claude.cmd → 실제 claude 실행

순서로 동작하면서 자동으로 메모리 제한이 적용된다.

 

장점

• 특정 프로그램에만 적용
• CMD 전체 동작을 변경하지 않음
• 문제 발생 시 파일 삭제만 하면 복구 가능

그래서 대부분 개발 환경에서는 이 방식을 가장 많이 사용한다.

 

AutoRun 방식

Windows CMD에는 AutoRun 기능이 있다.

 

레지스트리 위치

HKCU\Software\Microsoft\CommandProcessor

여기 AutoRun 값을 설정하면 CMD 실행 시 자동으로 명령이 실행된다.

예

doskey claude=set NODE_OPTIONS=--max-old-space-size=1024 ^& claude $*

동작

claude
↓
NODE_OPTIONS 설정
↓
claude 실행

 

장점

• 별도 스크립트 없이 설정 가능
• 모든 CMD 세션에서 자동 적용

주의

• 설정 이후 활성화된 모든 CMD 전체 실행 시 설정이 적용됨

그래서 AutoRun 방식은 간단하지만 권장되는 방법은 아니다.