광고
클로드코드

매번 ’한국어로’라고 치는 수고, CLAUDE.md 한 줄로 끝내는 법

2026-08-22 · 1분 읽기
매번 ’한국어로’라고 치는 수고, CLAUDE.md 한 줄로 끝내는 법
광고

매 대화마다 ‘한국어로 해줘’, ‘코드 주석은 영어로’라고 다시 입력해야 하는 게 번거로우시죠? 이런 반복 지시를 파일 한 줄로 해결할 수 있습니다. CLAUDE.md에 어떤 규칙을 어떻게 적어야 AI가 제대로 기억하는지, 실패하지 않는 방법을 알려드립니다.

핵심만 먼저 정리했어요

· CLAUDE.md는 프로젝트 폴더에 두는 텍스트 파일로, AI가 해당 프로젝트 작업을 시작할 때마다 자동으로 읽는 상시 지침서 역할을 합니다.

· 이 파일에는 ‘한국어로 답변하라’, ‘API 키를 코드에 직접 넣지 마라’처럼 모든 대화에서 지켜야 할 상시적인 규칙과 금지사항을 명확하게 기재해야 합니다.

· CLAUDE.md의 내용이 지나치게 길어지면 AI가 핵심 규칙을 놓치거나 무시할 수 있으므로, 반드시 짧고 구체적인 핵심 사항만 선별하여 작성하는 것이 효과적입니다.

CLAUDE.md에 ‘한국어로 답변’, ‘API 키 하드코딩 금지’ 등 상시 규칙을 한 줄로 적어두는 법

프로젝트 폴더에 CLAUDE.md 파일을 두면 클로드 코드가 매번 자동으로 읽어 규칙으로 삼습니다. 쉽게 말하면 AI에게 주는 상시 지침서라고 볼 수 있습니다. 세션이 바뀌어도 한 번 적어둔 내 말투나 업무 규칙이 계속 유지되는 원리입니다.

예를 들어 ‘항상 한국어로 답변해라’, ‘API 키를 코드에 직접 넣지 마라’처럼 짧고 명확하게 적는 것이 좋습니다. 이렇게 핵심만 짚어두면 AI가 혼란 없이 일관된 행동을 할 수 있습니다. 반면에 내용이 길어지면 오히려 지켜지지 않을 가능성이 높아집니다.

이 파일은 복잡한 설명보다 간결한 지시사항에 더 강점이 있습니다. 자주 쓰는 값이나 금지사항을 한 줄로 정리해 두세요. 필요할 때마다 매번 지시하는 수고를 덜어주는 실용적인 방법입니다.

회의록 요약 시 담당자별 액션 아이템 추출 규칙을 CLAUDE.md에 정의해 반복 지시 없이는 그대로 지키게 하는 팁

회의록을 정리할 때마다 ‘누가, 무엇을, 언제까지’를 빼달라고 반복적으로 지시하고 계시다면 CLAUDE.md 파일 활용을 고려해볼 수 있습니다. 이 파일은 프로젝트 폴더에 두면 AI가 매번 자동으로 읽어들이는 상시 지침서 역할을 합니다. 쉽게 말하면, AI에게 한 번만 알려주면 세션이 바뀌어도 계속 지켜야 하는 업무 규칙을 미리 적어두는 것과 같습니다.

예를 들어 ‘회의록 요약 시 담당자별 액션 아이템을 반드시 추출해라’라는 내용을 명확하게 정의해두면 좋습니다. 이렇게 하면 매번 동일한 형식으로 결과를 요청할 필요가 줄어듭니다. 반복적인 지시로 인한 피로감이 감소하고, 일관된 출력을 기대해볼 수 있는 구조가 만들어집니다.

다만 규칙을 작성할 때는 짧고 명확하게 쓰는 것이 효과적입니다. 내용이 지나치게 길어지면 오히려 AI가 이를 충분히 반영하지 못할 수 있습니다. 핵심만 짚어서 간결하게 표현하는 것이 규칙의 실효성을 높이는 지점입니다.

이런 방식으로 반복적인 업무를 시스템화해두면, 새로운 회의록이 들어올 때마다 동일한 품질의 요약 결과를 받아볼 수 있습니다. 처음 설정에 시간을 들이지만, 장기적으로는 업무 효율을 높이는 데 도움이 될 것입니다. 필요할 때 꺼내서 참고해두시면 좋겠습니다.

CLAUDE.md를 너무 길게 쓰면 AI가 규칙을 무시하는 이유와 핵심 금지사항만 남기는 실전 편집법

내 말투나 금지사항, 자주 쓰는 값을 한 번 적어두면 세션이 바뀌어도 계속 따르게 됩니다.

하지만 이 파일을 너무 길게 쓰면 오히려 규칙이 지켜지지 않을 수 있습니다. 정보가 많으면 핵심이 흐려져 AI가 중요도를 판단하기 어려워지기 때문입니다. 따라서 짧고 명확하게 작성하는 것이 좋습니다.

예를 들어 ‘항상 한국어로’, ‘API키 하드코딩 금지’, ‘커밋 전 확인받기’처럼 구체적인 지시만 남기는 것입니다. 이런 핵심 금지사항과 필수 규칙만 선별해 담아두면 AI가 훨씬 잘 따르는 경향이 있습니다.

불필요한 설명을 덜어내고 필요한 부분만 정리하는 습관을 들여보세요. 복잡한 설정보다 단순하고 명확한 지침이 실무에서 더 유용하게 작동하는 것 같습니다. 이 편집법을 참고해 본인만의 최적화된 CLAUDE.md를 만들어보시길 권합니다.

반복되는 지시를 파일에 위임하면, AI는 매번 같은 맥락 위에서 일관된 답변을 내어줍니다. 이 글이 도움되었다면 저장해두고, 새로운 프로젝트 시작 시 CLAUDE.md를 설정하는 첫 단계로 활용해보시길 권합니다.

이 글의 내용, 복사해서 바로 써보세요

아래 프롬프트를 AI 어시스턴트에 붙여넣고, 대괄호 부분만 내 상황으로 바꾸면 됩니다.

당신은 내 글쓰기 규칙을 준수하는 편집자 역할을 맡아 주세요.
아래 [여기에 작성할 내용을 붙여넣으세요] 칸에 입력된 텍스트를 대상으로 작업해 주세요.

1. 첫 문장에서 핵심이나 독자의 문제를 바로 짚어 주세요.
2. 반말이나 명령조, 다그치는 톤은 사용하지 마세요.
3. 단정적인 표현 대신 '~인 것 같습니다', '~해볼 수 있습니다'처럼 여지를 남기는 표현을 사용해 주세요.
4. 전문용어를 쓰면 바로 뒤에 '쉽게 말하면 ~'으로 풀어 설명해 주세요.
5. 한 문장에 한 가지 정보만 담고, 짧고 간결하게 작성해 주세요.
6. 결과는 천천히 온다는 태도를 유지하며, 과장된 표현은 피해 주세요.

위 규칙을 적용하여 최종 문단을 작성해 주세요.

저장해두고 필요할 때 꺼내 쓰세요. 결과가 어땠는지 댓글로 알려주시면 다음 글에 반영하겠습니다.

광고

같은 주제 더 보기 — 클로드코드