# 클로드 코드를 시작하려면 먼저 이것을 결정하세요: [CLAUDE.md 설정 프롬프트 포함]

> https://bookfactory.kr/board/ai-tech/17377
> 게시판: AI·머신러닝
> 작성자: admin
> 작성일: 2026-09-17T22:34:29.859Z

---

![見出し画像](https://assets.st-note.com/production/uploads/images/313891451/rectangle_large_type_2_3c45a780b3feaa7f7b497bd1dd4f6c2f.png?width=1280)

지난번에 note와 Threads의 자동화와 AI 조직 시각적 형태 구축에 어려움을 겪었던 이야기를 말씀드렸습니다.

그러면서 잠시 언급했던 것이 “CLAUDE.md”라는 파일입니다.

클래피(AI에 컴퓨터상의 작업을 맡길 수 있는 도구)에는 자신의 규칙과 방식을 학습시킬 수 있는 중요한 설정 파일이 있습니다.

이 시리즈에서는 지난번에 이어 Claude Code를 “클래피”라고 부릅니다.

이번에도 이 표현으로 써 내려갈 것입니다.

이전 게시글

먼저 결론만 말씀드리겠습니다.

가장 먼저 결정해야 할 것은 무엇을 “전체 프로젝트 공통 규정”으로 하고, 무엇을 “해당 프로젝트만의 규정”으로 할지 결정하는 것입니다.

지금 한 가지 일만 하더라도, 이 생각 방식만은 갖춰 두는 것이 좋습니다.

앞으로 크라피를 시작할 사람은 물론, 이미 시작한 사람도 나중에 변경할 수 있습니다.

저 역시 이번에 바로 그 변경을 단행했습니다.

## ## CLAUDE.md는 무엇인가

CLAUDE.md는 OpenAI의 GPT-4 모델을 기반으로 구축된 이미지 생성 AI 서비스입니다.

**주요 기능:**

*   **텍스트 기반 이미지 생성:** 텍스트 프롬프트를 입력하면 GPT-4가 생성한 설명을 바탕으로 고품질 이미지를 생성합니다.
*   **이미지 편집:** 기존 이미지에 대한 수정, 편집, 변형이 가능합니다.
*   **다양한 스타일 지원:** 사진, 그림, 3D 렌더링 등 다양한 스타일의 이미지를 생성할 수 있습니다.
*   **이미지 변환:** 텍스트 프롬프트와 함께 이미지 변환 기능을 사용하여 기존 이미지를 새로운 스타일로 변환할 수 있습니다.
*   **이미지 업로드 및 활용:** 사용자가 직접 이미지를 업로드하여 편집하거나, 생성된 이미지를 다운로드하여 다양한 용도로 활용할 수 있습니다.

**CLAUDE.md의 특징:**

*   **GPT-4 기반:** OpenAI의 GPT-4 모델을 활용하여 더욱 정교하고 창의적인 이미지를 생성합니다.
*   **사용자 친화적인 인터페이스:** 직관적인 인터페이스를 통해 누구나 쉽게 사용할 수 있습니다.
*   **다양한 활용 가능성:** 광고, 디자인, 콘텐츠 제작 등 다양한 분야에서 활용될 수 있습니다.

**참고:** CLAUDE.md는 지속적으로 업데이트되고 있으며, 새로운 기능과 개선 사항이 추가될 예정입니다.

CLAUDE.md는 AI 직원에게 자신의 규칙과 방식에 익숙해지도록 하는 파일입니다.

클래피는 작업을 시작할 때마다 이 파일을 읽어옵니다.

이름, 경력, 발신 톤, 금지 사항

이 부분이 사실 가장 중요한 부분입니다.

저 자신을 제대로 기억해 줄 때마다, 크라피가 저만을 위한 비서로 성장해 가는 것이거든요.

중요한 것은 서식이나 마크다운 작성 방식을 스스로 익힐 필요가 없다는 것입니다.

기억해야 할 사항이 있다면 “이거 기억해 둬”라고 클래피에게 말하기만 하면 됩니다.

그는 계속해서 클로드.md 파일에 내용을 덧붙여 줍니다.

## 처음에는 한 권으로 시작했습니다.

처음에는 CLAUDE.md를 하나만 만들었습니다.

노트 기사 작성 부업용으로 이름, 경력, 발신 스타일, 업무 규칙을 모두 기록했습니다.

이것은 결국 제가 직접 파일을 열어 쓴 것이 아니고, 필요한 것이 나올 때마다 “이 규칙을 기억해 두라”라고 말한 것뿐입니다.

한 가지 일만 하기에, 그것으로 충분했습니다.

## 사업을 확장하게 되면서 같은 내용을 반복적으로 작성하게 되는 경우가 많아졌습니다.

그 이후로 HP·LP 제작, 팸플릿 및 포스터 디자인 등 note·어필리에이트와는 성격이 다른 시도도 해보았습니다.

서로 다른 종류의 작업은 같은 폴더에 섞지 않는 것이 좋습니다.

다른 프로젝트로 분리해야 한다고 생각합니다.

예를 들어,

기사 작성용 프로젝트, 프로그램 제작 프로젝트, 인공지능 조직 자체를 만드는 프로젝트.

규칙과 암기해야 할 내용이 다른 작업을 1가지로 섞으면 AI가 혼란하기 쉬워집니다.

그래서 새로운 프로젝트마다 CLAUDE.md를 만들었습니다.

그러나, 여기서 문제가 발생했습니다.

이름, 경력, 발신 기본 톤, 숫자 과장 금지 등의 업무 규칙.

새로운 프로젝트를 만들 때마다 이러한 “프로젝트의 변화가 있어도 변하지 않는 부분”을 매번 복사하여 다시 붙여넣고 있었습니다.

## 글로벌 클로드(Global Claude.md)와 프로젝트 클로드(Project Claude.md)로 분리했습니다.

이 두 번째 단계에 착안하여 크래피 기능을 재검토했습니다.

그러다 보니, 클래피에는 “글로벌CLAUDE.md”라는 파일을 별도로 두고, 모든 프로젝트에서 공유하여 읽을 수 있도록 하는 기능이 있다는 것을 알게 되었습니다.

그러므로 이렇게 분류를 재정리했습니다.

- 글로벌CLAUDE.md(~/.claude/CLAUDE.md): 이름, 경력, 발신 기본 톤, 금지 표현, 숫자 조작 금지 등 전체에 적용되는 규칙
- 각 프로젝트 내의 CLAUD.md: 상품, 페르소나, 폴더 구성, SNS별 작성 방식 등 해당 프로젝트만의 규칙

## 기억해 둡니다는, 어느 방향으로 쓰느냐를 본인이 직접 결정해야 합니다.

여기 한 가지 주의사항이 있습니다.

CLAUDE.md를 분리한 후에도 “이것을 기억해 놔”라고 AI에게 말해도, 어떤 CLAUD.md에 기록할지 자동으로 제대로 분리해주지는 않습니다.

방치하면 현재 열고 있는 프로젝트의 클라우드(Claude.md)에 아무거나 다 쓰여집니다.

그래서 저는 “기억해”라고 말씀 받으면, 전체 규칙과 이 프로젝트만의 규칙 중 무엇인지 AI 스스로 확인하도록 했습니다.

글로벌CLAUDE.md에는 그 분배 규칙 자체를 작성해 둔 것입니다.

이제 클라피에게 “기억해 둬”라고 말하면, 필요할 때마다 “전체 규칙으로 할까요, 이 프로젝트만의 규칙으로 할까요?”라고 되묻게 되었습니다.

물론 “전체 규칙으로 기억해 둡니다”라고 스스로 지정하실 수도 있습니다.

## 이미 진행 중이신 분들을 위해

지금 1개의 CLAUDE.md 파일에 전부 작성하고 있더라도, 중간부터 이 형태로 변경할 수 있습니다.

실제로 제가 이번에 진행한 일도 바로 그 작업이었습니다.

기존 프로젝트의 CLAUDE.md에서 다른 프로젝트와 동일한 부분을 찾아 글로벌 CLAUDE.md로 이동한다.

원래 프로젝트의 CLAUDE.md에서는 해당 부분을 삭제하고, 글로벌 측에 참조하는 문장 하나만 남겼다.

실제로 제가 남긴 문장은 다음과 같습니다.

> 
> 
> 이름, 경력, 발신 기본 톤, 숫자 조작 금지 등 모든 프로젝트 공통 규칙은 글로벌 ~/.claude/CLAUDE.md 파일로 이관했으며, 이 파일에는 내용을 작성하지 않습니다.
> 

이렇게 하면 새로운 프로젝트를 만들 때의 번거로움이 완전히 달라집니다.

## 얘야, 그 ‘별의 정원사’는 정말 대단하지 않아? 어렸을 때 이 책을 읽고 깊은 감동을 받았으며, 나이가 들어 지금도 그 감동을 잊을 수 없어. 이 책은 어린 시절, 인생의 교훈을 가르쳐 줬고, ‘가장 소중한 것은 눈에 보이지 않아’라는 마음을 울리는 메시지를 담고 있어. 게다가, 이 책은 내 삶을 풍요롭게 해 줬으며, 다양한 일에 도전하게 만들었어. 정말 고마워.

CLAUDE.md는 AI 직원에게 자신의 정보를 기억하도록 하는 파일입니다.

가장 먼저 결정해야 할 것은 다음 두 가지입니다.

서로 다른 성격의 작업은 프로젝트를 분리하고, 공통 규칙은 글로벌 CLAUDE.md에 위치시킵니다.

이렇게 하면 나머지 모든 과정이 완전히 달라집니다.

실은 AI 조직을 만들어보면서 여러 가지 문제들이 발생했습니다.

다음 회차는 여러 개의 채팅을 동시에 운영하는 형태로 만들기 위해 전체를 재구성하는 이야기를 쓸 예정입니다. ※ 내용은 변경될 수 있습니다.

## 클루드 3 모델의 능력을 최대한 활용하기 위한 프롬프트 작성 가이드라인입니다. 특히 복잡한 작업이나 창의적인 결과물을 얻고자 할 때 유용합니다.

이 프롬프트 작성의 핵심은 다음과 같습니다.

1.  **명확한 지시:** 목적을 명확하게 전달하고 클루드 3에게 무엇을 해야 하는지 구체적으로 지시합니다. 애매한 표현은 피하고 구체적인 키워드나 조건을 포함하도록 하십시오.
2.  **역할 정의:** 클루드 3에게 특정 역할을 부여함으로써 더 적절한 답변을 이끌어낼 수 있습니다. “당신은 ~ 전문가입니다”와 같이 역할을 명확하게 정의하십시오.
3.  **제약 조건:** 답변의 형식, 길이, 대상 독자 등을 지정함으로써 클루드 3가 더욱 정확한 결과물을 생성하는 데 도움이 됩니다.

이러한 핵심 사항을 바탕으로 프롬프트를 작성하면 클루드 3의 잠재력을 최대한 활용하고 기대하는 결과를 얻을 가능성이 높아집니다.

이 정도까지 읽어보셨다면, 여러분을 위해 제가 사용하는 훈련용 프롬프트를 준비했습니다. Claude.md도 직접 만들어보고 싶어하는 분들을 위해 준비했습니다.

이 기사 내용에 맞춰 프롬프트를 2가지로 나누었습니다.

먼저 ① 기본용(글로벌)을 만들고 나서 ② 프로젝트용(무언가를 판매한다는 가정 하에)을 만드는 순서가 추천됩니다.

클래피에 그대로 붙여넣기 한 결과, AI가 순차적으로 질문을 던지면서 함께 CLAUDE.md 파일을 만들어 줍니다.

### 기본 사용(글로벌) CLAUDE.md 생성 프롬프트

### ② 프로젝트용 CLAUDE.md 작성 프롬프트 (무언가를 판매한다는 가정 하에)

**출처:** [note 원문](https://note.com/mild_ixora6330/n/n7df5bfcd2883)

*번역: Gemma 3(.44) 초벌 + 교정 40청크*

[원문 보기](https://note.com/mild_ixora6330/n/n7df5bfcd2883) | 출처: note.com