Claude Code & Codex, 설정만 바꿔도 토큰이 줄어든다!

 

 

 

AI 코딩 도구를 쓰다 보면 이런 상황, 한 번쯤은 겪어보셨죠?

 

"어? 왜 이렇게 빨리 토큰이 바닥나지?"

"오늘도 한도 초과... ㅠㅠ"

 

사실 Claude Code나 Codex를 사용할 때, 설정 몇 가지만 제대로 바꿔도 토큰 낭비를 확 줄일 수 있습니다.

그럼 어떻게 토큰을 줄일 수 있는지 알아보도록 하겠습니다.

 

 

잠깐, 토큰이 뭔가요?

 

토큰은 AI가 글을 읽고 쓸 때 사용하는 비용의 단위입니다.

 

내가 AI에게 질문할 때도, AI가 답변을 만들 때도 모두 토큰이 소비됩니다.

마치 휴대폰 데이터 요금처럼, 많이 쓸수록 비용이 올라가고 한도도 빨리 찬다고 생각하면 됩니다.

 

최근 Claude Opus 4.7 업데이트 이후, 같은 작업을 해도 이전보다 최대 1.5배 토큰이 더 소비된다는 이야기가 나올 정도로 토큰 관리가 더욱 중요해졌습니다.

 

그럼 어디서 토큰이 새는지, 그리고 어떻게 막는지 알아볼게요!

 

 

토큰이 새는 3가지 구멍

 

설정을 바꾸기 전에, 왜 토큰이 낭비되는지 먼저 알아야겠죠?

 

1) 매번 자동으로 붙는 숨은 텍스트

Claude Code가 시작할 때마다 자동으로 각종 설명(Git 안내, 메모리, 명령어 목록 등)을 AI에게 전달합니다. 정작 지금 작업과 무관한 내용들도 함께 딸려오는 거죠.

 

2) 너무 긴 도구 실행 결과

파일 읽기, 터미널 명령어 실행 결과가 수만 글자씩 쏟아질 때, 그 내용이 통째로 AI의 기억 공간(컨텍스트)을 차지합니다.

 

3) 쓰지 않는 외부 연결

안 쓰는 MCP 서버나 IDE 연동이 켜져 있으면, 매 요청마다 불필요한 정보가 추가로 딸려옵니다.

 

 

Claude Code 토큰 절약 설정

 

1) Git 안내 문구 끄기 (추천!)

 

수정 파일 : ~/.claude/settings.json

"includeGitInstructions": false

 

 

Claude Code는 기본적으로 Git 사용 방법을 매번 AI에게 전달합니다.

하지만 AI는 Git을 이미 잘 알고 있는데... 굳이 매번 설명할 필요가 없겠죠?

이 설정 하나만 꺼도 **눈에 띄는 토큰 절약** 효과가 있다고 합니다.

 

2) IDE 자동 연결 끄기

 

수정 파일 : ~/.claude/settings.json

"autoConnectIde": false

 

 

이 설정을 켜두면 VS Code나 JetBrains에서 열려있는 파일, 선택한 텍스트, 에러 메시지 등이 자동으로 AI에게 전달됩니다.

끄는 게 좋은 경우	켜두는 게 좋은 경우
터미널 중심으로 작업할 때	IDE에서 코드를 드래그해서 자주 대화할 때
AI가 알아서 에러를 찾게 할 때	IDE 에러를 바로 수정시킬 때

 

3) 불필요한 파일 검색 줄이기

 

수정 파일: ~/.zshrc 또는 ~/.bashrc

CLAUDE_CODE_GLOB_NO_IGNORE=false

 

 

기본 설정에서는 AI가 파일을 찾을 때 `.gitignore`에 적힌 파일(node_modules, 빌드 결과물 등)도 함께 검색합니다.

이 설정을 바꾸면 필요 없는 파일들은 검색에서 제외되어 결과가 훨씬 가볍게 나옵니다.

 

.gitignore에 있는 파일을 직접 수정해야 하는 경우라면 불편할 수 있습니다.

 

4) 출력 크기 상한 설정하기

 

터미널 출력이나 파일 읽기 결과가 너무 길면 컨텍스트가 순식간에 가득 찹니다.

아래 환경변수로 최대 출력 크기를 제한할 수 있어요.

 

수정 파일: ~/.zshrc 또는 ~/.bashrc

BASH_MAX_OUTPUT_LENGTH=10000 # 터미널 출력 최대 글자 수
CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS=10000 # 파일 읽기 최대 토큰 수
MAX_MCP_OUTPUT_TOKENS=10000 # MCP 도구 출력 최대 토큰 수

 

너무 작게 설정하면 중요한 로그나 에러 내용이 잘릴 수 있습니다.

처음엔 기본값보다 조금 줄이는 정도로 시작해보세요.

 

5) 간단한 작업용 '경량 모드' alias 만들기

 

간단한 파일 이동, 이름 바꾸기 같은 단순 작업을 시킬 때도 AI는 MCP 설정, 메모리, 명령어 목록 등을 잔뜩 불러옵니다. 이런 경우를 위해 **꼭 필요한 것만 켜는 별명 명령어(alias)** 를 만들어두면 편합니다.

 

수정 파일: ~/.zshrc 또는 ~/.bashrc

alias ccb='ENABLE_CLAUDEAI_MCP_SERVERS=false \
CLAUDE_CODE_DISABLE_AUTO_MEMORY=1 \
CLAUDE_CODE_DISABLE_CLAUDE_MDS=1 \
claude --tools "Bash,Edit,Glob,Grep,Read,Write" \
--disable-slash-commands \
--exclude-dynamic-system-prompt-sections'

 

`ccb` 라고 입력하면 불필요한 것들을 다 끈 가벼운 Claude가 실행됩니다!

 

위 alias에 쓰인 환경변수들의 의미를 간단히 설명하면...
- `ENABLE_CLAUDEAI_MCP_SERVERS=false` → MCP 서버 끄기
- `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1` → 자동 저장된 기억 불러오지 않기
- `CLAUDE_CODE_DISABLE_CLAUDE_MDS=1` → CLAUDE.md 파일 무시하기
- `--disable-slash-commands` → /help 같은 명령어 정의 제외
- `--exclude-dynamic-system-prompt-sections` → 매번 바뀌는 환경 정보 제외 (캐시 재사용률 향상)

 

6) 커밋 메시지 attribution 비우기

 

수정 파일 : ~/.claude/settings.json

{
  "attribution": {
    "commit": "",
    "pr": ""
  }
}

 

 

Claude Code는 기본적으로 Git 커밋과 PR에 *"Generated with Claude Code"* 같은 문구를 자동으로 붙입니다.

이게 git log를 AI에게 읽힐 때마다 불필요한 텍스트로 쌓이게 됩니다.

팀 정책상 문제없다면 비워두는 게 좋습니다.

 

 

Codex 토큰 절약 설정

 

Codex는 Claude Code보다 토큰 여유가 많은 편이지만, 그래도 아낄 수 있다면 아끼는 게 좋겠죠!

 

1) ChatGPT 연동 앱/커넥터 끄기

 

수정 파일: ~/.codex/config.json

"features": {
  "apps": false
},
"apps": {
  "_default": { "enabled": false }
}

 

 

ChatGPT OAuth로 Codex를 쓰는 분들에게 중요한 설정입니다.

기본적으로 ChatGPT에 설치된 앱/커넥터 정보가 시스템 프롬프트에 자동으로 주입되는데, 이걸 끄면 토큰도 절약되고 불필요한 MCP 호출도 줄어듭니다.

 

 

2) 웹 검색 끄기

 

수정 파일: ~/.codex/config.json

"web_search": "disabled"

 

 

코드 리팩토링, 테스트 수정처럼 인터넷 검색이 필요 없는 작업을 할 때는 웹 검색을 꺼두는 게 좋습니다.

검색이 필요 없는데도 AI가 괜히 검색을 시도하면서 토큰을 낭비하는 걸 막을 수 있습니다.

 

 

3) 도구 출력 크기 제한

 

수정 파일: ~/.codex/config.json

"tool_output_token_limit": 5000

 

 

기본값은 10,000인데, 로컬 코드 작업 위주라면 절반 정도로 줄여도 대부분 충분합니다.

 

 

토큰 절약 방법 한눈에 정리!

 

도구	설정	수정 파일	효과
Claude Code	includeGitInstructions: false	~/.claude/settings.json	Git 안내 문구 제거
Claude Code	autoConnectIde: false	~/.claude/settings.json	불필요한 IDE 컨텍스트 차단
Claude Code	CLAUDE_CODE_GLOB_NO_IGNORE=false	~/.zshrc or ~/.bashrc	파일 검색 결과 경량화
Claude Code	출력 상한 환경변수	~/.zshrc or ~/.bashrc	대용량 출력 급팽창 방지
Claude Code	경량 모드 alias	~/.zshrc or ~/.bashrc	단순 작업 시 컨텍스트 최소화
Claude Code	attribution 비우기	~/.claude/settings.json	git log 불필요 텍스트 제거
Codex	features.apps: false	~/.codex/config.json	ChatGPT 앱 정보 주입 차단
Codex	web_search: disabled	~/.codex/config.json	불필요한 검색 호출 방지
Codex	tool_output_token_limit 줄이기	~/.codex/config.json	도구 출력 크기 제한

 

 

마무리하며...

 

오늘 소개한 설정들은 한 번만 해두면 그다음부터는 자동으로 토큰이 절약되는 것들입니다.

처음엔 낯설 수 있지만, 하나씩 적용해보면서 본인 작업 방식에 맞게 조율해보세요.

 

AI 코딩 도구는 쓰면 쓸수록 요령이 생깁니다.

설정 하나 바꾸는 것도 결국 더 스마트하게 쓰는 방법을 배워가는 과정이니까요!

 

 

 

#ClaudeCode #Codex #토큰절약 #AI코딩 #개발자팁 #Claude #토큰효율 #코딩에이전트 #AI개발도구 #설정최적화