부록
부록 D · 막힐 때 대처표
본문의 함정 표를 한 곳에 모았습니다. 증상으로 찾으세요. 5분 넘게 혼자 씨름하지 않습니다.
어디서든 첫 번째는 같습니다. 오류를 통째로 복사(또는 캡처)해서 Claude에게 붙여넣고 "원인 설명하고 고쳐줘." 그다음 이 표를 봅니다.
채팅 Claude (1·2부)
| 증상 | 먼저 해볼 것 |
|---|---|
| 무료 한도에 닿았다 | 고장 아님. 시간이 지나면 풀립니다. 받은 답을 검토하며 기다리기 |
| 파일 첨부가 안 된다 | 내용을 복사해 붙여넣기. 대부분 같은 일을 할 수 있음 |
| 답이 자꾸 엉뚱해진다 | 대화가 길어진 것. 배경 2~3줄 정리해 새 대화 |
| 같은 질문에 답이 다르다 | 정상. 중요한 답은 교차검증 (4장) |
| 저장했더니 이름.md.txt | 파일 형식 '모든 파일'로 다시 저장 |
| .md 열었더니 한글이 깨진다 | 저장할 때 인코딩 UTF-8 |
| 확장자가 안 보인다 | 탐색기 보기 → 표시 → 파일 확장명 |
| Skill 올리기 오류 | ZIP 안에 폴더가 먼저, 그 안에 SKILL.md. 폴더째 다시 압축 |
| Skill을 올렸는데 안 쓴다 | description에 '언제 쓰는지' 넣기. 이름을 불러 요청 |
| 스킬 메뉴가 없다 | 설정 → 기능 → '코드 실행 및 파일 생성' 켜기 |
| 지침을 안 지킨다 | 방 안 vs 방 밖 비교. 없는 규칙이면 한 줄 추가, 7개 넘으면 정리 |
설치 (10장)
| 증상 | 원인 → 해결 |
|---|---|
| Git·bash를 찾을 수 없다 | Git 미설치 → git-scm.com에서 설치 후 VS Code 재시작 |
| 한글이 깨지거나 경로 오류 | 폴더 이름에 한글·공백 → 영문 이름으로 |
| 파일이 사라지거나 동기화 충돌 | OneDrive 안의 폴더 → C:\work 같은 곳에 새로 |
| 압축 풀었는데 파일이 안 보임 | 폴더가 한 겹 더 → 안쪽 폴더를 열기 |
| Claude 아이콘이 안 보인다 | Ctrl+Shift+P → Developer: Reload Window |
| 'Not logged in' | Reload Window. Pro 결제한 계정인지 확인 |
| Code 탭이 업그레이드를 요구한다 | 무료 플랜. Claude Code는 Pro부터 |
| 이름 비슷한 확장이 여러 개 | 만든 곳 'Anthropic' 확인 |
| 회사 노트북에서 설치가 막힌다 | 보안 정책. 회사에 설치 권한 문의, 안 되면 개인 노트북 |
Claude Code 작업 (10·11·15장)
| 증상 | 먼저 해볼 것 | 그래도 안 되면 |
|---|---|---|
| 패널이 안 열린다 | VS Code 재시작 → 다시 로그인 | 10장 설치 다시 |
| 엉뚱한 폴더에 파일이 생긴다 | 창 제목의 폴더 이름 확인 | 파일 → 폴더 열기로 다시 |
| 만든 파일이 어디 있는지 모르겠다 | "방금 만든 파일 어디 있어? 여는 법도" | 파일 우클릭 → 파일 탐색기에 표시 |
| 만든 화면이 하얗게 비어 있다 | 캡처 + "빈 화면이 나와" | "다른 방법으로 다시 만들어줘" |
| 승인 창이 계속 뜬다 | 모드를 Edit automatically로 | /permissions로 허용 목록 |
| 고칠수록 더 이상해진다 | "마지막으로 잘 되던 상태로 되돌려줘" | 새 대화에서 @기획.md부터 |
| 같은 문제를 세 번 고쳐도 또 난다 | "요구사항은 그대로, 다른 방법으로" | 새 대화 + 더 구체적인 첫 요청 |
| Claude가 API 키를 넣으라고 한다 | 멈추고 "키 없이 되는 방법으로" | v4로 예약 (18장) |
| CLAUDE.md 규칙을 안 지킨다 | 파일이 길거나 문장이 애매. 줄이기 | 그 줄만 IMPORTANT, 또는 훅 |
GitHub (12장)
| 화면에 보이는 말 | 뜻 → 이렇게 말하기 |
|---|---|
| 로그인 창이 안 보이고 멈춤 | 창이 뒤에 숨음 → 작업 표시줄 확인, 없으면 오류 복사 |
| Author identity unknown | 이름·이메일 미설정 → "Git 이름·이메일 설정해줘" |
| rejected · fetch first | 창고에 README가 이미 있음 → "원격 내용과 합쳐 다시 올려줘" |
| Repository not found | 주소 오타·다른 계정 → 저장소 주소 다시 복사 |
| 저장소에 파일이 안 보임 | 다른 폴더를 올림 → 창 제목의 폴더 이름 확인 |
| push가 실패한다 | 에러 전체 복사 → Claude에게. 로그인 상태 확인 |
| 비밀 파일을 올려 버렸다 | 파일 삭제로 끝이 아님. 키를 새로 발급해 교체하고 저장소에서 제거 |
Vercel (12장)
| 증상 | 해결 |
|---|---|
| 저장소가 목록에 안 보인다 | 권한 설정에서 이 저장소 허용 |
| 배포 실패 | Settings → Build and Deployment → Framework Preset을 Other로 → 다시 배포 |
| 주소에서 옛 화면이 보인다 | 브라우저 캐시. 잠시 뒤 새로고침 |
| 그래도 안 바뀐다 | Vercel 배포 목록에 새 줄이 있는지 확인. 없으면 push가 안 된 것 |
| 배포 목록에 오류 표시 | 그 배포를 눌러 나온 로그를 통째로 Claude에게 |
| 회사 조직 계정의 비공개 저장소 | 무료 요금제로 공개 안 됨. 개인 계정으로 연습 |
| 회사·상품 사이트로 운영하려 한다 | 무료(Hobby)는 비상업 전용. 유료 요금제 검토 |
휴대폰 화면 (11장)
| 증상 | 해결 |
|---|---|
| 폰에서 글자가 깨알 같다 · 옆으로 밀린다 | 11장 휴대폰 화면 요청문. 캡처해서 "여기가 겹쳐" |
| PC에서 전화 버튼이 반응 없다 | 정상. 공개 후 폰에서 확인 |
| 폰에서만 이상하다 | 폰 화면 캡처를 PC로 보내 Claude에게 붙여넣기 |
그래도 안 되면
- 이 표와 본문의 함정 표를 다시 봅니다
- "이 방법은 막혔어. 요구사항은 그대로, 다른 방법으로"
- 사람에게 묻습니다 — 캡처 + 무엇을 하다가 + Claude가 뭐라고 했는지
막힌 채 제출도 제출입니다. 어디까지 왔고 무엇에 막혔는지가 가장 좋은 공유입니다.