클로드 코드 제대로 쓰는 법, 제작자가 짚은 세 가지 원칙

클로드 코드를 잘 쓰는 방법은 결론부터 말하면 하나입니다. 버그를 고치게 하지 말고 그 버그가 다시 안 생기게 만드는 규칙을 짜게 하는 겁니다.

같은 오류를 세 번째 지적하고 있다면 도구가 부족한 게 아닙니다. 쓰는 방식이 한 단계 아래에 머물러 있는 겁니다.

클로드 코드 제작자는 어떻게 일할까

보리스 셰르니는 클로드 코드를 만든 사람입니다. 프라그매틱 엔지니어 인터뷰 기준 그는 메타에서 프린시펄 엔지니어로 5년을 일한 뒤 앤트로픽에서 이 도구를 만들었습니다.

작업 방식이 흥미롭습니다. 벤처비트 보도에 따르면 그는 6개월 넘게 코드를 직접 쓰지 않았다고 밝혔습니다. 클로드 코드 자체도 그 기간 동안 클로드 코드가 작성했습니다.

대신 그는 에이전트가 돌아가는 판을 짭니다. 풀 리퀘스트를 감시하고 실패한 CI를 고치고 다른 에이전트의 결과를 검토하는 흐름을 만들어 둡니다. 사람은 코드를 치는 대신 그 흐름을 설계합니다.

클로드 코드 자동화, 같은 버그를 세 번 고치고 있다면

클로드 코드 자동화의 핵심은 반복을 없애는 데 있습니다. 에이전트에게 같은 부류의 버그를 계속 고치게 하면 매번 토큰이 나갑니다. 결과물은 같은데 비용만 쌓입니다.

제작자의 조언은 한 단계 위를 건드리라는 쪽입니다. 그 버그를 고치는 대신 그 버그를 잡아내는 린트 규칙을 클로드에게 작성하게 합니다. 클로드 코드 린트 규칙 하나가 그 부류의 문제를 이후 계속 걸러냅니다.

CI도 같은 원리입니다. 클로드 코드 CI 단계를 에이전트가 직접 짜게 하면 이후 모든 작업이 그 검문소를 통과합니다. 커뮤니티 베스트 프랙티스 문서도 포매터와 린터와 테스트를 리뷰 전에 강제하라고 같은 방향을 권합니다.

레버리지가 달라진 점이 중요합니다. 예전에는 자동화 하나가 내 생산성을 두 배로 만들었습니다. 지금은 그 자동화가 동시에 돌아가는 에이전트 전부의 속도를 함께 올립니다.

같은 규칙을 여러 대가 공유하면 그만큼 효과가 겹칩니다. 에이전트를 늘릴수록 규칙 한 줄의 값어치가 커지는 구조입니다.

클로드 코드 CLAUDE.md는 사람이 관리합니다

CLAUDE.md는 프로젝트 규칙과 맥락을 클로드에게 알려주는 지침 파일입니다. 한국어 가이드 상당수는 이 파일을 클로드에게 맡겨 다듬으라고 안내합니다.

영상에서 소개된 보리스의 조언은 여기서 갈립니다. 지침 파일만큼은 에이전트가 직접 쓰게 두지 말라는 겁니다. 사람이 에이전트의 동작을 관찰하고 손으로 조정해야 방향이 잡힙니다.

이 대목은 원문 인용을 독립 매체에서 확인하지 못했습니다. 제작자 조언으로 받아들이시면 됩니다.

논리는 납득이 갑니다. 에이전트가 자기 지침을 쓰면 자기가 이미 하는 행동을 정당화하는 문장이 쌓이기 쉽습니다. 규칙이 행동을 교정해야 하는데 행동이 규칙을 따라오는 역전이 일어납니다.

개인적으로는 이 지적이 분량 줄이기 조언보다 훨씬 유용했습니다. CLAUDE.md 작성법의 핵심은 몇 줄로 줄이느냐가 아니라 누가 최종 문장을 쓰느냐입니다.

지침 파일이 길어서 문제가 되는 경우는 드뭅니다. 문제는 그 안에 사람이 검토하지 않은 문장이 섞여 있을 때 생깁니다.

클로드 코드 팁, 머릿속 지식을 파일로 옮기는 순서

클로드 코드 팁 중 효과가 오래가는 건 지식을 파일로 옮기는 작업입니다. 사람 머리에만 있던 규칙은 그 사람이 자리를 비우면 사라집니다. 같은 규칙이 파일에 있으면 에이전트도 신규 입사자도 바로 씁니다.

옮길 대상은 정해져 있습니다. 빌드와 테스트 명령, 코딩 스타일과 린터 설정, 도메인별 진입점 파일 위치가 1순위입니다. 여기에 클로드가 자주 틀리는 지시와 승인 없이 실행하면 안 되는 행동을 더합니다.

지식 유형	두는 곳	효과
프로젝트 규칙과 금지 행동	CLAUDE.md	세션마다 자동 적용
코드 스타일 위반	린트 규칙	위반 자체가 차단
빌드와 테스트 강제	CI 단계	머지 전 검문
반복 작업 절차	커스텀 스킬	호출 한 번으로 재현
폴더별 세부 규칙	.claude/rules	문맥 낭비 감소

표에서 아래로 갈수록 사람 손이 덜 갑니다. 위쪽은 문장으로 부탁하는 방식이고 아래쪽은 구조로 강제하는 방식입니다. 제작자가 권하는 방향은 아래쪽입니다.

개인적으로는 커스텀 스킬 항목을 가장 늦게 손대게 됩니다. 앞의 네 가지를 정리해 두지 않으면 스킬을 만들어도 매번 예외 처리부터 하게 됩니다.

클로드 코드 사용법이 바뀌면 역할도 바뀝니다

에이전트가 못 하는 일을 메우는 것도 사람 몫입니다. 영상에서 든 예가 구체적입니다. 에이전트는 깃허브 화면에서 파일을 끌어다 놓지 못하니 풀 리퀘스트에 영상 파일을 붙일 수 없습니다.

해법은 도구를 바꾸는 게 아니라 길을 새로 내는 쪽이었습니다. 영상 제작자는 클라우드플레어로 자체 업로드 서비스를 만들어 에이전트가 쓰게 했습니다. 막힌 곳을 우회하는 대신 통로를 깔아준 셈입니다.

이 사례가 이번 영상에서 가장 실용적이었습니다. 에이전트가 뭘 못 하는지 목록을 만들어 보면 그대로 할 일 목록이 됩니다. 권한이 없어 멈추는 작업, 화면 조작이 필요한 작업, 사내 시스템에 막히는 작업이 대체로 여기 걸립니다.

성장 경로도 같은 방향을 가리킵니다. 코드를 직접 머지하는 것보다 코드가 잘 머지되는 환경을 만드는 쪽이 영향력이 넓습니다. AI 도입 전부터 스태프 엔지니어의 조건이었고 지금은 그 비중이 더 커졌습니다.

클로드 코드 요금제와 토큰 셈법

클로드 코드 요금제는 크게 세 갈래입니다. 프로는 월 20달러, 맥스는 월 100달러와 200달러 구간이 있습니다. 맥스 5x는 프로의 5배, 맥스 20x는 20배 사용량을 씁니다.

여기서 앞의 자동화 이야기가 돈 문제로 이어집니다. 클로드 코드 한도는 5시간 단위와 주 단위로 함께 걸립니다. 같은 버그를 반복해서 고치는 데 토큰을 쓰면 정작 필요한 작업에서 한도에 먼저 걸립니다.

클로드 코드 Pro 사용자라면 체감이 특히 큽니다. 린트 규칙 하나를 짜는 데 쓴 토큰은 한 번만 나갑니다. 같은 실수를 스무 번 고치는 토큰은 스무 번 나갑니다. 요금제를 올리기 전에 이 구조부터 손보세요.

더 자세한 플랜별 비교는 앤트로픽 요금제 정리 글에 정리해 두었습니다. 다만 순서는 자동화가 먼저입니다. 반복 소모를 줄이고 나면 같은 요금제에서 쓸 수 있는 작업량이 달라집니다.

자주 묻는 질문

📺 출처: Theo – t3.gg — “Claude Code’s creator has some really good advice”

클로드 코드를 오래 쓸수록 손이 가는 자리가 바뀝니다. 처음에는 프롬프트를 잘 쓰는 데 신경이 쏠리지만 나중에는 규칙과 검문소를 어디에 세울지가 결과를 가릅니다. 지금 에이전트에게 같은 지적을 반복하고 있다면 그 지적을 파일로 옮길 때입니다.