Kobin이 작성한 Claude Code 활용 팁 모음 글(피트남 가이드)이 총 7장인데, 제가 전부 읽어봤습니다. 그중에서도 가장 소장할 가치가 높은 것은 초반에 언급된 오류가 발생하지 않는 네 가지 함정입니다.
프로젝트 폴더 안에 CLAUDE.md와 AGENTS.md 파일이 동시에 존재하는데, 시스템은 기본적으로 CLAUDE.md만 읽는 경향이 있습니다. 아무리 공들여 작성한 AGENTS.md라 할지라도, 실제로 시스템에 의해 읽힌 적이 없을 수 있습니다. 환경 변수(Environment Variable)에 ANTHROPIC_API_KEY를 남겨두면, 구독을 사용한다고 생각했지만 실제로는 계속해서 종량제(Pay-as-you-go)로 청구될 수도 있습니다. 또한, 대화 도중에 CLAUDE.md를 수정하더라도 현재 세션에서는 다시 읽히지 않습니다.
더 황당한 것은 Skill 기능입니다. Skill 설명을 넣을 수 있는 공간은 컨텍스트(Context) 예산의 약 1%밖에 되지 않는데, 여기에 너무 많은 내용을 채우면 시스템이 가장 적게 사용되는 몇 개의 설명부터 삭제하고 이름만 남깁니다. 그런데 바로 이 설명 부분이 AI가 이번에 해당 기능을 사용할지 말지를 판단하는 근거가 되기 때문에, 많이 넣을수록 기억해내지 못하게 되는 것이 많아집니다.
마치 신입 동료에게 인수인계 문서를 한 무더기로 쌓아두어 뜯어보지도 않고, 아무 말도 하지 않은 채 넘겨주는 것과 같습니다. 결국 나중에 보는 사람은 '이 사람 왜 이렇게 바보 같지?'라고 생각할 수밖에 없습니다.
저자 본인도 이런 실수를 했습니다. 프로젝트의 모든 검사를 통과했다고 체크했지만, Claude에게 전체 건강 검진을 맡긴 후에야 43장의 썸네일 이미지가 공백이라는 것을 발견했습니다.
앞으로 Claude Code를 사용할 때 가장 먼저 습관화해야 할 것은 /context 명령어를 실행하여 시스템이 실제로 무엇을 읽어왔는지 확인하는 것입니다. 이 글의 초반부에 5분 버전이 있으니, 그것부터 따라 해보는 것이 좋겠습니다.
이건 정말 알짜배기 Claude code 피트남 가이드입니다—
같은 Claude Code라도 어떤 사람은 이걸 바보 같다고 하고, 어떤 사람은 밤새도록 일하게 합니다.
문제는 모델 자체가 아니라 사용법인 경우가 많습니다. 심지어 오류도 발생하지 않는 함정들이 있습니다. 예를 들어, 작성한 AGENTS.md가 아예 읽히지 않았을 수도 있다는 식입니다.
총 7장이며, 각 장마다 따라 할 수 있는 내용이 담겨있습니다. 5분 버전은 글 맨 앞에 있습니다. https://t.co/VJ7Dp2Kovu