Claude Code 및 Codex 설정 변경으로 토큰을 절약하는 방법

Claude Opus 4.7 이후 토큰 사용량이 늘어난 체감과 커뮤니티 이슈를 계기로, Claude Code와 Codex CLI에서 실제로 토큰 효율을 높일 수 있는 설정들을 정리한다.

핵심 관점은 세 가지다.

• 세션마다 자동으로 붙는 추가 프롬프트를 줄이기
• 대화 히스토리에 쌓이는 긴 툴 출력을 제한하기
• 검색, 커넥터, IDE 연동 같은 외부 호출을 줄이기

Claude Code

최종 확인한 버전은 2.1.114이며, 다음 설정들이 토큰 절약에 유효하다고 정리한다.

• includeGitInstructions: false
• autoConnectIde: false
• CLAUDE_CODE_GLOB_NO_IGNORE=false
• BASH_MAX_OUTPUT_LENGTH, CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS, MAX_MCP_OUTPUT_TOKENS로 출력 상한 설정
• 비대화형 작업용 환경변수와 플래그 조합

특히 아래 옵션들이 실전에서 의미가 크다.

• ENABLE_CLAUDEAI_MCP_SERVERS=false: MCP 서버 비활성화
• CLAUDE_CODE_DISABLE_AUTO_MEMORY=1: 자동 메모리 로드 방지
• CLAUDE_CODE_DISABLE_CLAUDE_MDS=1: 글로벌/프로젝트 CLAUDE.md 무시
• CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS=1: 빌트인 서브에이전트와 스킬 정의 제외
• --tools: 필요한 도구만 선택적으로 켜기
• --strict-mcp-config: CLI에 명시한 MCP만 사용
• --disable-slash-commands: 슬래시 커맨드 정의 제거
• --no-session-persistence: 세션 저장/재개 경로 차단
• --exclude-dynamic-system-prompt-sections: 변동 섹션을 빼 캐시 재사용률 개선
• --system-prompt: 시스템 프롬프트 자체를 교체 가능

또한 attribution을 비우는 것도 절약 포인트로 제시한다.

Codex CLI

최종 확인한 버전은 0.121.0이며, 해당 버전의 GitHub 소스코드까지 함께 분석해 다음을 정리한다.

• ChatGPT 연결 MCP(앱/커넥터) 끄기: features.apps = false
• web_search = "disabled"
• tool_output_token_limit로 출력 상한 설정
• 비대화형 모드용 플래그 조합

실전에서 유용한 플래그는 다음과 같다.

• --profile: web_search, tool_output_token_limit 같은 설정을 묶어 재사용
• --json + --output-last-message FILE: 파이프라인 후처리에서 토큰 재소비 감소
• --sandbox read-only: 쓰기 실패 후 재시도 루프 방지
• --skip-git-repo-check: 신뢰 디렉토리 제약 우회
• --ephemeral: 세션 파일을 디스크에 저장하지 않음
• --color never: 파이프 출력 정리

결론적으로, 단순히 모델이나 reasoning만 조절하는 수준을 넘어서 기본 연결, 메모리, 시스템 프롬프트, 도구 출력, 세션 지속성까지 손보면 체감 가능한 토큰 절감과 부팅 속도 개선이 가능하다고 본다.