AI 지침을 파일로 관리하면 달라지는 것들 — VS Code + CLAUDE.md 실전 가이드

웹에서 AI 지침을 설정해봤다면, 한 가지 불편함을 느꼈을 겁니다. 지침이 길어질수록 관리가 어렵고, 프로젝트마다 다른 규칙을 체계적으로 분리하기 힘들다는 점입니다.

이 문제를 해결하는 방법이 있습니다. AI 지침을 텍스트 파일로 만들어 VS Code에서 관리하는 것입니다. 개발자들이 쓰는 방식이지만, 코딩을 전혀 몰라도 할 수 있습니다.

웹 지침 설정의 한계

이전 글에서 Claude 프로젝트 지침, ChatGPT Custom Instructions, Grok 커스텀 지침을 다뤘습니다. 이 기능들은 훌륭한 출발점이지만, 실무에서 쓰다 보면 몇 가지 벽에 부딪힙니다.

첫째, 한 칸에 모든 걸 넣어야 합니다. 문체 규칙, 형식 규칙, 금지 사항, 참고 정보를 하나의 텍스트 박스에 섞어 적으면 금방 복잡해집니다.

둘째, 수정 이력이 남지 않습니다. "지난주에 바꾼 규칙이 뭐였지?" 하고 되돌아갈 수 없습니다.

셋째, 팀과 공유하기 어렵습니다. 내 지침을 동료에게 전달하려면 복사-붙여넣기뿐입니다.

파일로 관리하면 이 세 가지가 모두 해결됩니다.

VS Code가 뭔데, 왜 이걸 쓰나요

VS Code(Visual Studio Code)는 마이크로소프트가 만든 무료 텍스트 편집기입니다. 개발자들이 코드를 작성할 때 쓰지만, 본질적으로는 고급 메모장입니다.

AI 지침 관리에 VS Code를 쓰는 이유는 세 가지입니다.

• 폴더와 파일로 정리할 수 있습니다 — 지침을 주제별로 나눠서 관리
• AI 도구가 내장되어 있습니다 — Claude Code, Cursor, GitHub Copilot 등이 이 파일을 직접 읽습니다
• 수정 이력이 자동으로 남습니다 — Git 연동 시 언제 무엇을 바꿨는지 추적 가능

코드를 한 줄도 쓸 필요 없습니다. 텍스트 파일을 만들고, 폴더에 넣고, AI에게 읽히는 것이 전부입니다.

CLAUDE.md란

CLAUDE.md는 AI에게 프로젝트의 규칙을 알려주는 텍스트 파일입니다. 확장자가 .md인 마크다운 파일이고, 프로젝트 폴더의 최상단에 놓습니다.

웹에서 입력하던 지침과 같은 내용을 담지만, 파일이기 때문에 구조화가 가능합니다.

웹 지침 (한 칸에 몰아넣기):

나는 기획자입니다. 격식체로 써주세요. 표를 사용해주세요. 숫자에는 단위를 붙여주세요. 영어 약어는 한글 병기해주세요...

파일 지침 (구조화):

프로젝트-폴더/
├── CLAUDE.md          ← 핵심 규칙 (간결하게)
└── docs/
    ├── writing-rules.md   ← 문체·형식 상세 규칙
    ├── seo-guide.md       ← SEO 관련 규칙
    └── translation-guide.md ← 번역 규칙

핵심 규칙은 CLAUDE.md에 짧게, 상세 규칙은 docs 폴더에 분리합니다. AI는 필요할 때 해당 파일을 참조합니다.

실전: 처음부터 따라하기

1단계 — VS Code 설치

code.visualstudio.com에서 무료로 다운로드합니다. Windows, Mac, Linux 모두 지원합니다.

2단계 — 프로젝트 폴더 만들기

바탕화면이나 원하는 위치에 폴더를 하나 만듭니다. 이름은 자유입니다 (예: my-ai-rules).

VS Code에서 "파일 → 폴더 열기"로 이 폴더를 엽니다.

3단계 — CLAUDE.md 파일 만들기

VS Code 좌측 탐색기에서 "새 파일" 아이콘을 클릭하고, 파일 이름을 CLAUDE.md로 지정합니다.

아래 내용을 붙여넣고 자신에 맞게 수정합니다.

# 프로젝트 지침

나는 IT 기업의 기획자입니다. 이 프로젝트의 산출물은 주간 보고서, 기획 문서, 회의록입니다.

## 핵심 규칙

1. 격식체(입니다/합니다) 사용
2. 결론을 먼저, 근거는 뒤에
3. 숫자에는 반드시 단위와 출처 명시
4. 추측성 표현 최소화

## 상세 지침

파일	내용
docs/writing-rules.md	문체·형식 규칙
docs/report-template.md	주간 보고서 양식

4단계 — 상세 규칙 파일 만들기

docs 폴더를 만들고 그 안에 writing-rules.md 파일을 만듭니다.

# 문체 규칙

## 기본 원칙

• 한 문장은 40자 이내
• 접속사("그리고", "그래서") 남용 금지
• 영어 약어는 첫 등장 시 한글 병기 (예: PM(프로젝트 매니저))

## 금지 사항

• "~일 수 있습니다" 류의 회피 표현
• 이모지 사용
• 3문장 이상의 서론

이렇게 규칙이 늘어나도 파일별로 분리되어 있으니 관리가 쉽습니다.

5단계 — AI에게 읽히기

이 파일들을 AI에게 전달하는 방법은 여러 가지입니다.

방법 A: 웹에 붙여넣기

CLAUDE.md 내용을 복사해서 Claude 프로젝트 지침이나 ChatGPT Custom Instructions에 붙여넣습니다. 파일을 관리하는 곳은 VS Code, 실제 사용은 웹 — 이렇게 분리하면 수정 이력이 로컬에 남습니다.

방법 B: AI 코딩 도구 사용

VS Code에 Claude Code, Cursor, GitHub Copilot 같은 AI 확장을 설치하면, AI가 CLAUDE.md를 자동으로 읽습니다. 별도로 붙여넣을 필요가 없습니다. 이 방법이 가장 강력하지만, AI 코딩 도구에 대한 추가 학습이 필요합니다.

방법 C: 파일 첨부

Claude 프로젝트나 ChatGPT GPTs에 파일을 직접 업로드합니다. CLAUDE.md와 docs 폴더의 파일들을 첨부하면 AI가 참조합니다.

파일 관리의 실질적 장점

수정 이력 추적

"지난달에 보고서 형식을 바꿨는데 원래 뭐였지?" — 파일로 관리하면 이전 버전을 되돌아볼 수 있습니다. Git을 쓰면 자동으로 기록되고, Git 없이도 파일을 날짜별로 백업해두면 됩니다.

팀 공유

지침 파일을 GitHub에 올려두면 팀원 모두가 같은 규칙을 쓸 수 있습니다. 누군가 규칙을 수정하면 모두에게 반영됩니다. 복사-붙여넣기로 전달하던 시절과는 차원이 다릅니다.

점진적 확장

처음에는 CLAUDE.md 하나로 시작합니다. 규칙이 늘어나면 docs 폴더에 파일을 추가합니다. 프로젝트가 여러 개면 폴더를 나눕니다. 구조가 자연스럽게 성장합니다.

웹 지침과 파일 지침 비교

항목	웹 지침 설정	파일(VS Code) 지침
시작 난이도	쉬움 (바로 입력)	약간의 설정 필요
구조화	한 칸에 몰아넣기	파일·폴더로 분리
수정 이력	없음	Git 또는 수동 백업
팀 공유	복사-붙여넣기	GitHub 등으로 공유
AI 도구 연동	수동 붙여넣기	자동 인식 (Claude Code 등)
추천 대상	AI 입문자, 가벼운 사용	지침이 복잡해진 사용자

정리

웹에서 AI 지침 설정에 익숙해졌다면, 파일로 관리하는 단계로 넘어갈 준비가 된 겁니다.

VS Code는 무료이고, CLAUDE.md는 텍스트 파일일 뿐입니다. 코딩을 몰라도 폴더를 만들고 텍스트 파일을 정리하는 것만으로 AI 지침을 체계적으로 관리할 수 있습니다.

지침 하나로 시작해서, 필요할 때 파일을 추가하면 됩니다. 복잡하게 생각할 필요 없습니다 — 결국 잘 정리된 메모장입니다.