AUTOFROG PRESS · FIELD MANUAL 003 설치법이 아니라, 이관 순서

[ 클로드 코드 실전 워크북 ]

업무 하나
넘기기

내 업무의 값을 계산해 넘길 일을 고르고,
30분 세팅으로 오늘 하나를 넘깁니다.

6
STEPS
12
이관 카드
0원
FREE
오토프로그 지음 · 무료 공개 autofrog.kr
일러두기

이 책의 사용법

읽는 책이 아니라, 옆에 펴 놓고 따라 하는 책입니다

이 책은 설치 설명서가 아닙니다. 내 업무 하나를 골라서 실제로 넘기는 것이 목표입니다. 그래서 설치보다 무엇을 넘길지 고르는 일을 앞에 두었습니다.

읽는 순서

STEP 0 부터
넘길 일을 안 고르고 설치부터 하면, 깔아 놓고 안 쓰게 됩니다. 순서를 지켜 주세요.
이미 깔았다면
STEP 0을 하고 STEP 2로 건너뛰세요. STEP 1은 설치 과정입니다.
막혔다면
부록 A에서 화면에 뜬 문구를 찾으세요. 대부분 거기서 끝납니다.

두 가지 상자

초록 테두리
클로드 코드 대화창에 그대로 붙여 넣는 문장입니다. 우리말이라 읽어 보고 고쳐 쓰셔도 됩니다.
검은 상자
터미널에 입력하는 명령어입니다. 글자 하나 틀리면 안 되니 복사해서 쓰세요.

이 책의 기준

사실 확인
설치 명령어·오류 문구·명령 목록은 2026년 8월 공식 문서를 직접 확인해 적었습니다.
바뀔 수 있는 것
요금과 화면 문구는 변합니다. 금액은 공식 요금 페이지에서 한 번 더 보세요.
예시
본문의 회사명·거래처명·금액은 전부 가상입니다.
안 다루는 것
WSL·도커·서버 배포, Git 사용법, MCP 연결, 프로그래밍 문법. 처음 단계에 필요 없어서 일부러 뺐습니다.
이 책을 다 덮었을 때

손으로 하던 업무 한 가지가 사라져 있는 것이 목표입니다. 열 가지를 배우는 것보다 한 가지를 실제로 넘기는 편이 훨씬 빠릅니다.

차례

여섯 단계

고르고 → 깔고 → 넘기고 → 굳히고 → 넓힙니다

STEP 0 · 고르기 — 무엇을 넘길 것인가

0-1내 반복 업무의 값 계산하기실습
0-2넘길 일과 직접 할 일 가르기판정 기준
0-3오늘 넘길 하나 정하기워크시트

STEP 1 · 깔기 — 30분 세팅

1-1무엇을 까는 것인지, 얼마인지채팅 AI와의 차이
1-2맥 설치4단계
1-3맥에서 막히는 지점여섯 가지
1-4윈도우 설치1~3단계
1-5윈도우 설치 — 확인과 마무리4~5단계
1-6윈도우에서 막히는 지점열 가지
1-7작업대와 작업 폴더VS Code
1-8설치 점검과 뒷정리claude doctor

STEP 2 · 넘기기 — 첫 이관

2-1로그인과 첫 지시브라우저 승인
2-2승인 화면과 권한 모드선택지 셋
2-3멈추기와 되돌리기Esc · /rewind
2-4지시문 3요소목표·상황·울타리
2-5결과를 고쳐 받는 법첫날 실수 다섯

STEP 3 · 실전 — 업무 이관 카드 12장

3-1파일과 폴더 정리카드 01~03
3-2서류에서 뽑아내기카드 04~06
3-3맞춰 보고 일정 잡기카드 07~09
3-4문서 만들기카드 10~12

STEP 4 · 굳히기 — 두 번째부터는 5초

4-1회사 규칙 파일 만들기CLAUDE.md
4-2나만의 명령 만들기슬래시 한 줄
4-3계획 먼저, 대화는 짧게플랜 모드

STEP 5 · 넓히기 — 팀과 안전

5-1회사 자료를 다룰 때 다섯 가지필독
5-2팀에 넘길 때 다섯 줄공유용
5-3오토프로그가 넘긴 일곱 가지자사 실측

부록

A-1막혔을 때 — 화면 문구로 찾기증상별
A-2영어 오류 메시지 읽는 요령세 군데만
B-1먼저 익힐 여섯 가지와 단축키키 목록
B-2명령어 사전/ 로 부르기
B-3줄바꿈과 기호 네 개/ @ ! :
C2주 실행표하루 한 칸
STEP 0

고르기

깔기 전에 고릅니다. 내 업무 중 무엇이 반복이고 얼마짜리인지 계산하고, 넘겨도 되는 일과 직접 해야 하는 일을 가릅니다. 이 단계를 건너뛰면 깔아 놓고 안 쓰게 됩니다.

STEP 0-1

내 반복 업무의 값 계산하기

막연히 "바쁘다"를 숫자로 바꾸면, 무엇부터 넘길지가 보입니다

넘길 일을 고르는 가장 빠른 방법은 값을 매겨 보는 것입니다. 아래 문장을 클로드 코드나 쓰시는 AI 앱에 그대로 넣어 보세요. 아직 설치 전이어도 됩니다.

그대로 복사
내 반복 업무의 값을 계산해 줘.

업종: ____        내 시급 또는 담당자 시급: ____원

매주 반복하는 일과 걸리는 시간
1. ____ — 주 __시간
2. ____ — 주 __시간
3. ____ — 주 __시간

주·월·1년 기준으로 시간과 금액을 계산해 주고,
이 중에서 무엇부터 자동화하면 좋을지 하나만 골라서
그 이유를 한 줄로 알려 줘.

손으로 해도 됩니다

WORKSHEET · 직접 채워 보기
일 ①
· 주 시간
일 ②
· 주 시간
일 ③
· 주 시간
합계
시간 × 시급 원 = 주
1년이면
주 금액 × 52주 =
보기 — 시급 2만 원, 주 15시간이면

주 30만 원 · 월 120만 원 · 1년 1,440만 원입니다. 사람을 더 뽑을지 고민하기 전에, 이 시간부터 확인해 볼 만합니다.

숫자가 크게 나왔다고 놀라실 필요는 없습니다. 전부 없앨 수 있다는 뜻이 아닙니다. 이 중에서 넘겨도 되는 것만 골라내는 것이 다음 꼭지입니다.

STEP 0-2

넘길 일과 직접 할 일 가르기

다 넘길 수는 없습니다. 고르는 기준이 있습니다

기준은 하나입니다 — 결과가 틀렸을 때 내가 바로 알아챌 수 있는 일부터.

파일 정리는 틀리면 눈에 보입니다. 반면 숫자 계산은 틀려도 안 보입니다. 눈에 보이는 일부터 시작해서 신뢰가 쌓이면 범위를 넓히면 됩니다.

바로 넘기기
눈에 보이는 일
파일 정리, 이름 변경, 형식 변환, 자료 요약, 초안 작성, 반복되는 주간·월간 정리
조건부
검산이 필요한 일
수치 계산, 자료 대사, 집계. 고객에게 바로 나가는 문서는 초안까지만
직접
책임이 걸린 일
가격 결정, 인사 판단, 계약 조건. 확인 안 된 수치가 들어가는 보고

왜 그렇게 갈리나

파일 정리·이름 변경·형식 변환
기준만 정하면 되고, 결과가 화면에 바로 보입니다. 실패해도 되돌리기 쉽습니다.
자료 요약·초안 작성
초안까지 맡기고 마지막만 내가 다듬는 편이 가장 빠릅니다. 처음부터 쓰는 것보다 고치는 게 쉽습니다.
반복되는 주간·월간 정리
한 번 규칙을 만들면 계속 씁니다. 효과가 제일 큽니다 — STEP 4에서 명령 한 줄로 만듭니다.
수치 계산·대사·집계
반드시 검산하세요. 원본 파일과 대조하도록 지시에 적어 두면 훨씬 안전합니다.
가격·인사·계약
책임이 사람에게 있는 일입니다. 자료 정리까지만 시키고 판단은 직접 합니다.
넘기면 안 되는 신호

"이거 틀리면 누가 책임지지?"라는 질문에 답이 바로 안 나오는 일은 아직 넘기지 마세요. 넘기더라도 초안까지만입니다.

STEP 0-3

오늘 넘길 하나 정하기

세 가지를 적고, 그중 하나에 동그라미를 칩니다

0-1에서 나온 후보 중 0-2 기준으로 "바로 넘기기"에 해당하는 것만 남깁니다. 그리고 그중 하나를 오늘의 목표로 정합니다.

WORKSHEET · 오늘의 하나
넘길 일
지금 걸리는 시간
건당 분 · 주
쓰는 파일

예) 견적서 PDF, 매출 엑셀, 회의 메모, 현장 사진
결과물 모양

예) 정리된 폴더, 비교표 한 장, 회의록 문서
틀리면
□ 바로 눈에 보인다    □ 검산해야 안다    □ 모른다
"틀리면 모른다"에 표시하셨다면

그 일 말고 다른 것을 고르세요. 첫 이관은 결과가 눈에 보이는 일이어야 합니다. 그래야 이 도구를 믿을지 말지 스스로 판단할 수 있습니다.

고른 일이 STEP 3의 어느 카드인지

파일이 뒤엉켜 있다
카드 01~03 — 거래처별 정리, 이름 규칙, 오래된 파일 골라내기
서류를 보고 옮겨 적는다
카드 04~06 — 사진 이름 붙이기, 서류에서 숫자 뽑기, 매출 요약
두 목록을 맞춰 보거나 일정을 짠다
카드 07~09 — 목록 대조, 납기 일정표, 월말 체크리스트
같은 문서를 또 쓰고 있다
카드 10~12 — 회의록, 안내문, 문의 답변 모음
STEP 0 완료 확인
  • 내 반복 업무를 시간과 금액으로 계산해 봤다
  • 넘길 일 / 직접 할 일을 갈라 봤다
  • 오늘 넘길 하나를 정하고 워크시트에 적었다
  • 그 일이 STEP 3의 몇 번 카드인지 확인했다
STEP 1

깔기

명령어 한 줄로 설치하고, 작업대를 만듭니다. 맥은 4단계, 윈도우는 5단계입니다. 중간에 영문 오류가 나는 것은 실패가 아니라 정상 과정이고, 막히는 지점은 정해져 있습니다.

STEP 1-1

무엇을 까는 것인지, 얼마인지

채팅 AI와 딱 하나가 다릅니다 — 내 컴퓨터의 파일을 직접 만집니다

클로드 코드를 써 보신 채팅 AI와 비교하면 이해가 빠릅니다. 답은 잘 해 주는데 그 답을 내가 다시 복사해서 엑셀에 붙이고 파일 이름을 하나하나 바꿔야 하죠. 그 뒷부분을 대신하는 것이 클로드 코드입니다.

일하는 곳
채팅 AI는 웹브라우저 채팅창 · 클로드 코드는 내 컴퓨터 안
파일
채팅 AI는 내가 복사해서 붙여 넣어야 함 · 클로드 코드는 내 폴더의 파일을 직접 읽고 씀
결과물
채팅 AI는 화면에 글로 표시 · 클로드 코드는 실제 파일로 폴더에 저장
여러 단계
채팅 AI는 매번 내가 이어 붙여야 함 · 클로드 코드는 스스로 순서대로 진행
이것만 이해하면 됩니다

"정리해 줘"라고 말하면 진짜로 폴더 안에서 파일이 움직입니다. 결정적인 차이는 이 하나입니다.

얼마인가

클로드 코드는 Pro · Max · Team · Enterprise 계정에서 동작합니다. 공식 문서에는 무료 플랜에 포함되지 않는다고 안내돼 있습니다.

여기서 시작
Pro
월 $20 (연간 결제 시 월 $17). 혼자 또는 소규모, 하루 한두 시간이면 충분합니다
모자랄 때
Max
월 $100 · $200. Pro의 5배·20배 사용량 중에서 고릅니다
여러 명
Team
1인당 별도 요금. 회사 단위로 쓸 때

금액과 사용량 기준은 바뀝니다. 결제 전에 공식 요금 페이지에서 확인하세요. 처음부터 상위 요금제로 갈 이유가 없습니다 — Pro로 한두 주 써 보고 모자랄 때 올리세요.

내 컴퓨터가 되는지

운영체제
맥 macOS 13.0 이상 / 윈도우 Windows 10 1809 버전 이상 — 맥은 애플 메뉴 → 이 Mac에 관하여, 윈도우는 설정 → 시스템 → 정보
메모리
4GB 이상 · 64비트(x64 또는 ARM64) — 요즘 나온 PC는 거의 다 해당됩니다
인터넷
일반 인터넷 연결이면 충분합니다
STEP 1-2

맥 설치

윈도우를 쓰시면 이 꼭지와 다음 꼭지를 건너뛰고 1-4로 가세요

1

터미널 열기

키보드에서 Command(⌘) 키와 스페이스바를 동시에 누릅니다. 화면 가운데에 검색창이 뜨면 터미널이라고 입력하고 Enter를 누릅니다. (영문 자판이면 Terminal)

흰색 또는 검은색 창이 뜨고 네모난 커서가 깜빡입니다.

터미널은 컴퓨터를 글자로 조작하는 창입니다. 평소 마우스로 폴더를 더블클릭하던 것을 글자로 하는 것뿐이고, 여기서 할 일은 대부분 복사해서 붙여 넣고 엔터입니다.

2

설치 명령 붙여 넣기

아래 한 줄을 통째로 복사해 터미널에 붙여 넣고(⌘ + V) Enter를 누릅니다. 글자가 주르륵 올라갑니다. 몇 분 걸릴 수 있으니 중간에 창을 닫지 마세요.

TERMINAL · macOS
curl -fsSL https://claude.ai/install.sh | bash

Claude Code successfully installed! 같은 문구가 나옵니다.

3

설치 확인

TERMINAL
claude --version

2.1.211 (Claude Code) 처럼 숫자와 함께 (Claude Code) 가 나오면 성공입니다. 4단계는 건너뛰고 1-7로 가세요.

zsh: command not found: claude 가 나왔다면 4단계로 갑니다. 실패가 아니라 아주 흔한 정상 상황입니다.

4

command not found 해결

먼저 가장 쉬운 것부터. ⌘ + Q 를 눌러 터미널을 완전히 끄고 다시 여세요. 창 왼쪽 위 빨간 점을 누르는 것만으로는 부족합니다. 이것만으로 해결되는 경우가 절반입니다.

그래도 같은 메시지가 나오면 아래 두 줄을 한 줄씩 차례로 붙여 넣고 각각 엔터를 누릅니다.

TERMINAL · zsh
# 맥 기본 셸(zsh)을 쓰는 경우
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

다시 claude --version 을 입력하면 버전이 나옵니다.

STEP 1-3

맥에서 막히는 지점

화면에 뜬 문구를 왼쪽에서 찾으세요. 앞부분만 비슷해도 됩니다

bash: claude: command not found
기본 셸이 bash입니다. 1-2의 4단계에서 ~/.zshrc 대신 ~/.bashrc 를 쓰세요. 내가 어느 쪽인지 모르겠으면 echo $SHELL 을 입력해 보세요. 끝이 /zsh 면 zsh입니다.
syntax error near unexpected token '<' 또는 웹페이지 코드가 쏟아짐
설치 파일 대신 웹페이지가 내려온 경우입니다. 우선 같은 명령을 한 번 더 실행해 보세요. 계속 그러면 아래 Homebrew로 설치합니다.
dyld: cannot load / built for Mac OS X 13.0
맥 운영체제가 오래된 것입니다. 애플 메뉴 → 이 Mac에 관하여에서 버전을 보고, 13.0보다 낮으면 시스템 설정 → 소프트웨어 업데이트를 먼저 하세요.
App unavailable in region
현재 계신 국가에서 서비스가 열리지 않은 경우입니다. 한국은 지원 국가이므로, 이 문구가 뜨면 VPN이 켜져 있는지 확인해 보세요.
붙여넣기가 안 됨
터미널에서는 ⌘ + V 가 정상 동작합니다. 안 되면 터미널 창 안에서 마우스 오른쪽 클릭 → 붙여넣기를 쓰세요.
비밀번호 입력창인데 글자가 안 보임
고장이 아닙니다. 보안상 일부러 안 보이게 한 것입니다. 보이지 않아도 그대로 치고 엔터를 누르세요.

공식 설치가 계속 실패할 때 — Homebrew

TERMINAL · macOS
# Homebrew가 없다면 먼저 설치
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Homebrew로 클로드 코드 설치
brew install --cask claude-code

Homebrew로 깔면 자동 업데이트가 안 됩니다. 가끔 brew upgrade claude-code 를 실행해 주세요.

맥 설치 확인
  • 터미널을 열 수 있다 (⌘ + 스페이스 → "터미널")
  • claude --version 에서 버전 숫자가 나온다
  • 안 나오면 ⌘+Q로 완전히 껐다가 다시 열어봤다
  • 그래도 안 되면 PATH 두 줄을 입력해봤다
STEP 1-4

윈도우 설치

맥을 쓰시면 이 꼭지와 다음 꼭지를 건너뛰고 1-7로 가세요

솔직히 말씀드리면 윈도우가 맥보다 걸리는 데가 많습니다. 대신 걸리는 지점이 정해져 있어서, 이 순서대로만 가면 다 통과합니다.

1

Git for Windows 설치 (권장)

클로드 코드가 명령을 더 잘 다루게 해 주는 보조 프로그램입니다. 없어도 설치는 되지만 있으면 할 수 있는 일이 늘어납니다. Git 자체를 배울 필요는 전혀 없습니다.

git-scm.com/downloads/win 에서 내려받아 실행하고, 설치 화면이 열 번 넘게 나와도 전부 그냥 Next만 누르시면 됩니다. 기본값이 정답입니다.

이미 깔려 있는지 모르겠으면 그냥 설치하세요. 다시 설치해도 문제없습니다.

2

PowerShell 열기 — CMD와 헷갈리지 않기

키보드에서 윈도우 키 + X 를 누르고 Windows PowerShell 또는 터미널을 고릅니다. 윈도우에는 비슷하게 생긴 창이 두 개 있어서 여기서 가장 많이 실수합니다.

PowerShell
줄 맨 앞이 PS C:\Users\내이름>PS가 붙어 있습니다. 이걸 쓰세요
CMD
줄 맨 앞이 C:\Users\내이름> — PS가 없습니다

파란색 또는 검은색 창이 뜨고 줄 맨 앞에 PS가 보입니다.

(x86)이 붙은 것은 고르지 마세요

시작 메뉴에 Windows PowerShellWindows PowerShell (x86) 두 개가 보일 수 있습니다. (x86)은 32비트로 동작해서 64비트 PC에서도 Claude Code does not support 32-bit Windows 오류가 납니다.

3

설치 명령 붙여 넣기

PowerShell 창에 아래를 붙여 넣고(Ctrl + V 또는 마우스 오른쪽 클릭) Enter를 누릅니다. 관리자 권한은 필요 없습니다.

POWERSHELL
irm https://claude.ai/install.ps1 | iex

Claude Code successfully installed! 가 나옵니다. 다음 꼭지로 이어집니다.

STEP 1-5

윈도우 설치 — 확인과 마무리

윈도우 설치 실패의 절반 이상이 다음 한 단계를 건너뛰어서 생깁니다

4

창을 완전히 닫았다가 새로 열기

이 단계를 건너뛰면 다음 단계에서 거의 반드시 막힙니다. 설치가 끝났다고 그 창에서 바로 claude 를 치지 마세요. X 버튼으로 완전히 닫고, 윈도우 키 + X → PowerShell로 새 창을 엽니다.

왜 껐다 켜야 하나

설치 프로그램은 윈도우에게 "클로드는 이 폴더에 있습니다"라고 등록해 둡니다(환경 변수 PATH). 그런데 이미 열려 있는 창은 자기가 열릴 때의 목록을 계속 들고 있습니다. 새 창을 열어야 새 목록을 읽습니다.

5

설치 확인, 안 되면 환경 변수 등록

POWERSHELL
claude --version

버전 숫자와 (Claude Code) 가 나오면 끝입니다. 1-7로 가세요.

'claude' is not recognized... 가 나오면 아래 두 줄을 한 줄씩 붙여 넣고 각각 엔터를 누른 뒤, 창을 다시 닫고 새로 열어 확인하세요. 입력해도 화면에 아무 반응이 없는 게 정상입니다.

POWERSHELL
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

명령어 입력이 부담스러우면, 마우스로

위 두 줄이 무섭게 느껴지면 화면 클릭으로도 됩니다.

윈도우 키를 누르고 환경 변수라고 검색 → 시스템 환경 변수 편집 클릭
오른쪽 아래 환경 변수(N)... 버튼 클릭
위쪽 사용자 변수 목록에서 Path를 선택하고 편집 클릭
새로 만들기를 누르고 %USERPROFILE%\.local\bin 을 그대로 입력한 뒤 확인을 계속 누릅니다

그다음 열려 있던 PowerShell 창을 모두 닫고 새로 여세요.

회사 노트북이라 설치가 막힌다면

백신이나 보안 프로그램이 차단하는 경우가 있습니다. 혼자 우회하지 마시고 정보보안 담당자에게 요청하세요. 요청 문구 예시 — "Anthropic의 Claude Code CLI를 설치하려 합니다. claude.exe 와 이 프로그램이 실행하는 cmd.exe, bash.exe 를 예외 처리해 주세요."

STEP 1-6

윈도우에서 막히는 지점

화면에 뜬 영문 문구를 왼쪽에서 찾으세요

'claude' is not recognized
창을 껐다 새로 열지 않았거나 PATH 등록이 안 된 상태입니다. 1-5의 4~5단계를 그대로 따르세요.
'irm' is not recognized
PowerShell이 아니라 CMD 창에 있습니다. PowerShell을 새로 열거나, CMD용 명령을 쓰세요.
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
The token '&&' is not a valid statement separator
반대 경우입니다. PowerShell에 CMD용 명령을 넣었습니다. irm https://claude.ai/install.ps1 | iex 를 쓰세요.
A parameter cannot be found that matches parameter name 'fsSL' · 'bash' is not recognized
맥·리눅스용 명령을 PowerShell에 넣었습니다. PowerShell용 irm ... | iex 로 바꾸세요.
Could not create SSL/TLS secure channel
구형 Windows 10에서 보안 통신 설정이 낮은 경우입니다. 아래를 먼저 넣고 설치를 다시 하세요.
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
running scripts is disabled on this system
윈도우가 스크립트 실행을 막고 있습니다. 아래를 넣고(Y 입력) 다시 시도하세요.
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Claude Code does not support 32-bit Windows
시작 메뉴에서 Windows PowerShell (x86)을 연 것입니다. (x86)이 안 붙은 것으로 다시 설치하세요.
The process cannot access the file
이전 설치가 아직 돌고 있거나 백신이 파일을 검사 중입니다. 다른 PowerShell 창을 모두 닫고 아래를 넣은 뒤 다시 설치하세요.
Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\downloads"
설치는 됐는데 Git을 못 찾는다는 경고
Git 위치를 직접 알려주면 됩니다. 설정 파일에 아래를 넣으세요. 다른 곳에 깔렸다면 where.exe git 으로 위치를 확인합니다.
"CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
WSL은 지금 안 하셔도 됩니다

윈도우에서 리눅스를 돌리는 WSL이라는 방식도 있습니다. 검색하면 많이 나오는데 처음에는 하지 마세요. 설정할 게 훨씬 많고, 위의 일반 설치로도 이 책에 나오는 일은 전부 됩니다.

STEP 1-7

작업대와 작업 폴더

클로드 코드는 지금 있는 폴더를 기준으로 일합니다

터미널만으로도 잘 돌아갑니다. 그런데 VS Code라는 무료 프로그램을 쓰면 네 가지가 편해집니다.

왼쪽에 폴더가 보인다
만들어진 파일이 실시간으로 목록에 나타납니다. 확인하러 갈 필요가 없습니다
폴더 이동이 필요 없다
폴더를 열면 터미널이 이미 그 폴더에서 시작합니다. 이동 명령을 배울 필요가 없습니다
결과를 바로 열어본다
만들어진 문서·표·웹페이지를 클릭 한 번으로 확인합니다
화면이 하나로 정리된다
창을 왔다 갔다 하지 않아도 됩니다. 처음일수록 이게 제일 큽니다

설치와 폴더 열기

code.visualstudio.com → 파란 다운로드 버튼 → 압축이 풀리면 아이콘을 응용 프로그램 폴더로 끌어다 놓기(이걸 빼먹으면 나중에 아이콘이 사라진 것처럼 보입니다)
윈도우
code.visualstudio.com → Download for Windows → 설치 중 추가 작업 선택 화면에서 "Code을(를) 사용하여 파일/디렉터리 열기"와 PATH에 추가를 체크
폴더 열기
상단 메뉴 파일 → 폴더 열기 → 작업할 폴더 선택 → "이 폴더의 작성자를 신뢰합니까?"에
폴더는 여기에 만드세요

바탕화면이나 문서 폴더 안에 영문·숫자로 된 짧은 이름의 폴더가 가장 속 편합니다. 그리고 구글드라이브·아이클라우드·원드라이브 같은 클라우드 동기화 폴더 안은 처음엔 피하세요. 동기화 중에 파일이 잠겨 이상한 오류가 납니다.

터미널 켜고 끄기

켜기 — 메뉴 (권장)
상단 메뉴 터미널 → 새 터미널. 매번 성공합니다
켜기 — 단축키
Ctrl + ` (숫자 1 왼쪽 키). 다만 맥에서 한글 입력 상태일 때는 그 자리가 ₩로 입력돼서 안 열립니다. 고장이 아니니 한/영 키를 누르고 다시 하거나 메뉴를 쓰세요
잠깐 숨기기
Ctrl + J 또는 터미널 오른쪽 위 아이콘. 다시 열면 그대로 있습니다
완전히 종료
터미널 오른쪽 위 휴지통 아이콘, 또는 exit 입력

글자가 네모(□)로 깨져 보이거나 화면이 번지면, 클로드 코드 안에서 /terminal-setup 을 한 번 실행하세요. 여러 줄 지시문을 Shift + Enter 로 쓰고 싶을 때도 이 명령이 필요합니다.

STEP 1-8

설치 점검과 뒷정리

이상하면 지우기 전에 점검부터. 삭제까지 갈 일은 거의 없습니다

설치 상태를 눈으로 확인하는 명령이 있습니다. 클로드 코드를 실행하지 않고 상태만 보여줍니다.

TERMINAL · 맥·윈도우 공통
claude doctor

어려운 영어가 잔뜩 나오지만 네 가지만 보면 됩니다.

Version
숫자가 적혀 있으면 정상
Install
OK 계열 문구면 정상
Search
OK 면 정상. 오류면 부록 A의 검색 항목 참고
Warning
경고가 있으면 그 아래 제안된 해결 방법을 그대로 따르면 됩니다

클로드 코드를 실행한 상태에서는 /doctor 를 입력해도 같은 점검이 됩니다.

업데이트 · 재설치 · 삭제

업데이트
보통은 알아서 됩니다
claude update 한 줄이면 끝. 공식 설치본은 평소에 알아서 최신으로 유지됩니다. Homebrew는 brew upgrade claude-code, WinGet은 winget upgrade Anthropic.ClaudeCode 로 직접 올려야 합니다.
재설치
아무리 해도 안 될 때
curl -fsSL https://claude.ai/install.sh | bash
윈도우 irm https://claude.ai/install.ps1 | iex
완전 삭제
마지막 수단
rm -f ~/.local/bin/claude · rm -rf ~/.local/share/claude
윈도우 Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
순서를 지키세요

안 될 때 지우고 다시 까는 것보다 터미널을 새로 열어보는 것이 먼저입니다. 그 다음이 claude doctor, 그 다음이 재설치입니다.

STEP 1 완료 확인
  • claude --version 에서 버전 숫자가 나온다
  • VS Code로 작업 폴더를 열었다
  • 메뉴 → 터미널 → 새 터미널로 터미널을 켤 수 있다
  • claude doctor 에 빨간 오류가 없다
STEP 2

넘기기

로그인하고, STEP 0에서 고른 그 일을 실제로 넘깁니다. 결과의 품질을 좌우하는 것은 도구가 아니라 지시문입니다. 여기서 지시문 쓰는 법을 익히면 나머지는 응용입니다.

STEP 2-1

로그인과 첫 지시

한 번만 로그인하면 다음부터는 바로 시작합니다

1

실행하고 로그인하기

VS Code에서 작업 폴더를 연 상태로 터미널을 켜고 아래를 입력합니다.

TERMINAL
claude

처음 실행하면 화면 색 테마를 고르라고 하고, 그다음 로그인 안내가 나옵니다. 안내에 따라 엔터를 누르면 브라우저가 자동으로 열립니다. 클로드 계정으로 로그인하고 승인(Authorize)을 누르면 끝입니다.

터미널로 돌아오면 환영 화면이 떠 있습니다.

로그인이 안 될 때

브라우저가 안 열린다 — 화면에 주소(https://...)가 같이 나옵니다. 복사해서 브라우저에 직접 붙여 넣으세요.
무료 플랜이라 막힌다 — Pro 이상 유료 구독이 필요합니다.
로그인 화면이 반복된다/logout/login 으로 다시 시도하세요.

2

어느 폴더에서 일하는지 확인하기

엉뚱한 폴더에서 실행하면 엉뚱한 파일을 봅니다. VS Code로 폴더를 열고 그 안에서 터미널을 켰다면 이미 맞지만, 확실히 하려면 이렇게 물어보세요.

그대로 복사
지금 어느 폴더에서 작업 중이야? 이 폴더에 뭐가 들어 있는지 알려 줘.

폴더를 옮기려면 /cd 뒤에 경로를, 다른 폴더도 같이 보게 하려면 /add-dir 를 씁니다. 경로 타이핑이 어려우면 폴더를 터미널 창으로 끌어다 놓으세요. 경로가 자동 입력됩니다.

3

첫 지시 — 그냥 우리말로

명령어가 아니라 그냥 문장입니다. 몸을 푸는 셈 치고 하나만 해 보세요.

그대로 복사
이 폴더에 지금 어떤 파일들이 있는지 종류별로 표를 만들어서
"현황.md" 파일로 저장해 줘. 파일은 지우거나 옮기지 마.

왼쪽 파일 목록에 실제로 파일이 생기는 게 보입니다. 이것이 채팅 AI와 다른 지점입니다.

STEP 2-2

승인 화면과 권한 모드

파일을 건드리기 전에 반드시 물어봅니다. 그 화면을 읽는 법입니다

파일을 만들거나 고치기 전에 클로드 코드는 "이렇게 할 건데 괜찮습니까?"라고 먼저 물어봅니다. 화면에 뜨는 선택지의 뜻은 이렇습니다.

Yes
이번 한 번만 허락합니다. 처음에는 이것만 쓰세요.
Yes, and don't ask again
앞으로 같은 종류는 묻지 않고 진행합니다. 익숙해진 뒤에 쓰세요.
No, tell Claude what to do differently
거절하고, 대신 어떻게 해야 할지 말로 알려줍니다.

선택은 위아래 화살표로 옮기고 엔터로 확정합니다. 터미널에서는 마우스 클릭이 안 되니 화살표를 쓰세요.

권한 모드 — Shift + Tab

입력창에서 Shift + Tab 을 누르면 권한 모드가 바뀝니다. 여러 번 누르면 순서대로 돌아갑니다.

처음엔 여기
Manual
파일을 바꾸기 전에 매번 물어봅니다. 기본값입니다
큰 작업 전
Plan
실행하지 않고 "이렇게 하겠습니다"라는 계획만 먼저 보여줍니다
익숙해진 뒤
Accept edits
파일 수정을 묻지 않고 진행합니다. 되돌릴 수 있는 작업에만
사고를 줄이는 습관 하나

파일을 많이 건드리는 작업은 Plan 모드로 계획을 한 번 훑고 시작하세요. 계획을 읽고 고칠 부분을 말한 다음 진행시키면 사고가 거의 안 납니다.

STEP 2-3

멈추기와 되돌리기

이걸 알아야 마음 편히 시켜볼 수 있습니다

방향이 틀렸다, 멈춰
Esc 한 번. 지금까지 한 작업은 남습니다
입력한 글을 지우고 싶다
Esc 두 번
이전 시점으로 되돌리고 싶다
입력창이 빈 상태에서 Esc 두 번, 또는 /rewind 입력
완전히 나가기
/exit 입력, 또는 빈 입력창에서 Ctrl + D 두 번
아예 반응이 없다
Ctrl + C. 그래도 안 되면 터미널을 닫고 새로 여세요
화면이 깨져 보인다
Ctrl + L 로 화면을 새로 그립니다
껐어도 대화는 안 사라집니다

실수로 창을 닫아도 괜찮습니다. 같은 폴더에서 claude 를 다시 실행하고 /resume 을 입력하면 이전 대화 목록이 뜹니다. 골라서 이어 가면 됩니다.

되돌리기가 어디까지 되나

클로드 코드는 작업 중간중간을 자동으로 저장해 둡니다. /rewind 메뉴에서 대화만 되돌릴지, 파일까지 되돌릴지 고를 수 있습니다.

대화만
지시를 되돌립니다. 만들어진 파일은 그대로 남습니다
파일까지
그 시점의 파일 상태로 돌아갑니다
그래도 되돌리기를 믿지 마세요

되돌리기는 클로드 코드가 한 작업에 대한 것입니다. 처음 다루는 중요한 폴더라면 복사본을 만들어 놓고 연습하시는 편이 확실합니다. 그리고 지시문에 "지우지 말고 옮기기만 해"를 넣는 습관을 들이세요.

STEP 2-4

지시문 3요소

같은 도구인데 사람마다 결과가 다릅니다. 차이는 여기서 갈립니다

좋은 지시문에는 세 가지가 들어갑니다 — 목표 · 상황 · 울타리.

① 목표
무엇을, 어떤 수준으로. 이게 없으면 "대충 평균적으로" 만들어 놓습니다
② 상황
내가 어떤 일을 하는 사람인지, 이 결과물이 어디에 쓰이는지. 알려줄수록 내 것에 가까워집니다
③ 울타리
이건 하지 마라. 가장 많이 빠뜨리고 가장 효과가 큽니다. 없으면 요청하지 않은 것까지 건드립니다
세 가지가 다 들어간 예시
이 폴더의 견적서 PDF들을 비교표로 만들어 줘.            ← 목표
나는 가구를 만드는 회사 대표고, 이 표는 내부 검토용이야.    ← 상황
업체명·금액·납기·담당자를 뽑아서 금액이 낮은 순으로 정렬해 줘.
원본 파일은 건드리지 말고, 찾지 못한 항목은 빈칸으로 두지 말고
"없음"이라고 적어 줘. 만들기 전에 표를 먼저 보여 줘.        ← 울타리

울타리에 자주 쓰는 네 문장

아래 네 문장은 거의 모든 지시문 끝에 붙여도 좋습니다. 외우실 필요는 없고, 이 페이지를 접어 두세요.

"지우지 말고 옮기기만 해."
파일을 잃지 않습니다. 정리 작업에는 무조건 붙이세요
"실행하기 전에 계획을 먼저 보여 줘."
사고를 미리 막습니다. 되돌리는 것보다 훨씬 쌉니다
"확인되지 않은 숫자는 지어내지 말고 [확인 필요]라고 표시해 줘."
그럴듯한 가짜 숫자를 막습니다. 실무에서 쓸 수 있는 문서와 못 쓰는 문서를 가르는 한 줄입니다
"다른 파일은 건드리지 마."
작업 범위를 묶어 둡니다
STEP 2-5

결과를 고쳐 받는 법

"다시 해 줘"라고 하면 비슷한 게 또 나옵니다

무엇이 왜 아쉬운지를 말해야 방향이 잡힙니다. 사람에게 일을 다시 시킬 때와 똑같습니다.

"다시 해 줘"
→ "제목이 너무 딱딱해요. 좀 더 친근한 말투로 바꿔 줘"
"이상해"
→ "3번 항목이 우리 상황과 안 맞아. 우리는 기업 대상이라 그 부분을 빼 줘"
"더 잘해 줘"
→ "길이는 지금의 절반으로 줄이고, 숫자를 두 개만 넣어 줘"
"에러 났어"
→ 화면의 오류 문구를 한 글자도 빼지 말고 통째로 복사해서 붙여넣기

첫날 자주 하는 실수 다섯 가지

바탕화면 전체나 문서 폴더 전체에서 바로 실행
파일이 너무 많아 느려지고 엉뚱한 파일까지 건드릴 수 있습니다 → 연습용 폴더를 하나 만들어 그 안에서
지시를 너무 짧게 ("정리해 줘")
기준을 모르니 마음대로 정리합니다 → 목표·상황·울타리 세 가지를
승인 화면을 안 읽고 계속 엔터
의도와 다른 작업이 그대로 실행됩니다 → 처음 며칠은 한 줄이라도 읽고
한 대화에서 전혀 다른 일을 계속 이어감
답이 느려지고 앞의 지시와 섞입니다 → 일이 바뀌면 /clear
오류를 요약해서 전달
원인을 못 찾습니다 → 통째로 복사해서 붙여넣기
STEP 2 완료 확인 — 여기까지가 진짜 시작선
  • 로그인을 마치고 환영 화면을 봤다
  • 우리말로 시켜서 파일이 하나 만들어지는 걸 봤다
  • 승인 화면에서 Yes를 골라봤다
  • Esc 로 멈추고 /exit 로 나가는 법을 안다
  • 지시문에 울타리 한 줄을 넣어봤다
STEP 3

실전 —
업무 이관 카드 12장

카드마다 준비물 · 결과물 · 지시문 · 잘 안 될 때가 함께 있습니다. 준비물이 폴더에 없으면 그 카드는 아직 못 씁니다. 있는 것부터 하세요.

01–03 파일·폴더  ·  04–06 뽑아내기  ·  07–09 대조·일정  ·  10–12 문서

STEP 3-1

파일과 폴더 정리

결과가 눈에 바로 보이는 일들입니다. 첫 이관으로 가장 좋습니다

파일을 옮기는 카드는 이것부터

처음 한 번은 폴더를 복사해 두고 그 복사본에서 연습하세요. 그리고 지시문의 "바로 옮기지 말고 표로 먼저 보여 줘"는 지우지 마세요.

01거래처별 견적서 정리매주
준비물 견적서 파일이 뒤섞인 폴더결과물 거래처 > 연월 폴더로 분류
그대로 복사
이 폴더의 견적서 파일들을 거래처별로 정리해 줘.
거래처 이름 폴더를 만들고 그 안에 연월 폴더를 하나 더 만들어서 옮겨 줘.
지우는 건 절대 하지 마. 옮기기만 해.
바로 옮기지 말고 어떤 파일이 어디로 갈지 표로 먼저 보여 줘.
잘 안 되면 거래처 이름을 파일명에서 못 읽는 경우입니다. "파일을 열어서 안에 적힌 거래처명을 읽고 판단해 줘"를 덧붙이세요.
02파일 이름 규칙 일괄 적용수시
준비물 이름이 제각각인 파일들결과물 날짜_거래처_문서종류 로 통일
그대로 복사
이 폴더의 파일 이름을 규칙에 맞게 바꿔 줘.
규칙은 "날짜_거래처_문서종류" 순서이고 날짜는 YYYYMMDD로.
날짜를 알 수 없는 파일은 바꾸지 말고 따로 알려 줘.
바꾸기 전에 "지금 이름 → 바뀔 이름" 표를 먼저 보여 줘.
잘 안 되면 파일 만든 날짜와 서류에 적힌 날짜가 다를 수 있습니다. "파일 안에 적힌 발행일 기준으로"라고 못 박으세요.
03오래된 파일 골라내기분기
준비물 몇 년치가 쌓인 폴더결과물 보관 폴더 + 목록 문서
그대로 복사
이 폴더에서 1년보다 오래된 파일을 골라
"보관" 폴더를 만들어 옮겨 줘. 연도별로 나눠서 넣어 줘.
지우는 건 하지 마. 옮기기만 해.
무엇을 옮겼는지 목록을 "보관목록.md"로 남겨 줘.
잘 안 되면 지금도 쓰는 서식 파일까지 딸려갈 수 있습니다. "파일 이름에 '양식'·'템플릿'이 들어간 것은 제외해 줘"를 덧붙이세요.
STEP 3-2

서류에서 뽑아내기

눈으로 읽고 손으로 옮겨 적던 것들입니다

뽑아낸 숫자는 반드시 검산하세요

숫자는 틀려도 눈에 안 보입니다. 지시문의 "[확인 필요]로 표시해 줘"를 반드시 남기고, 나온 표를 원본 서류 두세 장과 눈으로 대조한 뒤에 쓰세요.

04현장 사진 이름 붙이기수시
준비물 번호만 붙은 사진 수십~수백 장결과물 내용이 보이는 한글 이름
그대로 복사
이 폴더의 사진들을 하나씩 열어보고
찍혀 있는 내용에 따라 파일 이름을 다시 지어 줘.
이름은 한글로 20자 이내로 짧게, 앞에 촬영일을 붙여 줘.
사람 얼굴·명함·서류처럼 개인정보가 보이는 사진은
이름을 바꾸지 말고 목록으로만 알려 줘.
잘 안 되면 사진이 아주 많으면 오래 걸립니다. "먼저 10장만 해 보고 결과를 보여 줘"로 시작해 이름 규칙을 잡은 뒤 전체를 돌리세요.
05서류에서 숫자 뽑아 비교표로매주
준비물 거래명세서·계산서 PDF 여러 장결과물 비교표 문서 한 장
그대로 복사
이 폴더의 PDF를 전부 읽고 거래처명·품목·수량·단가·합계·발행일을
뽑아서 비교표로 만들어 줘. 합계가 낮은 순서로 정렬하고
"비교표.md"로 저장해 줘.
찾지 못한 항목은 빈칸으로 두지 말고 "없음"이라고 적어 줘.
확인되지 않은 숫자는 지어내지 말고 [확인 필요]로 표시해 줘.
잘 안 되면 스캔해서 만든 PDF는 글자가 그림이라 못 읽습니다. 그럴 땐 "글자 인식이 안 되는 파일은 목록으로만 알려 줘"를 붙이고, 그 파일들만 손으로 처리하세요.
06매출 자료 요약 리포트매월
준비물 매출 엑셀을 CSV로 저장한 파일결과물 요약 문서 (건수·상위·증감)
그대로 복사
이 폴더의 매출 CSV를 읽고 핵심만 요약해 줘.
전체 건수, 거래처별 합계와 평균, 상위 5곳,
지난달 대비 늘거나 줄어든 곳을 표로 정리해서
"매출요약.md"로 만들어 줘. 숫자는 천 단위 쉼표를 넣어 줘.
합계는 계산 후에 한 번 더 검산해서 알려 줘.
준비 엑셀에서 다른 이름으로 저장 → CSV(쉼표로 분리)를 고르면 CSV가 됩니다. 원본 엑셀은 그대로 두세요.
STEP 3-3

맞춰 보고 일정 잡기

두 개를 나란히 놓고 비교하던 일, 날짜를 정리하던 일

애매한 건 물어보게 하세요

이름이 조금 다른 항목을 같은 것으로 볼지 말지는 사람이 정할 일입니다. 지시문의 "판단이 애매한 건 마음대로 정하지 말고 물어봐 줘"를 남겨 두세요.

07두 목록 대조해 빠진 것 찾기매주
준비물 비교할 목록 파일 두 개결과물 누락 목록 두 표
그대로 복사
이 폴더의 [A목록] 파일과 [B목록] 파일을 나란히 대조해 줘.
A에는 있는데 B에 없는 항목, B에만 있는 항목을 각각 표로 뽑아 줘.
이름이 조금 다르지만 같은 것으로 보이는 항목도 따로 모아 줘.
판단이 애매한 건 마음대로 정하지 말고 물어봐 줘.
쓰는 곳 자재목록↔발주목록, 입금내역↔청구내역, 출고↔재고. 두 목록이 있는 일이면 뭐든 됩니다.
08주문서에서 납기 일정표매주
준비물 주문서·발주서 파일들결과물 날짜순 일정표
그대로 복사
이 폴더의 주문서들을 읽고 납기 일정표를 만들어 줘.
날짜 순서로 정렬하고 같은 날 나가는 건은 한 줄로 묶어 줘.
항목은 납기일·거래처·품목·수량·담당자로.
납기가 이번 주 안인 건은 맨 위에 따로 모아 줘.
"납기일정.md"로 저장해 줘.
잘 안 되면 납기일 표기가 서류마다 다를 수 있습니다("8/15", "8월 15일"). "날짜 표기가 제각각이면 전부 YYYY-MM-DD로 통일해 줘"를 덧붙이세요.
09월말 마감 체크리스트매월
준비물 매달 하는 일을 적은 메모결과물 순서와 마감일이 있는 체크리스트
그대로 복사
내가 매달 말에 하는 일을 체크리스트로 만들어 두고 싶어.
아래 일들을 순서와 마감일 기준으로 정리해서 "월말마감.md"로 만들어 줘.
[여기에 매달 하는 일을 생각나는 대로 적으세요]
빠뜨리기 쉬운 항목이 보이면 같이 알려 주고,
내가 안 적었지만 보통 함께 하는 일은 제안만 해 줘. 마음대로 넣지는 마.
다음 단계 이 파일이 생기면 STEP 4-2에서 /월말마감 명령 한 줄로 만듭니다.
STEP 3-4

문서 만들기

초안까지 맡기고 마지막만 다듬는 것이 가장 빠릅니다

고객에게 나가는 문서는 초안까지만

여기서 나온 결과물은 발송 전에 사람이 반드시 마지막으로 읽습니다. 그리고 지시문에 "없는 내용을 지어내지 마"를 남겨 두세요.

10회의 메모를 회의록으로매주
준비물 급하게 적은 메모 파일결과물 결정사항·담당자·마감일이 있는 회의록
그대로 복사
이 폴더의 회의 메모를 읽고 정식 회의록으로 정리해 줘.
'논의 내용', '결정 사항', '후속 할 일(담당자와 마감일 포함)'
세 부분으로 나눠 줘.
메모에 없어서 내가 확인해야 하는 부분은 [확인 필요]로 표시해 줘.
없는 내용을 만들어 넣지 마.
더 쓰려면 녹취 파일을 글로 옮긴 텍스트가 있으면 그것도 같은 폴더에 넣고 "녹취록도 같이 읽어 줘"라고 하세요.
11안내문 세 가지 버전수시
준비물 알릴 내용 한 문단결과물 상대별 안내문 세 개 파일
그대로 복사
아래 내용으로 안내문을 세 가지 버전으로 써 줘.
(1) 오래된 거래처용 — 정중하고 짧게
(2) 신규 문의 고객용 — 우리가 뭘 하는 회사인지 한 줄 설명 포함
(3) 문자·메신저용 — 세 줄 이내, 존댓말
내용: [여기에 알릴 내용을 적으세요]
각각 파일로 저장해 줘. 과장된 표현은 쓰지 마.
다듬을 때 "2번이 너무 딱딱해. 좀 더 편한 말투로"처럼 어느 것이 왜 아쉬운지를 말하면 한 번에 잡힙니다.
12자주 오는 문의 답변 모음한 번 만들고 계속
준비물 지난 문의 메일·메시지를 모아 둔 파일결과물 질문별 표준 답변 문서
그대로 복사
이 폴더의 문의 내용들을 읽고 자주 반복되는 질문을 묶어 줘.
질문 유형별로 표준 답변을 하나씩 써서 "문의답변.md"로 만들어 줘.
가격·납기처럼 확정할 수 없는 항목은 [확인 필요]로 비워 두고,
거래처명·연락처 같은 개인정보는 답변에 넣지 마.
효과 이 문서 하나가 있으면 다음부터 답장이 복사·붙여넣기가 됩니다. STEP 4에서 명령 한 줄로 만들 수 있습니다.
STEP 4

굳히기

STEP 3까지는 한 번씩 시켜 보는 일이었습니다. 여기서부터는 계속 반복되는 일을 아예 구조로 만듭니다. 두 번째부터는 30분짜리가 5초가 됩니다.

STEP 4-1

회사 규칙 파일 만들기

매번 같은 설명을 반복하고 있다면, 한 번만 적어 두세요

작업 폴더에 CLAUDE.md 라는 파일을 두면, 클로드 코드가 일을 시작할 때마다 그 파일을 먼저 읽습니다. 회사 이름, 말투, 금지 사항, 자주 쓰는 문서 형식을 여기에 한 번만 적어 두면 매번 설명할 필요가 없어집니다.

그대로 복사
이 폴더에 CLAUDE.md 파일을 만들어 줘. 아래 내용을 담아 줘.
- 회사명: [회사 이름]
- 하는 일: [한 줄 설명]
- 문서 말투: 정중한 존댓말, 과장된 표현 금지
- 고객에게 나가는 문서에는 내부 폴더 이름을 쓰지 말 것
- 확인되지 않은 숫자는 지어내지 말고 [확인 필요]로 표시할 것
- 파일 이름은 "날짜_주제" 형식으로
- 파일을 지우지 말고 옮기거나 복사만 할 것

여기에 적어 두면 좋은 것

거래처를 부르는 방식
"○○상사 귀중" 같은 우리 회사 관행. 매번 고쳐 주지 않아도 됩니다
쓰지 않는 표현
"최고의", "혁신적인" 같은 과장어. 한 줄 적어 두면 안 씁니다
문서 기본 형식
견적서·회의록에 늘 들어가는 항목 순서
건드리면 안 되는 폴더
"계약·인사 폴더는 읽지도 쓰지도 말 것" 같은 선
더 쉬운 방법

클로드 코드 안에서 /init 을 입력하면 이 파일의 뼈대를 알아서 만들어 주기도 합니다. 이미 만든 파일을 손보려면 /memory 를 쓰세요.

이 파일에 넣지 말 것

비밀번호·계좌번호·주민번호 같은 비밀값은 적지 마세요. 이 파일은 매번 읽히는 안내문이지 금고가 아닙니다.

STEP 4-2

나만의 명령 만들기

잘 먹힌 지시문은 버리지 말고 명령으로 저장하세요

자주 쓰는 지시문을 파일로 저장해 두면 슬래시(/) 하나로 부를 수 있습니다. 직접 만들 필요 없이 이렇게 시키면 됩니다.

그대로 복사
내가 매달 하는 마감 정리를 명령 하나로 부를 수 있게 만들어 줘.
이 폴더 안에 .claude/skills/월말마감/SKILL.md 를 만들어 줘.
내용은: 이번 달에 만들어진 파일을 전부 확인하고
"한 일 / 진행 중 / 다음 달 할 일" 세 부분으로 요약해서
"월말보고-날짜.md" 파일로 저장하는 작업이야.
만든 뒤에 어떻게 실행하는지 알려 줘.

다음부터는 /월말마감 만 입력하면 됩니다. 매달 30분 걸리던 일이 5초가 됩니다.

명령으로 만들면 좋은 것

주기가 있는 일
주간 보고, 월말 마감, 분기 정리 — 가장 효과가 큽니다
형식이 정해진 일
회의록 정리, 견적서 비교표, 납기 일정표
여러 단계를 매번 같은 순서로
"파일 읽고 → 표 만들고 → 저장" 같은 흐름
만드는 요령

처음부터 명령으로 만들지 마세요. STEP 3의 지시문을 두세 번 써 보고, 손에 익은 다음에 그 문장을 그대로 명령으로 옮기는 순서가 실패가 없습니다.

지시문을 그냥 모아 두기만 해도 됩니다

거창하게 안 하셔도 됩니다. 작업 폴더에 지시문모음.md 파일을 하나 만들어 잘 먹힌 문장을 붙여 넣기만 해도 충분합니다. 다음에 복사해서 조건만 바꾸면 되니까요.

STEP 4-3

계획 먼저, 대화는 짧게

느려지는 이유와 사고가 나는 이유는 각각 하나씩입니다

큰 작업은 계획부터

파일을 많이 건드리는 작업은 Shift + Tab 을 눌러 Plan 모드로 바꾼 뒤 시작하세요. 실행하지 않고 계획만 먼저 보여줍니다. 계획을 읽고 고칠 부분을 말한 다음 진행시키면 사고가 거의 안 납니다.

대화가 길어지면 느려집니다

클로드 코드는 지금까지의 대화 전체를 매번 다시 읽으면서 답합니다. 그래서 대화가 길어지면 읽을 게 많아져 느려집니다. 고장이 아닙니다.

/context
지금 얼마나 찼는지 보여줍니다 — 느려진 이유를 확인할 때
/compact
핵심만 남기고 요약합니다 — 하던 일을 이어갈 때
/clear
전부 지우고 새로 시작합니다 — 다른 일로 넘어갈 때
습관 하나

일이 하나 끝날 때마다 /clear. 이 습관 하나로 속도 문제의 대부분이 사라집니다.

잘못했을 때

빈 입력창에서 Esc 를 두 번 누르거나 /rewind 를 입력하면 되돌리기 메뉴가 뜹니다. 대화만 되돌릴지, 파일까지 되돌릴지 고를 수 있습니다.

STEP 4 완료 확인
  • 작업 폴더에 CLAUDE.md 가 있다
  • 매달·매주 하는 일 하나를 명령으로 만들었다
  • 큰 작업 전에 Plan 모드를 눌러 봤다
  • 일이 끝나면 /clear 를 누르는 습관이 생겼다
STEP 5

넓히기

혼자 쓰다가 팀에 퍼지기 시작하면 규칙이 없어서 사고가 납니다. 회사 자료를 다룰 때의 선을 먼저 긋고, 팀에 넘길 다섯 줄을 준비합니다.

STEP 5-1

회사 자료를 다룰 때 다섯 가지

사고는 대부분 이 다섯 군데에서 납니다

1

승인 모드를 유지하세요

파일을 지우거나 크게 바꾸는 작업은 실행 전에 물어보는 기본 모드로 두세요. 익숙해지기 전까지 자동 승인을 켜지 마세요. 편해지는 것보다 잃는 게 큽니다.

2

지우는 작업은 시키지 마세요

"정리해 줘"는 괜찮지만 "필요 없는 거 지워 줘"는 위험합니다. 지시문에 "지우지 말고 옮기기만 해"를 넣는 습관을 들이세요.

3

중요한 폴더는 복사본으로

처음 다루는 폴더라면 복사본을 만들어 연습하세요. 익숙해진 다음 원본에 적용해도 늦지 않습니다.

4

개인정보는 범위를 정하세요

주민번호·계좌·고객 연락처가 든 파일은 작업 폴더에서 빼 두거나, 지시문에 아래 한 줄을 넣으세요.

그대로 복사
개인정보가 보이면 건드리지 말고 목록만 알려 줘.
5

확인 안 된 숫자를 지어내지 않게

지시문에 이 한 줄을 넣으세요. 실무에서 쓸 수 있는 문서와 못 쓰는 문서를 가릅니다.

그대로 복사
확인되지 않은 숫자나 사실은 지어내지 말고 [확인 필요]라고 표시해 줘.
STEP 5-2

팀에 넘길 때 다섯 줄

규칙 없이 퍼지면 사고가 납니다. 이것만 먼저 공유하세요

아래 다섯 줄을 그대로 팀 채널에 붙여 넣으세요. 그리고 이걸 CLAUDE.md 에 넣어 두면 매번 지켜집니다.

그대로 복사 — 팀 공유용
1. 지우는 작업은 시키지 않는다. 옮기거나 복사만 시킨다.
2. 고객에게 나가는 문서는 사람이 반드시 마지막에 확인한다.
3. 확인되지 않은 숫자는 [확인 필요]로 표시하고 그대로 내보내지 않는다.
4. 개인정보가 든 파일은 별도 폴더에 두고 작업 폴더에 섞지 않는다.
5. 자동 승인 모드는 되돌릴 수 있는 작업에만 쓴다.

겁내지 않아도 되는 것들

팀원들이 처음에 하는 걱정은 거의 정해져 있습니다.

"컴퓨터를 망가뜨리면 어떡하지"
클로드 코드는 물어보고 진행합니다. 승인 없이 시스템을 바꾸지 않습니다
"명령어를 잘못 치면 큰일 나나"
대부분은 "그런 명령 없다"는 메시지가 나올 뿐입니다. 다시 치면 됩니다
"영어를 못하는데"
지시는 전부 우리말로 합니다. 영어는 오류 메시지에만 나오고, 그건 통째로 붙여넣으면 됩니다
"나이가 있어서 못 배울 것 같은데"
배울 게 이 책 분량이 전부입니다. 나머지는 말로 시키는 것이라 오히려 익숙한 방식입니다
"내 파일이 밖으로 나가나"
작업에 필요한 내용만 전송됩니다. 회사 보안 정책이 따로 있다면 그 정책을 먼저 따르세요

퍼뜨리는 순서

한꺼번에 전 직원에게 알리면 대부분 안 씁니다. 저희가 실제로 쓴 순서는 이렇습니다.

1주차
한 사람이 먼저 자기 업무 하나를 넘겨 보고, 결과물을 팀에 보여 줍니다. 설명보다 결과물이 빠릅니다
2주차
관심 보인 사람에게 이 책과 위 다섯 줄을 건넵니다. 설치는 옆에서 30분만 같이 앉아 주면 됩니다
그다음
각자 만든 지시문을 한 파일에 모읍니다. 이게 회사 자산이 됩니다
STEP 5-3

오토프로그가 넘긴 일곱 가지

참고가 되도록, 저희 회사가 실제로 넘긴 일과 절감 시간을 그대로 적습니다

직원 13명 규모의 제조·유통 회사입니다. 2026년 2월부터 하나씩 늘려 왔고, 아래는 자사 실측 기준입니다.

넘긴 일계산 근거주당 절감
상담 초기 응대와 정보 수집건당 10분 이상 × 하루 20건 × 주 5일16.7시간
견적서 작성건당 20분 → 5분 × 주 20건5시간
제안 메일 발송건당 3분 절감 × 100건 × 주 1회5시간
블로그 글쓰기편당 1시간 절감 × 주 3편3시간
메일함 정리하루 30분 × 주 5일2.5시간
판매 전표 입력건당 5분 × 주 30건2.5시간
연차·급여 정리월 8시간 → 클릭 몇 번2시간

합치면 주 35시간 이상입니다. 직원 한 명의 근무 시간에 가깝습니다.

정직하게 밝힙니다

위 숫자는 전부 저희 회사 안에서 측정한 것입니다. 다른 회사에 넣어서 만든 성과는 아직 없습니다. 그래서 이 책도 "이렇게 하면 얼마를 법니다"가 아니라 "저희는 이렇게 했습니다"까지만 씁니다.

시작한 순서도 그대로 적으면

가장 먼저 넘긴 것은 메일함 정리였습니다. 절감 시간이 큰 일이 아니라 틀려도 바로 눈에 보이는 일이었기 때문입니다. STEP 0-2에서 말씀드린 기준이 저희가 실제로 쓴 기준입니다.

APPENDIX

부록

막혔을 때 화면 문구로 찾는 해결표, 필요할 때 펼쳐 보는 단축키와 명령어, 그리고 하루 한 칸씩 채우는 2주 실행표.

부록 A-1

막혔을 때 — 화면 문구로 찾기

먼저 세 단계를 순서대로. 대부분 1단계에서 끝납니다

1단계
통째로 붙여넣기
오류 문구를 한 글자도 빼지 말고 복사해서 물어봅니다
2단계
/clear 후 다시
대화가 엉켰을 때는 비우고 새로 시키는 게 답입니다
3단계
터미널 껐다 켜기
그래도 안 되면 재설치. 삭제까지 갈 일은 거의 없습니다
그대로 복사 — 1단계에 쓰는 문장
이런 오류가 났어. 원인이 뭐고 어떻게 해결하면 될까?

[여기에 화면의 오류 문구를 통째로 붙여넣기]

증상별 해결표

claude 를 쳤는데 못 찾는다고 나옴
터미널을 완전히 껐다 새로 여세요(맥 ⌘+Q, 윈도우 창 닫기). 그래도 안 되면 1-2의 4단계(맥) 또는 1-5의 5단계(윈도우) PATH 등록.
어제는 됐는데 오늘 안 됨
터미널에서 claude doctor 실행. 상태와 해결 방법을 알려줍니다.
답이 갑자기 아주 느려짐
/compact 로 요약하거나, 다른 일을 시작하는 거면 /clear.
계속 엉뚱한 파일을 봄
작업 폴더가 틀린 겁니다. /cd 로 옮기거나 VS Code에서 폴더를 다시 여세요.
파일을 못 찾는다고 함
파일 이름을 @ 로 직접 지정해 보세요. 그래도 안 되면 다른 폴더에 있는 겁니다 — /add-dir 로 추가.
화면 글자가 네모(□)로 깨짐
/terminal-setup 실행 후 편집기를 다시 시작하세요.
화면이 지저분하게 겹쳐 보임
Ctrl + L 로 화면을 새로 그립니다.
아무 반응 없이 멈춤
Ctrl + C 로 중단. 그래도 안 되면 터미널을 닫고 새로 연 뒤 claude/resume 으로 이어가세요.
컴퓨터가 갑자기 느려지고 팬이 돎
큰 폴더를 통째로 읽고 있을 수 있습니다. Esc 로 멈추고 범위를 좁혀 다시 시키세요.
되돌리고 싶음
빈 입력창에서 Esc 두 번, 또는 /rewind.
부록 A-2

영어 오류 메시지 읽는 요령

영어를 잘할 필요는 없습니다. 세 군데만 보면 됩니다

1

맨 첫 줄과 맨 끝 줄

가운데는 대개 기술적인 경로 나열입니다. 첫 줄에 무엇이, 끝 줄에 왜가 들어 있습니다.

2

not found / cannot / failed

이 세 단어 근처가 원인입니다. "찾을 수 없다 / 할 수 없다 / 실패했다" 뒤에 오는 이름이 범인입니다.

3

큰따옴표나 경로

C:\.../Users/... 같은 경로가 보이면 그 위치의 파일 문제입니다.

그리고 어차피 해석은 클로드에게 시키면 됩니다. 통째로 붙여넣고 "이거 무슨 뜻이야?"라고 물어보세요.

이 세 가지도 자주 나옵니다

사용 한도 안내가 뜸
/usage 로 남은 양과 초기화 시각을 확인하세요. 자주 걸리면 상위 요금제를 검토합니다.
로그인이 계속 반복됨
/logout/login. 그래도 안 되면 브라우저에서 claude.ai에 먼저 로그인해 두고 다시 시도하세요.
검색이 잘 안 되고 파일을 못 찾음
(claude doctor 의 Search 항목이 오류)
검색 도구가 안 잡히는 경우입니다. 맥은 brew install ripgrep, 윈도우는 winget install BurntSushi.ripgrep.MSVC.

사람에게 도움을 요청할 때 담을 다섯 가지

동료나 아는 사람에게 물어볼 때, 아래 다섯 가지가 있으면 해결 시간이 절반으로 줄어듭니다.

① 운영체제
맥인지 윈도우인지, 버전은 무엇인지
② 어디까지 했는지
"1-4의 3단계 설치 명령까지 했습니다"
③ 무엇을 입력했는지
입력한 명령 한 줄 그대로
④ 화면에 나온 문구
요약하지 말고 통째로. 캡처면 더 좋습니다
⑤ 이미 해본 것
"터미널을 껐다 켜봤고 PATH도 등록해봤습니다"
캡처 한 장이 문장 열 줄보다 낫습니다

맥은 ⌘ + Shift + 4, 윈도우는 윈도우 키 + Shift + S 로 화면 일부를 캡처할 수 있습니다. 터미널 화면을 통째로 찍어 두세요.

부록 B-1

먼저 익힐 여섯 가지와 단축키

다 외우지 마세요. 여섯 개만 익히고 나머지는 찾아 쓰면 됩니다

Esc — 멈추기
방향이 틀렸을 때. 제일 많이 씁니다
Shift + Tab — 권한 모드
큰 작업 전에 계획부터 보고 싶을 때(Plan 모드)
/ — 명령 목록
입력창 맨 앞에서. 뭘 할 수 있는지 막막할 때
@ — 파일 지정
"이 파일을 고쳐 줘"라고 짚어줄 때
/clear — 새로 시작
완전히 다른 일을 시작할 때
/rewind — 되돌리기
"이게 아닌데" 싶을 때

기본 단축키

Esc작업 중단, 창 닫기
Esc Esc입력 지우기 / 되돌리기 메뉴
Ctrl + C강제 중단, 한 번 더 누르면 종료
Ctrl + D종료 (빈 입력창에서 두 번)
Ctrl + L화면 새로 그리기
Ctrl + O자세히 보기 켜기/끄기
Ctrl + R예전에 입력한 것 검색
Ctrl + B오래 걸리는 작업 뒤로 돌리기
Ctrl + T할 일 목록 보기/숨기기
Ctrl + S쓰던 글 잠시 치워 두기
Ctrl + G긴 글을 외부 편집기로 열기
↑ / ↓커서 이동, 예전 입력 불러오기
?단축키 도움말 (빈 입력창에서)
Ctrl+V / Alt+V화면 캡처 붙여넣기 (윈도우는 Alt)

글자 편집

Ctrl + A / E줄 맨 앞으로 / 줄 맨 뒤로
Ctrl + W앞 단어 하나 지우기
Ctrl + U커서 앞쪽 전부 지우기
Ctrl + K커서 뒤쪽 전부 지우기
Ctrl + Y방금 지운 글 되살리기
부록 B-2

명령어 사전

외우지 말고 / 를 친 다음 글자 몇 개로 걸러 쓰세요

명령하는 일언제 쓰나
/help도움말과 명령 목록뭘 할 수 있는지 모를 때
/clear대화 비우고 새로 시작다른 작업으로 넘어갈 때
/compact대화를 요약해 정리답이 느려질 때
/context대화가 얼마나 찼는지 보기느려진 이유를 확인할 때
/resume이전 대화 이어가기어제 하던 일을 오늘 이어서
/rewind이전 시점으로 되돌리기"이게 아닌데" 싶을 때
/init이 폴더의 안내 파일 만들기회사 규칙을 정리해둘 때
/memory기억해둘 규칙 편집"앞으로 이렇게 해"를 저장할 때
/model사용할 AI 모델 바꾸기더 똑똑하게 또는 더 빠르게
/usage사용량과 남은 한도 보기"얼마나 썼지?" 궁금할 때
/doctor설치·설정 상태 점검뭔가 이상하게 동작할 때
/terminal-setup터미널 표시 문제 수정글자가 깨져 보일 때
/copy마지막 답변을 복사답변을 다른 곳에 붙여넣을 때
/export대화 전체를 파일로 저장기록을 남겨야 할 때
/add-dir다른 폴더도 보게 추가여러 폴더를 한 번에 다룰 때
/cd작업 폴더 옮기기다른 폴더로 이동할 때
/diff바뀐 내용을 나란히 비교뭐가 어떻게 바뀌었는지 볼 때
/permissions승인 규칙 설정매번 묻는 게 번거로울 때
/login · /logout로그인 / 로그아웃계정 문제가 생겼을 때
/exit클로드 코드 종료일을 마칠 때

이 밖에 /config(각종 설정), /deep-research(웹을 찾아 출처와 함께 정리), /bug(문제 신고), /feedback(의견 보내기)도 있습니다. 지금 다 보실 필요는 없습니다.

부록 B-3

줄바꿈과 기호 네 개

알아 두면 입력이 훨씬 편해지는 것들입니다

줄바꿈 — 엔터를 누르면 그냥 보내질 때

\ 치고 Enter
모든 터미널에서 됩니다. 이게 제일 확실합니다
Shift + Enter
맥 기본 터미널·iTerm2·Windows Terminal 등에서 바로 됨
Ctrl + J
어떤 터미널에서든 동작
붙여넣기
여러 줄짜리 글은 복사해서 붙여 넣으면 그대로 들어갑니다

이 네 개는 명령어가 아니라 기호입니다

/
명령 목록 열기 — /re 까지만 쳐도 /resume 이 걸립니다
@
파일이나 폴더를 지정 — @견적서.pdf 이 파일 요약해 줘
!
클로드를 거치지 않고 내가 직접 명령 실행. 맨 앞에 붙여 씁니다 (터미널에서 연 클로드 코드에서만)
:
이모지 넣기 — :smile: 처럼 입력

자주 쓰는 조합

@파일명 + 지시문
"이 파일만" 이라고 짚어 주는 가장 확실한 방법입니다 — @견적서.pdf 여기서 금액만 뽑아 줘
캡처 붙여넣기 + 지시문
화면을 캡처해 붙여 넣고 "이 화면에서 뭘 하면 돼?"라고 물으면 설명 열 줄보다 빠릅니다
Shift + Tab → 지시문
큰 작업 전에 계획부터 받아 보는 조합. 사고를 미리 막습니다
일 끝 → /clear
다음 일을 시작하기 전에 한 번. 속도 문제의 대부분이 사라집니다
부록 C

2주 실행표

설치까지 하고 안 쓰는 분이 가장 많습니다. 하루 15분이면 됩니다

안 쓰게 되는 이유는 하나입니다 — "뭐부터 시켜야 할지 모르겠어서." 그래서 2주치를 미리 정해 뒀습니다.

할 일구체적으로
1일내 업무의 값 계산STEP 0-1. 아직 설치 전이어도 됩니다. 쓰시는 AI 앱에 넣어 보세요
2일넘길 하나 정하기STEP 0-2·0-3. 워크시트를 채우고 카드 번호까지 확인합니다
3일설치STEP 1-1~1-5. claude --version 에서 버전 숫자를 봅니다
4일작업대 만들기STEP 1-6. VS Code를 깔고 작업 폴더를 열어 터미널을 켭니다
5일로그인과 첫 지시STEP 2-1. 파일이 하나 만들어지는 걸 봅니다
6일멈추고 되돌리기STEP 2-3. Esc, /rewind, /clear 를 한 번씩 눌러 봅니다
7일고른 그 일 넘기기2일에 정한 카드를 실행합니다. 복사본 폴더에서
8일지시문 3요소로 다시STEP 2-4. 7일에 쓴 지시문에 목표·상황·울타리를 넣어 다시 시켜 봅니다
9일숫자 다루는 카드 하나STEP 3-2에서 하나. 결과를 원본과 눈으로 대조합니다
10일문서 쓰는 카드 하나STEP 3-4에서 하나. 실제로 보내야 할 문서가 있으면 그걸로
11일회사 규칙 적어두기STEP 4-1. 회사 이름·말투·금지 사항을 CLAUDE.md에 적습니다
12일플랜 모드 써 보기STEP 4-3. Shift + Tab 으로 계획을 먼저 보고 시작해 봅니다
13일나만의 명령 만들기STEP 4-2. 세 번쯤 반복한 그 일을 명령 하나로 만듭니다
14일팀에 다섯 줄 공유STEP 5-2의 다섯 줄을 팀 채널에 올립니다
2주 뒤 스스로 체크
  • 터미널을 켜는 게 더 이상 무섭지 않다
  • 오류가 떠도 당황하지 않고 그대로 복사해 물어본다
  • STEP 0에서 고른 그 일이 실제로 줄었다
  • 매주 반복하던 일 하나가 명령 한 줄이 됐다
  • "이것도 시킬 수 있나?"라는 생각이 하루에 한 번은 든다

[ 마치며 ]

열 가지를 배우는 것보다
한 가지를 넘기는 편이 빠릅니다

이 책의 목표는 처음부터 하나였습니다. 손으로 하던 업무 한 가지가 사라지는 것입니다. STEP 0에서 적으신 그 일이 지금 줄어 있다면, 나머지는 같은 방법의 반복입니다.

저희도 2026년 2월에 메일함 정리 하나로 시작했습니다. 지금은 주 35시간을 돌려받고 있습니다. 이 책 다음에 볼 것을 아래에 적어 뒀습니다. 전부 무료입니다.

바이브 코딩 무료 20강

autofrog.kr/lab/lectures

이 책이 "업무를 넘기는 법"이라면, 20강은 "직접 만들어 세상에 내놓는 법"입니다. 7강이 지시문, 9강이 회사 규칙 파일, 19강이 자동화 편입니다.

필드 매뉴얼 서가 — 전자책 전부 무료

autofrog.kr/book

001 『팔리는 바이브 코딩』 · 002 『Hermes 에이전트 설치 매뉴얼』 · 003 이 책.

유튜브 — 실제로 돌아가는 자동화 사례

youtube.com/@autofrogkr

오늘 넘긴 일 하나가, 내년의 하루를 바꿉니다.

《업무 하나 넘기기》 · AUTOFROG PRESS FIELD MANUAL 003 · 2026년 8월 초판
설치 명령어·오류 문구·명령 목록은 클로드 코드 공식 문서(2026년 8월 기준)를 확인해 적었습니다.
요금제와 화면 문구는 변경될 수 있으니 최신 내용은 공식 페이지에서 확인하세요.
본문의 회사명·거래처명·금액은 전부 가상입니다. · 오토프로그 · autofrog.kr