Claude Code를 글쓰기와 리서치를 위한 개인 AI 에이전트 시스템으로 만드는 법

들어가며: Claude Code는 개발자만을 위한 도구가 아니다

대부분의 사람들은 Claude Code가 앱을 빠르게 만들고 싶은 엔지니어를 위한 도구라고 생각합니다. 저도 그랬습니다. 이미 Cursor로 코딩 프로젝트를 잘 처리하고 있었고, Claude 웹/데스크톱으로 브레인스토밍, 리서치, 글쓰기를 충분히 해결하고 있었으니까요.

그래서 Claude Code가 출시되었을 때 솔직한 반응은 이랬습니다: "이미 잘 돌아가는 시스템을 왜 복잡하게 만들어?"

터미널은 위협적으로 보였고, 모든 데모는 코딩에 관한 것이었지 글쓰기가 아니었습니다. 그래서 몇 달간 무시했죠.

완전히 틀린 판단이었습니다.

두 달 전 Claude Code를 써보고 깨달았습니다: Claude Code는 제가 써본 최고의 글쓰기 및 리서치 어시스턴트일 수 있다는 것을요.

---

Claude Code가 일반 Claude와 다른 3가지 핵심 차이점

복잡한 아티클을 작업하면서 리서치에 파묻혀 있었습니다. PDF 10개, 여러 실험의 스크린샷, 여기저기 흩어진 메모들. 그 완벽한 인용구가 어느 파일에 있는지 기억나지 않는 그 느낌 아시죠?

예전에는 글쓰기를 시작하기도 전에 리서치 정리하는 데만 몇 시간을 썼습니다.

어느 날 우연히 Claude Code를 제 지저분한 리서치 폴더에 연결해봤습니다. 각 파일이 무엇인지 제가 설명하는 대신, Claude Code가 모든 것을 읽고 제가 놓친 연결고리들을 즉시 찾아내기 시작했습니다.

Claude Code가 다른 점은 세 가지입니다:

1. 에이전틱(Agentic): 맥락을 더 잘 이해하고 능동적으로 작업을 완료합니다
2. 빠름: 터미널에서 작동하므로 지연이 적고, 생각하고 실행하는 속도가 빠릅니다
3. 직접 파일 접근: 파일에 직접 접근하고 편집할 수 있습니다 - 이것이 가장 큰 차이점입니다

---

1. 시작하기: 설치와 설정

Step 1: Claude Code 설치

터미널을 열고 다음 코드를 붙여넣으세요:

npm install -g @anthropic-ai/claude-code

사전에 NodeJS 18+ 버전이 설치되어 있어야 합니다. 설치 중 오류가 발생하면 오류 코드를 Claude 웹/데스크톱에 붙여넣고 해결 방법을 물어보세요.

Step 2: 프로젝트 구조 설정

컴퓨터에 프로젝트 폴더를 만드세요. 예를 들어 "내 블로그 프로젝트" 같은 이름으로요.

Step 3: IDE 활용하기

순수하게 터미널에서만 작업하면 어둠 속에서 코딩하는 느낌입니다. 파일도 안 보이고, 폴더 구조도 파악하기 어렵죠. 이때 VSCode나 Cursor 같은 IDE가 필요합니다.

IDE에서 프로젝트 폴더를 열고, Terminal 탭에서 claude를 입력하면 Claude Code가 활성화됩니다.

Step 4: 테스트

• Claude Code에 "이 프로젝트에 어떤 파일이 있는지 보여줘"라고 입력
• IDE에서 "test.md" 파일을 새로 생성
• Claude Code에 "방금 이 프로젝트에 뭘 추가했어?"라고 질문

Claude Code가 새 파일을 인식하면 설정 완료!

---

2. claude.md: 프로젝트의 영구 기억 시스템

대부분의 사람들은 Claude Code를 파일에 접근하는 채팅 세션으로만 생각합니다. 매번 새로 시작하고, 프로젝트 맥락을 반복해서 설명하죠.

비밀은 claude.md 파일입니다 - 프로젝트의 영구 기억 시스템 역할을 합니다.

claude.md가 하는 일

• 모든 세션에 걸쳐 지속되는 프로젝트 맥락 저장
• 작업 스타일과 선호도 기억
• Claude가 어떻게 도와야 하는지에 대한 구체적인 지침 포함

설정 방법

1. 프로젝트 관련 파일을 모두 폴더에 모으세요:
   • 과거 콘텐츠 성과 데이터
   • 발행된 글들 (글쓰기 스타일 학습용)
   • 소개 페이지와 콘텐츠 설명
   • 독자 피드백
   • 콘텐츠 전략 문서
2. Claude Code 터미널에서 다음 명령어 실행:

/init

Claude Code가 전체 프로젝트 폴더를 읽고 자동으로 포괄적인 claude.md 파일을 생성합니다.

이제 세션을 시작할 때마다 Claude Code는 여러분의 글쓰기 스타일, 어떤 콘텐츠가 잘 먹히는지, 독자가 겪는 문제 유형 등을 이미 알고 있습니다.

---

3. 슬래시 커맨드: 작업 단축키

슬래시 커맨드는 Claude Code의 강력한 무기입니다. 매번 맥락을 설명할 필요 없이 정확히 어떤 도움이 필요한지 알려주는 사전 구축된 단축키입니다.

꼭 알아야 할 기본 명령어 5가지

명령어 설명

/agents	프로젝트의 다른 부분을 처리하는 활성 서브 에이전트 표시
/compact	대화 기록을 지우되 맥락 요약은 유지
/exit	Claude Code 세션을 깔끔하게 종료
/mcp	Model Context Protocol 연결 관리
/memory	Claude Code가 현재 세션에서 기억하는 내용 표시

커스텀 명령어 만들기

예시 - /quick-edit 명령어:

다음 항목에 집중해서 이 콘텐츠를 빠르게 개선해줘:
1. 개인적인 훅/오프닝 강화
2. 프레임워크를 더 명확하고 실행 가능하게
3. 섹션 간 전환 개선
4. 더 강력한 다음 단계로 결론 강화
5. 전체적으로 목소리 일관성 유지

이제 초안을 완성한 후 /quick-edit만 입력하면 됩니다. 매번 맥락을 설명할 필요가 없어요!

---

4. Plan Mode: 실행 전에 생각하기

바이브 코딩을 해본 분들이라면 공감하실 겁니다: 브레인스토밍을 요청했는데 AI가 요청도 안 했는데 바로 코딩을 시작해버리는 문제요. 글쓰기에서도 마찬가지입니다.

Plan Mode는 이 문제를 완전히 해결합니다. Claude Code가 바로 행동에 뛰어들지 않고, 먼저 무엇을 할 것인지 상세한 계획을 보여주고 승인을 기다립니다.

활성화 방법

Shift + Tab을 눌러서 Plan Mode를 켜세요.

언제 사용할까

• 여러 리서치 소스를 분석해서 요약 문서 만들 때
• 콘텐츠 폴더나 리서치 자료를 재정리할 때
• 독자 피드백을 처리하고 콘텐츠 개선점을 제안할 때

Plan Mode는 Claude Code를 지나치게 열정적인 어시스턴트에서 변경 전에 작업을 보여주는 사려 깊은 파트너로 변화시킵니다.

---

5. Sub-Agents: 백그라운드에서 일하는 AI 팀

서브 에이전트는 Claude Code가 특정 작업을 처리하도록 생성할 수 있는 더 작고 전문화된 AI 어시스턴트입니다.

서브 에이전트의 특징

• 특정 목적과 전문 영역을 가짐
• 메인 대화와 별도의 컨텍스트 윈도우 사용
• MCP 같은 특정 도구 사용 가능
• 고유한 시스템 프롬프트로 행동 안내

실제 활용 예시: 매일 아침 AI 뉴스 브리핑

매일 아침 서브 에이전트가 다음 작업을 수행합니다:

1. Perplexity MCP로 일일 AI 뉴스 소스 스캔
2. 독자에게 맞는 콘텐츠만 필터링
3. 과거 성과 데이터 기반으로 콘텐츠 아이디어 제안
4. 특정 포맷으로 "콘텐츠 아이디어" 폴더에 출력

결과? 커피 한 잔 마시고 나면 어제의 AI 뉴스와 맞춤형 콘텐츠 아이디어가 정리되어 있습니다. 주당 최소 5시간 절약!

서브 에이전트 생성 방법

/agents 명령어로 에이전트 모드를 열고 Claude Code에게 설정을 요청하세요.

---

6. Output Styles: Claude Code를 나처럼 생각하게 훈련시키기

Output Style은 Claude Code의 가장 과소평가된 기능입니다. 작업 유형에 따라 완전히 다른 방식으로 응답하도록 훈련할 수 있습니다.

왜 중요한가

대부분의 AI 대화는 천편일률적인 응답을 제공합니다. Output Style을 사용하면 다른 사고 모드를 미리 정의할 수 있습니다.

실제 활용 예시

1. 성장 전략가 모드

• 구체적인 성장 지표와 벤치마크
• 타임라인 추정치가 포함된 실행 가능한 전략
• 경쟁 분석 및 포지셔닝 인사이트

2. 퍼널 전환 모드

• 무료와 유료 티어 간 콘텐츠 격차 분석
• 유료 콘텐츠 가치 제안 최적화
• 전환 시퀀스 개선점

3. 소셜 미디어 전략가 모드

• 최대 소셜 임팩트를 위한 콘텐츠 재활용
• 플랫폼별 최적화 전략
• 바이럴 콘텐츠 패턴과 타이밍

---

7. MCP 통합: Claude Code를 파일 너머로 확장하기

Claude 웹/데스크톱처럼 **MCP(Model Context Protocol)**를 사용해 Claude Code를 여러 외부 앱과 서비스에 연결할 수 있습니다.

추천 MCP 설정

MCP 용도

Perplexity MCP	프로젝트를 떠나지 않고 실시간 웹 검색 및 분석
Firecrawl MCP	웹사이트에서 콘텐츠를 직접 추출하고 분석

Claude Code의 MCP 통합은 프로젝트 맥락을 이해하므로, 결과를 자동으로 정리하고 기존 파일과 일관성을 유지하며 claude.md 파일에 설정된 패턴을 따릅니다.

---

8. GitHub + Obsidian 통합: 24/7 AI 어시스턴트 만들기

가장 놀라운 부분입니다.

지금까지 다룬 모든 것 - 슬래시 커맨드, 서브 에이전트, MCP 통합, 출력 스타일 - 을 모바일 폰에서 언제 어디서나 접근할 수 있습니다.

모바일 돌파구: GitHub Issues를 Claude Code 명령어로

Claude Code 프로젝트를 GitHub에 연결하면, GitHub 모바일 앱을 통해 이슈 티켓으로 Claude Code에 명령을 내릴 수 있습니다.

워크플로우:

1. GitHub 모바일 앱 열기
2. 프로젝트 저장소에 새 이슈 생성
3. 요청 설명 작성: "최신 뉴스레터를 LinkedIn 포스트 5개로 재활용해줘"
4. 이슈에 코멘트: "Hey @claude, 이 이슈 처리해줘"
5. Claude가 이슈를 완료된 작업과 파일 위치로 업데이트

지하철에서 아이디어가 떠올랐다면? GitHub 이슈를 생성하세요. 사무실에 도착할 때쯤이면 Claude Code가 리서치를 완료하고 콘텐츠 브리프를 준비해놓습니다.

Obsidian: 모든 곳에서 프로젝트 데이터에 접근

Obsidian은 모든 것을 로컬 마크다운 파일로 저장합니다. Claude Code 프로젝트 폴더를 Obsidian 볼트로 설정하면 모든 기기에서 동기화됩니다.

음성 메모 활용 팁:

Wisprflow + Apple Shortcuts로 음성 메모를 녹음하면 자동으로 Obsidian 볼트에 삽입됩니다. 걷거나 운전하면서 콘텐츠 아이디어가 떠오르면 바로 녹음하고, 나중에 Claude Code에 "어제 음성 메모를 분석해서 뉴스레터 아웃라인으로 만들어줘"라고 요청하면 됩니다.

---

다음 단계: 단계별 접근법

한 번에 모든 것을 구현할 필요 없습니다. 단계별로 접근하세요:

Phase 1: 기본 설정

• Claude Code 설치
• 프로젝트 폴더 설정
• /init 실행해서 claude.md 생성
• 기본 슬래시 커맨드에 익숙해지기

Phase 2: 첫 커스텀 커맨드

• 가장 자주 하는 작업에 대한 커스텀 슬래시 커맨드 만들기

Phase 3: Plan Mode 실험

• 리서치 파일 정리 같은 안전한 작업으로 시작

Phase 4: 첫 서브 에이전트 배포

• 반복적인 백그라운드 작업에 활용

---

마치며

Claude Code는 단순히 더 빠른 응답을 받는 것이 아닙니다. AI와의 관계를 재정의하는 것입니다.

AI가 가끔 도움을 요청하는 대상에서, 작업을 이해하고 필요를 예측하며 프로젝트 백그라운드에서 지속적으로 작동하는 지능형 시스템으로 변합니다.

이것이 2025년 실용적인 AI 구현의 모습입니다. 인간의 창의성을 대체하는 것이 아니라 증폭하는 것. 모든 것을 자동화하는 것이 아니라, 정말 중요한 작업에 에너지를 쏟을 수 있도록 반복적인 인지 작업을 지능적으로 처리하는 것입니다.

프로젝트 맥락을 진정으로 이해하고, 선호도를 기억하며, 모든 기기에서 작동하는 AI 에이전트를 경험하고 나면 - 일반 AI 채팅으로 돌아가는 것은 한 손을 묶고 일하는 것처럼 느껴질 겁니다.

AI 에이전트의 미래는 오고 있는 게 아닙니다 - 이미 여기 있습니다.

---

원문: AI Maker Newsletter - How I Turned Claude Code Into My Personal AI Agent Operating System for Writing and Research