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

먼저 읽기

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 — 매 세션 자동으로 읽히는 유일한 파일

CLAUDE.mdproject memory

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

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

나한테 왜 필요한가 대화가 길어져 압축이 일어나도 디스크에서 다시 읽어옵니다. 그래서 '끝까지 살아남는 지시'는 이것뿐입니다.

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

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

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

📎 Memory (CLAUDE.md)

/init

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

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

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

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

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

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

📎 Memory (CLAUDE.md)

자동 메모리auto memory

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

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

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

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

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

📎 Memory (CLAUDE.md)

정정 — '#'으로 메모리 추가
인터넷에 #을 앞에 붙여 메모리를 추가한다는 설명이 돌지만, 공식 문서에서 확인되지 않았습니다(두 차례 교차 확인). 문서가 안내하는 방법은 ①“기억해줘”라고 말하기 ②“CLAUDE.md에 추가해줘”라고 시키기 ③/memory에서 직접 편집 — 이 세 가지입니다. 영상에서 언급하지 마세요.

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

스킬skill

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

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

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

한 번 호출된 스킬 본문은 그 세션 내내 남습니다(매 턴 다시 읽지 않음).

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

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

📎 Skills

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

	CLAUDE.md	스킬(SKILL.md)
언제 읽히나	매 세션 시작 시 항상	그 일을 할 때만
적을 것	항상 지켜야 할 규칙·말투·금지사항	가끔 하는 긴 절차
길면	매번 비용 + 중요한 규칙이 묻힘	부담 거의 없음
권장 분량	200줄 미만	제한 없음(중요한 지시는 위쪽에)

📎 Memory (CLAUDE.md) · Skills

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

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

기본값은 읽기 전용입니다. 파일 수정·명령 실행은 그때그때 승인을 요구하고, ls·cat·git status 같은 읽기 전용 명령만 묻지 않고 실행합니다.
작업 디렉터리 경계 — 시작한 폴더와 그 하위에만 쓸 수 있고, 상위 폴더는 별도 승인 없이 건드리지 못합니다.
읽기 도구(Read·Grep·Glob)조차 작업 폴더 밖 경로면 확인을 요구합니다.

프롬프트 인젝션prompt injection

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

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

나한테 왜 필요한가 그래서 curl·wget처럼 웹에서 뭔가 가져오는 명령은 자동 승인 대상이 아닙니다.

⚠️ 틀리기 쉬운 지점 최종 방어선은 사람입니다 — 승인 전에 제안된 명령을 읽는 습관. 공식 문서도 “클로드 코드는 당신이 부여한 권한만 갖는다”고 못박습니다.

📎 Security

MCP는 감사받지 않는다
외부 도구를 붙이는 MCP 서버는 Anthropic이 보안 감사하지 않습니다. 직접 만들었거나 신뢰하는 제공자의 것만 쓰라고 공식 문서가 명시합니다. 📎 Security

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

체크포인트checkpointing

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

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

나한테 왜 필요한가 되돌릴 수 있으니 과감하게 시켜도 됩니다. 이게 비개발자에게 가장 큰 심리적 안전장치입니다.

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

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

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

⚠️ 틀리기 쉬운 지점 추적하지 않는 것 — ①터미널 명령(rm·mv·cp)이 바꾼 파일 ②서브에이전트가 한 편집 ③내가 다른 프로그램에서 직접 고친 것 ④심볼릭 링크 경로. 공식 문서는 체크포인트를 “로컬 실행취소”, Git을 “영구 기록”이라 부르며 버전관리를 대체하지 않는다고 명시합니다.

📎 Checkpointing

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

권한 모드permission mode

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

비유 신입에게 “하나하나 물어봐” / “편집은 알아서 해” / “계획만 가져와”를 정해주는 것.

나한테 왜 필요한가 Shift+Tab으로 바꿉니다. 기본 순환은 세 가지 — 기본(default) → 편집 자동수락(acceptEdits) → 플랜(plan).

전체는 여섯입니다 — 기본 / 편집 자동수락 / 플랜 / 오토(auto) / 사전승인만(dontAsk) / 전부 통과(bypassPermissions). 뒤의 셋은 기본 순환에 없습니다.

플랜 모드는 파일을 건드리지 않고 계획만 세웁니다. 승인해야 실제 작업이 시작됩니다.

⚠️ 틀리기 쉬운 지점 ★주의 — 교재 시뮬레이터는 auto → plan으로 보여주지만, 기본 설정에서는 acceptEdits가 먼저 나옵니다. 내 화면을 미리 확인하세요. 윈도우에서 Shift+Tab이 안 먹으면 Alt+M.

📎 Permission modes · Interactive mode

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

	무엇을 정하나	비유	언제 올리나
`/model`	누구에게 맡길지	수석 설계사 / 실무 에이스 / 빠른 막내	처음 짓는 것, 중요한 설계
`/effort`	얼마나 깊이 생각할지	“대충 보고” vs “충분히 검토하고”	결과가 얕게 느껴질 때 한 칸씩

📎 Commands · Manage costs

모델 이름은 계속 바뀝니다
라인업은 몇 달 단위로 갱신되고, 요금제·조직 설정에 따라 보이는 목록도 다릅니다. 그래서 이름·숫자 대신 ‘급’으로 익혀두는 게 오래갑니다. /model·/effort를 눌러 내 화면 선택지를 먼저 확인하세요. 모델 전환 단축키는 Alt+P(맥 Option+P).

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

Claude in Chrome크롬 확장

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

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

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

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

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

Plan 모드에서는 읽기 전용 동작만 승인 없이, 클릭·입력·이동은 승인을 요구합니다.

⚠️ 틀리기 쉬운 지점 ①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`	자동 업데이트됨
윈도우 WinGet	`winget install Anthropic.ClaudeCode`
맥 Homebrew	`brew install --cask claude-code`
확인	`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 설치 권장(데스크톱 앱 Code 탭은 필수).
로그인은 프로젝트 폴더에서 claude 실행 → 브라우저 인증. 세션 안에서 /login·/logout.
★함정: 예전에 ANTHROPIC_API_KEY 환경변수를 넣어둔 적이 있으면 구독보다 그게 우선이라 엉뚱한 오류가 납니다. /status로 확인.

설치·로그인이 안 될 때

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

📎 설치·로그인 문제 해결

B-2. 작동 원리와 도구

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

비개발자가 알아야 할 도구 6종과 권한 확인 여부

도구	하는 일	승인 필요?
Read	파일 읽기	아니오(작업 폴더 밖이면 예)
Glob · Grep	파일 찾기 · 내용 검색	아니오(밖이면 예)
Edit · Write	파일 수정 · 새로 쓰기	예
Bash · PowerShell	명령 실행	예(읽기 전용 명령은 예외)
WebSearch · WebFetch	웹 검색 · 페이지 읽기	예
Agent	서브에이전트에 위임	아니오

📎 Tools reference

이 표가 “AI가 내 컴퓨터에서 뭘 할 수 있나”에 대한 가장 정확한 답입니다. 읽는 건 자유롭게, 바꾸는 건 허락받고 — 한 줄로 이렇게 설명하면 됩니다.

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

꼭 외울 단축키

키	하는 일
Esc	클로드 중단(하던 일 멈춤)
Esc Esc	입력창이 비어 있으면 되감기 메뉴 / 글자가 있으면 입력 지우기
Shift+Tab	권한 모드 순환 (윈도우에서 안 되면 Alt+M)
Alt+V (맥 Cmd+V)	클립보드 이미지 붙여넣기 — 윈도우는 Ctrl+V가 아님
Ctrl+J	줄바꿈(Enter는 전송)
Alt+P (맥 Option+P)	모델 전환
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선

① 시작·설정

명령	하는 일
`/init`	이 폴더의 CLAUDE.md 초안 만들기
`/model`	모델 바꾸기(기본값으로 저장됨)
`/effort`	고민의 깊이 조절
`/login` `/logout`	계정 로그인·로그아웃
`/help`	도움말
`/config`	설정 화면

📎 Commands

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

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

📎 Commands

③ 일 시키는 방식

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

📎 Commands

④ 점검 (문제 생겼을 때)

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

📎 Commands · Debug your config

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)이 일어납니다.

📎 Context window

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

습관	왜
주제가 바뀌면 `/clear`	오래된 맥락이 매 메시지마다 비용을 발생시킴
일에 맞는 모델 고르기	대부분의 일은 중간급으로 충분
CLAUDE.md는 짧게, 긴 절차는 스킬로	CLAUDE.md는 매번 로드, 스킬은 필요할 때만

📎 Manage costs

오래 켜둔 세션은 가만히 있어도 사용량이 계속 늘어납니다(전체 대화가 매 요청마다 전송되므로). 쓰던 작업이 끝나면 /clear하거나 창을 닫는 습관이 돈을 아낍니다. 📎 Costs

/goal

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

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

나한테 왜 필요한가 밤새 돌려두는 식의 작업에 씁니다. 조건은 측정 가능하게 쓰고 “20턴 지나면 멈춰” 같은 상한을 넣는 게 안전합니다.

📎 /goal

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

어디서 쓸 수 있나

창구	특징	비개발자 관점
데스크톱 앱	Claude 앱의 Code 탭. 터미널·Node 설치 불필요, 변경 전 diff를 보여주고 승인 대기	설치 장벽이 가장 낮음. 윈도우는 Git for Windows 필요
VS Code 확장	나란히 비교 diff, 계획을 문서로 열어 코멘트	편집기를 이미 쓰는 사람에게
웹(claude.ai/code)	클라우드에서 실행, 브라우저 닫아도 유지. GitHub 연결 필요	내 PC가 꺼져 있어도 되는 작업
모바일	Claude 앱의 Code 탭 = 조종기. 내 PC 세션을 폰에서 조종하거나 클라우드 세션 확인	이동 중 진행 확인·알림

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

설정은 공유됩니다
데스크톱 앱과 터미널은 같은 엔진이고 CLAUDE.md·MCP·훅·스킬 설정을 공유합니다. 동시에 켜둬도 됩니다. 즉 터미널에서 만든 규칙 파일이 데스크톱에서도 그대로 적용됩니다. 📎 Desktop

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

검증 수단을 쥐여줘라 — 합격/불합격이 나오는 검사를 주면 스스로 돌려보고 고친다. “됐습니다”가 아니라 증거를 요구하라.
탐색 → 계획 → 구현 — 큰 작업은 플랜 모드로 먼저 읽고 계획하게 하고, 승인 후 구현.
구체적으로 지시 — 어떤 파일, 어떤 상황, ‘고쳐진 상태’가 무엇인지 지목.
CLAUDE.md는 짧게 — 길면 정작 중요한 규칙이 묻혀 무시된다.
컨텍스트가 1순위 자원 — 무관한 작업 사이엔 /clear.
조사는 서브에이전트에 — 자료 더미가 본 대화를 오염시키지 않게.
빨리 궤도수정 — 두 번 고쳐도 안 되면 /clear 후 더 나은 지시로 다시 시작.

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

문제 생겼을 때 순서

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

📎 Troubleshooting · Debug your config

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

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

조직 관리 — 회사 전체 정책·중앙 설정·사용량 분석 (admin-setup, analytics)
게이트웨이·클라우드 — 아마존/구글/마이크로소프트 인프라 경유 (gateways, amazon-bedrock 등)
Agent SDK — 프로그램 안에 에이전트를 넣어 개발 (agent-sdk)
플러그인 제작 — 기능을 만들어 배포 (plugins)
에이전트 팀·워크플로우 — 여러 세션을 동시에 조율 (agent-teams, 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
가끔 하는 긴 절차	스킬
오탈자·색 바꾸기	가벼운 모델 + 낮은 에포트
처음 짓는 것·중요한 설계	좋은 모델 + 높은 에포트
큰 작업 시작 전	플랜 모드(Shift+Tab)
웹페이지 확인	“네가 브라우저 열어서 직접 확인해줘”

📎 Commands · Permission modes

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

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

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

무료로 쓸 수 있나요?

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

📎 Authentication

돈이 얼마나 나오나요?

구독이면 플랜 한도 안에서 씁니다. 사용량은 /usage로 확인하고, 주제가 바뀔 때 /clear하는 습관이 가장 큰 절약입니다.

📎 Manage costs

AI가 제 파일을 다 지우면 어떡하죠?

기본은 읽기 전용이고, 수정·명령 실행은 그때그때 승인을 요구합니다. 시작한 폴더 밖은 별도 승인 없이 건드리지 못합니다.

📎 Security

잘못됐을 때 되돌릴 수 있나요?

네. 지시할 때마다 자동 저장되고 /rewind로 돌아갑니다. 단 터미널 명령으로 지운 파일은 복구되지 않으니 중요한 자료는 사본을 두세요.

📎 Checkpointing

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

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

📎 설치·로그인 문제 해결

로그인이 안 됩니다.

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

📎 설치·로그인 문제 해결

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

데스크톱 앱의 Code 탭을 쓰면 터미널 없이 화면으로 씁니다. 변경 전 비교 화면을 보여주고 승인을 기다립니다.

📎 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을 눌렀는데 화면이 달라요.

설정에 따라 순환에 들어오는 모드가 다릅니다. 기본은 기본 → 편집 자동수락 → 플랜입니다. 윈도우에서 안 먹으면 Alt+M을 쓰세요.

📎 Permission modes

어떤 모델을 골라야 하나요?

대부분은 중간급으로 충분합니다. 처음 짓는 것·중요한 설계에만 가장 강력한 걸 쓰세요. 목록은 요금제에 따라 다릅니다.

📎 Manage costs

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

결과가 늘 좋아지진 않고 느리고 비싸집니다. 간단한 일에는 오히려 과하게 생각해 돌아갑니다.

AI가 브라우저를 쓰는 게 안전한가요?

허용한 사이트에서만 동작하고, 클릭·입력 같은 상태 변경은 승인을 요구합니다. 로그인 화면이나 캡차를 만나면 멈추고 사람에게 넘깁니다.

📎 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

폰에서도 되나요?

Claude 앱의 Code 탭으로 진행 상황을 보고 지시할 수 있습니다. 실제 작업은 내 PC나 클라우드에서 돌아갑니다.

📎 Mobile

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

됩니다. 문서·메모 폴더에서도 검색·편집·정리가 되고, 실제로 문서 업무가 가장 많이 쓰이는 영역입니다.

📎 Common workflows

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

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

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

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