클로드 코드 사용법 정리: 슬래시 명령어와 CLAUDE.md, 확장 사고 강도 조절까지

핵심 메시지

• 컨텍스트가 한정돼 있어 주제가 바뀌거나 꼭 남기고 싶은 내용이 있을 때 대화를 압축하는 습관이 필요하다.
• CLAUDE.md는 프로젝트용, 개인 로컬용, 사용자 전역용으로 나뉘고 실행 위치에서 위로 올라가며 함께 읽힌다.
• 일반·자동 수정·플랜의 세 가지 모드는 단축키로 전환되며, 플랜 모드는 그만큼 토큰을 더 쓴다.
• 요금제에 따라 쓸 수 있는 모델과 사용량이 달라, 한도에 닿으면 더 가벼운 모델로 자동 전환되게 설정할 수 있다.
• 코드베이스가 크면 작업 범위를 잘게 나누고 체크포인트를 남기는 방식이 코드 장악력을 지키는 데 유리하다.

쉽게 이해하기

국내 스터디 모임이 클로드 코드 입문서 5~9장을 함께 읽고 정리한 발표 녹화본이다. 발표자는 실습 환경을 가상 머신에 설치해 두고, 이론 정리를 마친 뒤 실제 화면에서 시연하는 방식으로 진행했다. 초반부 개인 정보가 담긴 구간은 편집으로 제외됐다.

첫 주제는 컨텍스트 관리다. 한 번에 담을 수 있는 대화 분량이 정해져 있어, 이전과 완전히 다른 질문으로 넘어갈 때나 반드시 기억시키고 싶은 내용이 있을 때 대화를 압축해 두는 편이 좋다는 설명이 나왔다. 한도에 도달하면 자동으로 압축되는 기능도 있지만, 필요한 시점을 스스로 정해 압축하는 쪽이 안전하다는 취지다. 이런 동작은 설정 명령으로 조정할 수 있다.

설정 파일은 세 갈래로 나뉜다. 프로젝트 루트에 두는 공용 설정, 개인만 쓰는 로컬 설정, 사용자 홈에 두는 전역 설정이다. 도구를 실행한 위치의 설정에서 시작해 상위 경로의 파일까지 함께 읽어 들이기 때문에, 팀 공통 규칙과 개인 취향, 프로젝트별 특수 규칙을 층층이 나눠 둘 수 있다. 발표자는 특히 강조 표현을 설정에 넣어 두면 해당 지시를 더 비중 있게 따른다고 전했다. 매번 파일을 열지 않아도 특정 키를 눌러 입력한 지시를 어느 범위에 저장할지 그 자리에서 고를 수 있다는 점도 함께 소개됐다.

작업 모드는 세 가지다. 기본적인 작업을 처리하는 일반 모드, 함수나 변수 수정까지 스스로 진행하는 자동 수정 모드, 그리고 계획을 먼저 세우는 플랜 모드다. 단축키 한 번으로 전환되며 플랜 모드는 토큰 소모가 크다. 권한 설정으로 '이 작업은 물어보지 말고 바로 하라'는 식의 허용·차단 규칙을 미리 정해 두면 파일이나 폴더를 만들 때마다 확인을 요구받는 번거로움을 줄일 수 있다. 발표자는 상위 모델이 중급 모델보다 몇 배 비싼 탓에 실무에서는 중급 모델을 주로 쓴다고 전했고, 사용량이 일정 비율을 넘기면 더 가벼운 모델로 자동 전환되게 하는 설정도 가능하다고 덧붙였다.

마지막 이론 주제는 확장 사고였다. '생각해 보라'고 지시하는 것만으로도 답변이 단계별로 정리되며, 그 강도를 여러 단계로 나눠 요청할 수 있다. 다만 강도를 올릴수록 사용량도 함께 늘어난다. 이어진 질의응답에서는 실무 감각이 오갔다. 한 참가자는 코드베이스가 큰 상황에서 한 번에 많은 부분을 고치게 하면 정작 사람이 변경 사항을 따라가지 못해 코드 장악력을 잃는다며, 함수 단위로 범위를 좁혀 수정하고 체크포인트를 남기는 방식을 쓴다고 말했다. 다른 참가자도 작업을 단계별로 쪼개 진행 상황을 중간중간 확인하는 방식에 동의하면서, 기능별로 나눈 뒤 터미널을 여러 개 띄우거나 하위 에이전트를 병렬로 돌리면 오히려 속도가 붙지만 그만큼 상위 요금제가 필요해진다고 덧붙였다. 작업 도중 한도에 걸려 환경을 닫아야 하면 이전 맥락을 그대로 되살리기 어렵다는 점도 사용량을 늘리게 되는 이유로 꼽혔다.

주요 인사이트

• 설정 파일이 실행 위치에서 상위로 올라가며 누적 적용된다는 점은, 팀 규칙과 개인 설정을 분리해 두면 그대로 병행할 수 있다는 뜻이다.
• 압축을 자동에 맡기지 않고 주제가 바뀌는 시점에 직접 실행하는 것이, 남기고 싶은 맥락을 지키는 실용적인 습관으로 제시됐다.
• 플랜 모드와 확장 사고는 품질을 올리는 대신 사용량을 함께 끌어올린다. 요금제 선택은 결국 이 둘을 얼마나 쓰느냐의 문제다.
• 계획 단계를 다른 도구나 사람이 맡고 실행만 맡기는 방식도 대안으로 언급됐다. 상위 요금제가 반드시 필요한지는 사용 패턴에 달렸다.
• 작업을 잘게 쪼개 범위를 좁히는 습관은 결과 품질보다 사람이 변경 내용을 추적할 수 있느냐의 문제로 이야기됐다.

자주 묻는 질문

관련 AI 소식