home
About
home
청년들의 시작
청년들 구성원
청년 랩스
최근 소식
세무 기장대리
세무 컨설팅
경리업무 아웃소싱
매입매출관리시스템
기장상담신청
조직문화
청년들 독서클럽
리더 생각
청년주니어교육
청년들 일상
필택스
준오헤어-스터디
상담 문의
영등포 본점・지점
인재 채용
home
About
Service
Contact

클로드코드 - 비개발자편

클로드코드-비개발자편
이 책은 코딩 경험이 없는 분을 위해 쓰였습니다. PM, 마케터, 디자이너, 영업, 경영지원 등 직무와 관계없이 컴퓨터로 반복 업무를 하고 있다면 대상입니다.
Claude Code는 터미널에서 자연어로 지시하면 내 컴퓨터의 파일을 직접 다루는 AI 비서입니다. 파일 정리, 데이터 분석, 보고서 작성, 외부 도구 연동까지 코딩 없이 할 수 있습니다.

왜 지금 배워야 하나요?

AI는 이미 선택이 아닌 필수가 되고 있습니다. 특히 비개발 직군에서도 "AI 도구를 업무에 활용할 수 있나요?"가 면접 질문으로 등장하기 시작했습니다.
지금 Claude Code를 배워두면:
•
면접 경쟁력: "Claude Code로 반복 업무를 자동화했습니다"라고 말할 수 있는 지원자는 아직 많지 않습니다
•
업무 효율: 팀에 합류하자마자 바로 생산성을 보여줄 수 있습니다
•
선점 효과: 1-2년 후에는 모두가 배우게 될 기술을, 지금 먼저 익혀두는 것입니다
•
커리어 확장: AI 활용 역량은 이제 PM, 마케터, 경영지원 모든 직무에서 요구되는 기본 역량이 될 것입니다
기술이 대중화되기 전에 먼저 배우는 사람이 유리합니다. 이 책은 그 출발점입니다.

이 책을 읽으면

이 책을 끝까지 읽고 따라 하면:
0. 이책에 들어가기전

이 장에서 배우는 것

•
Claude Code가 무엇이고, 왜 "코딩 도구"가 아닌지
•
화면 기반 AI(Claude.ai, ChatGPT)와 어떻게 다른지
•
업무 방식이 어떻게 바뀌는지
•
실제로 누가, 어떻게 쓰고 있는지
•
처음 시작할 때 겪는 어려움과 극복 방법
이름에 "Code"가 붙어 있어서 오해하기 쉽습니다. Claude Code는 코드를 작성하는 도구가 아니라, 내 컴퓨터에서 직접 파일을 다루는 AI 비서입니다. 파일 정리, 데이터 분석, 보고서 작성까지 자연어로 지시하면 됩니다.

화면으로 쓰는 AI vs 명령어로 쓰는 AI

AI 도구를 사용하는 방식은 크게 두 가지입니다.
화면 기반: 웹사이트나 앱에서 버튼을 누르고, 채팅창에 입력하는 방식입니다. ChatGPT, Claude.ai, Gemini 같은 서비스가 여기에 해당합니다. 익숙하고 직관적이지만, 할 수 있는 일이 화면 안에서 제공하는 기능으로 한정됩니다.
명령어 기반: 터미널이라는 텍스트 입력 창에서 AI에게 직접 지시하는 방식입니다. Claude Code가 여기에 해당합니다. 화면은 단순하지만, 내 컴퓨터의 파일을 직접 다룰 수 있어서 할 수 있는 일의 범위가 넓습니다.
구분
화면 기반 (웹/앱)
명령어 기반 (터미널)
사용법
채팅창에 입력, 버튼 클릭
터미널에 문장으로 지시
파일 처리
직접 업로드해야 함
내 컴퓨터 파일에 바로 접근
결과물
답변을 텍스트로 보여줌
파일을 직접 만들고 수정함
예시
Claude.ai, ChatGPT
Claude Code
1장. Claude Code는 코딩 도구가 아닙니다

이 장에서 배우는 것

•
터미널이 무엇이고, 왜 필요한지
•
자신의 OS에 맞는 터미널 앱 선택 (Mac: iTerm2, Windows: Windows Terminal)
•
Homebrew 설치 (Mac)
•
터미널 기본 사용법 (cd, pwd)
•
터미널 사용 중 흔한 문제와 해결법
Claude Code는 터미널에서 실행됩니다. 이 장에서는 터미널이 무엇인지, 어떤 앱을 쓰면 좋은지, 그리고 Claude Code를 쓰기 위해 알아야 할 최소한의 사용법을 다룹니다.

터미널이란

터미널은 컴퓨터에 텍스트로 명령을 입력하는 프로그램입니다. 평소에 마우스로 폴더를 열고, 파일을 클릭하는 것과 같은 일을 텍스트로 하는 것입니다.
Claude Code를 쓸 때 터미널 명령어를 많이 알 필요는 없습니다. 터미널은 Claude Code를 실행하는 입구이고, 실행한 뒤에는 자연어로 대화하면 됩니다. 알아야 할 명령어는 이 장에서 다루는 것이 전부입니다.
터미널은 안전합니다 처음 터미널을 열면 까만 화면에 텍스트만 나와서 당혹스러울 수 있습니다. 뭘 잘못 건드려서 컴퓨터가 망가지면 어쩌나 싶은 마음도 들 수 있습니다. 걱정하지 않아도 됩니다. 이 장에서 다루는 명령어(cd, pwd)는 폴더 위치만 확인하고 이동하는 것이라서, 파일이 지워지거나 변경되는 일은 없습니다. 마치 Finder나 탐색기에서 폴더를 클릭하는 것과 같습니다.

터미널 앱 선택

2장. 터미널 준비하기

이 장에서 배우는 것

•
구독 플랜 선택 기준 (Pro vs Max)
•
Claude Code 설치 방법 (Mac/Windows/Linux)
•
첫 실행과 로그인
•
안전하게 사용하는 방법
•
처음에 겪는 느낌과 적응 기간
이 장에서는 Claude Code를 설치하고 첫 번째 작업을 실행합니다. 터미널이 준비되어 있다는 전제로 진행합니다 (2장 참고).

구독 플랜 선택

Claude Code를 사용하려면 Claude 유료 구독이 필요합니다. 구독하면 Claude.ai(웹/앱)와 Claude Code(터미널)를 하나의 계정으로 사용할 수 있습니다.
플랜
월 비용
사용량
추천 대상
Pro
$20
기본
처음 시작하는 분, 가벼운 작업
Max 5x
$100
Pro의 5배
Claude Code를 자주 쓰는 분
Max 20x
$200
Pro의 20배
하루 종일 쓰는 분
Claude.ai와 사용량이 합산됩니다 웹에서 Claude.ai를 많이 쓰면 Claude Code에 쓸 수 있는 양이 줄어듭니다. 사용량은 5시간 단위로 초기화됩니다.

비용

$20(약 2.7만원)짜리 Pro 플랜의 사용량은 생각보다 빨리 소진됩니다. Claude Code는 하나의 작업을 처리할 때 내부적으로 여러 번의 처리를 하기 때문에, 웹에서 대화하는 것보다 사용량 소모가 큽니다. "파일 20개 이름을 바꿔줘" 같은 간단한 작업도 Claude Code 입장에서는 파일 목록 확인, 이름 변경 계획, 실행, 결과 확인 등 여러 단계를 거칩니다.
추천 전략: Pro 플랜으로 시작해서 2~3일 써보면 자신의 사용 패턴이 보입니다.
•
하루에 한두 번 짧은 작업: Pro로 충분
•
업무 시간 내내 켜두고 사용: Max 5x($100)가 현실적
•
Max 20x($200): 하루 8시간 이상 쓰는 경우 (이 책 독자 대부분에게 불필요)
3장. 설치와 첫 시작
파트 1에서 다룬 내용을 보충합니다. 필요할 때 찾아보면 됩니다.
부록 활용 팁 처음 읽을 때는 표시가 있는 것만 보세요. 나머지는 필요할 때 찾아보면 됩니다.

실행 옵션

터미널에서 Claude Code를 시작할 때 쓰는 명령어입니다.

초보자 필수

처음에는 아래 세 개만 알면 충분합니다.
명령어
설명
실사용 상황
claude
새 대화 시작
새로운 작업을 시작할 때
claude --continue
마지막 대화 이어서 시작
점심 후 복귀, 터미널 재시작
claude --resume
이전 대화 목록에서 선택
며칠 전 작업 다시 찾을 때

실전 예제

점심 먹고 돌아왔는데 터미널이 꺼져있음
월요일에 금요일 작업 다시 시작

익숙해진 뒤에

명령어
설명
실사용 상황
claude --dangerously-skip-permissions
권한 확인 건너뛰기
작업 전용 폴더에서 반복 작업
claude --model sonnet
모델 지정
특정 모델로 시작하고 싶을 때
claude -p "질문"
한 번만 질문하고 종료
빠른 확인이 필요할 때
claude --version
설치된 버전 확인
업데이트 확인 전
claude --help
실행 옵션 목록
명령어 기억 안 날 때
claude update
수동 업데이트
새 기능 사용하고 싶을 때
claude config
설정 변경
기본 모델, 언어 등 설정
파트 1 부록. 시작하기 — 더 알아보기

이 장에서 배우는 것

•
500개 파일도 당황하지 않고 파악하는 현황 분석 방법
•
실수 없이 정리하는 5단계 순서 (현황 → 계획 → 백업 → 테스트 → 전체 적용)
•
Claude의 분류 제안을 내 업무 기준에 맞게 검토하는 방법
•
미분류 파일이 남아도 되는 이유
•
파일 이름 일괄 변경과 중복 파일 정리
김 대리가 퇴사하고 작업 폴더를 넘겨받았습니다. 파일이 500개쯤 있고, 어디에 뭐가 있는지 아무도 모릅니다. 상사는 이번 주까지 정리하라고 합니다. 이 장에서는 이 폴더를 Claude Code로 정리하는 전체 과정을 따라갑니다.
시작하기 전에 한 가지. 파일 정리는 Claude Code가 가장 잘하는 일 중 하나지만, 동시에 실수하기 쉬운 일이기도 합니다. 파일을 잘못 옮기면 되돌리기가 까다롭습니다. 이 장에서는 실수를 방지하는 습관까지 함께 다룹니다.
이 장의 핵심 원칙 파일 정리는 현황 파악 → 계획 확인 → 백업 → 테스트 → 전체 적용 순서로 진행합니다. 이 순서를 지키면 되돌릴 수 없는 실수를 방지할 수 있습니다.

현황부터 파악한다

파일이 500개면 하나씩 볼 수 없습니다. 먼저 전체 그림을 봅니다.
Claude Code는 터미널 명령어를 만들어서 실행합니다. Claude가 실행할 명령을 먼저 보여주고 허용 여부를 묻습니다:
4장. 파일과 폴더 관리

이 장에서 배우는 것

•
CSV/엑셀 파일의 구조를 파악하는 방법
•
여러 파일을 하나로 합치고 열 이름 불일치 해결하기
•
데이터 품질 점검 (빈 칸, 중복, 이상값)
•
집계표와 그래프 만들기
•
분석 결과를 검증하는 방법
•
큰 파일과 엑셀 피벗 테이블 중 무엇을 선택할지
영업팀에서 월별 매출 CSV 파일 12개를 받았습니다. 각 파일은 한 달치 판매 기록입니다. 분기 보고용으로 이 데이터를 합치고, 지역별·월별 매출을 정리하고, 추이 그래프까지 만들어야 합니다. 이 장에서는 이 과정을 처음부터 끝까지 따라갑니다.

파일 하나를 먼저 살펴본다

12개를 한꺼번에 열기 전에, 하나만 먼저 봅니다. 데이터가 어떻게 생겼는지 알아야 뭘 시킬 수 있습니다.
Claude가 파일을 읽고 구조를 정리합니다:
Python이 필요할 수 있습니다 데이터 처리에는 Python이라는 도구가 필요할 수 있습니다. 여러분이 직접 코드를 쓸 일은 없습니다. 설치되어 있지 않으면 Claude가 "Python이 필요합니다. 설치할까요?"라고 묻습니다. Y를 누르면 자동으로 설치됩니다.
5장. 데이터 처리와 분석

이 장에서 배우는 것

•
Playwright MCP 설치해서 웹 검색 기능 추가하기
•
URL을 주면 페이지 내용을 요약하는 방법
•
여러 사이트를 비교표로 정리하는 방법
•
웹 리서치 결과를 믿을 수 있는 기준 (할루시네이션 주의)
•
비교표를 보고서 파일로 저장하는 방법
우리 회사가 온라인 교육 서비스를 준비하고 있습니다. 팀장이 국내 경쟁사 5곳을 비교한 자료를 이번 주까지 요청했습니다. 인터넷에서 정보를 찾고, 비교표를 만들고, 보고서 파일로 정리하는 과정을 따라갑니다.

웹 검색 기능을 설치한다

Claude Code는 기본적으로 내 컴퓨터의 파일만 다룹니다. 웹 검색을 하려면 Playwright MCP라는 기능을 추가해야 합니다. "Claude에게 웹 브라우저를 달아주는 것" 정도로 이해하고 설치만 합니다. MCP에 대한 자세한 설명은 12장에서 다룹니다.
터미널에서 아래 명령을 실행합니다:
설치가 끝나면 Claude Code를 종료했다가 다시 시작합니다. 이후부터 웹 검색이 가능합니다.
설치가 안 되는 경우 12장의 MCP 트러블슈팅을 참고하세요. 가장 흔한 원인은 Node.js 미설치입니다. "Node.js가 설치되어 있는지 확인해줘"라고 Claude에게 먼저 물어보세요.
6장. 웹 리서치와 정보 수집
분기 말입니다. 경영진에게 성과 보고서를 제출해야 합니다. 재료는 두 가지입니다: 5장에서 다룬 것처럼 정리한 매출 CSV 파일과, 주요 회의에서 메모해둔 텍스트 파일. 이 두 재료를 합쳐서 하나의 보고서로 만드는 과정을 따라갑니다.

이 장에서 배우는 것

•
데이터 파일과 메모를 합쳐서 보고서 만들기
•
구조 먼저 잡고 섹션별로 작성하는 패턴
•
AI 특유의 문체(번역투, 추상적 수식어)를 교정하는 방법
•
팩트와 Claude의 추론을 구분하는 습관
•
회의록, 이메일, 번역, 블로그까지 응용하기

재료를 확인한다

보고서를 쓰기 전에 재료가 어떤 상태인지 먼저 봅니다.
Claude가 두 파일을 읽고 요약합니다:
여러 파일을 동시에 참조할 수 있습니다 Claude Code는 대화 안에서 앞서 분석한 결과도 기억하고 있으므로, 데이터 분석과 문서 작성을 한 흐름으로 이어갈 수 있습니다.
7장. 문서 작성과 콘텐츠
파트 2에서 다룬 내용을 보충합니다.
이 부록에서 다루는 것 - Claude Code와 Claude.ai 중 상황에 맞는 선택 기준 - 경비 보고서 자동 생성 실전 예제 - 마크다운 파일을 노션/구글 문서로 옮기는 방법 - AI가 쓴 글을 그대로 쓰면 안 되는 이유 - 파일 깨짐, 엑셀 수식 손실 등 자주 겪는 문제 해결 - 보안과 개인정보 처리 가이드

Claude Code와 Claude.ai, 언제 뭘 쓸까

Claude Code와 Claude.ai(웹/앱)는 같은 계정으로 쓰지만, 잘 맞는 작업이 다릅니다.
상황
Claude.ai (웹/앱)
Claude Code (터미널)
간단한 질문 하나
적합
과함
파일 여러 개 처리
하나씩 업로드 필요
폴더 통째로 접근
큰 파일
업로드 제한 있음
제한 없음
결과물 저장
복사해서 붙여넣기
파일로 바로 저장
반복 작업
매번 새로 설명
설정 저장해서 재사용
화면 보며 수정 반복
직관적
덜 편함
판단 기준 3가지 - 결과물이 파일이어야 하면 → Claude Code 후속 작업이 이어지면 → Claude Code 화면 보면서 수정 반복하고 싶으면 → Claude.ai

실전 사례: 경비 보고서 자동 생성

신용카드 거래 내역 CSV가 있다면:
Claude가 거래 내역을 분석해서 교통비, 식비, 사무용품 등으로 분류하고, 항목별 합계가 포함된 보고서를 만들어줍니다.
자동 분류의 현실적인 정확도 "스타벅스 강남점"은 식비로 분류될 수 있지만, 거래처 미팅 비용이라면 "접대비"가 맞습니다. "쿠팡"은 사무용품일 수도, 개인 구매일 수도 있습니다. Claude는 상호명만 보고 판단하므로, 100% 정확한 분류를 기대하면 안 됩니다. 자동 분류 후 결과를 훑어보면서 잘못 분류된 항목을 잡아내는 시간이 필요합니다.
분류가 애매한 항목을 별도로 표시해달라고 하면 사후 확인이 쉬워집니다:
파트 2 부록. 업무 자동화 — 더 알아보기

이 장에서 배우는 것

•
좋은 지시의 4단계 (목표, 조건, 맥락, 예시)
•
모호한 지시 vs 구체적인 지시 차이
•
이미지를 활용해서 데이터 추출하고 상황 전달하기
•
"계획만 먼저 세워줘" 패턴으로 복잡한 작업 시작하기
•
결과를 보고 수정 지시하는 방법
•
프롬프트 엔지니어링의 현실적 한계
"보고서 만들어줘"라고 했는데 엉뚱한 결과가 나온 적 있나요? 대부분 지시가 모호해서 생기는 문제입니다. 4~7장에서 파일 정리, 데이터 처리, 웹 리서치, 문서 작성을 해봤습니다. 이 장에서는 같은 작업을 더 정확한 결과로 얻기 위한 지시 방법을 다룹니다.

지시의 4단계

Claude Code에게 지시할 때 이 순서를 따르면 대부분 좋은 결과가 나옵니다.
1.
목표: 무엇을 원하는가
2.
구체적 조건: 분량, 형식, 포함할 내용
3.
맥락: 누가 읽는지, 어디에 쓰는지
4.
예시: 원하는 결과의 샘플
8장. 효과적인 지시법

이 장에서 배우는 것

•
CLAUDE.md가 무엇이고 언제 만들어야 하는지
•
Claude Code에게 시켜서 만드는 방법
•
좋은 규칙과 나쁜 규칙의 차이
•
프로젝트별 설정 vs 전역 설정 구분
•
CLAUDE.md가 너무 길어졌을 때 정리하는 방법
•
규칙이 안 먹힐 때 원인 파악하기
Claude Code에게 같은 말을 반복하고 있다면, CLAUDE.md에 적어둡니다. 이 장에서는 CLAUDE.md가 무엇이고, 어떻게 활용하는지 다룹니다.

CLAUDE.md란

CLAUDE.md는 Claude Code가 매 대화를 시작할 때 자동으로 읽는 설정 파일입니다.
예를 들어, 매번 "보고서는 한국어로 써줘", "표를 꼭 포함해줘"라고 말하고 있다면, 이 내용을 CLAUDE.md에 적어두면 더 이상 반복할 필요가 없습니다.

언제 만들면 좋을까

처음부터 만들 필요는 없습니다. Claude Code를 쓰다가 같은 지시를 3번 이상 반복하고 있다면, 그때 만드는 것을 권합니다.
9장. CLAUDE.md로 나만의 설정 만들기

이 장에서 배우는 것

•
모델(Haiku/Sonnet/Opus) 선택으로 사용량 아끼기
•
대화가 길어졌다는 신호와 새 대화 시작 타이밍
•
/compact와 핸드오프의 차이와 사용 상황
•
/fork로 다른 방향 부담 없이 시도하기
•
사용량이 예상보다 빠르게 소진되는 원인
Claude Code는 Anthropic 구독에 포함된 사용량 안에서 동작합니다. 대화를 효율적으로 관리하면 같은 구독으로 더 많은 작업을 할 수 있습니다.

사용량 관리

3장에서 소개한 것처럼, Claude Code는 Anthropic 구독(Pro 또는 Max)에 포함되어 있고 Claude.ai와 사용량이 합산됩니다. 사용량 한도에 도달하면 일정 시간 후 자동으로 초기화됩니다.

모델 선택

대화 중에 /model을 입력하면 모델을 변경합니다.
모델
특징
사용량 소모
적합한 작업
Haiku
빠르고 가벼움
적음
파일 정리, 단순 변환
Sonnet
균형 잡힌 성능
보통
대부분의 업무 작업
Opus
가장 정교함
많음
복잡한 분석, 섬세한 문서
단순한 작업은 Haiku, 정교한 작업은 Sonnet이나 Opus "이 CSV에서 서울 데이터만 골라줘" 같은 단순한 작업은 Haiku나 Opus나 결과가 같습니다. 모델 차이가 드러나는 건 판단이 필요한 작업입니다. 문서의 톤을 맞추거나, 복잡한 데이터에서 패턴을 찾을 때 상위 모델이 더 나은 결과를 냅니다.
10장. 대화 관리와 비용 최적화

이 장에서 배우는 것

•
오류의 3가지 원인 구분 (내 지시 문제 / 맥락 손실 / 기술적 한계)
•
흔한 오류 메시지와 해결법
•
원하는 결과가 아닐 때 구체적으로 수정 요청하는 방법
•
중요한 작업 전 백업하는 습관
•
포기해야 할 때를 아는 것
Claude Code를 쓰다 보면 오류 메시지를 만나거나 예상과 다른 결과가 나올 때가 있습니다. 이 장에서는 흔한 문제 상황과 대응법을 다룹니다.

문제의 원인 파악하기

오류가 나면 "Claude가 고장났다"고 생각하기 쉽습니다. 실제로는 세 가지 원인 중 하나입니다.
원인
확인 방법
해결법
내 지시가 불분명했다
지시를 다시 읽어봄
더 구체적으로 지시
Claude가 맥락을 놓쳤다
"지금까지 내가 지시한 조건을 정리해봐"
/compact 또는 새 대화
기술적 제약이다
"이거 할 수 있어? 솔직하게 말해줘"
다른 방법 찾기
이 세 가지를 구분하지 않으면 헛수고를 반복합니다 지시 문제인데 Claude에게 "다시 해봐"만 반복하거나, 기술적 한계인데 지시를 바꿔가며 시간과 사용량을 낭비하게 됩니다.

흔한 오류 상황과 대응

"권한이 없습니다" (Permission denied)

11장. 문제 해결과 오류 대응

이 장에서 배우는 것

•
MCP가 무엇이고 왜 필요한지 (USB 포트 비유)
•
claude mcp add로 서버 추가하는 방법
•
설치 실패 원인 5가지와 해결법
•
노션, Playwright, 웹 검색 MCP 활용법
•
MCP 여러 개 조합해서 복잡한 작업 처리하기
•
음성으로 Claude Code 사용하는 방법
지금까지 다룬 파일 정리, 데이터 분석, 문서 작성은 모두 컴퓨터에 있는 파일로 하는 작업이었습니다. 하지만 실제 업무는 여러 도구에 흩어져 있습니다. 회의록은 노션에, 파일은 구글 드라이브에, 대화는 슬랙에 있습니다. MCP 없이는 이런 것들을 일일이 복사해서 Claude Code에 붙여넣어야 합니다. MCP를 연결하면 "노션에서 이번 달 회의록을 가져와서 보고서를 만들어줘"처럼 한 번에 지시할 수 있습니다. MCP 하나를 잘 연결하면 매일 반복하던 수작업이 한 문장 지시로 바뀝니다.

MCP란

MCP는 Claude Code와 외부 서비스를 연결하는 표준 규격입니다(Model Context Protocol의 약자). USB 포트에 다양한 장치를 꽂아 쓰듯, MCP라는 규격을 통해 노션, 슬랙, 웹 검색 같은 서비스를 Claude Code에 연결합니다. 이렇게 연결된 각각의 서비스를 "MCP 서버"라고 부릅니다.
MCP는 Claude Code 전용이 아닙니다 MCP는 Anthropic이 만들었지만 Claude Code 전용이 아닙니다. Cursor, Windsurf 같은 다른 AI 도구에서도 같은 MCP 서버를 쓸 수 있는 개방형 표준입니다. 그래서 MCP 서버의 종류가 빠르게 늘고 있고, 사례와 문제 해결 자료가 풍부합니다.
기본 Claude Code만으로는 할 수 없지만, MCP를 추가하면 가능한 것들:
•
인터넷에서 최신 정보 검색
•
노션 페이지를 읽고 작성
12장. MCP로 외부 도구 연결하기

이 장에서 배우는 것

•
복잡한 작업을 나눠서 시켜야 하는 이유
•
"계획 → 확인 → 실행" 순서로 진행하는 방법
•
단계별로 중간 결과 확인하는 습관
•
Claude가 자주 하는 실수 패턴과 예방법
•
결과가 이상할 때 구체적으로 수정 요청하기
•
복잡한 작업의 현실적인 기대치
간단한 작업은 한 문장으로 지시하면 됩니다. 하지만 여러 단계가 얽힌 작업은 한 번에 시키면 결과가 엉뚱하게 나올 수 있습니다. 이 장에서는 복잡한 작업을 단계별로 나누어 확실하게 처리하는 방법을 다룹니다.
13장. 복잡한 작업 해결하기

이 장에서 배우는 것

•
커스텀 슬래시 명령어 만들기 (/명령이름으로 실행)
•
스킬: 참고자료를 포함할 수 있는 확장판
•
Hooks: 특정 이벤트에 자동으로 실행되는 규칙
•
세 기능 비교와 언제 무엇을 선택할지
•
Claude에게 시켜서 만드는 방법
•
커스터마이징에 시간을 쏟기 전에 알아야 할 것
Claude Code에는 자주 하는 작업을 저장해두고 반복 실행하거나, 특정 시점에 자동으로 동작을 실행하는 기능이 있습니다. 이 장에서는 커스텀 슬래시 명령어, 스킬, Hooks를 다룹니다.

커스텀 슬래시 명령어

9장에서 다룬 CLAUDE.md가 "항상 적용되는 규칙"이라면, 커스텀 슬래시 명령어는 "필요할 때 꺼내 쓰는 도구"입니다. 자주 하는 작업을 마크다운 파일 하나로 저장해두고, /명령이름으로 실행합니다.

만들기

~/.claude/commands/ 폴더에 마크다운 파일을 만듭니다. 파일 이름이 곧 명령어 이름입니다.
예를 들어, 문서를 리뷰하는 명령어를 만들려면:
파일: `~/.claude/commands/review.md`
14장. 커스터마이징: 스킬과 Hooks

사례 1: 회의 녹음에서 노션 회의록까지

회의가 끝나면 녹음 파일만 남고, 회의록은 나중에 정리해야 합니다. 이 과정을 Claude Code와 노션 MCP로 자동화할 수 있습니다.

전체 흐름

1.
회의를 녹음한다
2.
음성→텍스트 변환 도구로 텍스트를 뽑는다
3.
텍스트 파일을 Claude Code에 전달한다
4.
Claude Code가 정리해서 노션에 저장한다

1단계: 음성을 텍스트로 변환

Claude Code는 음성 파일을 직접 처리하지 못합니다. 먼저 음성→텍스트 변환 도구로 텍스트를 뽑아야 합니다.
도구
무료 사용량
특징
클로바노트 (네이버)
월 300분
한국어 인식 정확도 높음
Notta
월 120분
다국어 지원, 웹 기반
녹음 파일을 도구에 업로드하면 텍스트 파일로 변환됩니다.
변환 품질에 현실적인 기대치를 가지세요 조용한 회의실에서 한 사람이 명확하게 말하는 녹음은 90% 이상 정확하게 변환됩니다. 여러 사람이 동시에 말하거나, 전화 회의로 음질이 나쁘면 정확도가 크게 떨어집니다. 변환된 텍스트를 Claude Code에 넘기기 전에 한 번 훑어보세요. "매출 50억"이 "매출 15억"으로 변환된 것까지는 Claude가 잡아내지 못합니다.

2단계: Claude Code로 회의록 정리

변환된 텍스트는 말 그대로 "말한 것을 받아 적은 것"이라 그대로 쓰기 어렵습니다.
15장. 실전 사례 모음

이 장에서 배우는 것

•
팀 도입 3단계 (시범 → 공유 → 정착)
•
도입 시 흔한 저항과 현실적인 대응법
•
프로젝트 CLAUDE.md로 팀 규칙 공유하기
•
문서 기반 협업 (작성 → 편집 → 검토)
•
공유 스킬과 MCP 설정을 팀에 배포하는 방법
•
도입이 잘 안 되는 경우와 팀 온보딩 비용
Claude Code를 혼자 쓰는 것과 팀으로 쓰는 것은 다릅니다. 이 장에서는 팀 환경에서 Claude Code를 도입하고, 일관된 작업 방식을 만드는 방법을 다룹니다.

팀에 Claude Code 도입하기

팀 전체에 한꺼번에 도입하면 혼란이 생기기 쉽습니다. 단계적으로 접근하는 것이 현실적입니다.

1단계: 한두 명이 먼저 써본다

관심 있는 팀원 1~2명이 자기 업무에 먼저 적용합니다.
시작하기 좋은 작업:
•
회의록 정리
16장. 팀 협업과 워크우16장. 팀 협업과 워크플로
파트 5에서 다룬 내용을 보충합니다.
이 부록에서 다루는 것 - 무료 음성→텍스트 변환 도구 비교 (클로바노트, Notta, 다글로) - 15장 사례별 필요한 MCP 서버 조합 - 팀용 CLAUDE.md 템플릿 (바로 복사해서 쓸 수 있는) - 공유 스킬 폴더 구조와 개인/팀 스킬 이름 충돌 해결 - 워크플로우가 무너지는 패턴과 예방법

무료 음성→텍스트 변환 도구

15장의 회의록 워크플로우에서 사용할 수 있는 도구들입니다.
도구
무료 사용량
플랫폼
특징
클로바노트 (네이버)
월 300분
웹, 앱
한국어 인식 정확도 높음, 화자 분리 지원
Notta
월 120분
웹, 앱
다국어 지원, 실시간 자막
다글로
월 90분
웹, 앱
한국어 전용, 회의록 자동 요약
녹음 파일(m4a, mp3, wav 등)을 업로드하면 텍스트 파일로 변환됩니다. 변환된 텍스트를 작업 폴더에 저장한 뒤 Claude Code에 전달합니다.

음성 변환 도구 선택 팁

무료 사용량만 보고 고르기보다, 자기 회의 환경에 맞는 도구를 선택하는 것이 중요합니다.
한국어 전용 회의가 대부분이라면 클로바노트가 가장 정확합니다. 한국어 고유명사(회사명, 제품명)를 잘 인식하고, 화자 분리 정확도도 높습니다.
한국어와 영어가 섞이는 회의라면 Notta가 낫습니다. 다국어 전환을 비교적 잘 처리합니다.
변환 정확도를 높이는 실전 팁 - 회의 시작 시 참석자가 한 번씩 이름을 말하게 하면 화자 분리 정확도가 올라갑니다 - 녹음 기기를 발언자 가까이에 두는 것도 효과가 큽니다 - 노트북 내장 마이크로 회의실 전체를 녹음하면 먼 쪽 사람의 발언은 정확도가 크게 떨어집니다

MCP 서버 조합 예시

15장에서 다룬 사례들에 사용된 MCP 서버 조합입니다.
파트 5 부록. 실전 워크플로우 — 더 알아보기
Claude Code를 쓰고 있다면 Cowork로 갈아탈 이유는 없다 — 업무 유형별로 어느 쪽이 맞는지 판단 기준을 정리합니다
"코워크랑 코드랑 크게 차이가 안 나지 않나요?"
퍼포먼스 마케팅을 하는 분에게 이 질문을 받았습니다. 캠페인 데이터 분석이나 보고서 자동화가 주 업무인데, 터미널의 장점이 와닿지 않는다는 겁니다. 코드를 짜는 사람이 아니니까, 터미널이든 앱이든 결과만 같으면 되지 않느냐는 거죠.
이 질문은 마케터만의 것이 아닙니다. HR, 영업, 기획, 콘텐츠 — 코드를 짜지 않는 대부분의 직군이 같은 의문을 가질 수 있습니다. 답은 "업무에 따라 다르다"인데, 그 판단 기준이 생각보다 단순하지 않습니다.

Cowork가 뭔가요?

2026년 1월에 나온 Cowork는 Claude Desktop 앱 안에 들어있는 에이전트 작업 환경입니다. Claude Code와 같은 기술 기반이지만, 터미널 대신 데스크톱 앱의 GUI에서 동작합니다.
앱 상단의 "Cowork" 탭을 누르고, 작업할 폴더를 지정하고, 자연어로 지시하면 됩니다. 2강에서 터미널을 설치하고 cd 명령어로 폴더를 이동하던 과정이 클릭 몇 번으로 대체됩니다. Claude가 계획을 세우고, 파일을 읽고, 결과물을 만드는 흐름은 Claude Code와 같습니다.
Cowork는 샌드박스(가상 머신) 안에서 돌아가고, 앱을 닫지 않는 한 30분~1시간짜리 긴 작업도 끊기지 않습니다. Pro($20/월) 이상 구독이면 쓸 수 있고, macOS와 Windows를 지원합니다.

업무 유형으로 나눠보면

"마케터니까 Cowork", "개발자니까 Claude Code" 같은 직군 분류는 의미가 없습니다. 같은 마케터라도 업무 성격에 따라 답이 다릅니다. 업무를 네 가지 유형으로 나눠봅니다.

1. 한 번 하고 끝나는 작업

파일 100개를 폴더별로 정리하기. 스크린샷에서 표 추출하기. 여행 일정 짜기. 경쟁사 웹사이트 훑어보기. 결과물을 받으면 작업이 끝납니다.
이런 작업은 Cowork가 편합니다. 앱 열고 폴더 지정하고 지시하면 끝이니까요. 터미널을 열 이유가 없습니다. 다만 Claude Code로도 똑같이 되고, 토큰은 더 적게 씁니다. "편의"와 "효율" 사이의 선택입니다.
Claude Code VS Cowork
Claude Code에 학습 스킬을 설치하면, PDF 교재를 읽고 퀴즈를 내주는 개인 튜터가 된다.
자격증 시험을 준비하거나, 새로운 분야를 공부할 때 가장 답답한 건 "내가 뭘 모르는지 모르겠다"는 상태입니다. 책을 읽으면 다 아는 것 같은데, 막상 문제를 풀면 틀립니다. Claude Code에 학습용 스킬을 설치하면 이 문제를 꽤 직접적으로 해결해줍니다.
tutor-skills라는 오픈소스 스킬이 있습니다. PDF 교재나 문서를 넣으면 Claude Code가 자동으로 핵심 개념을 정리하고, 연습 문제를 만들고, 퀴즈로 약점을 찾아서 반복 드릴까지 해줍니다. 실제로 이 스킬을 만든 개발자는 2주 만에 AWS 자격증을 땄다고 합니다.
"내가 뭘 모르는지 모르겠다" — 학습용 스킬이 풀어주는 문제입니다.

스킬 설치

14강에서 스킬이 "슬래시 명령어의 확장판"이라고 다뤘습니다. 거기서는 직접 폴더를 만들고 SKILL.md를 작성하는 방식이었는데, 다른 사람이 만든 스킬은 명령어 한 줄로 설치됩니다.
터미널에 이 명령어를 붙여넣고 Enter를 누르면 됩니다. npx가 없다는 에러가 나오면 Claude Code에게 "npx 설치법 알려줘"라고 물어보면 안내해줍니다. 설치가 끝나면 /tutor-setup과 /tutor 두 개의 슬래시 명령어가 생깁니다.

학습 자료 만들기

공부할 교재를 폴더에 넣고, 그 폴더에서 Claude Code를 실행합니다.
그리고 /tutor-setup을 입력합니다. Claude Code가 교재를 분석하기 시작합니다. PDF, 마크다운, HTML, EPUB 파일을 자동으로 찾아서 읽고, 개념별로 노트를 정리합니다. 결과물은 Obsidian이라는 노트 앱에서 여는 형태입니다.
생성되는 구조는 이렇습니다:
이제 공부도 클로드 코드로 해보세요!
우회로 쓰던 음성 입력이 공식 기능으로 들어왔습니다. /voice 한 줄이면 됩니다.
Claude Code에서 음성으로 지시하고 싶은 사람들은 이전부터 있었습니다. 그래서 VoiceMode MCP라는 커뮤니티 프로젝트가 나왔습니다. MCP 서버를 설치하고, OpenAI API 키를 따로 발급받고, 음성 인식 엔진을 연결해야 했습니다. 12강에서 다뤘던 MCP 설정 과정을 한 번 더 거치는 셈이라, 쓰고 싶어도 진입장벽이 있었습니다.
2026년 3월, 이 기능이 Claude Code에 공식으로 들어왔습니다. MCP 서버도, 외부 API 키도 필요 없습니다. /voice 한 줄이면 됩니다.
커뮤니티가 우회로 만들어 쓰던 기능이 공식으로 흡수된 케이스. MCP 설정도, 외부 API 키도 필요 없어졌습니다.

이전 방식 vs 지금

이전에는 VoiceMode MCP를 설치해서 우회했습니다. MCP 서버 등록, OpenAI API 키 발급, 음성 인식 엔진(Whisper) 설정까지 거쳐야 말로 지시할 수 있었습니다. 로컬에서 돌리면 프라이버시는 좋지만, 비개발자가 세팅하기엔 부담이 컸습니다.
공식 보이스 모드는 이 과정을 통째로 건너뜁니다. /voice 입력하면 바로 쓸 수 있고, 끄려면 다시 /voice를 입력하면 됩니다.

쓰는 법

터미널에 이것만 입력하면 보이스 모드가 켜집니다.
말할 때는 스페이스바를 누른 채로 말하고, 끝나면 뗍니다. 워키토키 방식이라 마이크가 항상 켜져 있지는 않습니다. 주변이 시끄러워도 실수로 엉뚱한 명령이 들어가는 일은 없습니다.
말한 내용은 텍스트로 변환되어 입력 필드에 들어갑니다. Claude가 음성으로 대답해주는 건 아닙니다. 말은 내가 하고, 결과는 텍스트로 읽는 구조입니다.
Claude Code 보이스 모드
오늘 출시된 /btw — 작업 중 대화 기록에 남기지 않고 Claude에게 빠르게 묻는 기능. Esc+Esc 되감기, Tab 자동 제안, Ctrl+B 백그라운드 실행도 함께 정리했습니다.
오늘 Claude Code에 /btw가 정식으로 나왔다. 작년 초에 코드에 먼저 들어갔다가 "작동을 안 한다"는 버그 리포트가 쏟아지면서 조용히 내려갔던 기능이다. 오늘은 공식 문서에도 올라왔다.
이 글에서 /btw를 주로 다루고, 같이 확인한 다른 대화 기능들도 뒤에 정리한다.
대화 흐름을 방해하지 않고 Claude에게 바로 물어볼 수 있다.

/btw — 대화 기록에 남기지 않고 묻기

Claude가 작업 중일 때, 혹은 막 끝냈을 때, 대화 흐름과 무관한 걸 물어보고 싶을 때가 있다. "지금 수정하는 파일이 원본이야, 사본이야?", "아까 만든 폴더 이름이 뭐였지?" 같은 것들.
그냥 물어봐도 되지만, 긴 작업 중간에 잡담을 끼워 넣으면 대화 맥락이 흐트러지기도 한다. /btw는 이때 쓴다.
답변이 오버레이로 표시된다. Space, Enter, Esc로 닫으면 원래 대화로 돌아온다. 질문과 답변은 대화 기록에 남지 않는다. Claude는 이 교환이 없었던 것처럼 이어서 작업한다.
제한이 하나 있다. /btw에 답할 때 Claude는 파일을 새로 읽거나 터미널 명령을 실행하거나 인터넷을 검색할 수 없다. 이미 대화에서 알고 있는 것만 대답한다. 그래도 "이 파일 경로가 어디였지?" 같은 건 대부분 된다. Claude가 이미 파일을 읽었다면 기억하고 있으니까.
Claude가 한창 작업 중일 때도 쓸 수 있다. 완료를 기다리지 않고 작업이 돌아가는 동안 옆에서 물어볼 수 있다.

Esc + Esc — 되감기

작업 중에 쓸 수 있는 기능들