Claude Code를 쓰기 시작한 지 2년이 됐습니다. 처음엔 "목회자가 터미널을 열고 코딩 도구를?"이라는 의구심이 있었는데, 써보고 나서 생각이 완전히 바뀌었습니다. 코딩을 넘어 글쓰기, 자료 정리, 반복 작업 자동화, 교회 웹앱 제작까지 — 활용 범위가 생각보다 훨씬 넓었습니다.
이 글은 제가 직접 쓰면서 체감한 것들을 강의 형식으로 정리했습니다. 목회자의 눈으로 읽은 Claude Code 완전 활용 가이드입니다. 기술 지식 없이도 충분히 따라올 수 있도록, 개념부터 실전 워크플로우까지 최대한 촘촘하게 담았습니다.
Claude Code의 개념과 설치 / 에이전틱 사고방식 / 핵심 명령어 / 컨텍스트 관리 / 프롬프트 설계 / MCP·Hooks·에이전트 고급 기능 / 설교·교육·행정 실전 워크플로우 / 분별과 AI의 한계
Claude Code란 무엇인가
한 줄로 요약하면 "터미널에서 Claude와 대화하면서 실제 컴퓨터 작업을 처리하는 도구"입니다. 브라우저에서 쓰는 Claude.ai와 가장 큰 차이는 하나 — 내 컴퓨터 파일에 직접 접근한다는 것입니다.
Claude.ai 캔버스에서 HTML을 만들어도 실제 브라우저에서 다르게 보이는 경험, 많이 하셨을 겁니다. Claude Code는 처음부터 내 환경에서 직접 파일을 만들고, 수정하고, 실행합니다. 결과물이 바로 실제 작동하는 파일이 됩니다.
Claude Code vs Claude.ai 차이
| 구분 | Claude.ai (웹) | Claude Code (터미널) |
|---|---|---|
| 파일 접근 | 직접 접근 불가 | 내 컴퓨터 파일 직접 읽기·쓰기 |
| 결과물 | 텍스트·미리보기 | 실제 작동하는 파일 |
| 자동화 | 한 번에 한 작업 | 반복·순차 작업 자동화 |
| 연동 | 제한적 | Git, 터미널, MCP 서버 등 연동 |
| 적합 대상 | 일회성 질문·글쓰기 | 반복 작업·파일 관리·웹앱 제작 |
시작 방법
에이전틱 사고방식 — Claude Code를 잘 쓰려면 먼저 이것부터
Claude Code를 효과적으로 사용하기 위해 가장 먼저 필요한 것은 기술이 아니라 사고방식의 전환입니다. 혼자 작업하는 것이 아니라, AI라는 파트너와 함께 일하는 방식으로 생각해야 합니다.
원칙 1 — 큰 문제는 잘게 쪼개라
AI와 협업에서 가장 중요한 기술은 "큰 문제를 잘게 쪼개는 능력"입니다. AI는 명확하고 구체적인 지시를 받았을 때 가장 뛰어난 성능을 발휘합니다.
저는 이것을 "하나씩, 확인하고, 다음으로"라고 부릅니다. 사역 기획할 때와 같습니다. 단계마다 검증하면서 가면 완성됩니다.
실제로 저는 사순절 묵상 앱을 만들 때 이렇게 분해했습니다:
- 날짜별 본문 목록 화면 — 작동 확인
- 당일 본문 클릭하면 묵상 내용 보이기 — 작동 확인
- 묵상 완료 체크 표시 — 작동 확인
- 전체 진도율 표시 — 작동 확인
- 모바일에서도 잘 보이게 디자인 수정
한 번에 다 만들려 했으면 훨씬 오래 걸리고, 중간에 포기했을 겁니다.
원칙 2 — 계획 모드와 즉시 실행 모드
Claude Code에는 두 가지 작업 방식이 있습니다. 상황에 맞게 선택하는 것이 중요합니다.
원칙 3 — 미지의 영역에서 용감해지기
저는 Claude Code를 쓰면서 "미지의 영역에서 더 용감해졌다"는 걸 느꼈습니다. React를 제대로 배운 적이 없는데 React 앱을 만들었고, Python을 모르는데 데이터 처리 스크립트를 돌렸습니다.
비결은 간단합니다. 막히면 물어보는 겁니다. "이 줄이 정확히 무슨 의미인지 설명해줘", "왜 이 방식을 선택했어?", "더 간단한 방법은 없어?" AI가 설명해주면서 저도 배웁니다. 완전히 이해하지 못해도 괜찮습니다. 단계적으로 접근하면서 문제가 생기면 그 부분만 집중적으로 파고들면 됩니다.
환경 설정과 핵심 명령어
자주 쓰는 명령어들을 모아두겠습니다. 처음엔 외우려 하지 말고, 이 글을 옆에 두고 필요할 때 찾아보세요.
필수 슬래시 명령어
| 명령어 | 설명 | 언제 쓰나 |
|---|---|---|
/init | 프로젝트 설명서 자동 생성 | 새 프로젝트 시작할 때 가장 먼저 |
/clear | 대화 내용 초기화 | 새 작업 시작할 때, 컨텍스트 오염 시 |
/context | 현재 컨텍스트 사용량 확인 | AI가 엉뚱한 답을 할 때 |
/usage | 토큰 사용량 확인 | 세션 시작할 때 |
/export | 대화 내용 마크다운으로 저장 | 팀 공유, 기록 보관 |
/vim | Vim 모드 활성화 | Vim 사용자 |
/mcp | MCP 서버 목록·관리 | 외부 연동 설정할 때 |
/permissions | 승인된 명령어 관리 | 보안 점검, 위험 명령어 제거 |
/release-notes | 최신 업데이트 확인 | 주기적으로 |
! 접두사 — 즉시 실행의 마법
!를 붙이면 Claude 처리 없이 바로 터미널 명령이 실행됩니다. 토큰 낭비를 막고 속도가 빨라집니다.
키보드 단축키
| 단축키 | 기능 |
|---|---|
Esc Esc | 마지막 작업 되돌리기 (실수 즉시 취소) |
Shift+Tab × 2 | 계획 모드 전환 |
Ctrl+R | 이전 명령어 검색 |
Ctrl+S | 현재 프롬프트 임시 저장 |
Ctrl+G | 외부 에디터(VS Code 등)에서 프롬프트 편집 |
Ctrl+B | 실행 중인 작업을 백그라운드로 이동 |
Tab / Enter | Claude가 제안한 다음 작업 수락 |
CLAUDE.md — AI를 위한 프로젝트 설명서
프로젝트 루트에 있는 CLAUDE.md 파일은 AI가 가장 먼저 읽는 설명서입니다. 여기에 교단, 교회 이름, 디자인 색상, 코딩 스타일, 하면 안 되는 것들을 적어두면 매번 설명하지 않아도 됩니다.
자연어로 업데이트도 됩니다. "CLAUDE.md에 추가해줘: 모든 텍스트는 word-break: keep-all을 적용할 것"이라고 하면 파일을 직접 수정해줍니다.
단, 간결하게 유지하세요. 너무 길면 컨텍스트를 낭비합니다. 반복적으로 설명하게 되는 내용만 추가하는 것이 좋습니다.
세션 관리 — 작업을 잃지 않는 법
claude --continue 또는 claude -c. 컴퓨터를 껐다 켜도 마지막 대화를 이어갈 수 있습니다./rename 설교앱-2026 입력. 나중에 claude --resume 설교앱-2026으로 재개./export 명령으로 전체 대화를 마크다운 파일로 저장. 팀 공유, 문서화, 학습 자료로 활용.컨텍스트 관리의 기술
AI와 작업할 때 가장 자주 망치는 부분이 바로 컨텍스트 관리입니다. 이걸 잘하면 결과 품질이 확연히 달라집니다.
"컨텍스트는 우유와 같다"
AI에게는 한 번에 처리할 수 있는 기억 공간이 있습니다. 이것을 컨텍스트 윈도우라고 합니다. Claude는 최대 200,000 토큰까지 처리할 수 있는데, 대화가 길어지고 여러 주제가 섞이면 앞에서 했던 중요한 지시를 잊어버리기 시작합니다.
신선할 때가 가장 좋고, 오래되면 성능이 떨어집니다. 여러 주제가 섞이면 더 빨리 오염됩니다.
실전 관리 전략 4가지
전략 1 — 작업별로 대화를 분리하세요. 설교 준비는 따로, 교육 자료는 따로, 웹앱 작업은 따로. 한 대화창에서 여러 주제를 섞지 마세요. 갑자기 "아 그리고 출석부도 만들어줘"라고 하면 컨텍스트가 오염됩니다.
전략 2 — 새 작업은 /clear로 시작하세요. 특히 전혀 다른 성격의 작업을 시작할 때는 깨끗한 컨텍스트로 시작하는 게 좋습니다.
전략 3 — 긴 작업은 인수인계 문서를 만드세요. 작업이 길어져서 컨텍스트 50% 이상 사용 중이다 싶으면 이렇게 합니다:
전략 4 — /context로 현재 상태 확인하세요.
대화 기록이 너무 많다면 /clear로 초기화하거나, HANDOFF.md를 만들고 새로 시작합니다.
새신자 교육 앱 작업 중 컨텍스트가 너무 길어진 적이 있었습니다. AI가 갑자기 이전에 정해둔 디자인과 다른 스타일로 코딩하기 시작했고, 수정하느라 두 배 시간이 걸렸습니다. 그 이후로는 일정 분량 이상 작업하면 반드시 HANDOFF.md를 뽑아두고 새로 시작합니다.
프롬프트 설계 완전 정복
AI의 결과물 품질은 질문의 품질에 비례합니다. 잘 묻는 것은 기술이고, 연습하면 늡니다.
CRISPE 프레임워크 — 제가 실제로 쓰는 틀
설교 준비 프롬프트 수준 비교
같은 본문인데 결과의 깊이와 실용성이 완전히 달라집니다. 처음엔 프롬프트 작성이 번거롭게 느껴지지만, 결과 품질의 차이를 보면 투자할 가치가 있습니다.
AI 도구 4형제 — 각자 잘하는 게 다릅니다
| 도구 | 핵심 강점 | 목회 최적 활용 |
|---|---|---|
| Claude | 분석·글쓰기·장문 처리, 신중하고 논리적, 신학·인문에 탁월 | 설교 준비, 성경 연구, 강의 자료, 긴 문서 작업 |
| ChatGPT | 범용적, 빠른 초안, 예화 아이디어 다양 | 주보 문구, 행사 공지, 빠른 아이디어 발굴 |
| Gemini | Google 생태계 연동, 실시간 검색, 멀티모달 | Google 문서·스프레드시트 연동, 이미지 분석 |
| Perplexity | 실시간 검색 + 출처 자동 제공, 팩트 확인 최강 | 본문 배경 리서치, AI 결과 사실 검증 |
한 도구에만 의존하지 마세요. 저는 설교 준비 시 Perplexity로 배경과 출처를 확인하고, Claude로 구조를 잡고, ChatGPT로 예화 아이디어를 추가합니다. 각 강점을 조합하면 결과가 훨씬 좋아집니다.
고급 기능 — MCP·Hooks·에이전트
여기부터는 좀 더 깊이 들어가는 내용입니다. 처음 시작하시는 분은 넘어가도 됩니다. 어느 정도 익숙해진 후에 돌아오세요.
MCP — Claude를 외부 세계와 연결하기
MCP(Model Context Protocol)는 Claude가 외부 서비스와 직접 통신하게 해주는 프로토콜입니다. 설치하면 Claude가 데이터베이스를 직접 조회하거나, 웹을 크롤링하거나, 브라우저를 제어할 수 있습니다.
저는 목회 현장에서 이런 식으로 씁니다: "이 교단 공지사항 페이지를 크롤링해서 이번 달 중요 공지만 정리해줘." Firecrawl MCP가 설치되어 있으면 Claude가 직접 웹페이지를 읽고 정리해줍니다.
⚠️ MCP 성능 주의: MCP가 많을수록 컨텍스트를 많이 차지합니다. 10개 미만의 MCP 서버, 80개 미만의 활성 도구를 유지하세요. 안 쓰는 MCP는 /mcp로 비활성화하는 습관을 가지세요.
Hooks — AI에게 규칙을 강제하기
Hooks는 특정 이벤트가 발생할 때 자동으로 실행되는 명령어입니다. AI의 확률적 행동에 절대적인 규칙을 강제할 수 있습니다.
예를 들어 위험한 명령어를 차단하는 Hook:
이 설정이 있으면 Claude가 실수로 rm -rf 같은 위험한 명령을 실행하려 해도 자동으로 차단됩니다.
서브에이전트 — Claude의 엘프들
서브에이전트는 특정 작업에 전문화된 독립적인 AI 프로세스입니다. 복잡한 작업을 여러 에이전트에게 분산할 수 있습니다. 각자 독립적인 200k 컨텍스트 윈도우를 갖고 병렬로 실행됩니다.
저는 AI 목회 강의 준비할 때 이렇게 씁니다: "보안 감사 에이전트를 실행해서 이 코드베이스의 취약점을 찾아줘." 그동안 저는 다른 작업을 계속합니다. 완료되면 결과를 보고해줍니다.
Headless 모드 — 자동화 파이프라인에 통합
Claude Code는 대화형 도구를 넘어 자동화 파이프라인에 통합할 수 있습니다.
목회 현장 실전 워크플로우
이제 실제로 쓰는 방식들입니다. 하나라도 가져가시면 충분합니다.
설교 준비 — 4도구 조합 워크플로우
이 워크플로우를 쓰면 AI가 시간을 절약해주는 게 아니라, 더 깊이 생각할 수 있도록 도와줍니다. 저는 이 방식으로 설교 준비를 하고 나서 준비 시간이 오히려 늘었습니다. 더 많은 질문이 생겼기 때문입니다.
교육 콘텐츠 제작
연령별 교육 콘텐츠는 이 자료실의 교육 콘텐츠 제작 프롬프트(7종)를 활용하시면 됩니다. 여기서는 활용 원칙만 이야기합니다.
- 영유아·초등: 감각·신체 활동 포함. 부모 연계 자료도 함께 요청. "부모가 가정에서 이어갈 수 있는 활동을 포함해줘"
- 중고등: 설교보다 대화와 탐구 중심으로. "소그룹 나눔 질문 5개 포함해줘"
- 청년·장년: 삶과 연결된 적용. "개인·가정·직장·공동체 4가지 차원의 적용점 각각 1개씩"
- 노년: 큰 글씨, 간결한 언어. "큰 글씨 자료로 출력하기 적합한 형태로 만들어줘"
행정 문서 자동화
저는 이런 작업들을 Claude Code로 자동화했습니다:
- 주보 광고문 정리: 날짜와 행사 목록을 주면 주보 형식으로 변환
- 설교 녹취 요약: 녹취 텍스트를 넣으면 3줄 요약 + 핵심 구절 추출
- 회의 안건 정리: 주제들을 주면 교역자회 안건 형식으로 구성
- 사역 기획서 초안: 이 자료실의 사역 기획서 템플릿으로 직접 입력·관리
같은 작업을 세 번 이상 반복하고 있다면 자동화를 생각해보세요. 처음 설정에 30분이 걸려도, 이후에는 수십 배 이상 아낍니다.
글쓰기 도우미
AI는 탁월한 글쓰기 파트너입니다. 제가 실제로 쓰는 방식들입니다:
웹앱 제작 — Vibe Coding
저는 이것을 "Vibe Coding"이라고 부릅니다. 완성된 코드를 이해하지 못해도 됩니다. 원하는 게 무엇인지만 명확히 말하면 Claude Code가 만들어줍니다.
지금까지 이 방식으로 만든 것들:
- 사순절 40일 묵상 앱 — 날짜별 본문·묵상 질문 자동 제공
- 교회 출석 관리 시스템 — 부서별 입력, 자동 집계, 결석자 추적
- 설교 프롬프트 생성기 — 본문·청중·구조 선택하면 프롬프트 자동 생성
- 실시간 투표 앱 — 강의 중 QR코드 투표, AI 분석 결과 즉시 표시
- 새신자 정착 관리 시스템 — 등록부터 5단계 정착까지 추적
- 사역 기획서 관리 앱 — 일정·예산·KPT 평가 통합
이 앱들을 만들면서 코딩을 배운 게 아닙니다. 단지 "원하는 것을 명확하게 말하는 법"을 익혔습니다.
⚠️ 반드시 알아야 할 것 — AI 할루시네이션: AI는 존재하지 않는 신학자 발언, 없는 책 제목, 틀린 성경 구절 해석을 매우 자신 있게 말합니다. AI가 확신에 찬 표현("분명히", "확실히")을 쓸 때 오히려 더 의심하세요. 모든 인용과 역사적 사실은 Perplexity나 원자료로 확인하는 습관이 필요합니다. 강단에서 확인되지 않은 인용을 쓰면 신뢰를 잃습니다.
분별과 AI가 못 하는 것
저는 AI를 매일 씁니다. 설교 준비에도, 강의 자료에도, 행정 문서에도. 그래서 확실하게 말씀드릴 수 있습니다.
AI가 절대 대신할 수 없는 것
기도입니다.
성도의 이름을 부르며 드리는 기도.
눈물을 흘리며 강단 앞에 서는 것.
새벽에 홀로 하나님 앞에 무릎 꿇는 것.
이것은 정보의 문제가 아니라 관계의 문제입니다. AI는 관계를 가질 수 없습니다.
AI는 설교문의 구조를 잡아줄 수 있습니다. 예화를 제안해줄 수 있습니다. 주석 자료를 정리해줄 수도 있습니다. 그러나 AI는 성도의 이름을 알지 못합니다. 그 사람이 지난 주에 얼마나 힘들었는지 모릅니다. 그 눈물의 의미를 모릅니다.
목회의 언어는 체화된 언어입니다. 몸을 가지고, 시간을 살고, 고통을 함께 겪으면서 나오는 말. 그것은 AI가 생성할 수 없습니다. 그것이 목회자의 말입니다.
도구가 좋아질수록 사람이 더 중요해진다
AI 도구의 성능이 좋아질수록 역설적으로 그 도구를 쓰는 사람의 질이 더 중요해집니다. 같은 도구를 써도 깊이 생각하는 사람과 그렇지 않은 사람의 결과물은 완전히 다릅니다.
AI 시대에 목회자에게 오히려 더 필요한 것은 더 깊은 기도, 더 진실한 관계, 더 성실한 묵상입니다. AI는 외형을 채울 수 있지만, 내면은 채울 수 없습니다.
계속 배우는 것이 최고의 전략
Claude Code는 계속 발전합니다. 2026년 현재 기준으로 Claude Sonnet 4.6이 출시되었고, 기능이 계속 추가되고 있습니다. 따라가려면 계속 써보는 것이 가장 좋습니다.
제가 추천하는 학습 순서:
| 단계 | 기간 | 목표 | 핵심 학습 |
|---|---|---|---|
| 입문 | 1-2개월 | 일상 작업에 AI 활용 시작 | /init, /clear, 기본 프롬프트, CLAUDE.md |
| 중급 | 3-6개월 | 반복 작업 자동화, 웹앱 제작 | 컨텍스트 관리, HANDOFF.md, MCP 1개 |
| 고급 | 1년 이상 | 팀 공유 워크플로우 구축 | Hooks, 서브에이전트, 커스텀 명령어 |
처음엔 아무것도 외우려 하지 마세요. 지금 당장 설교 준비 중인 본문으로 Claude에게 한 번 물어보세요. 써보는 게 가장 빠른 학습입니다.
그 도구를 쓰면서 내가 어디로 가고 있는지를 아는 것이
더 중요합니다.
이 자료실의 설교 준비 프롬프트 패키지, 목회 상담 프롬프트, 교육 콘텐츠 프롬프트를 함께 활용하시면 실전에서 훨씬 더 많은 도움이 되실 겁니다. 질문과 나눔은 커뮤니티 게시판에서 만나요.
나눔
0개로그인하시면 나눔에 참여할 수 있습니다.
로그인 / 가입