Claude 에이전트가 터미널을 너무 자주 실행하는 문제, CLAUDE.md 규칙으로 막기
Claude 같은 AI 에이전트가 작업 중 터미널 명령을 반복 실행하면 시간과 비용(토큰)이 낭비된다. CLAUDE.md 파일에 규칙을 추가하면 이 문제를 줄일 수 있다.
AI 코딩 도구(Claude 등)는 자율적으로 작업할 때 같은 터미널 명령을 여러 번 실행하거나, 확인이 필요 없는 상황에서도 불필요하게 명령을 호출하는 경우가 있다. 이런 행동은 API 토큰을 소모해 비용을 높이고, 작업 속도도 느려진다.
CLAUDE.md는 Claude에게 행동 지침을 주는 텍스트 파일로, 프로젝트 폴더에 넣어두면 에이전트가 매번 읽는다. 여기에 '불필요한 터미널 핑 금지', '이미 알고 있는 정보를 재확인하지 말 것' 같은 규칙을 적어두면 에이전트가 과도한 명령 실행을 스스로 억제한다.
핵심 포인트
용어 한 줄 설명
- AI 에이전트
- 사람 대신 정보를 찾거나 작업을 처리하도록 만든 AI 프로그램입니다.
- 터미널
- 명령어를 입력해 컴퓨터를 조작하는 검은 화면 형태의 도구입니다.
- 명령
- AI가 무엇을 할지 알려주기 위해 입력하는 짧은 안내 글입니다.
- CLAUDE.md
- Claude Code에게 프로젝트 규칙과 작업 방식을 알려주는 안내 파일입니다.
- AI 코딩 도구
- 사람의 설명을 바탕으로 코드를 쓰거나 고치는 프로그램입니다.
- 코딩 도구
- 프로그래밍 작업을 더 쉽고 빠르게 할 수 있게 도와주는 소프트웨어입니다.
- 코딩
- 컴퓨터가 이해할 수 있는 언어로 명령을 작성하여 프로그램을 만드는 일입니다.
- 터미널 핑
- 에이전트가 시스템 상태를 확인하기 위해 실행하는 짧은 명령어