Claude Code 설정, 이것 모르면 손해입니다 (필수 최적화 가이드)

하이라이트

• settings.json의 cleanupPeriodDays 설정을 통해 한 달로 제한된 대화 내역 보관 기간을 1년 이상으로 연장 가능

• 터미널 출력 제한을 기본 30,000자에서 150,000자 이상으로 늘려 대규모 로그나 테스트 결과 누락 방지

• agent 및 isolation 플래그를 사용하여 특정 서브 에이전트를 직접 실행하거나 독립된 작업 트리에서 안전하게 실험 가능

• 2,000줄 이상의 긴 파일을 읽을 때 발생하는 제한을 Claude.md 지침과 offset/limit 파라미터로 우회하는 방법

• 컨텍스트 창이 75%에 도달했을 때 자동 압축(auto-compact)을 트리거하여 AI 응답 품질 저하를 방지

• 오픈 소스 도구인 Claude CTX를 활용하여 프로젝트별 프로필, 설정, MCP 서버를 효율적으로 분리 및 관리

• 종료 코드(exit code) 2를 활용한 커스텀 훅을 구성하여 Claude가 특정 라이브러리나 명령어를 강제로 사용하도록 제어

타임라인

1. 00:00 - 02:20

   대화 내역 보관 및 프로젝트 규칙 최적화

   Claude Code는 기본적으로 대화 내역을 한 달만 보관하지만, 메인 폴더의 settings.json에서 cleanupPeriodDays를 수정하여 보관 기간을 대폭 늘릴 수 있습니다. 프로젝트 내 .claud 폴더에 경로별 규칙을 설정하면 에이전트가 특정 파일을 수정할 때 필요한 컨텍스트만 로드하여 작업 효율을 높입니다. 모든 지침을 하나의 파일에 넣기보다 관심사 분리 원칙에 따라 React 컴포넌트 등 특정 작업에 맞는 지침만 로드하는 것이 에이전트의 집중력을 유지하는 데 유리합니다. 이를 통해 앱이 커지더라도 Claude가 지침을 무시하지 않고 정확하게 작업을 수행할 수 있도록 환경을 조성할 수 있습니다. 설정 파일의 중요성을 이해하는 것이 최적화의 첫걸음입니다.

2. 02:21 - 05:23

   터미널 출력 및 서브 에이전트 고급 설정

   기본적으로 Claude는 터미널 출력물을 30,000자까지만 읽을 수 있어 긴 빌드 로그나 테스트 결과가 잘리는 문제가 발생하지만, 설정을 통해 이를 150,000자까지 확장할 수 있습니다. 특정 작업을 위해 서브 에이전트를 호출할 때는 agent 플래그를 사용하여 오버헤드 없이 직접 위임할 수 있으며, skill이나 effort 플래그로 에이전트의 능력을 세밀하게 조정할 수 있습니다. 특히 isolation 구성을 활용하면 메인 코드베이스에 영향을 주지 않는 임시 작업 트리에서 대대적인 코드 변경을 안전하게 실험해 볼 수 있습니다. 또한 허용된 에이전트 목록을 제한함으로써 단일 에이전트가 무분별하게 많은 서브 에이전트를 생성하는 현상을 방지할 수 있습니다. 이러한 기능들은 복잡한 프로젝트 구조 내에서 에이전트를 효율적으로 제어하는 핵심적인 방법들입니다.

3. 05:24 - 07:56

   대용량 파일 읽기 및 컨텍스트 압축 관리

   Claude는 파일을 읽을 때 토큰 제한뿐만 아니라 2,000줄이라는 물리적 행수 제한이 있어 긴 파일의 내용을 놓칠 위험이 있습니다. 이를 해결하기 위해 Claude.md에 파일 행수를 먼저 확인하고 offset과 limit 파라미터를 사용하도록 지침을 추가하여 전체 파일을 누락 없이 읽게 할 수 있습니다. 컨텍스트 창 관리 측면에서는 기본 95%에서 작동하는 자동 압축 기능을 75% 수준으로 낮추어 응답 품질이 떨어지기 전 미리 최적화하는 것이 권장됩니다. 영상 중간에는 Make.com 스폰서십을 통해 노코드와 AI 에이전트를 결합하여 시각적 캔버스에서 비즈니스 워크플로우를 구축하는 방법이 소개됩니다. 시각적 플랫폼을 사용하면 에이전트의 의사 결정 과정을 직접 모니터링하고 제어할 수 있다는 장점이 있습니다. 사용자는 100만 토큰 시대에 걸맞은 새로운 컨텍스트 관리 전략이 필요합니다.

4. 07:57 - 10:03

   에이전트 팀 및 프로필 관리 도구 활용

   Agent Teams는 서브 에이전트와 달리 개별 세션들이 서로 소통하고 정보를 공유하며 팀 리더의 조율 아래 협업하는 실험적인 기능입니다. 여러 클라이언트나 프로젝트를 관리하는 개발자를 위해 오픈 소스 도구인 Claude CTX를 사용하여 설정, MCP 서버, 백업 등을 프로필별로 완벽하게 분리하는 방법이 제시됩니다. Claude CTX를 설치하면 간단한 명령어로 프로필을 전환할 수 있으며, 각 프로필은 고유의 settings.json과 권한을 가집니다. 전환 시에는 현재 상태가 자동으로 백업되므로 이전 작업 기록을 안전하게 보관하고 필요할 때 참조할 수 있습니다. AI Labs Pro와 같은 리소스를 통해 프로젝트에 즉시 적용 가능한 템플릿과 스킬을 활용하는 것도 생산성 향상에 큰 도움이 됩니다. 팀 단위 협업과 환경 격리는 전문적인 개발 환경 구축에 필수적입니다.

5. 10:04 - 13:24

   개인정보 보호 및 종료 코드를 이용한 워크플로우 제어

   GitHub 커밋 시 Claude가 공동 작성자로 표시되는 것을 원치 않는다면 settings.json에서 attribution 설정을 수정하여 커스텀 문자열로 변경하거나 비워둘 수 있습니다. 분석 데이터 전송이나 오류 로깅을 차단하고 싶다면 원격 측정 관련 변수를 추가하여 자동 업데이트를 방해하지 않으면서도 프라이버시를 강화할 수 있습니다. Ctrl + S를 이용한 프롬프트 스태싱 기능을 사용하면 현재 입력을 임시 저장하고 긴급한 작업을 먼저 처리한 뒤 원래 프롬프트로 복귀할 수 있어 편리합니다. 가장 강력한 제어 수단인 종료 코드(exit code) 2는 Claude에게 오류 메시지를 직접 전달하여 특정 라이브러리 사용을 강제하는 등 워크플로우를 강력하게 통제합니다. 이러한 훅과 종료 코드의 조합은 미완성 작업을 방지하고 Real-time Loops와 같은 고도화된 자동화 프로세스를 가능하게 만듭니다.