클로드코드와 코덱스 겹쳐 쓰는 사람들의 지침 파일 정리법

밤 8시 17분, 코덱스(Codex)로 작업 도구를 옮기려던 한 참여자가 물었다. "코덱스로 넘어가보려고하는데 코덱스도 claude.md 가 있나요" 답은 곧바로 왔다. 다른 참여자가 "Agents.md 가 있습니다"라고 짚었다.

문제는 두 도구를 같이 쓸 때였다. 질문자는 "지침을 그냥 클로드.md를 agent.md라고 생각하라고 하면 되겠죠?"라고 되물었지만, 답은 그렇지 않았다. 한 참여자는 "둘다 있으면 클코는 claude.md 만 봄"이라며 정정했다. 두 파일을 함께 쓰는 방법도 구체적으로 이어졌다.

"둘다 쓸려면 이렇게 하십시오. 1. agents.md 에 지침작성. 2. claude.md 에서는 클로드 코드에만 적용할 지침만 작성 3. claude.md에서 agents.md를 import"

agents.md에 실제 작업 지침을 모아두고, claude.md에는 클로드 코드(Claude Code) 전용 설정만 남긴 뒤, claude.md가 agents.md를 불러오게(import) 만드는 3단 구성이었다. 질문자는 "쉽지 않군요"라고 반응했고, 뒤이어 "클로드 사용량이 너무 적어서 힘드네오"라는 불만도 덧붙였다. 도구를 옮기는 이유가 지침 파일 문제 하나만은 아니라는 방증이었다. 옆에서는 클로드에 사진으로 프롬프트를 먹이면 입력 토큰을 아낄 수 있다는 이야기도 곁들여져, 한도에 쪼들리는 사람들이 저마다 나름의 절약법을 공유하는 분위기로 흘러갔다.

여기에 다른 참여자가 자신의 운영 방식을 보탰다. 클로드와 코덱스를 혼용하면서 claude.md와 agents.md 중 하나를 기준 파일로 정해두고, 수정이 생기면 다른 쪽에 미러링한 뒤 바이트 단위로 복사가 정상적으로 됐는지 체크하는 규칙을 세워뒀다는 것이다. 지침 하나가 잘못 밀리면 두 도구가 서로 다른 규칙으로 움직일 수 있다는 점을 감안한 대응이었다.

이 대화는 한 도구에서 다른 도구로 넘어가는 이들이 흔히 부딪히는 지점을 보여준다. 지침 파일은 이름도 우선순위도 도구마다 달라, import 구조 하나만 알아도 이중 관리 부담이 크게 줄어든다. 더 나아가 두 도구를 상시 병행하는 이들에게는 파일 동기화 자체가 하나의 작업 규율이 된다는 점도 드러난다. 기준 파일을 정하고 변경 시 체크하는 절차를 미리 세워두는 습관이, 도구를 오가며 생기는 사소한 불일치를 막는 실질적인 안전장치인 셈이다.