| /notice | 가정통신문 (커스텀 Skill) | 학부모 안내 |
| /feedback | 학생 피드백 (커스텀 Skill) | 개별 피드백 작성 |
| /weekly-report | 주간보고 (커스텀 Skill) | 주간 학습 보고 |
| claude -p "명령" | 대화 없이 한 줄 실행 | 반복 자동화 |
| --dangerously-skip-permissions | YOLO Mode (승인 생략) | 대량 파일 생성 (안전한 환경에서만) |
Cowork 관련 5개
| 명령어/기능 | 설명 | 사용 상황 |
|---|---|---|
| Scheduled Tasks | 예약 실행 작업 | 매주 반복 업무 |
| Dispatch | 폰에서 PC로 원격 요청 | 이동 중 작업 지시 |
| Remote Control | 실행 중 세션 이어받기 | 자리 비운 뒤 확인 |
| Channels | 외부 이벤트 수신 | 알림 기반 반응 |
| Projects | 배경 자료 관리 | 교육과정, 참고 자료 |
부록 D: 트러블슈팅 + FAQ 통합 (25선)
설치/실행 오류 15선
| # | 증상 | 원인 | 해결 방법 |
|---|---|---|---|
| 1 | npm: command not found | Node.js 미설치 | nodejs.org에서 LTS 버전 설치 |
| 2 | permission denied (Mac/Linux) | 권한 부족 | sudo npm install -g @anthropic-ai/claude-code |
| 3 | EACCES 오류 (npm) | npm 글로벌 폴더 권한 | npm config set prefix ~/.npm-global 후 PATH 추가 |
| 4 | claude: command not found | 설치 후 PATH 미등록 | 터미널 재시작 또는 PATH에 npm 경로 추가 |
| 5 | 인증 오류 (API key) | API 키 미설정 또는 만료 | claude auth 명령으로 재인증 |
| 6 | 응답이 매우 느림 | 문맥창 가득 참 | /compact 실행 |
| 7 | "앞에서 한 말을 잊음" | 대화 길어져 문맥 초과 | /compact 후 핵심 정보 다시 제공 |
| 8 | 파일을 못 읽음 | 경로 오타 또는 권한 | 파일 경로 확인, 프로젝트 폴더 안에 있는지 확인 |
| 9 | 한글 깨짐 | 파일 인코딩 문제 | UTF-8로 저장 확인 |
| 10 | YOLO Mode에서 파일 폭주 | 제한 조건 없이 실행 | 새 빈 폴더에서만 YOLO Mode 사용 |
| 11 | Skill이 인식 안 됨 | 파일 위치 오류 | .claude/commands/ 폴더에 .md 파일 확인 |
| 12 | VS Code 터미널 안 열림 | 터미널 설정 문제 | Ctrl+` (백틱) 또는 메뉴 > 터미널 > 새 터미널 |
| 13 | Windows에서 ~ 경로 안 됨 | 셸 차이 | %USERPROFILE% 또는 C:\Users\사용자명 사용 |
| 14 | 비용 초과 경고 | 월간 사용량 한도 도달 | /cost 확인, 모델 다운그레이드, /compact 습관 |
| 15 | Agent Teams 안 됨 | 기능 미활성화 또는 플랜 제한 | Max 플랜 확인, 실험적 기능 활성화 |
자주 묻는 질문 10선
Q1: /compact를 쓰면 아까 대화가 다 사라지나요? 아니에요. 사라지는 게 아니라 요약돼요. 핵심 내용은 유지되고 불필요한 반복이 정리돼요.
Q2: 무료로도 충분히 쓸 수 있나요? 기본 탐색은 가능하지만, 교사 업무용으로는 Pro 이상을 추천해요. 무료는 사용량 제한이 있어 30분 작업도 어려울 수 있어요.
Q3: Opus를 항상 쓰면 안 되나요? 쓸 수는 있지만 비추천이에요. Opus는 강력하지만 느리고 비용이 높아요. 간단한 일에는 Haiku나 Sonnet이 더 빠르고 효율적이에요.
Q4: YOLO Mode가 위험하진 않나요? 약간의 주의는 필요해요. 잘못된 명령을 내리면 파일이 예상과 다르게 만들어질 수 있어요. 새 빈 폴더에서 새 파일을 만드는 작업으로 시작하세요.
Q5: 학생 이름을 AI에 넣어도 되나요? 안 돼요. 반드시 번호 코드로 바꿔서 입력하세요. 매핑표는 AI에 보내지 않고 별도 보관하세요.