Claude Code 한국어 실전 가이드

오픈소스 어전과 1인 앱 스튜디오를 Claude Code로 돌리며 실제로 해 본 것만 모았다. 모든 글은 공식 문서와 대조한다.

1. 1편 · 가이드 · 2026년 10월 29일Claude Code 설치와 첫 실행 — 명령 한 줄 설치부터 첫 질문까지Claude Code를 맥·윈도우·리눅스에 설치하는 공식 명령, 설치 확인(claude --version·claude doctor), 어떤 요금제로 로그인하는지, 첫 세션에서 무엇부터 물어보면 좋은지, 자동 업데이트와 지우는 법까지 공식 문서와 대조해 정리했다.
2. 2편 · 가이드 · 2026년 10월 28일Claude Code 권한 모드 6가지 — Manual·acceptEdits·plan·auto·dontAsk·bypassPermissions 차이와 고르는 법Claude Code가 무엇을 묻지 않고 실행하는지는 권한 모드가 정한다. 모드 6가지가 각각 무엇을 허락하는지, Shift+Tab·--permission-mode·settings.json으로 바꾸는 법, 하이아이오가 실제로 어떤 일에 어떤 모드를 쓰는지까지 표 하나로 정리했다.
3. 3편 · 가이드 · 2026년 10월 25일Claude Code hooks 예제 4개 — 권한 요청 알림, 위험한 명령 막기, 작업 기록, 브라우저로 보내기Claude Code hooks를 settings.json에 넣는 법과 바로 복사해 쓰는 예제 4개. 권한을 물을 때 맥 알림 띄우기, rm -rf 같은 명령을 exit 2로 막기, 모든 작업을 파일에 남기기, 오픈소스 어전처럼 브라우저 화면으로 보내기까지 실제로 써 본 설정 그대로.
4. 4편 · 가이드 · 2026년 10월 29일Claude Code 서브에이전트 만들기 — .claude/agents 파일 하나로 '전담 직원' 두는 법Claude Code 서브에이전트는 마크다운 파일 하나다. 어디에 두는지, name·description·tools·model 같은 머리 항목이 무엇을 정하는지, Claude가 언제 알아서 맡기는지, 하이아이오가 실제로 쓰는 14명 중 '전령' 파일을 예로 정리했다.
5. 5편 · 준비 중스킬 만들기
6. 6편 · 준비 중플러그인 만들어 배포하기
7. 7편 · 준비 중MCP 서버 연결
8. 8편 · 준비 중사용량·비용 아끼기
9. 9편 · 준비 중폰에서 내 Claude Code 보기
10. 10편 · 준비 중자주 나는 오류와 해결

이 가이드는 AI(Claude)가 쓰고, 하이아이오가 실제로 써 본 설정만 싣습니다.