클로드 코드와 코덱스를 설치하고, 막힌 곳을 화면 문구로 찾고, 업무 프롬프트 하나를 실행합니다. 처음 설치할 때 필요한 명령만 직접 붙여 넣고, AI가 켜진 뒤의 점검과 설정은 말로 맡기십시오.
| 처음이라면 | PART 1에서 내 운영체제의 설치부터 진행합니다. 맥은 1장, 윈도우는 2장입니다. 작업 폴더와 로그인은 3장입니다. |
| 코덱스 설치 | 6장에서 설치하고 7장에서 권한을 고릅니다. |
| 이미 설치했다면 | 8장의 업무 예시 12개 중 하나를 시켜 보십시오. 규칙과 명령 저장은 9장, 회사 자료 취급은 10장입니다. |
| 막혔다면 | 맥 오류는 1장, 윈도우 오류는 2장, 공통 증상은 4장, 코덱스 오류는 6장입니다. |
| 말로 하기 | AI 대화창에 붙여 넣습니다. 대괄호 속 입력란은 내 자료로 바꾸고 [확인 필요]는 남깁니다. 첫 설치 명령은 별도 상자에 담았습니다. |
| 세 줄 정리 | 장 끝에서 확인할 내용을 모았습니다. 결과는 답변만 믿지 말고 파일을 열어 보십시오. |
| 원판 기준 | 설치 명령·오류 문구·명령 목록은 2026년 8월 공식 문서를 확인한 원판 기준입니다. 요금과 화면은 바뀔 수 있으므로 공식 페이지에서 다시 확인합니다. |
| 예시 | 회사명·거래처명·금액은 전부 가상입니다. 내 자료에 맞게 바꿔 쓰십시오. |
| 안 다루는 것 | WSL·도커·서버 배포, Git 사용법, MCP 연결, 프로그래밍 문법은 처음 단계에서 뺐습니다. |
| 절 | 주제 | 공부했나요? |
|---|---|---|
| 01.1 | 도구와 계정 | ☐ |
| 01.2 | 맥 설치 네 단계 | ☐ |
| 01.3 | 맥에서 막히는 문구 | ☐ |
채팅 AI의 답을 엑셀에 붙이고 파일 이름을 하나씩 바꾸는 일은 클로드 코드에 맡길 수 있습니다. 말로 시키면 내 폴더를 읽고 실제 파일을 만듭니다. 설치 전에 컴퓨터와 계정부터 확인하십시오.
채팅 AI의 답은 화면에 남습니다. 클로드 코드의 결과는 작업 폴더에 파일로 남습니다. 여러 단계가 필요한 일도 순서대로 이어 갑니다. "정리해 줘"라고 하면 폴더 안의 파일이 실제로 움직이므로, 처음에는 복사본에서 연습하십시오.
아래 요금과 설치 조건은 2026년 8월 원판 기준입니다. 결제 전에는 공식 요금 페이지에서 다시 확인하십시오.
| Pro | 월 $20. 연간 결제 시 월 $17. 원판은 혼자 또는 소규모로 하루 한두 시간 쓸 때 권합니다. |
| Max | 월 $100 · $200. Pro의 5배·20배 사용량 중에서 고릅니다. |
| Team · Enterprise | 회사 단위 계정입니다. Team은 1인당 별도 요금입니다. 무료 플랜에는 클로드 코드가 포함되지 않습니다. |
| 운영체제 | macOS 13.0 이상. Windows 10 1809 버전 이상. |
| 컴퓨터 | 메모리 4GB 이상, 64비트(x64 또는 ARM64). 일반 인터넷 연결이 필요합니다. |
맥은 애플 메뉴 → 이 Mac에 관하여, 윈도우는 설정 → 시스템 → 정보에서 버전을 봅니다. Pro로 한두 주 써 보고 부족할 때 올리십시오.
윈도우를 쓰시면 2장으로 가십시오. 터미널은 컴퓨터를 글자로 조작하는 창입니다. AI가 아직 없으므로 첫 설치만은 명령을 직접 붙여 넣습니다.
1단계. ⌘ + 스페이스를 누르고 "터미널" 또는 "Terminal"을 찾아 Enter를 누르십시오. 커서가 깜빡이는 창이 열립니다.
2단계. 아래 한 줄을 통째로 복사해 ⌘ + V로 붙여 넣고 Enter를 누르십시오. 설치 중에는 창을 닫지 않습니다.
Claude Code successfully installed! 같은 문구가 나오면 3단계로 설치를 확인합니다.
2.1.211 (Claude Code)처럼 버전 숫자가 나오면 성공입니다. 이 숫자는 원판의 출력 예시입니다. 3장으로 가십시오.
zsh: command not found: claude가 나오면 4단계로 갑니다. ⌘ + Q로 터미널을 완전히 종료한 뒤 다시 여십시오. 빨간 점으로 창만 닫는 것과 다릅니다. 같은 오류가 남으면 아래 두 줄을 한 줄씩 실행합니다.
경로 등록 뒤 claude --version으로 다시 확인하십시오.
| bash: claude: command not found | 기본 셸이 bash입니다. 앞의 두 줄에서 ~/.zshrc 대신 ~/.bashrc를 씁니다. echo $SHELL의 끝이 /zsh면 zsh입니다. |
| syntax error near unexpected token '<' | 설치 파일 대신 웹페이지가 내려온 경우입니다. 같은 설치 명령을 다시 실행하고, 계속 실패하면 아래 Homebrew 방법을 씁니다. 웹페이지 코드가 쏟아져도 같습니다. |
| dyld: cannot load / built for Mac OS X 13.0 | 운영체제를 확인하십시오. 13.0보다 낮으면 시스템 설정 → 소프트웨어 업데이트부터 진행합니다. |
| App unavailable in region | 한국은 지원 국가입니다. 이 문구가 뜨면 VPN이 켜져 있는지 확인하십시오. |
| 붙여넣기가 안 됨 | 터미널 창에서 마우스 오른쪽 클릭 → 붙여넣기를 쓰십시오. |
| 비밀번호가 안 보임 | 보안상 글자를 숨깁니다. 보이지 않아도 입력하고 Enter를 누르면 됩니다. |
공식 설치가 계속 실패할 때는 Homebrew로 설치합니다. Homebrew가 없다면 첫 줄부터, 이미 있다면 둘째 줄만 실행하십시오.
Homebrew 설치본은 자동 업데이트가 안 됩니다. AI를 켠 뒤에는 아래처럼 맡기십시오.
02장 윈도우는 창을 다시 여십시오 — Git부터 설치 · 실행과 점검 · 오류 문구로 찾기
| 절 | 주제 | 공부했나요? |
|---|---|---|
| 02.1 | 설치 네 단계 | ☐ |
| 02.2 | 실행하고 확인하기 | ☐ |
| 02.3 | 윈도우 오류 찾기 | ☐ |
윈도우는 winget이라는 설치 도구를 씁니다. Git을 먼저 깔고 클로드 코드를 설치한 뒤 창을 완전히 닫았다 다시 엽니다. 이미 열린 창은 옛 경로 목록을 들고 있으므로, 설치 직후 같은 창에서 실행하면 프로그램을 못 찾기도 합니다.
맥을 쓰시면 3장으로 가십시오. 명령은 한 줄씩 붙여 넣고 매번 Enter를 누릅니다.
1단계. 시작 메뉴에서 Windows PowerShell을 여십시오. 관리자 권한은 필요 없습니다. 줄 앞에 PS C:\Users\내이름>처럼 PS가 붙어야 합니다. PS가 없는 CMD와 구분하십시오.
Windows PowerShell (x86)은 고르지 않습니다. 32비트로 실행되어 64비트 PC에서도 Claude Code does not support 32-bit Windows 오류가 납니다. 이 책은 윈도우 10·11의 64비트 환경을 기준으로 합니다.
2단계. 클로드 코드가 명령을 실행할 때 쓰는 Git Bash를 설치합니다. Git 사용법은 지금 배우지 않아도 됩니다.
Successfully installed 또는 already installed가 나오면 3단계로 클로드 코드를 설치합니다.
Successfully installed가 나오면 성공입니다. 저장소 약관 동의를 물으면 Y를 누르고 Enter를 누르십시오.
4단계. PowerShell 창을 X로 완전히 닫고 새로 여십시오. VS Code를 쓰고 있다면 터미널만 닫지 말고 VS Code 창 전체를 종료했다가 다시 켭니다.
5단계. 새로 연 PowerShell 창에서 실행합니다. 화면이 뜨고 브라우저가 열리면 로그인은 3장에서 이어집니다.
6단계. 원판의 연습 환경에서는 5단계의 claude 대신 아래 명령으로 켭니다. 파일 수정과 프로그램 설치 때의 질문이 생략됩니다. 남의 코드나 회사 자료가 든 폴더에서는 claude로 켜십시오. 모드의 차이는 4장에서 설명합니다.
7단계. 설치 위치 점검은 문제가 있을 때만 합니다. where.exe claude에 …\Microsoft\WinGet\Links\claude.exe 한 줄이 나오면 정상입니다. 여러 줄이면 옛 설치본과 겹쳤을 수 있습니다.
회사 노트북에서 백신이나 보안 프로그램이 막으면 정보보안 담당자에게 요청하십시오. 원판의 요청 문구는 다음과 같습니다. "Anthropic의 Claude Code CLI를 설치하려 합니다. claude.exe와 이 프로그램이 실행하는 cmd.exe, bash.exe를 예외 처리해 주세요."
| 'claude' is not recognized | 창을 완전히 닫았다 다시 여십시오. VS Code도 창 전체를 다시 엽니다. 계속되면 아래 경로를 등록합니다. |
| WindowsApps\Claude.exe가 먼저 나옴 | 데스크톱 앱의 실행 별칭이 CLI보다 먼저 잡혔습니다. 앱을 업데이트한 뒤 설정 → 앱 → 고급 앱 설정 → 앱 실행 별칭에서 Claude 항목을 끄고 창을 다시 여십시오. |
| where.exe claude에 여러 줄 | 옛 .local\bin\claude.exe 또는 npm 설치본과 겹친 경우입니다. %USERPROFILE%\.claude 폴더는 설정과 로그인 정보가 있으므로 지우지 않습니다. |
| 'winget' is not recognized | PowerShell인지 먼저 보십시오. Microsoft Store에서 앱 설치 관리자(App Installer)를 업데이트하거나 윈도우 업데이트 후 다시 시도합니다. |
| No package found matching input criteria | Anthropic.ClaudeCode 대소문자와 --source winget까지 한 줄 전체를 확인하십시오. |
| 32-bit Windows 오류 | (x86)이 안 붙은 PowerShell로 설치하십시오. |
| The process cannot access the file | 다른 PowerShell 창과 VS Code를 닫고 3단계 설치 명령을 다시 실행합니다. 이전 설치나 백신 검사 중일 수 있습니다. |
| Git을 못 찾는다는 경고 | 2단계를 확인하고, Git을 깔았는데도 나오면 아래 경로를 등록합니다. |
AI를 이미 켤 수 있다면 다음 문장을 맡기십시오. 못 켜는 상태에서는 아래에 적힌 해당 명령만 PowerShell에 직접 붙여 넣고 창을 다시 엽니다.
겹친 설치본은 옛것만 정리합니다. 원판의 npm 제거 명령은 npm uninstall -g @anthropic-ai/claude-code입니다. WSL은 처음 단계에 필요 없습니다. 위의 일반 설치로 이 책의 작업을 진행합니다.
03장 작업대를 만들고 첫 파일을 받습니다 — VS Code · 설치 점검 · 로그인과 첫 지시
| 절 | 주제 | 공부했나요? |
|---|---|---|
| 03.1 | 폴더와 터미널 | ☐ |
| 03.2 | 점검은 삭제보다 먼저 | ☐ |
| 03.3 | 로그인과 첫 지시 | ☐ |
클로드 코드는 지금 열어 둔 폴더를 기준으로 일합니다. VS Code는 그 폴더와 결과물을 한 화면에서 보는 작업대입니다. 폴더를 먼저 열고 그 안에서 클로드 코드를 켜면, 이동 명령을 외우지 않아도 됩니다.
VS Code는 무료입니다. 한 화면에서 파일 목록과 결과물을 보고, 열린 폴더에서 터미널을 시작할 수 있습니다.
| 맥 설치 | code.visualstudio.com의 다운로드 버튼을 누릅니다. 압축이 풀리면 아이콘을 응용 프로그램 폴더로 옮기십시오. |
| 윈도우 설치 | 같은 사이트에서 Download for Windows. 추가 작업에서 "Code을(를) 사용하여 파일/디렉터리 열기"와 PATH에 추가를 체크합니다. |
| 작업 폴더 | 파일 → 폴더 열기로 선택하고 "이 폴더의 작성자를 신뢰합니까?"에 예를 고릅니다. |
| 터미널 열기 | 상단 메뉴 터미널 → 새 터미널. 단축키는 Ctrl + 숫자 1 왼쪽의 키입니다. 맥의 한글 입력 상태에서는 ₩가 들어가므로 한/영을 바꾸거나 메뉴를 씁니다. |
| 숨기기와 종료 | Ctrl + J 또는 오른쪽 위 ∨는 숨기기입니다. 휴지통 아이콘이나 exit는 종료입니다. |
바탕화면이나 문서 폴더에 영문·숫자로 이름을 짧게 지은 연습 폴더를 만드십시오. 처음에는 구글드라이브·아이클라우드·원드라이브 동기화 폴더를 피합니다. 동기화 중 파일이 잠겨 오류가 나기도 합니다.
글자가 네모로 깨지거나 화면이 번지면 클로드 코드 안에서 /terminal-setup을 실행합니다. Shift + Enter로 줄을 바꿀 때도 이 명령을 씁니다.
공식 설치본은 자동으로 업데이트됩니다. 설치가 이상하면 claude doctor로 점검합니다. 실행 중에는 /doctor도 같습니다.
| Version | 버전 숫자가 있는지 봅니다. |
| Install · Search | OK 계열 문구인지 봅니다. Search 오류의 해결은 4장에 있습니다. |
| Warning | 경고 아래의 해결 제안을 읽습니다. |
| 순서 | 터미널 다시 열기, 점검, 재설치 순입니다. 삭제는 마지막 수단입니다. |
완전 삭제는 마지막 수단입니다. 아래 원판의 명령을 실행하기 전에 대상을 확인하십시오.
작업 폴더 안의 터미널에서 claude를 입력합니다. 처음에는 화면 색 테마를 고른 뒤 로그인합니다. Enter를 누르면 브라우저가 열립니다. 클로드 계정으로 로그인하고 Authorize를 누른 뒤 터미널로 돌아오십시오.
브라우저가 안 열리면 터미널의 https://... 주소를 직접 엽니다. 무료 플랜 때문에 막히면 Pro 이상 구독이 필요합니다. 로그인이 반복되면 /logout 후 /login을 씁니다. 계속되면 브라우저에서 claude.ai에 먼저 로그인합니다.
작업 폴더를 바꾸려면 /cd 뒤에 경로를 적고, 다른 폴더도 읽게 하려면 /add-dir를 씁니다. 폴더를 터미널로 끌어 놓으면 경로가 입력됩니다. 위치를 확인한 뒤 첫 파일을 받아 보십시오.
왼쪽 파일 목록에서 현황.md를 열어 보십시오. 파일이 만들어졌는지 확인해야 첫 지시가 끝납니다.
04장 승인하고 멈추고 오류를 읽습니다 — 권한의 범위 · 되돌리기 · 화면 문구 그대로 전달하기
| 절 | 주제 | 공부했나요? |
|---|---|---|
| 04.1 | 승인 화면과 모드 | ☐ |
| 04.2 | 멈추기와 되돌리기 | ☐ |
| 04.3 | 화면 문구로 찾기 | ☐ |
| 04.4 | 영어 오류 읽는 요령 | ☐ |
AI에게 일을 맡기려면 멈추는 법도 알아야 합니다. 승인 화면에서 무엇을 바꾸려는지 확인하고, 오류 화면에서 어디서 막혔는지 살피십시오. 두 화면 모두 읽고 진행해야 합니다.
선택지는 방향키로 옮기고 Enter로 확정합니다. 터미널에서는 마우스 클릭 대신 화살표를 씁니다.
| Yes | 이번 한 번만 허락합니다. 처음에는 이것부터 씁니다. |
| Yes, and don't ask again | 같은 종류의 작업은 다음부터 묻지 않습니다. |
| No, tell Claude what to do differently | 거절하고 다른 방법을 말합니다. |
| Manual | 파일을 바꾸기 전에 매번 묻는 기본 모드입니다. |
| Plan | 실행하지 않고 계획부터 보여 줍니다. |
| Accept edits | 파일 수정을 묻지 않습니다. 되돌릴 수 있는 작업에 씁니다. |
입력창에서 Shift + Tab을 누르면 모드가 순서대로 바뀝니다. 파일을 많이 다루는 일은 Plan으로 계획을 읽고 진행하십시오. claude --dangerously-skip-permissions는 승인 질문을 생략하는 원판의 연습용 실행입니다. 회사 자료나 남의 코드에서는 기본 모드로 돌아옵니다.
| Esc 한 번 | 진행 중인 일을 멈춥니다. 이미 한 작업은 남습니다. |
| Esc 두 번 | 입력을 지웁니다. 빈 입력창에서는 되돌리기 메뉴를 엽니다. |
| /rewind | 이전 시점으로 돌아갈 메뉴를 엽니다. 대화만 또는 파일까지 고릅니다. |
| /exit · Ctrl + D | 종료합니다. Ctrl + D는 빈 입력창에서 두 번 누릅니다. |
| Ctrl + C | 반응이 없을 때 강제로 중단합니다. 계속되면 터미널을 다시 엽니다. |
| Ctrl + L | 겹쳐 보이는 화면을 다시 그립니다. |
| /resume | 같은 폴더에서 claude를 다시 켠 뒤 이전 대화를 골라 잇습니다. |
대화만 되돌리면 파일은 남습니다. 파일까지 선택하면 그 시점의 파일 상태로 돌아갑니다. 되돌리기는 클로드 코드가 한 작업에 해당합니다. 중요한 폴더의 복사본을 만드는 일을 대신하지는 않습니다.
오류는 통째로 복사해 묻는 것이 먼저입니다. 대화가 엉켰으면 /clear 후 다시 시키고, 계속 안 되면 터미널을 다시 엽니다. 그 뒤에 재설치를 검토하십시오.
| 어제는 됐는데 오늘 안 됨 | claude doctor로 점검합니다. |
| 답이 느려짐 | 이어 할 일은 /compact, 다른 일은 /clear입니다. |
| 엉뚱한 파일을 봄 | 작업 폴더를 확인하고 /cd 또는 VS Code에서 다시 엽니다. |
| 파일을 못 찾음 | @파일명으로 짚습니다. 다른 폴더면 /add-dir를 씁니다. |
| 글자가 네모로 깨짐 | /terminal-setup 후 편집기를 다시 시작합니다. |
| 반응 없이 멈춤 | Ctrl + C, 터미널 다시 열기, claude → /resume 순입니다. |
| 컴퓨터가 느려지고 팬이 돎 | 큰 폴더를 읽는지 봅니다. Esc로 멈추고 범위를 좁힙니다. |
| 한도 안내 | /usage로 남은 양과 초기화 시각을 봅니다. |
검색 도구 오류는 claude doctor의 Search 항목에서 봅니다. AI를 켤 수 있다면 아래처럼 설치를 맡깁니다.
맨 첫 줄과 마지막 줄을 먼저 보십시오. not found, cannot, failed 근처의 이름을 찾고, C:\... 또는 /Users/... 경로를 봅니다. 해석은 오류 전체를 붙여 넣고 AI에게 맡겨도 됩니다.
사람에게 도움을 받을 때도 운영체제와 버전, 진행한 단계, 입력한 명령, 오류 문구 전체, 이미 시도한 일을 함께 전달하십시오. 캡처는 맥 ⌘ + Shift + 4, 윈도우는 윈도우 키 + Shift + S입니다.
05장 외우지 않고 찾아 씁니다 — 먼저 익힐 여섯 가지 · 명령 사전 · 입력 요령
| 절 | 주제 | 공부했나요? |
|---|---|---|
| 05.1 | 여섯 가지와 단축키 | ☐ |
| 05.2 | 명령 사전 | ☐ |
| 05.3 | 줄바꿈과 기호 | ☐ |
단축키와 명령은 한꺼번에 외울 필요는 없습니다. 멈추기, 계획 보기, 파일 짚기, 새 대화 시작하기만 먼저 익히십시오. 나머지는 필요한 순간에 이 장에서 찾으면 됩니다.
| Esc | 작업을 멈춥니다. |
| Shift + Tab | 권한 모드를 바꿉니다. 큰 작업은 Plan부터 봅니다. |
| / | 명령 목록을 엽니다. |
| @ | 다룰 파일을 직접 지정합니다. |
| /clear | 다른 일을 시작할 때 대화를 비웁니다. |
| /rewind | 이전 시점으로 되돌립니다. |
| 키 | 하는 일 |
|---|---|
| Ctrl + O | 자세히 보기 켜기·끄기 |
| Ctrl + R | 이전 입력 검색 |
| Ctrl + B | 오래 걸리는 작업을 뒤로 보내기 |
| Ctrl + T | 할 일 목록 보기·숨기기 |
| Ctrl + S | 쓰던 글 잠시 치워 두기 |
| Ctrl + G | 긴 글을 외부 편집기로 열기 |
| ↑ / ↓ | 커서 이동, 이전 입력 불러오기 |
| ? | 빈 입력창에서 단축키 도움말 |
| Ctrl+V / Alt+V | 캡처 붙여넣기. 윈도우는 Alt |
| Ctrl + A / E | 줄 맨 앞 / 맨 뒤로 |
| Ctrl + W | 앞 단어 지우기 |
| Ctrl + U / K | 커서 앞쪽 / 뒤쪽 지우기 |
| Ctrl + Y | 방금 지운 글 되살리기 |
Ctrl + C는 강제 중단이며 한 번 더 누르면 종료합니다. Esc, Ctrl + D, Ctrl + L의 사용은 4장에 있습니다.
입력창에서 /를 치고 글자 몇 개로 거릅니다. /re로 /resume을 찾는 식입니다.
| 명령 | 하는 일 |
|---|---|
| /help | 도움말과 명령 목록 |
| /clear · /compact · /context | 새 대화 / 요약 / 대화가 얼마나 찼는지 확인 |
| /resume · /rewind | 이전 대화 잇기 / 이전 시점으로 |
| /init · /memory | 폴더 안내 파일 만들기 / 규칙 편집 |
| /model · /usage | 모델 변경 / 사용량과 한도 확인 |
| /doctor · /terminal-setup | 설치 점검 / 터미널 표시 수정 |
| /copy · /export | 마지막 답변 복사 / 전체 대화를 파일로 |
| /add-dir · /cd | 다른 폴더 추가 / 작업 폴더 이동 |
| /diff · /permissions | 바뀐 내용 비교 / 승인 규칙 설정 |
| /login · /logout · /exit | 로그인 / 로그아웃 / 종료 |
| /config | 각종 설정 |
| /deep-research | 웹 검색과 출처 정리 |
| /bug · /feedback | 문제 신고 / 의견 보내기 |
여러 줄 지시문은 복사해 붙여 넣으면 그대로 들어갑니다. 직접 쓸 때는 역슬래시 \를 입력하고 Enter를 누르거나 Ctrl + J로 줄을 바꿉니다. 원판은 맥 기본 터미널·iTerm2·Windows Terminal에서 Shift + Enter도 안내합니다.
| / | 명령 목록을 엽니다. |
| @ | 파일이나 폴더를 짚습니다. @견적서.pdf 여기서 금액만 뽑아 줘처럼 씁니다. |
| ! | 클로드를 거치지 않고 명령을 직접 실행합니다. 터미널에서 연 클로드 코드의 입력 맨 앞에 붙입니다. |
| : | :smile:처럼 이모지를 넣습니다. |
파일을 짚고 지시하거나, 화면 캡처를 붙여 넣고 "이 화면에서 뭘 하면 돼?"라고 물어보십시오. 큰 작업은 Shift + Tab으로 계획부터, 일이 끝나면 /clear로 다음 대화를 시작합니다.
06장 코덱스를 깔고 로그인합니다 — 운영체제별 한 줄 설치 · ChatGPT 계정 · 첫 지시
| 절 | 주제 | 공부했나요? |
|---|---|---|
| 06.1 | 계정과 설치 | ☐ |
| 06.2 | 브라우저 로그인과 첫 지시 | ☐ |
| 06.3 | 코덱스에서 막히는 문구 | ☐ |
코덱스는 OpenAI가 만든 도구입니다. 터미널에서 말로 시키면 클로드 코드처럼 파일을 읽고 고칩니다. 클로드 코드는 클로드 모델, 코덱스는 GPT 모델을 씁니다. 구독 중인 쪽부터 쓰고, 둘 다 구독 중이면 한도가 찼을 때 번갈아 쓰십시오.
원판 기준으로 클로드 코드는 Claude Pro/Max, 코덱스는 ChatGPT Plus/Pro 구독에 포함됩니다. ChatGPT를 결제해 쓰고 있다면 추가 비용 없이 코덱스를 켭니다. 한 컴퓨터에 두 도구를 설치해도 각 도구의 설정 폴더는 따로 씁니다.
1단계. 맥은 ⌘ + 스페이스 → 터미널, 윈도우는 Windows PowerShell을 엽니다. CMD와 (x86)은 고르지 않습니다.
2단계. 내 운영체제의 한 줄만 붙여 넣습니다. 원판의 공식 설치는 Node.js와 npm이 필요 없습니다.
맥:
윈도우:
윈도우는 앞의 powershell -ExecutionPolicy ByPass -c까지 전부 넣습니다. 빼면 "이 시스템에서 스크립트를 실행할 수 없으므로" 오류가 납니다. 글자가 올라간 뒤 커서가 다시 깜빡이면 설치가 끝납니다.
3단계. 맥은 ⌘ + Q로 터미널을 종료한 뒤 다시 열고, 윈도우는 PowerShell 창을 닫고 새로 엽니다.
4단계. 원판의 연습용 실행 명령입니다. 승인 질문과 폴더 울타리를 모두 해제합니다. 회사 자료에서는 기본 명령 codex로 켜십시오.
맥에서 "손상되어 열 수 없습니다"가 나오면 원판은 xattr -d com.apple.quarantine $(which codex)로 격리 표시를 해제한 뒤 다시 켜도록 안내합니다. AI가 이미 있다면 이 명령의 실행을 맡기십시오.
처음 실행하면 방향키로 Sign in with ChatGPT를 고르고 Enter를 누릅니다. 브라우저에서 평소 쓰는 ChatGPT 계정으로 로그인하고 승인하십시오. 창이 열리지 않으면 터미널의 주소를 직접 엽니다.
로그인 확인 명령은 codex login status입니다. Logged in using ChatGPT가 나오면 끝났습니다. 작업 폴더에서 아래 문장을 시켜 보십시오.
지시문의 목표·상황·울타리와 회사 자료 취급 규칙은 두 도구에 모두 적용됩니다. 비밀번호 파일과 고객 개인정보 폴더는 열어 주지 마십시오.
| command not found: codex | 창 전체를 다시 여십시오. 맥은 ⌘ + Q입니다. 계속되면 1장의 경로 등록 두 줄을 실행합니다. |
| command not found: npm | Node.js가 없다면 nodejs.org에서 LTS로 설치하고 터미널을 다시 엽니다. 원판의 공식 설치는 npm 없이도 됩니다. |
| ENOTFOUND · 인터넷 오류 | workspace-write의 인터넷 제한을 확인합니다. 검색은 --search, 인터넷 허용 설정은 7장에 있습니다. |
| 파일을 못 만듦 | read-only이면 읽기만 됩니다. codex -s workspace-write로 다시 켭니다. |
| 답이 이상하거나 느림 | 원판의 codex update 또는 설치 명령 재실행으로 업데이트합니다. codex doctor로 상태를 봅니다. |
| 한도 소진 | 구독 사용량은 몇 시간 단위로 채워집니다. 그동안 클로드 코드로 이어 합니다. |
| 윈도우 버전 | 윈도우 11을 권하고, 윈도우 10은 1809 이상입니다. winget이 없으면 윈도우 업데이트부터 합니다. |
| 샌드박스 설정 실패 | 첫 실행의 관리자 승인(UAC)을 취소하면 unelevated로 내려갑니다. 다시 켜서 승인하거나 회사 IT에 문의합니다. 계속되면 unelevated로 씁니다. |
| 윈도우 폴더 읽기 | /sandbox-add-read-dir C:\경로로 읽기를 허용합니다. |
| 맥 Homebrew 설치 | brew install --cask codex입니다. formula가 아니라 cask입니다. |
이 장의 명령과 화면 문구도 2026년 8월 원판 기준입니다. 영어 오류는 4장처럼 첫 줄, 마지막 줄, 파일 경로를 보고 전체를 전달하십시오.
07장 코덱스의 울타리를 고릅니다 — 읽기와 쓰기 · 승인과 인터넷 · 두 도구를 함께 쓰기
| 절 | 주제 | 공부했나요? |
|---|---|---|
| 07.1 | 읽기와 쓰기의 범위 | ☐ |
| 07.2 | 승인 질문과 인터넷 | ☐ |
| 07.3 | 두 도구를 함께 쓰기 | ☐ |
코덱스는 켤 때 권한 범위를 정합니다. 읽기만 할지, 현재 폴더를 고칠지, 제한을 모두 풀지 고릅니다. 승인 질문과 폴더 울타리(샌드박스)는 각각 설정합니다.
| read-only | 읽고 답합니다. 파일은 고치지 않습니다. |
| workspace-write | 현재 작업 폴더 안에서 파일을 만들고 고칩니다. |
| danger-full-access | 폴더 울타리를 없앱니다. 프로젝트 밖에도 영향을 줍니다. |
처음 켜는 명령은 목적에 맞게 하나를 고릅니다.
원판 기준으로 workspace-write에서는 인터넷 접속이 제한됩니다. 새 프로그램을 받아 설치하는 일은 막힐 수 있습니다. 웹 검색의 --search와 인터넷 접속 권한은 아래에서 구분합니다.
멈추기는 Esc, 이전 대화 잇기는 codex resume입니다. workspace-write에서도 .git, .agents, .codex는 읽기 전용입니다. 원판의 --full-auto는 경고가 뜨므로 -s workspace-write로 바꾸도록 안내합니다.
원판의 기본값은 workspace-write와 on-request(Auto)입니다. 폴더 안은 진행하고, 폴더 밖이나 인터넷은 그때 묻습니다.
| -a never | 승인 질문만 끕니다. 폴더 울타리는 남습니다. |
| network_access | 폴더 제한을 유지하고 인터넷을 허용합니다. |
| --yolo | 승인과 샌드박스를 모두 해제합니다. |
아래는 켤 때 쓰는 원판의 명령입니다. 코덱스나 클로드 코드를 이미 켤 수 있다면 설정 방법을 AI에게 맡기십시오.
전부 허용하는 두 명령은 같은 뜻입니다.
매번 같은 설정으로 켜려면 ~/.codex/config.toml을 씁니다. 원판은 전체 허용을 approval_policy = "never", sandbox_mode = "danger-full-access" 두 줄로 안내합니다. 인터넷만 열려면 [sandbox_workspace_write] 아래 network_access = true를 적습니다.
웹 검색은 기본적으로 미리 모아 둔 결과를 씁니다. 원판에서 실시간 검색은 codex --search, 설정은 web_search = "live"이며 --yolo는 처음부터 live입니다. 전체 허용 모드에서는 프로젝트 밖 파일도 지울 수 있습니다. 원판의 공식 문서 안내처럼 이미 격리된 환경에서만 씁니다.
구독 중인 한쪽을 주력으로 쓰십시오. 한도가 차면 다른 쪽으로 넘어가 같은 지시문을 전달합니다. 중요한 결과는 다른 도구에도 다시 시켜 비교하십시오. 서로 다른 회사의 AI이므로 놓치는 부분이 다를 수 있습니다.
| 설치 확인 | codex --version에서 버전이 나옵니다. |
| 로그인 확인 | codex login status가 로그인됨으로 나옵니다. |
| 권한 확인 | 읽기만 하는 모드와 현재 폴더를 고치는 모드를 구분합니다. |
| 첫 작업 | 내 업무 하나를 코덱스에도 시켜 봅니다. |
이제 첫 작업을 맡길 차례입니다. 8장의 예시 중 오늘 일과 가까운 하나를 골라 시켜 보십시오.
08장 오늘 하나를 시켜 보십시오 — 목표·상황·울타리 · 업무 예시 열두 가지 · 결과 수정
| 절 | 주제 | 공부했나요? |
|---|---|---|
| 08.1 | 지시문의 세 재료 | ☐ |
| 08.2 | 파일과 폴더 정리 | ☐ |
| 08.3 | 서류에서 뽑아내기 | ☐ |
| 08.4 | 목록 대조와 일정 | ☐ |
| 08.5 | 문서 초안 만들기 | ☐ |
지시문은 업무를 넘기는 메모입니다. 무엇을 만들지, 어디에 쓸지, 건드리지 말아야 할 것을 적습니다. 아래 업무 예시는 두 도구에 모두 쓸 수 있습니다. 처음에는 폴더 복사본에서 한 가지 작업만 맡기십시오.
| 목표 | 무엇을 어떤 수준으로 만들지 적습니다. |
| 상황 | 내가 하는 일과 결과의 용도를 알려 줍니다. |
| 울타리 | 하지 말아야 할 일과 범위를 정합니다. |
울타리에는 "지우지 말고 옮기기만 해", "실행하기 전에 계획을 먼저 보여 줘", "확인되지 않은 숫자는 [확인 필요]라고 표시해 줘", "다른 파일은 건드리지 마"를 필요에 맞게 붙입니다.
결과를 고칠 때는 위치와 이유를 말하십시오. "다시 해 줘"보다 "3번 항목은 기업 대상인 우리 상황과 안 맞으니 빼 줘"가 구체적입니다. "길이는 절반으로 줄이고 숫자를 두 개만 넣어 줘"처럼 범위를 정해도 됩니다. 오류는 원문 전체를 붙여 넣습니다.
첫날에는 바탕화면 전체에서 시작하거나 기준 없이 "정리해 줘"만 말하기 쉽습니다. 승인 화면을 읽지 않고, 한 대화에서 다른 일을 잇거나 오류를 요약해서 전달하는 것도 원판의 실수 예시입니다. 연습 폴더에서 목표·상황·울타리를 적고 승인을 확인하십시오. 일이 바뀌면 /clear를 쓰고 오류는 전체를 전달합니다.
01 거래처별 견적서 정리. 매주 쓰는 예시입니다. 견적서가 뒤섞인 폴더를 준비합니다. 처음에는 복사본을 쓰고 옮길 곳부터 표로 받으십시오.
거래처 이름을 파일명에서 못 읽으면 "파일을 열어서 안에 적힌 거래처명을 읽고 판단해 줘"를 덧붙입니다.
02 파일 이름 규칙 적용. 이름이 제각각인 파일을 수시로 정리합니다.
파일 생성일과 서류 발행일이 다르면 "파일 안에 적힌 발행일 기준으로"를 덧붙입니다.
03 오래된 파일 골라내기. 몇 년치가 쌓인 폴더에서 분기마다 보관할 것을 찾습니다.
지금도 쓰는 서식이 있다면 "파일 이름에 '양식'·'템플릿'이 들어간 것은 제외해 줘"를 덧붙입니다.
뽑은 숫자는 원본 두세 장과 대조하십시오. [확인 필요] 표시도 남깁니다.
04 현장 사진 이름 붙이기. 번호만 붙은 사진 수십~수백 장을 수시로 정리합니다.
사진이 많으면 "먼저 10장만 해 보고 결과를 보여 줘"로 이름 규칙부터 확인합니다.
05 서류에서 비교표 만들기. 거래명세서·계산서 PDF를 매주 모아 비교합니다.
스캔 PDF를 못 읽으면 "글자 인식이 안 되는 파일은 목록으로만 알려 줘"를 붙이고 해당 파일을 따로 처리합니다.
06 매출 요약 리포트. 매월 매출 엑셀에서 다른 이름으로 저장 → CSV(쉼표로 분리)를 고릅니다. 원본 엑셀은 남겨 둡니다.
07 두 목록에서 빠진 것 찾기. 매주 비교할 목록 파일 두 개를 준비합니다. 이름이 조금 다른 항목을 같은 것으로 볼지는 사람이 정합니다.
자재목록과 발주목록, 입금내역과 청구내역, 출고와 재고에 씁니다.
08 주문서에서 납기 일정표. 주문서와 발주서로 매주 날짜순 일정을 만듭니다.
"8/15", "8월 15일"처럼 표기가 다르면 "전부 YYYY-MM-DD로 통일해 줘"를 덧붙입니다.
09 월말 마감 체크리스트. 매달 하는 일을 적은 메모에서 시작합니다.
월말 보고를 /월말마감 명령으로 만드는 예시는 9장에 있습니다.
고객에게 나가는 문서는 발송 전에 사람이 읽습니다. "없는 내용을 지어내지 마"를 남겨 두십시오.
10 회의 메모를 회의록으로. 매주 메모 파일을 정리합니다. 글로 옮긴 녹취록이 있으면 같은 폴더에 넣고 함께 읽게 합니다.
11 안내문 세 가지 버전. 알릴 내용 한 문단을 준비하고 수시로 씁니다.
"2번이 너무 딱딱해. 좀 더 편한 말투로"처럼 대상과 이유를 짚어 고칩니다.
12 자주 오는 문의 답변 모음. 지난 문의 메일·메시지를 모아 한 번 만들고 계속 씁니다.
답변 모음을 다음 문의에 복사해 쓰거나, 9장처럼 명령으로 저장합니다.
09장 잘된 지시문을 남깁니다 — 회사 규칙 파일 · 나만의 명령 · 계획과 대화 정리
| 절 | 주제 | 공부했나요? |
|---|---|---|
| 09.1 | 회사 규칙 파일 | ☐ |
| 09.2 | 나만의 명령 | ☐ |
| 09.3 | 계획과 대화 정리 | ☐ |
같은 설명을 매번 하고 있다면 파일로 남기십시오. 회사 규칙은 시작할 때 읽는 안내문에, 반복 작업은 다시 부를 명령에 적습니다. 잘된 지시문을 두세 번 써 본 뒤 저장하십시오.
작업 폴더의 CLAUDE.md는 클로드 코드가 일을 시작할 때 읽는 안내문입니다. 회사 이름, 말투, 금지 사항과 문서 형식을 적습니다.
"○○상사 귀중" 같은 거래처 호칭, 쓰지 않는 과장어, 견적서·회의록 항목 순서도 넣습니다. 계약·인사 폴더처럼 읽지도 쓰지도 않을 범위도 적으십시오.
/init은 안내 파일의 뼈대를 만들고 /memory는 규칙을 편집합니다. 비밀번호·계좌번호·주민번호는 넣지 않습니다. 매번 읽는 안내문은 금고가 아닙니다.
잘된 지시문은 파일로 저장해 슬래시 명령으로 부릅니다. 아래는 원판의 월말마감 예시입니다.
다음부터 /월말마감으로 부릅니다. 주간 보고, 분기 정리처럼 주기가 있는 일이나 회의록·비교표처럼 형식이 정해진 일을 남기십시오.
명령으로 만들기 전에는 8장의 지시문을 두세 번 써 보십시오. 지시문모음.md에 잘된 문장만 모아 두고 다음에 조건을 바꿔 복사해도 됩니다.
파일을 많이 바꾸는 작업은 Shift + Tab으로 Plan 모드를 고릅니다. 실행 전에 계획을 읽고 고칠 부분을 말하십시오.
대화가 길어지면 클로드 코드는 앞의 대화 전체를 다시 읽습니다. 일이 끝났는데 다른 일을 계속 붙이면 느려지고 앞 지시와 섞입니다.
| /context | 대화가 얼마나 찼는지 봅니다. |
| /compact | 요약하고 하던 일을 이어 갑니다. |
| /clear | 다른 일을 시작할 때 비웁니다. |
| /rewind | 빈 입력창의 Esc 두 번과 같습니다. 대화만 또는 파일까지 되돌립니다. |
10장 회사 자료는 확인하고 씁니다 — 원본과 개인정보 · 숫자와 발송 전 확인
| 절 | 주제 | 공부했나요? |
|---|---|---|
| 10.1 | 원본과 개인정보 | ☐ |
| 10.2 | 숫자와 결과 확인 | ☐ |
도구를 설치한 뒤에도 마지막 판단은 남습니다. 원본이 움직여도 되는지, 개인정보를 읽어도 되는지, 문서의 숫자가 맞는지는 내가 확인합니다. 원판의 다섯 가지 규칙으로 오늘 작업을 마무리하십시오.
| 1. 승인 모드 | 파일을 지우거나 크게 바꾸는 일은 기본 승인 모드로 둡니다. 익숙해지기 전에는 자동 승인을 켜지 않습니다. |
| 2. 삭제 대신 이동 | "필요 없는 거 지워 줘" 대신 "지우지 말고 옮기기만 해"를 붙입니다. |
| 3. 복사본 | 처음 다루는 중요한 폴더는 복사본에서 연습합니다. |
| 4. 개인정보 | 주민번호·계좌·고객 연락처 파일은 작업 폴더에서 빼거나 읽을 범위를 정합니다. |
코덱스에도 같은 규칙을 적용합니다. 두 도구가 설치돼 있어도 넘겨 주는 자료의 범위를 넓힐 필요는 없습니다.
다섯째, 확인되지 않은 숫자와 사실은 채워 넣지 않습니다.
나온 표는 원본 서류와 대조하고 합계는 검산합니다. 고객에게 보낼 문서는 마지막으로 읽습니다. 이 책의 회사명·거래처명·금액은 전부 가상 예시이며, 실제 업무에서는 내 자료로 바꿉니다.
로그인 후 첫 파일을 받고, Yes로 승인하고 Esc로 멈춘 뒤 /exit로 종료해 봤다면 시작할 준비가 됐습니다. 오늘 가까운 업무 하나를 골라 울타리 한 줄을 붙이고 시켜 보십시오.
여기까지가 이 책의 본문입니다. 열 장을 다 기억하지 않아도 됩니다. 막히는 순간에 차례를 펴고 그 장 하나만 다시 읽으십시오.
두 도구를 깔고 첫 파일을 받아 봤다면, 8장에서 오늘 일과 가까운 예시 하나를 고르십시오. 내 자료로 바꾸고 울타리 한 줄을 붙입니다. 결과를 확인하면 그 지시문을 다음에 다시 씁니다.
| 무료 20강 | autofrog.kr/lab/lectures 직접 만들어 세상에 내놓는 과정입니다. 7강은 지시문, 9강은 회사 규칙 파일, 19강은 자동화입니다. |
| 필드 매뉴얼 서가 | autofrog.kr/book 002 『Hermes 에이전트 설치 매뉴얼』과 003 이 책은 무료입니다. 001 『팔리는 바이브 코딩』은 교육 수강생 전용입니다. |
| 자동화 사례 | youtube.com/@autofrogkr |
| 원판 | 2026년 8월 · 3판(세 파트 구성) |
| 펴낸 곳 | 오토프로그 · autofrog.kr |
| 배포 범위 | 무료 공개 · 로그인 없이 열람 |
| 사실 확인 | 설치 명령·오류 문구·명령 목록은 클로드 코드와 코덱스 공식 문서(2026년 8월 기준)를 확인한 원판을 보존했습니다. 원판의 코덱스 부분은 실제 설치 환경에서 명령과 출력을 대조했습니다. |
| 예시와 표지 | 회사명·거래처명·금액은 모두 가상입니다. 표지는 현재 서가의 표지를 그대로 사용합니다. |
| 편집 | 3파트·10장으로 다시 묶었습니다. 요금과 화면 문구는 최신 공식 페이지에서 확인하십시오. |