📚 클로드 코드 정석 — 비개발자를 위한 공부자료

먼저 읽기

PART A · 영상에 나오는 것들 — 왜 그런가

영상에서 한 문장으로 지나가는 것들의 배경입니다. 이걸 알고 있으면 그냥 따라 하는 게 아니라 이해하고 쓰게 되고, 막혔을 때 스스로 판단할 수 있습니다.

A-1. 챗봇과 에이전트는 무엇이 다른가

차이는 똑똑함이 아니라 도구(tool)를 쥐고 있느냐 하나입니다.

에이전트 루프agentic loop

한 줄로 맥락 수집 → 실행 → 결과 검증을, 일이 끝날 때까지 스스로 반복하는 주기.

비유 직원이 서류를 찾아보고(수집) → 일을 하고(실행) → 결과를 확인한 뒤(검증) 다시 다음 단계로 가는 것.

나한테 왜 필요한가 2강에서 클로드가 스스로 브라우저를 열어 확인하던 장면이 이 '검증' 단계입니다. 챗봇에는 이 고리가 없습니다.

도구가 없으면 아무리 좋은 모델도 글자만 내놓습니다. 도구가 붙는 순간 읽기·수정·명령 실행·웹 검색 같은 행동이 가능해집니다.

📎 How Claude Code works · Glossary

하네스agentic harness

한 줄로 모델을 실제로 일하는 에이전트로 만들어주는 도구·맥락관리·실행환경 묶음.

비유 말에 채우는 마구(harness). 말이 힘을 내도 마구가 있어야 수레를 끕니다.

나한테 왜 필요한가 클로드 코드가 하네스이고, 안에서 판단하는 건 클로드 모델입니다. 그래서 /model로 모델을 갈아끼울 수 있는 겁니다.

📎 Glossary

한 줄로 기억하기
“챗봇은 대답을 주고, 에이전트는 결과물을 준다. 그래서 챗봇에는 질문하고, 에이전트에는 의뢰한다.”

A-2. 접수표 5칸이 파일 5개가 되는 곳

영상의 뼈대입니다. 1강의 접수표 다섯 칸이 컴퓨터 안에서 각각 무엇으로 바뀌는지 — 이 대응표가 부록 전반부 전체입니다.

접수표 5칸 → 작업장의 파일 5개

접수표 칸	작업장에서는	실제 이름	성격
① 역할	벽에 걸린 명찰·근무수칙	CLAUDE.md	내가 쓰는 상시 지시문. 매 세션 자동 로드
② 상황	단골 가게의 고객 차트	자동 메모리(auto memory)	클로드가 스스로 적는 노트. 기기 안에만 저장
③ 문제	자주 쓰는 레시피 카드	스킬(SKILL.md)	평소엔 제목만, 쓸 때만 본문이 펼쳐짐
④ 결과물	납품물 + 검수 기준	폴더에 생기는 파일 + 완료 조건	말풍선이 아니라 실제 파일
⑤ 기준	벽의 규칙 + 문의 자물쇠	규칙 파일 + 권한(permission)	두 겹 잠금

📎 Memory (CLAUDE.md) · Skills · Permission modes

A-3. CLAUDE.md — 매 세션 자동으로 읽히는 지시 파일 (+AGENTS.md)

CLAUDE.mdproject memory

한 줄로 내가 직접 쓰는 상시 지시문. 세션이 시작될 때마다 자동으로 읽힌다.

비유 작업장 벽에 붙여둔 근무수칙 — 새 직원이 와도 매번 설명할 필요가 없다.

나한테 왜 필요한가 대화가 길어져 압축이 일어나도 디스크에서 다시 읽어옵니다. 그래서 '끝까지 지켜야 할 지시'는 대화창이 아니라 이 파일에 적어야 합니다.

위치는 여러 곳에 겹쳐서 둘 수 있습니다 — 관리자 정책 / 내 계정 전체(~/.claude/CLAUDE.md) / 프로젝트(./CLAUDE.md) / 개인 로컬(CLAUDE.local.md). 넓은 범위부터 좁은 범위 순으로 덮어쓰지 않고 이어붙습니다.

작업 폴더에서 위로 올라가며 발견한 CLAUDE.md를 전부 읽습니다. 하위 폴더의 CLAUDE.md는 그 폴더 파일을 읽을 때 로드됩니다.

⚠️ 틀리기 쉬운 지점 200줄 미만 권장. 길수록 지시 준수율이 떨어지고, 매 세션 전부 읽히므로 매번 비용이 듭니다. 긴 절차는 스킬로 빼세요.

📎 Memory (CLAUDE.md)

AGENTS.md다른 AI 코딩 도구와 함께 쓰는 지침 파일10월 개정

한 줄로 코덱스(Codex) 같은 다른 AI 코딩 도구용 공용 지침 파일. 이제 클로드 코드도 직접 읽습니다.

비유 여러 협력업체가 같이 보는 공용 작업 수칙 — 우리 회사 전용 수칙(CLAUDE.md)이 따로 있으면 공용 수칙은 아예 펴보지 않는다.

나한테 왜 필요한가 코덱스에서 쓰던 폴더를 클로드 코드로 열어도 지침을 다시 쓸 필요가 없습니다.

규칙은 하나 — 작업 폴더(와 그 위 폴더)에 CLAUDE.md가 없으면 AGENTS.md를 대신 읽고, 있으면 기본은 CLAUDE.md만 읽습니다. 내 계정 전체용 ~/.claude/CLAUDE.md는 이 판단과 상관없습니다. 둘 다 읽게 하려면 /config → Project instructions를 claude-md-and-agents-md로 바꿉니다.

가장 간단한 공존법: CLAUDE.md 첫 줄에 @AGENTS.md 한 줄을 넣으면 공용 수칙을 먼저 읽고, 그 아래 클로드 전용 지시를 이어서 읽습니다.

설정까지 통째로 옮기려면 /import — 코덱스·제미나이 CLI·커서에서 쓰던 지침 파일·MCP·스킬 등을 가져옵니다. 단 /import는 AGENTS.md 내용을 CLAUDE.md에 한 번 복사해 오는 방식이라, 이후 코덱스 쪽에서 AGENTS.md를 고쳐도 클로드엔 반영되지 않습니다 — 두 도구를 계속 같이 쓸 폴더라면 @AGENTS.md 한 줄이 낫습니다.

⚠️ 틀리기 쉬운 지점 클로드 코드 v2.1.277 이상에서만 됩니다. 또 개인용 CLAUDE.local.md를 하나 만들면 그것도 ‘CLAUDE 파일’로 쳐서 AGENTS.md를 안 읽게 됩니다 — 이때는 위 설정을 바꾸세요.

📎 Memory — AGENTS.md · Commands(/import)

/init

한 줄로 폴더를 분석해 CLAUDE.md 초안을 자동으로 써주는 명령.

비유 새 가게에 들어온 직원이 하루 둘러보고 근무수칙 초안을 써오는 것.

나한테 왜 필요한가 빈손으로 시작하지 않게 해줍니다. 다만 초안이므로 검증은 사장 몫입니다.

이미 CLAUDE.md가 있으면 덮어쓰지 않고 개선안을 제안합니다.

커서(Cursor)·코파일럿(Copilot) 규칙 파일이 있으면 그 내용도 읽어 반영합니다.

코덱스(Codex)·제미나이 CLI 설정을 발견하면 /import로 가져오기를 제안합니다. 10월 개정

⚠️ 틀리기 쉬운 지점 빈 폴더에서 실행하면 쓸 내용이 없습니다. 실습은 파일이 들어 있는 폴더(예: 2강의 '내 카페 문의')에서 하세요.

📎 Memory (CLAUDE.md)

자동 메모리auto memory

한 줄로 클로드가 스스로 배운 것을 기록하는 노트. 기본으로 켜져 있다.

비유 단골 미용실의 고객 차트 — 내가 쓰는 게 아니라 가게가 적어두는 것.

나한테 왜 필요한가 “이거 기억해줘”라고 하면 여기 저장됩니다. CLAUDE.md와는 별개입니다.

목차 파일의 앞부분(200줄 또는 25KB)만 매 세션 자동 로드되고, 나머지 낱장 노트는 필요할 때 찾아 읽습니다.

저장 위치는 내 컴퓨터 안이며 기기 간 동기화가 되지 않습니다. /memory에서 목록을 열어 고치거나 끌 수 있습니다.

⚠️ 틀리기 쉬운 지점 “파일이 진짜 있나요?” — 네, 실제 파일로 존재합니다. ~/.claude/projects/(프로젝트 폴더 이름)/memory/ 폴더에 목차인 MEMORY.md 한 장과 주제별 낱장 노트(.md)들로 저장됩니다. 일반 텍스트라 메모장으로도 열리지만, 고치거나 끌 때는 /memory 명령이 안전합니다.

📎 Memory (CLAUDE.md)

정정 — '#'으로 메모리 추가 10월 개정
예전엔 메시지 앞에 #을 붙여 메모리에 추가하는 공식 기능이 있었지만 v2.0.70에서 없어졌습니다. 지금 방법은 ①“기억해줘”라고 말하기 ②“CLAUDE.md에 추가해줘”라고 시키기 ③/memory에서 직접 편집 — 이 세 가지입니다. 옛 자료의 # 안내는 따라 하지 마세요.

A-4. 스킬 — 필요할 때만 펴보는 절차서

스킬skill

한 줄로 작업 절차를 적어둔 폴더. 진입점은 SKILL.md 한 장.

비유 주방 서랍의 레시피 카드 — 평소엔 제목만 보이고, 그 요리를 할 때 꺼내 편다.

나한테 왜 필요한가 점진적 공개가 핵심입니다. 평소엔 설명 한 줄만 올라가 있고 본문은 호출될 때 로드되므로, 절차서가 길어도 평소 비용이 거의 없습니다.

한 번 호출된 스킬 본문은 그 세션 내내 남습니다(매 턴 다시 읽지 않음 — 단 대화가 압축되면 앞부분만 다시 붙거나 오래된 스킬은 빠질 수 있음). 10월 개정

직접 부를 땐 /스킬이름, 목록 확인은 /skills. 파일을 고치면 재시작 없이 반영됩니다.

예전의 '커스텀 명령어'는 스킬로 통합됐습니다 — 둘 다 /이름으로 동작합니다.

📎 Skills

CLAUDE.md vs 스킬 — 뭘 어디에 적나

	CLAUDE.md	스킬(SKILL.md)
언제 읽히나	매 세션 시작 시 항상	그 일을 할 때만
적을 것	항상 지켜야 할 규칙·말투·금지사항	가끔 하는 긴 절차
길면	매번 비용 + 중요한 규칙이 묻힘	부담 거의 없음
권장 분량	200줄 미만	500줄 미만(공식 권장) — 긴 참고자료는 별도 파일로 10월 개정

📎 Memory (CLAUDE.md) · Skills

A-5. 두 겹 잠금 — 권한과 안전장치

수강생이 가장 무서워하는 지점입니다. “AI가 내 파일을 다 지우면요?”에 답할 수 있어야 합니다.

🆕 세션을 열면 기본이 ‘오토(auto) 모드’입니다 10월 개정
클로드 코드 v2.1.284 이상(9월 말 업데이트)에선 터미널·VS Code에서 세션을 열면 모든 요금제에서 오토 모드로 시작합니다(Pro·Max·Team은 8월 14일부터 이미 기본). 하나하나 묻는 대신 두 번째 AI인 ‘심사관’(classifier, 분류기)이 행동을 실행 전에 검토해 — 내 요청을 넘어서는 일, 처음 보는 외부 시스템을 건드리는 일, 읽은 내용에 조종당한 듯한 일 — 을 막습니다. 화면 아래 ⏵⏵ auto mode on이 보이면 이 상태입니다. 단 공식 문서도 못박습니다: 오토 모드는 묻는 횟수를 줄일 뿐 안전을 보장하지 않습니다. 민감한 작업(고객 명단·장부·원본 사진이 든 폴더 등)은 매뉴얼 모드로 하세요.

오토 모드가 기본으로 막는 것(공식 목록 중 일부) — 인터넷에서 받은 코드를 바로 실행(curl | bash), 민감한 정보를 외부로 보내기, 실서비스 배포, 세션 전부터 있던 파일을 되돌릴 수 없게 지우기, 강제 푸시(force push), 저장 안 한 변경을 날리는 git 명령.
묻지 않고 통과하는 것 — 작업 폴더 안의 파일 읽기·수정, 읽기만 하는 웹 요청, 지금 작업 중인 저장소로의 푸시(기본 브랜치 main 포함) 등. main에 올리면 자동 배포되는 저장소라면 푸시가 곧 배포입니다 — 푸시 전에 묻게 하려면 ask 규칙 Bash(git push *)(B-5). 10월 개정
꼭 작업용 폴더에 들어가서 claude를 시작하세요 — 시작한 폴더가 ‘작업 폴더’가 되고, 오토 모드에선 그 안의 파일을 묻지 않고 읽고 고칩니다. 터미널을 막 연 자리(내 계정 폴더 전체)에서 바로 시작하지 마세요.
말로 정한 경계도 참고해 막습니다 — “푸시하지 마”, “배포 전에 내가 볼게”라고 하면 심사관이 그에 맞는 행동을 막습니다. 다만 보장은 아니고 대화가 압축되면 그 말이 사라질 수 있으니, 확실히 하려면 B-5의 금지(deny) 규칙으로 적어두세요 — 클로드에게 “git push를 금지 규칙으로 막아줘”라고 시키면 설정 파일에 "deny": ["Bash(git push *)"]를 넣어 줍니다.
하나하나 승인받고 싶다면 ‘매뉴얼(Manual)’ 모드 — ① 바꾸기: Shift+Tab을 한 번 → ⏸ manual mode on ② 하는 일: 파일 수정·명령 실행마다 승인을 묻고, ls·cat·git status 같은 읽기 전용 명령만 묻지 않음(초판에서 ‘기본값은 읽기 전용’이라 설명한 게 이 모드) ③ 늘 매뉴얼로 시작: 클로드에게 “항상 매뉴얼 모드로 시작하게 설정해줘”라고 시키면 ~/.claude/settings.json에 "defaultMode": "default"를 넣어 줍니다 — 여기서 default는 ‘기본값’이 아니라 매뉴얼 모드의 설정 이름입니다.
작업 디렉터리 경계 — 매뉴얼 모드에선 시작한 폴더와 그 하위에만 쓸 수 있고, 폴더 밖은 읽기(Read·Grep·Glob)조차 확인을 요구합니다. 오토 모드에서도 작업 폴더 밖을 처음 읽을 때는 한 번 묻습니다.

※ 낱말 풀이 — 푸시 = 내 작업 기록을 인터넷 저장소(GitHub 등)에 올리기 · 강제 푸시 = 인터넷에 있던 기록을 덮어쓰기 · 저장 안 한 변경 = 아직 기록(커밋)하지 않은 수정

📎 Permission modes · Security · Permissions

프롬프트 인젝션prompt injection

한 줄로 파일·웹페이지·도구 결과 안에 숨겨둔 악의적 지시가 AI를 조종하려는 공격.

비유 택배 상자 안에 “이 집 금고를 열어라”는 쪽지를 넣어두는 것.

나한테 왜 필요한가 그래서 매뉴얼 모드에선 curl·wget처럼 웹에서 뭔가 가져오는 명령이 자동 승인 대상이 아니고, 오토 모드에선 심사관이 읽은 내용에 조종당한 듯한 행동을 막습니다.

⚠️ 틀리기 쉬운 지점 최종 방어선은 사람입니다 — 매뉴얼 모드라면 승인 전에 제안된 명령을 읽는 습관, 오토 모드라도 끝난 결과를 직접 확인하는 습관. 공식 문서도 “클로드 코드는 당신이 부여한 권한만 갖는다”고 못박습니다.

📎 Security

MCP는 감사받지 않는다
외부 도구를 붙이는 MCP 서버는 Anthropic이 보안 감사하지 않습니다(공식 디렉터리에 올라간 커넥터도 등록 기준 심사일 뿐 보안 감사는 아닙니다). 직접 만들었거나 신뢰하는 제공자의 것만 쓰라고 공식 문서가 명시합니다. 📎 Security

A-6. 되돌리기 — 무엇이 저장되고 무엇이 안 되나

체크포인트checkpointing

한 줄로 내가 지시를 보낼 때마다 코드 상태를 자동으로 찍어두는 스냅샷.

비유 게임의 자동 세이브 — 보스 잡기 전 저장 지점.

나한테 왜 필요한가 클로드가 편집 도구로 고친 파일은 되돌릴 수 있으니 과감하게 시켜도 됩니다 — 단 메일 발송·배포·외부 서비스에서 한 일은 되돌릴 수 없습니다. 10월 개정

여는 법: /rewind, 또는 입력창이 비어 있을 때 Esc 두 번(글자가 있으면 글자만 지워집니다 — 위 화살표로 복구).

고를 수 있는 것: 코드+대화 복원 / 대화만 / 코드만 / 여기서부터 요약 / 여기까지 요약.

세션당 최근 100개 보관, 기본 30일 뒤 세션과 함께 정리됩니다.

⚠️ 틀리기 쉬운 지점 추적하지 않는 것 — ①터미널 명령(rm·mv·cp)이 바꾼 파일 ②서브에이전트가 한 편집 ③내가 다른 프로그램에서 직접 고친 것 ④심볼릭 링크 경로 ⑤메일 발송·배포·데이터베이스처럼 컴퓨터 밖에서 한 일. 공식 문서는 체크포인트를 ‘세션 안에서 빠르게 되돌리는 장치’, Git을 ‘영구 버전 기록’으로 구분하며 버전관리를 대체하지 않는다고 명시합니다.

📎 Checkpointing · How Claude Code works

A-7. 플랜 모드 · 모델 · 에포트 — 일 맡길 때의 세 손잡이

권한 모드permission mode

한 줄로 이 세션에서 무엇까지 묻지 않고 할지 정하는 기본 태도.

비유 신입에게 “하나하나 물어봐” / “편집은 알아서 해” / “계획만 가져와” / “위험한 것만 심사관이 걸러줘”를 정해주는 것.

나한테 왜 필요한가 Shift+Tab으로 바꿉니다. 세션은 오토(auto)에서 시작하고, 누를 때마다 매뉴얼(Manual) → 편집 자동수락 → 플랜 → 다시 오토 순서로 돕니다. 10월 개정

전체는 여섯입니다 — 매뉴얼(설정값 default) / 편집 자동수락(acceptEdits) / 플랜(plan) / 오토(auto) / 사전승인만(dontAsk) / 전부 통과(bypassPermissions). bypassPermissions(전부 통과 — 안전장치를 모두 끔, 쓰지 마세요)는 특별한 옵션으로 시작했을 때만 순환에 들어오고, dontAsk는 순환에 아예 없습니다. 화면 표시는 ⏵⏵ auto mode on · ⏸ manual mode on · ⏵⏵ accept edits on · ⏸ plan mode on.

플랜 모드는 파일을 건드리지 않고 계획만 세웁니다. 승인해야 실제 작업이 시작되고, 승인할 때 ‘오토로 진행(Yes, and use auto mode)’과 ‘하나하나 승인(Yes, manually approve edits)’ 중에 고릅니다.

⚠️ 틀리기 쉬운 지점 ★주의 — 몇 번 눌렀는지 세지 말고 글자를 읽으세요. 순환에 들어오는 모드는 계정·설정에 따라 달라서, 같은 횟수를 눌러도 사람마다 도착지가 다릅니다(오토를 쓸 수 없으면 — Haiku로 시작했거나 조직이 끈 경우 — 매뉴얼로 시작하고 순환에도 오토가 없습니다). plan mode on이 떠야 맞습니다. 윈도우에서 Shift+Tab이 안 먹으면 Alt+M.

📎 Permission modes · Interactive mode

모델과 에포트 — 헷갈리지 않는 정리

	무엇을 정하나	비유	언제 올리나
`/model`	누구에게 맡길지	수석 설계사 / 소장 / 실무 에이스 / 빠른 막내 (2강의 네 칸 · 아래 라인업 표)	어려운 일엔 올리고, 가벼운 일엔 내리기. Enter=앞으로도 계속 이 모델, `s`=이번 세션만
`opusplan`	단계마다 다른 사람에게 (모델 선택지의 하나)	설계는 소장(opus), 시공은 에이스(sonnet) — 승인하는 순간 자동 교체	설계는 어렵고 시공은 단순한 일
`/effort`	얼마나 깊이 생각할지 — low · medium · high · xhigh · max	“대충 보고” vs “충분히 검토하고”	결과가 얕게 느껴질 때 한 칸씩. 지금 값은 `/effort status`, `max`는 이번 세션만
`ultracode`	혼자 말고 팀으로 — 에포트 단계가 아니라 `/effort` 안의 별도 스위치 10월 개정	켜면 큰 일을 여러 에이전트 작업(워크플로)으로 나눠 조사·검증. 켜도 에포트 단계는 그대로(v2.1.284~). 그 세션의 모든 일에 적용돼 사용량이 크게 늘고 한도가 빨리 닳습니다	크고 복잡한 일에만. `/effort` 화면에서 Tab, 또는 `/effort ultracode on` · `off` — 큰 일이 끝나면 off. (Pro는 `/config` → Dynamic workflows를 먼저 켜야 보임)

📎 Commands · Model configuration · Manage costs

2026-10-01 기준 모델 라인업 — Anthropic 계정으로 로그인했을 때 10월 개정

/model에서	지금 가리키는 모델	비유	이럴 때
`fable`	Fable 5.1 (9월 추가)	수석 설계사	하루 넘게 걸릴 큰 일, 원인 모를 문제. 기본값이 아니라 직접 골라야 합니다
`opus` · 기본값	Opus 5.5 (9월 추가 · 지금의 기본값)	소장	대부분의 일. Pro·Max·Team·Enterprise 모두 기본(한도를 빨리 쓰니 가벼운 일엔 sonnet)
`sonnet`	Sonnet 5.5 (9월 추가)	실무 에이스	빠르고 가볍게 많이
`haiku`	Haiku 4.5	빠른 막내	아주 간단한 일. 에포트 조절·오토 모드는 지원하지 않습니다(haiku로 시작하면 매뉴얼 모드)

📎 Model configuration · Models overview

Fable은 추가 요금이 붙을 수 있습니다 10월 개정
요금제·좌석 등급에 따라 Fable 사용분이 구독 한도가 아니라 추가 사용 크레딧(usage credits — 구독료와 별도로 결제되는 돈)으로 청구될 수 있습니다. 그 경우 /model 목록의 Fable 줄에 “Requires usage credits”가 표시되고, 처음 쓸 때 한 번만 동의를 묻습니다 — 그 뒤로는 묻지 않습니다. 또 /model에서 Enter로 고르면 다음 세션도 Fable로 시작하니, 시험 삼아 쓸 땐 s(이번 세션만)로 고르세요. 📎 Fable and usage credits

기본 에포트는 medium — 클로드 코드에서 Opus 5.5·Sonnet 5.5는 medium이 기본입니다. Anthropic 테스트에서 Opus 5.5 medium이 이전 Opus 5의 high와 같거나 나았다고 하니, 옛 습관대로 high부터 올리지 말고 medium에서 시작하세요.
생각(thinking)은 끌 수 없습니다 — Opus 5.5·Sonnet 5.5·Fable은 단계마다 스스로 생각의 양을 정하고, 깊이는 에포트로 조절합니다.
새 모델이 안 보이면 버전부터 — Fable 5.1은 v2.1.257, Opus 5.5는 v2.1.280, Sonnet 5.5는 v2.1.284 이상이 필요합니다. claude --version으로 확인하고 claude update(Homebrew·WinGet 설치는 B-1의 업그레이드 명령).

모델 이름은 계속 바뀝니다
라인업은 몇 달 단위로 갱신되고, 요금제·조직 설정에 따라 보이는 목록도 다릅니다. 그래서 이름·숫자 대신 ‘급’으로 익혀두는 게 오래갑니다. 실제로 초판 뒤 두 달 사이에 기본 모델이 Opus 5.5로 바뀌었습니다(그전엔 Pro·Team Standard는 Sonnet 5, 나머지는 Opus 5가 기본). /model·/effort를 눌러 내 화면 선택지를 먼저 확인하세요. 모델 전환 단축키는 Alt+P(맥 Option+P — 터미널에서 ‘Option을 Meta로’ 설정해야 동작, 안 되면 /model).

A-8. 브라우저를 조작하는 두 갈래

Claude in Chrome크롬 확장

한 줄로 클로드 코드가 내가 쓰던 크롬을 직접 조작하게 해주는 공식 확장.

비유 내 컴퓨터의 브라우저를 직원에게 잠깐 맡기는 것 — 이미 로그인된 상태 그대로.

나한테 왜 필요한가 내 로그인 상태를 그대로 씁니다. 그래서 지메일·구글 문서·노션처럼 로그인이 필요한 사이트를 다루게 할 수 있습니다.

켜는 법: 실행할 때 claude --chrome, 세션 중에는 /chrome으로 연결·권한 관리·재연결. VS Code에서는 @browser.

할 수 있는 일 — 콘솔 오류 읽고 원인 수정, 로컬 화면 폼 테스트, 데이터 추출해 CSV 저장, 반복 입력 자동화, 스크린샷·시연 GIF 저장.

어느 사이트에서 클릭·입력할지는 매뉴얼 모드 등에선 크롬 확장 설정의 사이트 권한을 따릅니다. 단 기본인 오토 모드에선 심사관이 승인한 동작이면 이 사이트별 확인을 건너뜁니다(v2.1.275~). 메일·은행·관리자 화면처럼 중요한 계정이 로그인된 크롬은 매뉴얼 모드에서 맡기세요. 플랜 모드에선 GIF 녹화·새 탭 열기·단축 동작 전에 승인을 묻고, 오토 모드에선 심사관이 페이지 내용·쿠키·로그인 정보를 다른 곳으로 보낼 수 있는 동작을 막습니다. 보낸 메일·결제처럼 밖으로 나간 일은 /rewind로 돌아오지 않습니다. 10월 개정

크롬 말고 엣지·브레이브·아크 같은 크로미움 계열 브라우저에서도 됩니다. 단 구독 계정으로 /login해야 하고, API 키로 로그인하면 꺼집니다.

⚠️ 틀리기 쉬운 지점 ①WSL에서는 지원되지 않습니다 ②시연 GIF에 로그인 계정 정보가 그대로 담기니 공유 전 확인 ③확장이 안 잡히면 크롬을 완전히 재시작(시작할 때만 연결 파일을 읽습니다).

📎 Claude in Chrome

플레이라이트(Playwright)는 원래 개발자용 브라우저 자동 검사 도구입니다. 2강에서 클로드가 폼을 채우고 지우고 휴대폰 폭까지 검사한 장면이 이것입니다. 웹페이지 검수 목적이면 크롬 확장이 더 간단하고, 반복 검사 자동화에는 플레이라이트가 강합니다.

평소 공부

PART B · 공식 매뉴얼 정석 — 개인 사용자 전영역

공식 문서를 순서대로 훑습니다. 각 항목은 ‘한 줄 정의 → 비유 → 나한테 왜 필요한가’ 구조이고, 📎로 원문을 붙였습니다. 팀·기업 관리자용 기능과 개발자 SDK는 마지막에 목록으로만 남겼습니다.

B-1. 설치와 로그인

설치 방법 (택 1)

환경	명령 한 줄	비고
윈도우 PowerShell	`irm https://claude.ai/install.ps1 \| iex`	자동 업데이트됨
맥·리눅스·WSL	`curl -fsSL https://claude.ai/install.sh \| bash`	자동 업데이트됨
윈도우 CMD	`curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd`	자동 업데이트됨
윈도우 WinGet	`winget install Anthropic.ClaudeCode`	자동 업데이트 안 됨 — 새 모델이 안 보이거나 한 달에 한 번 `winget upgrade Anthropic.ClaudeCode` 10월 개정
맥 Homebrew	`brew install --cask claude-code`	자동 업데이트 안 됨 — 새 모델이 안 보이거나 한 달에 한 번 `brew upgrade claude-code` 10월 개정
확인	`claude --version` / `claude doctor`	설치·설정 점검

📎 Advanced setup · Quickstart

★수강생 질문 1순위 — 무료로 되나요?
무료 Claude.ai 플랜으로는 클로드 코드를 쓸 수 없습니다. Pro·Max·Team·Enterprise 구독이나 Console(API 선불) 계정이 필요합니다. 📎 Authentication

요구사항: 윈도우 10(1809+)·맥 13+·우분투 20.04+, RAM 4GB 이상, 인터넷 필수. 윈도우의 Git for Windows는 선택입니다 — 설치하면 Bash 도구를, 없으면 PowerShell을 씁니다. 데스크톱 앱에서도 Git은 이제 필수가 아니고, 세션마다 따로 작업 사본(worktree)을 만들 때만 필요합니다(앱이 Git을 요구하면 앱을 업데이트). 10월 개정
터미널이 처음이라면 공식 터미널 가이드(Terminal guide for new users)가 창 여는 법부터 단계별로 보여줍니다.
로그인은 프로젝트 폴더에서 claude 실행 → 브라우저 인증. 세션 안에서 /login·/logout.
★함정: 예전에 ANTHROPIC_API_KEY 환경변수를 넣어둔 적이 있으면, 처음에 그 키를 쓸지 한 번 묻고 승인하는 순간 구독 대신 그 키(API 종량제 요금)로 씁니다. 키가 만료된 조직 것이면 엉뚱한 오류가 납니다. /status로 무엇이 쓰이는지 확인. 10월 개정

설치·로그인이 안 될 때

증상	원인	해결
`claude` 명령을 못 찾음	설치 경로가 PATH에 없음	윈도우는 `%USERPROFILE%\.local\bin`을 PATH에 추가
로그인 후 403	구독 미활성 / 역할 부족 / 사내 프록시	구독 상태와 계정 역할 확인
“organization has been disabled”	옛 API 키 환경변수가 구독을 덮어씀	환경변수 제거 후 재실행, `/status` 확인
원격·컨테이너에서 브라우저 로그인 실패	브라우저를 못 엶	화면의 코드를 터미널에 붙여넣기
원인 불명	인증 상태 꼬임	`/logout` → 종료 → 재실행

📎 설치·로그인 문제 해결

B-2. 작동 원리와 도구

클로드 코드는 맥락 수집 → 실행 → 검증을 반복합니다(에이전트 루프). 언제든 Esc로 끊고 방향을 바꿀 수 있습니다.

비개발자가 알아야 할 도구 6종과 권한 확인 여부 (매뉴얼 모드 기준)

도구	하는 일	승인 필요?
Read	파일 읽기	아니오(작업 폴더 밖이면 예)
Glob · Grep	파일 찾기 · 내용 검색 — 맥·리눅스·WSL에선 이 둘 대신 Bash의 `find`·`grep`으로 찾습니다(WSL 없이 쓰는 윈도우는 그대로) 10월 개정	아니오(밖이면 예)
Edit · Write	파일 수정 · 새로 쓰기	예
Bash · PowerShell	명령 실행	예(읽기 전용 명령은 예외)
WebSearch · WebFetch	웹 검색 · 페이지 읽기	예
Agent	서브에이전트에 위임	아니오

📎 Tools reference

이 표가 “AI가 내 컴퓨터에서 뭘 할 수 있나”에 대한 가장 정확한 답입니다(매뉴얼 모드 기준). 한 줄로 — 매뉴얼은 ‘읽기는 자유, 바꾸기는 허락받고’, 기본인 오토는 ‘읽기·고치기는 묻지 않고, 위험해 보이는 것만 심사관이 막음’. 10월 개정

B-3. 터미널에서 실제로 쓰는 조작

꼭 외울 단축키

키	하는 일
Esc	클로드 중단(하던 일 멈춤)
Esc Esc	입력창이 비어 있으면 되감기 메뉴 / 글자가 있으면 입력 지우기
Shift+Tab	권한 모드 순환 (윈도우에서 안 되면 Alt+M)
Ctrl+V (윈도우·WSL은 Alt+V)	클립보드 이미지 붙여넣기 — 윈도우는 Ctrl+V가 아니라 Alt+V. 맥 iTerm2는 Cmd+V도 됨 10월 개정
Ctrl+J	줄바꿈(Enter는 전송)
Alt+P (맥 Option+P)	모델 전환 — 맥은 터미널에서 ‘Option을 Meta로’ 설정이 필요(첫 실행 때 터미널 설정 제안을 수락했다면 이미 됨). 안 되면 `/model`
Ctrl+C / Ctrl+D	입력 취소 / 세션 종료
Ctrl+O	지금까지 대화 전체 보기
위 화살표	이전에 보낸 것 불러오기
?	단축키 도움말 열기

📎 Interactive mode · Terminal config

입력창 접두어 세 개

접두어	뜻	예
`/`	명령·스킬 실행	`/init`, `/model`
`@`	파일 경로 자동완성	`@메뉴판.txt` 이거 봐줘
`!`	명령을 바로 실행하고 결과를 대화에 넣기	`!git status`

📎 Interactive mode

Shift+Enter로 줄바꿈이 되는 터미널도 있지만 환경마다 다릅니다. 어디서나 되는 건 Ctrl+J입니다. 안 되면 /terminal-setup을 한 번 실행하세요. 📎 Terminal config

B-4. 슬래시 명령 — 비개발자용 25선 + 6

① 시작·설정

명령	하는 일
`/init`	이 폴더의 CLAUDE.md 초안 만들기
`/model`	모델 바꾸기 — Enter는 앞으로도 계속 이 모델(내 기본값으로 저장), `s`는 이번 세션만
`/effort`	고민의 깊이 조절(low~max) · `/effort status`로 지금 값 · ultracode 스위치
`/login` `/logout`	계정 로그인·로그아웃
`/help`	도움말
`/config`	설정 화면

📎 Commands

② 대화 관리 (가장 자주 씀)

명령	하는 일
`/clear`	대화 비우고 새로 시작 — 주제가 바뀔 때 필수
`/compact`	길어진 대화를 요약해 자리 확보
`/context`	지금 무엇이 얼마나 차지하는지 보기
`/resume`	이전 대화로 갈아타기
`/rewind`	코드·대화를 이전 지점으로 되돌리기
`/branch`	지금 지점에서 대화 복사해 새 갈래로
`/export` `/copy`	대화 내보내기 · 마지막 답변 복사

📎 Commands

③ 일 시키는 방식

명령	하는 일
`/plan`	큰 변경 전 계획부터 받기
`/goal`	조건을 채울 때까지 알아서 계속하기
`/subtask`	곁가지 조사를 서브에이전트에 위임
`/loop`	세션 열려 있는 동안 주기적으로 반복
`/chrome`	크롬 연결 상태·권한 관리

📎 Commands

④ 점검 (문제 생겼을 때)

명령	하는 일
`/doctor`	설정 점검하고 고칠 것을 제안(승인해야 적용) · 별칭 `/checkup`
`/status`	지금 무엇으로 인증됐고 어떤 설정이 적용 중인지
`/usage`	토큰 사용량·비용·요금제 한도 · `/cost`도 같은 명령
`/permissions`	권한 규칙 확인·관리
`/memory` `/skills`	메모리 파일 · 스킬 목록
`/mcp`	외부 도구 연결 상태
`/add-dir`	작업 폴더 추가하기

📎 Commands · Debug your config

⑤ 더 알아두면 좋은 명령 10월 개정

명령	하는 일
`/import`	코덱스·제미나이 CLI·커서에서 쓰던 설정(지침 파일·MCP·스킬 등)을 가져오기. `--dry-run`이면 미리보기만
`/btw`	대화 기록에 남기지 않는 곁질문 — 작업 중에도 되고, 지금까지 대화만 보고 답함(파일은 안 읽음)
`/output-style`	답변 스타일 바꾸기 — Explanatory(왜 그렇게 했는지 설명) · Learning(코드 일부를 직접 쓰게 하는 코딩 연습용) · Concise(결론부터 짧게) · Proactive(사소한 결정은 묻지 않고 진행 — 권한 승인은 그대로)
`/diff`	지금까지 바뀐 내용 보기(클로드가 고친 것 포함)
`/skill-doctor`	스킬마다 자리(컨텍스트)를 얼마나 차지하고 얼마나 쓰이는지 — 안 쓰는 스킬 정리
`/doctor prompt-audit`	내 CLAUDE.md·스킬에서 옛 모델용 지시·없는 파일 참조·서로 충돌하는 지시를 찾아 보고(직접 고치진 않음, v2.1.283~)

📎 Commands · Output styles

B-5. 권한 규칙과 설정 파일

허용·확인·금지allow / ask / deny

한 줄로 도구 사용을 세 가지로 미리 정해두는 규칙.

비유 직원 권한 설정 — 자유롭게 / 물어보고 / 절대 금지.

나한테 왜 필요한가 매번 승인 누르기 지치면, 안전한 것만 골라 ‘허용’으로 빼두면 됩니다.

평가 순서는 금지 → 확인 → 허용이고 먼저 맞는 규칙이 이깁니다. 어느 계층에서든 금지면 다른 어떤 설정도 허용하지 못합니다.

확인·관리는 /permissions — 지금 적용 중인 규칙과 그 출처 파일까지 보여줍니다.

📎 Configure permissions

내 컴퓨터 어디에 무엇이 있나

위치	무엇
`~/.claude/CLAUDE.md`	모든 프로젝트 공통 내 지침
`~/.claude/settings.json`	전역 설정(권한·훅·환경변수)
`~/.claude/projects/…/memory/`	자동 메모리
`./CLAUDE.md`	이 프로젝트 지침
`./.claude/settings.json`	이 프로젝트 설정(팀 공유)
`./.claude/skills/이름/SKILL.md`	이 프로젝트 스킬
`./.mcp.json`	외부 도구 연결(저장소 루트)

📎 .claude directory · Settings

~/.claude.json과 ~/.claude/settings.json은 다른 파일입니다. 권한·훅 설정을 앞의 파일에 넣으면 조용히 무시됩니다. 📎 .claude directory

B-6. 확장 기능 — 서브에이전트 · 훅 · MCP

서브에이전트subagent

한 줄로 자기만의 기억 공간에서 따로 일하고 요약만 돌려주는 보조.

비유 조사만 시켜서 보고서 한 장만 받는 것 — 자료 더미는 내 책상에 안 올라온다.

나한테 왜 필요한가 긴 조사·검색으로 본 대화가 지저분해지는 걸 막고, 본 대화가 가벼워져 이후 비용이 줄어듭니다(서브에이전트 자체도 사용량은 씁니다).

/subtask로 위임하거나, .claude/agents/에 역할을 정의해 둘 수 있습니다.

★주의: 서브에이전트가 한 파일 편집은 되돌리기로 복원되지 않습니다.

📎 Subagents · Checkpointing

훅hook

한 줄로 정해진 시점(편집 후·작업 끝 등)에 반드시 실행되는 자동 동작.

비유 CLAUDE.md가 “그렇게 해줘”라는 부탁이라면, 훅은 자동문이다 — 판단이 개입하지 않는다.

나한테 왜 필요한가 “매번 이렇게 해달라”고 적어도 가끔 빠뜨린다면, 그건 훅으로 만들 일입니다.

예: 파일 수정 후 자동 정렬, 입력 대기 시 알림음, 위험한 명령 차단.

⚠️ 틀리기 쉬운 지점 이 영역 중 진입장벽이 가장 높습니다(설정 파일 + 명령 작성). 비개발자는 “이런 게 있다”만 알고 넘어가도 충분합니다.

📎 Hooks guide

MCPModel Context Protocol

한 줄로 외부 서비스·데이터를 클로드에 연결하는 개방 표준.

비유 직원에게 회사 시스템 계정을 하나 더 열어주는 것.

나한테 왜 필요한가 다른 프로그램에서 데이터를 복사·붙여넣기 하고 있다면 그게 MCP로 붙일 신호입니다.

예: 지라 이슈 읽어 작업, 노션·피그마 연동, 데이터베이스 조회.

연결 상태 확인은 /mcp.

⚠️ 틀리기 쉬운 지점 보안 감사를 받지 않으니 신뢰할 수 있는 제공자의 것만 쓰세요.

📎 MCP · Security

B-7. 세션 · 컨텍스트 · 비용 (셋은 한 몸)

컨텍스트 창context window

한 줄로 지금 대화가 한 번에 들고 있을 수 있는 정보량.

비유 책상 넓이 — 자료를 계속 쌓으면 정작 볼 것을 못 편다.

나한테 왜 필요한가 비용과 속도의 근원입니다. 대화가 길수록 매 요청마다 전부 다시 보내지므로 느리고 비싸집니다.

시작할 때 이미 시스템 지침·메모리·CLAUDE.md·스킬 설명이 자리를 차지합니다. 확인은 /context.

꽉 차면 끊기지 않고 자동 요약(compact)이 일어납니다.

지금 모델들(Opus 5.5·Sonnet 5.5·Fable 5.1)은 책상이 100만 토큰(1M)이고, Pro 요금제도 같습니다. 그래도 길어질수록 느려지고 비싸지는 원리는 그대로입니다. 10월 개정

📎 Context window

비용을 줄이는 세 가지 습관 (공식 문서 권장)

습관	왜
주제가 바뀌면 `/clear`	오래된 맥락이 매 메시지마다 비용을 발생시킴
일에 맞는 모델 고르기 10월 개정	평소 일은 기본(Opus 5.5) 그대로도 되지만 한도를 빨리 씁니다 — 공식 비용 안내는 ‘대부분은 Sonnet, Opus는 복잡한 설계에’. 가볍고 많은 일은 sonnet으로 낮추세요
CLAUDE.md는 짧게, 긴 절차는 스킬로	CLAUDE.md는 매번 로드, 스킬은 필요할 때만

📎 Manage costs

오래 켜둔 세션은 한 줄만 물어도 쌓인 대화 전체를 다시 읽어서 많이 씁니다. 1시간 넘게 쉬었다 돌아오면 더 들고(저장해 둔 부분이 만료됨), /loop·/goal을 걸어 두면 가만히 있어도 씁니다. 쓰던 작업이 끝나면 /clear하거나 창을 닫는 습관이 돈을 아낍니다. 10월 개정 📎 Costs

/goal

한 줄로 완료 조건을 걸어두면 충족될 때까지 스스로 다음 턴을 이어가는 기능.

비유 “테스트 다 통과할 때까지 알아서 해두세요”라고 맡기고 자리를 비우는 것.

나한테 왜 필요한가 긴 작업을 맡기고 자리를 비울 때 씁니다 — 단 세션이 열려 있는 동안만 돕니다(PC를 끄면 멈춤). 조건은 측정 가능하게 쓰고 “20턴 지나면 멈춰” 같은 상한을 꼭 넣고, 시작 전에 사본을 두세요. PC 없이 정해진 시간에 돌리려면 클라우드 예약 작업을 씁니다. 10월 개정

📎 /goal

B-8. 터미널 말고 다른 창구 — 데스크톱 · VS Code · 웹 · 모바일

어디서 쓸 수 있나

창구	특징	비개발자 관점
데스크톱 앱	Claude 앱의 Code 탭(앱에는 Chat·Cowork·Code 세 탭). 터미널·Node 설치 불필요, 매뉴얼 모드면 변경 전 diff를 보여주고 승인 대기	설치 장벽이 가장 낮음. 윈도우의 Git for Windows는 이제 필수 아님(작업 사본 기능을 쓸 때만) 10월 개정
VS Code 확장	나란히 비교 diff, 계획을 문서로 열어 코멘트	편집기를 이미 쓰는 사람에게
웹(claude.ai/code)	클라우드에서 실행, 브라우저 닫아도 유지. GitHub 연결 필요	내 PC가 꺼져 있어도 되는 작업
모바일	Claude 앱의 Code 탭 = 조종기. 클라우드 세션 확인, 또는 내 PC 세션을 폰에서 조종 — 이때는 PC 세션에서 `/remote-control`(줄여서 `/rc`)을 먼저 켜야 하고 PC는 켜 둬야 함. `/mobile`은 앱 설치 QR 10월 개정	이동 중 진행 확인·알림(원격 조종을 켰을 때)

📎 Desktop app · VS Code · Claude Code on the web · Mobile

설정은 공유됩니다
데스크톱 앱과 터미널은 같은 엔진이고 CLAUDE.md·MCP·훅·스킬 설정을 공유합니다. 동시에 켜둬도 됩니다. 즉 터미널에서 만든 규칙 파일이 데스크톱에서도 그대로 적용됩니다. 터미널에서 claude --desktop을 치면 지금 폴더를 데스크톱 앱에서 열고(v2.1.285 이상·맥/x64 윈도우·구독 로그인 필요), 데스크톱 앱에선 /resume으로 터미널 세션을 이어받습니다(이어받기 전 터미널 쪽 세션은 닫기). 10월 개정 📎 Desktop

B-9. 잘 쓰는 습관 (공식 모범 사례)

검증 수단을 쥐여줘라 — 합격/불합격이 나오는 검사를 주면 스스로 돌려보고 고친다. “됐습니다”가 아니라 증거를 요구하라.
탐색 → 계획 → 구현 — 큰 작업은 플랜 모드로 먼저 읽고 계획하게 하고, 승인 후 구현.
구체적으로 지시 — 어떤 파일, 어떤 상황, ‘고쳐진 상태’가 무엇인지 지목.
CLAUDE.md는 짧게 — 길면 정작 중요한 규칙이 묻혀 무시된다.
컨텍스트가 1순위 자원 — 무관한 작업 사이엔 /clear.
조사는 서브에이전트에 — 자료 더미가 본 대화를 오염시키지 않게.
빨리 궤도수정 — 두 번 고쳐도 안 되면 /clear 후 더 나은 지시로 다시 시작.
배우는 중이면 답변에 설명을 붙이게 — /output-style explanatory: 왜 그렇게 했는지 설명을 붙여 줍니다(Learning은 코드 일부를 직접 쓰게 하고 멈춰 기다리는 코딩 연습용이라 비개발자에겐 비추천). 📎 Output styles 10월 개정

대표적 실패 패턴
잡탕 세션(무관한 작업 혼재) · 반복 교정으로 오염된 대화 · 비대한 CLAUDE.md · 검증 없이 그럴듯한 결과를 믿기 · 범위 없는 무한 탐색. 📎 Best practices

문제 생겼을 때 순서

증상	먼저 할 것
뭔가 이상함	`/doctor` — 점검하고 고칠 것을 제안
멈춘 것 같음	Ctrl+C → 안 되면 터미널 닫고 재시작(대화는 안 날아감)
느리고 무거움	`/compact` 또는 `/clear`, 재시작
파일을 못 찾음	검색 도구 문제 — 문서의 ripgrep 항목 참고
설정이 안 먹음	`/status`로 어떤 설정이 적용 중인지 확인
모델을 바꾼 뒤 지시가 어색하게 먹힘	`/doctor prompt-audit` — 옛 모델용 지시가 남았는지 점검 10월 개정

📎 Troubleshooting · Debug your config

B-10. 이런 것도 있습니다 (지금은 몰라도 되는 영역)

개인 사용자에게는 당장 필요 없지만, 나중에 팀·회사 단위로 갈 때 나오는 것들입니다. 이름만 알아두세요.

조직 관리 — 회사 전체 정책·중앙 설정·사용량 분석 (admin-setup, analytics)
게이트웨이·클라우드 — 아마존/구글/마이크로소프트 인프라 경유 (gateways, amazon-bedrock 등)
Agent SDK — 프로그램 안에 에이전트를 넣어 개발 (agent-sdk)
플러그인 제작 — 기능을 만들어 배포 (plugins)
에이전트 팀 — 여러 세션을 동시에 조율 (agent-teams). 여러 에이전트에게 나눠 맡기는 워크플로는 A-7의 울트라코드로 맛볼 수 있습니다 (workflows)

실무 트렌드

PART C · 지금 세상은 이렇게 쓴다

“요즘은…”이라고 대화를 열 때 쓸 재료입니다. [사실]은 1차 자료로 확인된 것, [관찰·주장]은 업계 논평입니다. 근거가 약한 건 일부러 뺐습니다.

C-1. 바이브 코딩은 지금 어디쯤인가

사실만든 사람이 1년 만에 “한물갔다”고 선언했다

카파시가 2025년 2월 “바이브에 몸을 맡기고 코드가 존재한다는 사실조차 잊는다”며 만든 말인데, 원래부터 주말용 일회성 프로토타입 경험을 가리킨 표현이었습니다. 2026년 초 본인이 이 용어를 접고 에이전틱 엔지니어링을 제안하며 “더 많은 감독과 검증을 곁들여서”라고 단서를 달았습니다.

📎 Forbes 보도 · 용어사(史) 정리

사실많이 쓰는데 덜 믿는다

개발자 설문에서 84%가 AI 도구를 쓰지만, 결과물 정확성에 대한 신뢰는 40%에서 29%로 떨어졌습니다. 사용량과 신뢰가 반대로 움직이는 국면입니다.

📎 Stack Overflow 2025 인용 보도

관찰·주장실무 정착 지점은 ‘실패 비용이 낮은 영역’

전부 맡기는 방식이 아니라 사내 자동화 도구·랜딩페이지·데모·시제품처럼 수명이 짧고 사고가 나도 감당되는 영역에 자리잡는다는 관찰. 계획·설계·유지보수는 여전히 사람 몫이라는 지적이 따릅니다.

📎 업계 논평

C-2. 챗봇에서 위임으로

사실같은 결과물, 대화 13번 vs 한 번

Anthropic 경제지수 보고서에 따르면 같은 산출물을 만들 때 챗봇에서는 중앙값 13라운드 대화가 필요했던 반면 클로드 코드에서는 단일 프롬프트로 끝났습니다. 응답자 35% 이상이 “내년이면 AI가 내 업무 대부분을 할 수 있다”고 답했습니다.

📎 Anthropic Economic Index (2026-06)

사실동시에, 거품도 빠지는 중

Gartner는 2026년 4월 에이전틱 AI를 기대 정점에서 환멸의 골짜기로 넘어가는 구간에 배치했습니다. 실제 배포 조직은 17%인데 60% 이상이 2년 내 도입을 계획하고, 2027년 말까지 에이전틱 프로젝트 40% 이상이 취소될 것으로 예측했습니다.

📎 Gartner 하이프 사이클

사실위임되는 일은 코딩 밖으로 번진다

이메일 분류, 인보이스 처리, 일정 조율, 리드 조사, 영업 메일 초안 — 비개발 업무로 확산 중입니다.

📎 Anthropic Economic Index (2026-01)

C-3. 프롬프트에서 컨텍스트로

“컨텍스트는 수확 체감이 있는 유한 자원이다.”— Anthropic, 컨텍스트 엔지니어링 문서

사실정의가 바뀌었다

Anthropic은 컨텍스트 엔지니어링을 “추론 중 최적의 토큰 집합을 큐레이션하고 유지하는 전략의 총체”로 정의합니다. 루프를 도는 에이전트는 계속 새 정보를 만들어내므로 주기적으로 정제해야 한다는 것이 전환의 이유입니다.

📎 Effective context engineering

관찰·주장한 줄 요약

프롬프트 엔지니어링 = 어떻게 말하는가. 컨텍스트 엔지니어링 = 무엇을 볼 수 있게 책상에 올려두는가. 규칙 파일·메모리·MCP가 부상한 이유가 이것입니다 — 부록 영상 전반부가 정확히 이 주제입니다.

📎 비교 정리

사실MCP는 벤더 중립 표준이 됐다

2024년 11월 공개 → 2025년 12월 Linux Foundation 산하 재단에 기증. 2026년 3월 기준 SDK 월 9,700만 다운로드, 조사 대상 조직 41%가 프로덕션에서 MCP 서버 운영.

📎 MCP 개요 · 2026 현황 정리

C-4. 비개발자가 실제로 만든 것들

출처 선택에 대해
자영업자 개인 사례를 찾았지만 대부분 노코드 플랫폼의 판매용 콘텐츠였고 실명·수치·검증이 붙은 독립 보도를 확인하지 못했습니다. 그래서 Anthropic이 공개한 자사 비엔지니어링 팀 사례로 대체합니다 — 1차 자료이고 구체적입니다.

사실법무팀이 사내 안내 시스템을 직접 만들었다

“어느 변호사에게 연결해야 하는지” 안내하는 전화 안내 트리 프로토타입을 개발 자원 없이 직접 제작했습니다.

📎 How Anthropic teams use Claude Code

사실마케팅팀: 몇 시간 → 몇 분

CSV를 읽혀 저성과 광고를 골라내고 새 변형안을 자동 생성 — “몇 시간 걸리던 일이 몇 분으로”. 디자인 도구 플러그인으로 광고 변형 100개를 만들 때는 “복붙 몇 시간 → 배치당 0.5초”.

📎 같은 자료

관찰·주장공통 패턴 네 가지

대량 문서 처리 / 임시 데이터 분석 / 워크플로 자동화 / 작은 사내 도구 제작. 요약하면 “개발팀에 요청하기엔 사소하지만 무시하기엔 성가신 일” 영역입니다. 수강생에게 첫 과제를 정해줄 때 이 기준이 정확합니다.

📎 정리 기사

C-5. 실패는 이렇게 난다 (꼭 알아둘 것)

사실★ 20% 빨라졌다고 느꼈지만, 실제로는 19% 느렸다

숙련 개발자 16명·과제 246개 무작위 대조 실험 결과입니다. 체감과 실제가 반대로 나온 대표 사례로, 검증을 건너뛰면 이 착시가 굳습니다. (연구팀 스스로 “현재 도구를 반영하지 않은 과거 결과”라고 표기한 점도 함께 말해야 공정합니다.)

📎 METR 실험

사실★ “코드 한 줄 안 썼다”는 서비스가 3일 만에 정보 유출

2026년 1월, 창업자가 코드를 한 줄도 쓰지 않았다고 공언한 AI 서비스가 출시 3일 만에 프로덕션 데이터베이스를 통째로 노출했습니다. API 토큰 150만 개·이메일 3.5만 개·비공개 메시지가 유출됐고, 원인은 인증 키가 사용자 화면 쪽 코드에 노출되고 접근 보안 설정이 꺼져 있던 것이었습니다.

📎 Infosecurity Magazine

사실AI 코드의 결함률이 더 높다는 분석

오픈소스 PR 470건 분석에서 AI 생성 코드 결함이 사람 코드의 1.7배(특정 취약점은 최대 2.74배). 보안 담당자 62%가 “AI 코드 증가로 검토를 따라갈 수 없다”고 답했습니다.

📎 보도 정리

수업용 결론
속도는 진짜지만 검증을 빼면 사고가 남습니다. 그래서 부록 영상의 ‘검증 1분’ 코너와 “초안은 AI가, 도장은 사장님이”가 장식이 아니라 핵심입니다.

C-6. 한국은 지금

사실회사가 ‘쓸 줄 아냐’ 대신 ‘만들 줄 아냐’를 묻기 시작

현대글로비스 임직원 ‘AI 부트캠프’, 한화손해보험 사내 ‘AI 바이브코딩 경진대회’, 행정안전부 주최 공무원 대상 ‘AI 챔피언 해커톤’(자연어 코딩 방식으로 진입장벽 완화) 등.

📎 한국경제 보도

사실교육·채용 시장이 같이 움직인다

올해 1~5월 ‘AI’ 키워드 채용공고 약 1만5천 건(전년 대비 +70%, 신입 +80%). 한 교육 플랫폼의 바이브코딩 강의 판매량 +175%, 관련 매출 8억 → 22억 원.

📎 같은 기사

사실직장인 74.3%가 주 1회 이상 업무에 AI를 쓴다

국내 직장인 1,000명 조사(2026년 5월). 거의 매일 쓰는 비율 30.4%. 가장 효과적인 영역은 문서 요약·작성 31.2% + 자료 검색 27.3%로 절반 이상이 문서 업무입니다.

📎 나우앤서베이 리포트

인용하지 말 것
“한국 직장인 AI 활용률 61.5%로 동아시아 1위” 류의 수치가 블로그에 널리 돌지만 원 리포트·발표기관·시점이 확인되지 않습니다. 그대로 인용하지 마세요.

인쇄해서 옆에 두기

부록 · 치트시트 · 자주 묻는 질문

인쇄해서 옆에 두고 바로 꺼내 쓰는 것들입니다.

부록 1. 한 장 치트시트

① 단축키

키	하는 일
Esc	중단
Esc Esc	되감기 메뉴(입력창 비었을 때)
Shift+Tab	권한 모드 (기본=오토 · 윈도우에서 안 되면 Alt+M)
Alt+V	이미지 붙여넣기(윈도우)
Ctrl+J	줄바꿈
Alt+P	모델 전환
Ctrl+O	대화 전체 보기
?	단축키 도움말

📎 Interactive mode

② 매일 쓰는 명령 10개

명령	언제
`/init`	새 폴더에서 처음
`/clear`	주제가 바뀔 때
`/context`	느려졌다 싶을 때
`/rewind`	잘못 갔을 때
`/resume`	어제 것 이어서
`/model`	어려운 일 앞두고
`/effort`	결과가 얕을 때
`/memory`	기억 고칠 때
`/usage`	얼마 썼나
`/doctor`	뭔가 이상할 때

📎 Commands

③ 판단 기준

상황	선택
대답이 필요하다	챗봇
결과물(파일)이 필요하다	에이전트
항상 지킬 규칙	CLAUDE.md
가끔 하는 긴 절차	스킬
오탈자·색 바꾸기	가벼운 모델(sonnet) + 낮은 에포트
처음 짓는 것·중요한 설계	기본(opus) 그대로 + 에포트 medium부터, 얕으면 한 칸씩
기본으로 안 풀리는 어려운 문제	fable (⚠️ 요금제에 따라 추가 요금 — `/model` 표시 확인) 10월 개정
하나하나 확인하고 싶다	매뉴얼 모드(Shift+Tab → `manual mode on`)
큰 작업 시작 전	플랜 모드(Shift+Tab)
웹페이지 확인	“네가 브라우저 열어서 직접 확인해줘”

📎 Commands · Permission modes

부록 2. 자주 묻는 질문 34개

코드를 하나도 모르는데 정말 되나요?

됩니다. 다만 ‘코드를 안 봐도 된다’와 ‘아무것도 몰라도 된다’는 다릅니다. 무엇을 맡기고, 무엇이 완성인지 정하고, 결과를 확인하는 건 사람 몫입니다. 이 시리즈가 그 최소 지식입니다.

무료로 쓸 수 있나요?

클로드 코드는 유료 플랜(Pro·Max·Team·Enterprise)이나 API 계정이 필요합니다. 무료 Claude.ai 플랜으로는 실행되지 않습니다.

📎 Authentication

돈이 얼마나 나오나요? 10월 개정

구독(Pro·Max 등)은 요금제 한도 안에서 씁니다. 단 /model에 ‘Requires usage credits’가 붙은 모델(Fable 등)과 API(선불) 계정은 쓴 만큼 돈이 따로 나갑니다. 사용량은 /usage로 확인하고, 주제가 바뀔 때 /clear하는 습관이 큰 절약입니다.

📎 Manage costs

AI가 제 파일을 다 지우면 어떡하죠? 10월 개정

지금 기본인 오토 모드에선 AI 심사관이 위험해 보이는 행동 — 세션 전부터 있던 파일을 되돌릴 수 없게 지우기, 강제 푸시 등 — 을 막도록 되어 있습니다. 다만 AI 판단이라 놓칠 수 있고(공식 문서도 ‘안전 보장은 아님’), 이번 세션에서 새로 만든 파일은 이 보호 목록에 들지 않습니다. 더 확실히 하려면 Shift+Tab으로 매뉴얼 모드(⏸ manual mode on)로 바꾸세요. 수정·명령 실행마다 승인을 묻고, 시작한 폴더 밖은 승인 없이 건드리지 못합니다. 어느 쪽이든 중요한 자료는 사본을 두세요.

📎 Permission modes · Security

잘못됐을 때 되돌릴 수 있나요? 10월 개정

일부만 됩니다. 클로드가 직접 고친 파일은 지시할 때마다 자동 저장되고 /rewind로 돌아갑니다. 하지만 터미널 명령으로 지우거나 옮긴 파일, 서브에이전트가 고친 파일, 보낸 메일·배포처럼 밖으로 나간 일은 돌아오지 않으니 중요한 자료는 사본을 두세요.

📎 Checkpointing

설치했는데 ‘claude를 찾을 수 없다’고 나와요.

설치 폴더가 PATH에 없어서입니다. 윈도우는 사용자 폴더의 .local\bin을 PATH에 추가하면 됩니다.

📎 설치·로그인 문제 해결

로그인이 안 됩니다.

구독 상태를 먼저 확인하고, 예전에 API 키를 환경변수로 넣은 적이 있는지 보세요(그게 구독을 덮어씁니다). /logout 후 재실행도 자주 통합니다.

📎 설치·로그인 문제 해결

터미널이 무서운데 다른 방법 없나요? 10월 개정

데스크톱 앱의 Code 탭을 쓰면 터미널 없이 화면으로 씁니다. 보내기 버튼 옆 모드 선택에서 Manual을 고르면 변경마다 비교 화면을 보여주고 승인을 기다립니다.

📎 Desktop app

CLAUDE.md는 꼭 만들어야 하나요?

없어도 동작합니다. 다만 같은 설명을 매번 반복하고 있다면 그때가 만들 시점입니다.

📎 Memory (CLAUDE.md)

CLAUDE.md에 뭘 적어야 하죠?

역할(너는 무엇을 하는 사람인가), 기준(지우지 마라·큰 결정은 물어봐라), 말투·형식 같은 항상 지킬 것들입니다. 200줄을 넘기지 마세요.

📎 Memory (CLAUDE.md)

‘기억해줘’ 하면 어디에 저장되나요?

자동 메모리에 저장됩니다. 내 컴퓨터 안이고 /memory에서 열어 고치거나 끌 수 있습니다.

📎 Memory (CLAUDE.md)

회사 PC에서 가르친 걸 집에서도 쓸 수 있나요?

자동 메모리는 기기별로 따로 쌓입니다. 공유하려면 CLAUDE.md에 적어 파일로 만드세요.

📎 Memory (CLAUDE.md)

스킬은 개발자만 만드나요?

글로 쓰는 절차서입니다. “방금 한 작업 스킬로 저장해 줘”라고 시키면 형식에 맞춰 대신 써줍니다.

📎 Skills

플랜 모드는 왜 써요? 그냥 시키면 되지 않나요?

큰 작업에서 방향이 틀리면 되돌리는 비용이 큽니다. 계획을 먼저 보면 ‘동사·숫자·저장 위치’ 세 가지만 확인해도 사고를 막습니다.

📎 Best practices

Shift+Tab을 눌렀는데 화면이 달라요. 10월 개정

세션은 오토에서 시작하고, 누를 때마다 매뉴얼 → 편집 자동수락 → 플랜 → 다시 오토 순서로 돕니다. 계정·설정에 따라 순환에 들어오는 모드가 다르니 횟수 말고 화면 아래 글자(manual mode on·plan mode on 등)를 읽으세요. 윈도우에서 안 먹으면 Alt+M을 쓰세요.

📎 Permission modes

어떤 모델을 골라야 하나요? 10월 개정

평소 일은 기본값(Opus 5.5) 그대로도 잘 합니다. 다만 공식 비용 안내는 ‘대부분은 Sonnet, Opus는 복잡한 설계에’라서, 한도가 빠듯하면 가볍고 많은 일은 Sonnet 5.5로 낮추세요(Haiku는 에포트 조절·오토 모드를 지원하지 않습니다). 기본으로 안 풀리는 어려운 일에만 Fable 5.1 — 요금제에 따라 추가 크레딧이 들 수 있으니 /model 화면 표시를 확인하세요. 목록은 요금제·조직 설정에 따라 다릅니다.

📎 Model configuration · Manage costs

에포트를 항상 최고로 두면 안 되나요? 10월 개정

결과가 늘 좋아지진 않고 느리고 비싸집니다. 간단한 일에는 오히려 과하게 생각해 돌아갑니다. Opus 5.5·Sonnet 5.5는 medium이 기본이고, 최고 단계 max는 이번 세션에만 적용됩니다. 지금 값은 /effort status로 확인하세요.

📎 Model configuration

AI가 브라우저를 쓰는 게 안전한가요? 10월 개정

매뉴얼 모드에선 크롬 확장 설정에서 허용한 사이트에서만 클릭·입력합니다. 기본인 오토 모드에선 심사관이 승인하면 이 사이트별 확인을 건너뛰므로, 중요한 계정이 로그인된 크롬이라면 매뉴얼 모드로 쓰세요. 클로드는 ‘내 계정 그대로’ 움직입니다 — 보낸 메일·결제처럼 밖으로 나간 일은 /rewind로 돌아오지 않습니다. 심사관은 페이지 내용·쿠키·로그인 정보를 밖으로 보낼 수 있는 동작을 막고, 로그인 화면이나 캡차(사람인지 확인하는 문제)를 만나면 멈추고 사람에게 넘깁니다.

📎 Claude in Chrome

시연 영상 찍어서 공유해도 되나요?

주의하세요. 브라우저 녹화에는 로그인된 계정 정보가 그대로 담깁니다. 공유 전에 반드시 확인하세요.

📎 Claude in Chrome

대화가 길어지면 왜 느려지나요?

매 요청마다 전체 대화가 다시 전송되기 때문입니다. /context로 확인하고 주제가 바뀌면 /clear하세요.

📎 Context window

어제 하던 작업을 이어서 하려면?

터미널에서 claude --continue로 직전 것을, claude --resume으로 목록에서 골라 이어받습니다. 기록은 기본 30일 보관됩니다.

📎 Manage sessions

AI가 ‘다 됐습니다’ 하는데 안 된 것 같아요.

정상입니다. 선언과 완성은 다릅니다. 직접 열어보고, 눌러보고, 휴대폰에서도 되는지 확인하세요.

📎 Best practices

제가 코드를 못 읽는데 어떻게 검증하죠?

코드를 읽는 게 아니라 결과를 확인하는 겁니다. 실제로 동작하는지, 빠진 항목은 없는지, 내 기준에 맞는지 — 이 세 가지면 됩니다.

AI가 만든 걸 그대로 손님에게 써도 되나요?

위험합니다. 실제로 검증 없이 배포해 3일 만에 회원 정보가 유출된 사례가 있습니다. 개인정보를 다루면 반드시 전문가 검토를 받으세요.

MCP가 뭔가요? 꼭 써야 하나요?

외부 서비스를 연결하는 규격입니다. 다른 프로그램에서 데이터를 복사·붙여넣기 하고 있다면 그때 붙이면 됩니다. 당장은 몰라도 됩니다.

📎 MCP

훅은 뭔가요?

정해진 시점에 반드시 실행되는 자동 동작입니다. 비개발자에게는 난이도가 높으니 ‘이런 게 있다’ 정도만 알아두세요.

📎 Hooks guide

폰에서도 되나요? 10월 개정

Claude 앱의 Code 탭으로 진행 상황을 보고 지시할 수 있습니다. 실제 작업은 내 PC나 클라우드에서 돌아갑니다. 내 PC 세션을 폰에서 보려면 그 세션에서 /remote-control(줄여서 /rc)을 켜세요 — PC는 켜 둬야 하고, 알림도 이때 옵니다. /mobile은 앱 설치 QR 코드입니다.

📎 Mobile

코드 아닌 일에도 쓸 수 있나요?

됩니다. 문서·메모 폴더에서도 검색·편집·정리가 됩니다.

📎 Common workflows

AI가 거짓말을 하지는 않나요?

합니다. 그래서 확인 가능한 형태로 시키고(파일·테스트·화면) 결과를 직접 보는 습관이 필요합니다.

이거 배우면 개발자가 되는 건가요?

아닙니다. ‘일을 맡길 줄 아는 사람’이 되는 겁니다. 목표는 개발자 대체가 아니라, 개발팀에 요청하기엔 사소한 일을 스스로 해결하는 것입니다.

클로드가 기억한 내용(자동 메모리)은 실제 파일인가요? 파일명이 뭔가요?

네, 진짜 파일로 존재합니다. 내 컴퓨터 안 ~/.claude/projects/(프로젝트 폴더 이름)/memory/ 폴더에 목차 역할의 MEMORY.md와 주제별 낱장 노트 파일들(○○.md)로 저장됩니다. 일반 텍스트라 아무 편집기로도 열리지만, 고치거나 끌 때는 /memory 명령이 안전합니다. 헷갈리기 쉬운 구분 — CLAUDE.md는 ‘내가’ 클로드에게 써주는 지침서, 자동 메모리는 ‘클로드가’ 스스로 적는 업무 노트로 서로 다른 파일입니다. 자동 메모리는 그 컴퓨터 안에만 있어 기기 간 동기화가 되지 않으니, 공유하고 싶은 내용은 CLAUDE.md에 옮겨 적으세요.

📎 Memory (CLAUDE.md)

화면 아래에 ‘auto mode on’이 떠 있어요. 이게 뭔가요? 10월 개정

2026년 10월 기준 기본 권한 모드인 오토 모드입니다. 하나하나 묻는 대신 AI 심사관이 위험해 보이는 행동을 골라 막습니다(안전을 보장하지는 않습니다). 처음 오토로 시작할 때 안내 문구가 한 번 뜹니다. 하나하나 승인받고 싶으면 Shift+Tab을 눌러 manual mode on으로 바꾸세요.

📎 Permission modes

새 모델(Fable 5.1·Opus 5.5·Sonnet 5.5)이 목록에 안 보여요. 10월 개정

클로드 코드 버전이 낮아서일 가능성이 큽니다. Fable 5.1은 v2.1.257, Opus 5.5는 v2.1.280, Sonnet 5.5는 v2.1.284 이상이 필요합니다. claude --version으로 확인하고 claude update로 올리세요(Homebrew·WinGet 설치는 자동 업데이트가 안 되니 B-1 표의 명령으로). 요금제·조직 설정에 따라 목록 자체가 다를 수도 있습니다.

📎 Model configuration · Advanced setup

코덱스(Codex)를 쓰다 왔어요. AGENTS.md를 그대로 쓸 수 있나요? 10월 개정

네. 클로드 코드 v2.1.277부터 작업 폴더에 CLAUDE.md가 없으면 AGENTS.md를 대신 읽습니다(개인용 CLAUDE.local.md 하나만 있어도 안 읽으니 주의). 설정까지 옮기려면 /import로 코덱스의 지침 파일·MCP·스킬 등을 가져오세요. 두 도구를 나란히 비교하려면 자매편 「코덱스 정석」을 보세요.

📎 Memory — AGENTS.md