부록
막혔을 때 던지는 만능 질문
VS Code 채팅창에 그대로 보내면 됩니다.
오류가 났을 때
이게 무슨 뜻이야? 어떻게 해? [오류 글자 붙여 넣기]
무슨 일인지 모를 때
방금 한 일을 컴퓨터 처음 쓰는 사람도 알아듣게 설명해 줘.
큰 일을 맡길 때
만들기 전에 95% 확신이 들 때까지 하나씩 물어봐.
한꺼번에 하면 헷갈릴 때
한 단계씩 나눠서 하고, 단계마다 결과를 보여 주고 확인받은 다음 넘어가 줘.
마음에 안 들 때
방금 바꾼 파일을 바꾸기 전으로 되돌려 줘. 무엇을 되돌렸는지 알려 줘.
같은 오류가 또 날 때
이 오류가 다시 안 나게 하려면 뭘 바꿔야 해? 바꾸기 전에 이유부터 설명해 줘.
오류 사전
설치와 Claude Code
| 이런 글이 나오면 | 뜻 | 할 일 |
|---|---|---|
claude을(를) 찾을 수 없음, command not found | 터미널용 Claude Code가 없거나 창이 설치 전 것 | 창을 닫고 새 창에서 다시. 그래도 안 되면 준비 5번 다시 |
| 비서 창: 터미널용 Claude Code를 찾지 못했습니다 | 비서가 부를 Claude가 없음 | 준비 5번을 하고 비서를 다시 켜기 |
| 사용량 한도에 닿았다는 안내 | Pro 요금제는 5시간 단위로 사용량이 다시 채워짐 | 안내된 시각까지 기다리기. 그동안 비서 창은 닫아 두기 |
| 모델 이름이 Opus 5.5가 아님 | 다른 모델이 골라져 있음 | 채팅창 아래 모델 이름을 눌러 Opus 5.5로 |
| 탭 제목 옆 흰 점 | 파일을 저장하지 않음 | Ctrl+S (Mac은 ⌘+S) |
Slack
| 이런 글이 나오면 | 뜻 | 할 일 |
|---|---|---|
not_authed, invalid_auth | 토큰이 비었거나 틀렸거나 저장을 안 함 | .env에 토큰을 다시 붙여 넣고 Ctrl+S |
account_inactive, token_revoked | 앱이 지워졌거나 다시 설치되어 예전 토큰을 못 씀 | OAuth & Permissions에서 새 토큰을 복사해 .env에 |
not_in_channel | 비서가 그 채널에 없음 | 그 채널에서 /invite @english-assistant |
missing_scope | 권한이 빠졌거나 추가한 뒤 다시 설치를 안 함 | 권한 추가 → 위쪽 노란 안내에서 다시 설치 |
channel_not_found | 채널 이름이 다르거나 비서가 없음 | 비서설정.txt의 채널 이름과 초대 확인 |
ratelimited | Slack이 잠깐 쉬라고 함 | 1분 기다리기 |
| 파일 내려받기 실패 | 사진을 가져올 권한이 없음 | files:read 권한 추가 → 다시 설치 |
| 매니페스트에서 display_name 오류 | 봇 이름에 한글이나 띄어쓰기가 있음 | display_name은 영어 소문자와 하이픈으로 |
비서와 PDF, 인쇄
| 이런 일이 생기면 | 뜻 | 할 일 |
|---|---|---|
| 👀만 붙고 ✅가 안 붙음 | 아직 만드는 중이거나 멈춤 | 10분 기다리기. 15분이 지나면 비서가 스스로 멈추고 이유를 스레드에 남김 |
| ❌가 붙음 | 만들지 못함 | 스레드의 이유를 읽고, 그 글을 Claude에게 붙여 넣어 묻기 |
| 아무 반응이 없음 | 비서 창이 닫혔거나, 내 글이 아니거나, 채널에 비서가 없음 | 비서 창, .env의 SLACK_OWNER_ID, 채널 초대 확인 |
| PDF를 만들지 못했습니다 | Edge나 Chrome을 못 찾음 | Chrome 설치 |
| 학습지 한글이 네모로 깨짐 | 서체 파일 경로가 틀림 | 학습지 서체 경로를 DESIGN.md대로 고쳐서 다시 만들어 줘 |
| 인쇄 꺼짐 | 인쇄 설정이 꺼져 있음 | 비서설정.txt의 PRINT_ENABLED=yes |
| 오늘 인쇄 한도를 넘습니다 | 하루 장수 제한 | 다음 날 자동으로 풀림. 늘리려면 PRINT_DAILY_LIMIT |
| 인쇄 실패 (Windows) | 기본 PDF 앱이 인쇄 명령을 못 받음 | 무료 SumatraPDF 설치 |
| Mac: 확인되지 않은 개발자 | 처음 여는 실행 파일 | Control 키를 누른 채 클릭 → 열기 |
| Mac: permission denied | 실행 권한이 없음 | 바탕화면의 비서 켜기 파일에 실행 권한을 줘 |
폰과 Remote Control
| 이런 일이 생기면 | 뜻 | 할 일 |
|---|---|---|
| 폰 Claude 앱에 내 세션이 안 보임 | VS Code가 닫혔거나 다른 계정 | VS Code를 켜고 /remote-control 다시. 폰과 같은 계정인지 확인 |
| 노트북을 덮었더니 끊김 | 컴퓨터가 잠듦 | 전원을 꽂고 덮지 않기. 깨어나면 다시 연결됨 |
용어
| 말 | 뜻 |
|---|---|
| 바이브 코딩 | 코드를 직접 쓰지 않고, 원하는 것을 말로 설명해 AI가 만들게 하는 방식 |
| Claude Code | 내 컴퓨터의 파일을 읽고 만들고 실행까지 하는 Claude |
| VS Code | Claude Code를 쓰는 작업 화면. 무료 |
| 확장 | VS Code에 기능을 더하는 추가 프로그램 |
| 터미널 | 글자만 있는 명령 창. Windows는 PowerShell, Mac은 터미널 |
| 작업 폴더 | 이번 수업의 모든 파일이 들어가는 폴더 (english-assistant) |
| CLAUDE.md | Claude가 이 폴더에서 일할 때마다 먼저 읽는 설명서 |
| 스킬 | 자주 하는 일을 저장해 둔 명령어. 예: /study-set |
| DESIGN.md | 색, 서체, 여백 규칙을 적어 둔 디자인 설명서 |
| 학습 기록부 | 단어장, 실수 장부, 학습 일지, 다음 팁. 비서와 내가 같이 읽고 쓰는 기록 |
| 워크스페이스 | 나만 쓰는 Slack 공간 |
| 채널 | 워크스페이스 안의 대화방. #자료함, #학습세트, #제출함 |
| 스레드 | 메시지 아래에 달리는 답글 묶음 |
| 앱, 봇 | Slack에 들어와 대신 일하는 프로그램. 여기서는 '내 영어 비서' |
| 매니페스트 | Slack 앱 설계도. 이름과 권한이 적혀 있음 |
| 권한(스코프) | 앱이 할 수 있는 일의 목록. 필요한 것만 준다 |
| 토큰 | 앱이 Slack에 들어갈 때 쓰는 비밀 열쇠. .env에만 둔다 |
| 허락 목록 | 비서가 묻지 않고 해도 되는 일. 나머지는 묻지 않고 거절 |
| Remote Control | 폰 Claude 앱으로 집 컴퓨터의 Claude Code를 조종하는 기능 |
| 아티팩트 | Claude가 만든 웹페이지. 기본은 나만 보기 |
| 예약 메시지 | 정해 둔 시각에 Slack이 대신 보내는 메시지. 컴퓨터를 꺼도 온다 |
Slack 권한표
이번 비서가 쓰는 권한은 위쪽 여섯 개입니다. 아래는 업무용 봇을 만들 때 자주 쓰는 권한입니다. 필요한 것만 더하세요.
| 권한 | 할 수 있는 일 | 언제 필요 |
|---|---|---|
chat:write | 초대받은 채널에 메시지 보내기 | 알림, 답글 (이번 비서) |
files:write | 파일 올리기 | 학습지 PDF (이번 비서) |
files:read | 올라온 파일 내려받기 | 손글씨 사진 (이번 비서) |
channels:history | 초대받은 공개 채널의 글 읽기 | #자료함, #제출함 확인 (이번 비서) |
channels:read | 공개 채널 목록 보기 | 채널 찾기 (이번 비서) |
reactions:write | 이모지 반응 달기 | 👀, ✅ (이번 비서) |
chat:write.public | 초대받지 않은 공개 채널에도 보내기 | 여러 채널에 공지하는 봇 |
groups:history, groups:read | 초대받은 비공개 채널 읽기, 목록 보기 | 비공개 채널에서 쓰는 봇 |
im:history, im:write | 봇과 나누는 1:1 메시지 읽고 쓰기 | DM으로 일을 시키는 봇 |
users:read | 멤버 이름과 프로필 보기 | 사람 이름을 넣어 보고서를 쓰는 봇 |
reactions:read | 이모지 반응 읽기 | 이모지로 승인받는 봇 |
권한을 더하면 앱을 다시 설치해야 하고, 다시 설치하면 토큰이 바뀔 수 있습니다. 바뀌었으면 .env에 새 토큰을 넣으세요.
DESIGN.md 받는 곳
| 곳 | 무엇이 있나 | 쓰는 범위 |
|---|---|---|
| getdesign.md | 유명 서비스의 웹 디자인을 본뜬 DESIGN.md 모음 | 개인 학습용. 그 회사 로고와 이름은 쓰지 않는다 |
| designmd.app | 미니멀, 레트로, 잡지풍 같은 스타일별 DESIGN.md | 파일마다 적힌 사용 조건 확인 |
| Google Stitch | 내가 만든 화면에서 DESIGN.md를 뽑아냄 | 내 디자인이니 자유롭게 |
받은 파일을 작업 폴더 맨 위에 DESIGN.md라는 이름으로 두고 아래처럼 보냅니다.
받은 디자인 입히기
DESIGN.md의 디자인으로 학습지를 다시 만들어 줘. 서체는 무료 한글 서체로 바꾸고, 인쇄했을 때 손글씨 줄이 잘 보이게 해 줘.
예산 사다리
0원으로 시작하고, 재미와 효과를 느낀 다음 필요한 만큼만 올리세요.
| 단계 | 추가 비용 | 할 수 있는 것 | 한계 |
|---|---|---|---|
| 0단계 · 오늘 수업 | 0원 (Claude Pro 구독만: 월 20달러, 1년 결제 시 월 17달러) | 바탕화면 비서, Slack 무료, 관제실 아티팩트, 집 프린터, 폰으로 조종. 복습 카드는 예약 메시지라 컴퓨터를 꺼도 옴 | 컴퓨터가 켜져 있고 비서 창이 열려 있어야 새 일을 함. Pro 사용량 한도(5시간 단위) |
| 1단계 · 컴퓨터를 꺼도 | 0원~월 몇천 원 | Claude 루틴(구독에 포함, 클라우드에서 1시간 이상 간격으로 실행, GitHub 무료 계정 필요). 공개 자료실은 Cloudflare 무료 주소 | 클라우드는 집 프린터를 못 씀. 인쇄는 집 컴퓨터 몫 |
| 2단계 · 하루 종일 | 월 1만 원 안팎부터 | 늘 켜 두는 컴퓨터(안 쓰는 노트북이면 0원, 미니 PC는 20~40만 원)로 비서와 프린터를 24시간. 웹 업로드 화면. 앱 10개 한도나 90일 기록 제한이 불편하면 Slack Pro. 많이 쓰면 Claude Max(월 100달러부터). 내 도메인(연 1~2만 원대) | 매일 쓰는 분만 올라오면 됩니다 |