본문 바로가기
claudecode.to
Docs · Learning

설치부터 팀 도입까지,
순서대로 익히고 필요할 때 찾아봅니다.

Claude Code를 순서대로 익히는 학습 코스(입문·Skills·실전·커스텀 커맨드·Hooks·루프 엔지니어링·비개발자·바이브 코딩)와 필요할 때 찾아보는 한국어 문서(설치·모델·퍼미션·세션·CLAUDE.md·서브에이전트·MCP·Claude API·기업 도입)를 한곳에. 설치부터 팀 도입까지 실무 기준으로 다룹니다.

Featured
바이브 코딩 코스

바이브 코딩 바이블 — 코드를 쓰지 않고, 만들고 싶은 것을 만든다

코드는 못 써도 만들고 싶은 것이 있다면, 머릿속 그림을 키우고 GitHub에 적고 정할 것만 정한 뒤 나머지는 Claude Code에 통째로 넘긴다. 열일곱 편으로 그 흐름을 익히는 코스의 출발점.

입문10분2026-08-22
시작하기

Claude Code 시작하기

터미널에서 동작하는 에이전트형 코딩 도구 Claude Code가 무엇인지, 기존 코딩 도우미와 무엇이 다른지 정리합니다.

6분2026-07-15
입문 코스

Claude Code의 기초

Claude Code는 Anthropic이 만든 CLI 기반 AI 코딩 에이전트입니다. 기존 AI 도구와의 차이, 핵심 5가지 능력, 설치와 첫 대화까지 처음 시작하는 분 눈높이로 정리했습니다.

입문15분2026-08-22
핵심 개념

에이전틱 루프의 동작 원리

Claude Code가 지시를 받고 나서 파일을 고치기까지, 내부에서 반복되는 판단·행동·관찰의 순환을 설명합니다.

8분2026-07-16
Skills 코스

Claude Skills란 무엇인가

Skills는 Claude Code가 필요할 때만 자동으로 발견해 불러오는 전문 지식 패키지입니다. 단계적 로딩 구조, CLAUDE.md·MCP와의 차이, 공식 frontend-design 플러그인으로 효과를 직접 체험하는 방법을 정리합니다.

중급14분2026-08-22
설정과 커스터마이즈

CLAUDE.md 작성법

CLAUDE.md는 프로젝트의 문맥과 규칙을 Claude Code에 전하는 지침 파일입니다. /init으로 초안을 만들고, 실제로 동작을 바꾸는 문장만 남겨 짧게 유지하는 작성 원칙과 구조 예시.

17분2026-08-22
실전 코스

하네스 엔지니어링 기초

모델을 바꾸는 게 아니라 모델이 일하는 환경을 설계한다 — 성과 차이를 만드는 진짜 변수.

고급18분2026-07-06
MCP와 확장

MCP — 외부 도구 연결하기

MCP(Model Context Protocol)는 AI 모델과 외부 도구·데이터 소스를 연결하는 오픈 표준 프로토콜입니다. 구조와 서버 종류, GitHub·DB·Slack·브라우저 연동 예, 스코프와 인증 관리까지 정리합니다.

11분2026-08-22
기업 도입

Claude Team·Enterprise vs ChatGPT Business·Enterprise — 기업 도입 비교

최소 시트, 시트당 요금, SSO·SCIM·감사 로그, 데이터 학습 정책과 보존 기간까지 — 정보보안 검토와 품의서에 그대로 옮길 수 있게 정리한 기업 플랜 비교.

10분2026-07-20
기업 도입

AI 에이전트 도입, 임원이 30분 안에 검증하는 법

시작 전 5가지 자가진단, 90일 로드맵의 주차별 산출물, 자주 빠지는 함정 5가지, 그리고 컨설턴트에게 던질 질문 — 직원 보고서를 받아든 의사결정자를 위한 검증 기준.

12분2026-07-20
Course · 순서대로 읽는 학습 코스

입문 코스

7 · 위에서부터 차례로

입문 코스

Claude Code의 기초

Claude Code는 Anthropic이 만든 CLI 기반 AI 코딩 에이전트입니다. 기존 AI 도구와의 차이, 핵심 5가지 능력, 설치와 첫 대화까지 처음 시작하는 분 눈높이로 정리했습니다.

입문15분2026-08-22
입문 코스

기본 조작과 명령어

Claude Code 의 기본 조작은 터미널에서 치는 셸 명령(claude, claude -c, claude -p)과 대화 중에 쓰는 슬래시 명령(/clear, /help, /resume) 두 종류로 나뉩니다. 파일 지목·중단·승인·단축키까지 한 번에 정리합니다.

입문21분2026-08-22
입문 코스

파일 조작 배우기

파일 읽기·생성·수정을 지시하는 방법과, 원치 않는 변경을 막는 습관.

입문10분2026-07-13
입문 코스

AI를 활용한 코드 생성

요구사항을 코드로 옮기는 지시문 작성법 — 무엇을 주면 원하는 결과가 나오는지.

입문12분2026-07-12
입문 코스

디버깅 지원 기능

오류를 던져 주는 것을 넘어, 원인 추적과 재현까지 맡기는 실전 디버깅 워크플로.

입문11분2026-07-11
입문 코스

Git 조작 자동화 — 커밋부터 PR 머지까지

Claude Code의 Git 자동화는 '커밋해줘', 'PR 만들어줘' 같은 자연어 지시로 리포지토리 초기화부터 PR 머지까지 처리하는 기능입니다. 7단계 실습과 안전장치를 정리합니다.

입문14분2026-08-22
입문 코스

바이브 코딩이란 무엇인가 — 정의와 한계

코드를 직접 읽지 않고 AI에 맡겨 만드는 방식의 정확한 정의, 통하는 조건과 무너지는 지점.

입문11분2026-07-19

커스텀 커맨드 코스

4 · 위에서부터 차례로

Hooks 코스

10 · 위에서부터 차례로

Hooks 코스

Hooks 설정 방법 — settings.json과 /hooks

Hooks 설정은 settings.json의 hooks 항목에 이벤트명·matcher·command 세 요소를 적는 것입니다. /hooks 로 설정을 확인하고, 명령은 sh 파일로 떼어내면 이스케이프 없이 관리할 수 있습니다.

중급10분2026-08-22
Hooks 코스

SessionStart 훅으로 초기화 자동화

SessionStart 훅은 세션이 시작되거나 재개될 때 자동으로 실행되는 훅입니다. npm install 같은 준비 작업을 맡기고 $CLAUDE_ENV_FILE 로 환경 변수를 세션 내내 유지하는 방법을 다룹니다.

중급12분2026-08-22
Hooks 코스

Stop 훅으로 완료 알림·로그 자동화

Stop 훅은 Claude가 응답을 끝냈을 때 자동으로 실행되는 훅입니다. 오래 걸리는 작업의 완료를 알림음이나 데스크톱 알림으로 받고 로그를 남기는 설정을 macOS 기준으로 정리합니다.

중급9분2026-08-22
Hooks 코스

PreToolUse·PostToolUse 훅 — 도구 실행 전후 처리

PreToolUse 훅은 도구 실행 직전, PostToolUse 훅은 도구 실행 직후에 발화하는 훅입니다. matcher로 대상 도구를 지정하고 파일 편집 후 Prettier 자동 포맷을 거는 실전 예를 다룹니다.

중급12분2026-08-22
Hooks 코스

Hooks 종료 코드로 도구 실행 차단하기

훅 스크립트의 종료 코드는 Claude Code의 다음 동작을 결정하는 신호입니다. 0은 허가, 2는 차단, 그 외는 에러이며, PreToolUse 훅에서 2를 반환해 rm -rf 같은 위험 명령을 막는 방법을 다룹니다.

중급9분2026-08-22
Hooks 코스

Hooks 환경 변수 — CLAUDE_PROJECT_DIR·CLAUDE_ENV_FILE

Hooks 환경 변수는 Claude Code가 훅 스크립트에 프로젝트 정보를 넘겨주는 통로입니다. CLAUDE_PROJECT_DIR로 프로젝트 루트를 얻고, CLAUDE_ENV_FILE로 세션 중 환경 변수를 영속화하는 방법을 다룹니다.

고급12분2026-08-22
Hooks 코스

Hooks 매처 — 와일드카드와 패턴 지정

매처(matcher)는 훅이 어떤 도구·이벤트에서 발화할지 지정하는 문자열 필터입니다. 빈 문자열, 도구명, 파이프 OR 조건, 정규 표현식, SessionStart 전용 매처와 Bash 명령 좁히기 요령을 다룹니다.

고급20분2026-08-22
Hooks 코스

비동기 실행 async:true — 훅을 기다리지 않기

async: true는 훅을 백그라운드에서 실행해 처리 완료를 기다리지 않고 다음 프롬프트를 보낼 수 있게 하는 Hooks 옵션입니다. 설정 한 줄로 자동 포맷·알림·환경 구축 같은 느린 처리를 작업 흐름에서 떼어내는 방법을 다룹니다.

고급13분2026-08-22
Hooks 코스

SubagentStop 훅 — 서브에이전트 완료 시 처리

SubagentStop 훅은 서브에이전트가 태스크를 완료한 시점에 자동으로 셸 명령을 실행하는 Hooks 이벤트입니다. Stop 훅과의 차이, settings.json 설정, 에이전트 타입 매처, 프롬프트 베이스 훅까지 정리합니다.

고급10분2026-08-22
Hooks 코스

UserPromptSubmit 훅 — 프롬프트 가공과 기밀 정보 차단

UserPromptSubmit 훅은 사용자가 프롬프트를 전송했을 때 발화해 입력을 가공·검증할 수 있는 Hooks 이벤트입니다. stdin JSON에서 prompt를 읽는 법, stdout으로 컨텍스트를 추가하는 법, API 키를 감지해 차단하는 법을 다룹니다.

고급22분2026-08-22

루프 엔지니어링 코스

8 · 위에서부터 차례로

루프 엔지니어링 코스

루프 엔지니어링이란 — 지시하는 사람을 시스템으로 갈아 끼운다

루프 엔지니어링은 에이전트에게 지시하는 역할을 나에게서 떼어내 시스템에 맡기는 일이다. 사람의 몫은 완료 조건과 검증 방법을 정하는 것이고, 평가 대상은 답 하나가 아니라 답을 계속 만들어 내는 구조로 옮겨간다.

중급14분2026-08-22
루프 엔지니어링 코스

그냥 자동화와의 차이, 그리고 하네스의 한 층 위

그냥 자동화는 정한 절차를 같은 정확도로 반복하지만, 루프는 검증을 내장하고 절차 대신 목적을 받고 돌릴수록 똑똑해진다. 프롬프트 → 컨텍스트 → 하네스 → 루프의 흐름에서 루프는 하네스의 한 층 위에 있는 관제실이다.

중급9분2026-08-22
루프 엔지니어링 코스

언제 써야 하나 — 구성 요소는 5개 + 기억

판단 기준은 '그 작업이 반복해서 일어나는가' 하나다. 일간 트리아지·CI 실패 요약·정기 버그 찾기에는 잘 듣고 단발 작업에는 과하다. 루프의 부품은 자동화·워크트리·스킬·커넥터·서브에이전트 5개에 토대인 기억을 더한 것이다.

중급7분2026-08-22
루프 엔지니어링 코스

자동화·워크트리·스킬 — 기동 장치, 작업 분리, 프로젝트 지식

자동화는 기동 조건과 정지 조건을 세트로 정해야 무한 루프를 피하고, 워크트리는 병행 에이전트가 서로를 밟지 않게 하며, 스킬은 에이전트가 추측으로 메울 프로젝트 지식을 적어 둔다.

중급7분2026-08-22
루프 엔지니어링 코스

커넥터·서브에이전트·기억 — 검증력, 생성과 검증의 분리, 디스크

커넥터가 늘수록 에이전트는 자기 결과를 실물로 검증할 수 있고, 서브에이전트는 생성과 검증을 나눠 자기 승인을 막으며, 기억은 휘발하는 컨텍스트가 아니라 디스크에 남겨야 루프가 바퀴를 넘어 똑똑해진다.

중급7분2026-08-22
루프 엔지니어링 코스

Claude Code와 Codex app에서 조립하는 법

자동화·분리·지식·접속·분담·기억 여섯 요소는 Claude Code와 Codex app 어느 쪽에도 대응물이 있다. 대응표와 함께 Windows·사내 프록시·폐쇄망 등 국내 기업 환경에서 걸리는 지점을 짚는다.

중급8분2026-08-22
루프 엔지니어링 코스

안쪽 루프와 바깥쪽 루프 — 쓸수록 똑똑해진다

안쪽 루프는 눈앞의 태스크를 완료까지 반복하고, 바깥쪽 루프는 그 과정에서 얻은 교훈을 디스크에 적어 다음 세션의 출발점으로 바꾼다. 두 루프가 맞물릴 때 시스템은 내버려 둬도 정확도를 올려 간다.

중급6분2026-08-22
루프 엔지니어링 코스

실례와 정리 — 이 가이드 자체가 루프로 만들어졌다

루프 엔지니어링을 해설하는 이 가이드 자체가 안쪽 루프(발견·조사·편집·검증·표시 확인)와 바깥쪽 루프(runs/·lessons.md)로 만들어졌다. 그 실례를 구성 요소와 대응시켜 보고, 코스 전체의 요점을 여섯 줄로 정리한다.

중급10분2026-08-22

바이브 코딩 코스

18 · 위에서부터 차례로

바이브 코딩 코스

바이브 코딩 바이블 — 코드를 쓰지 않고, 만들고 싶은 것을 만든다

코드는 못 써도 만들고 싶은 것이 있다면, 머릿속 그림을 키우고 GitHub에 적고 정할 것만 정한 뒤 나머지는 Claude Code에 통째로 넘긴다. 열일곱 편으로 그 흐름을 익히는 코스의 출발점.

입문10분2026-08-22
바이브 코딩 코스

바이브 코딩이란 무엇인가

바이브 코딩은 대충 만드는 게 아니라 역할 분담이 바뀐 것이다. 코드는 AI가 쓰고 무엇을 만들지는 사람이 정한다. 병목은 구현력에서 머릿속 그림의 해상도로 옮겨 갔다.

입문8분2026-08-22
바이브 코딩 코스

도구는 딱 둘 — Claude Code와 GitHub

바이브 코딩에 필요한 도구는 Claude Code와 GitHub 둘뿐이다. 외울 GitHub 단어는 5개, 코드 에디터는 열지 않고, 도구 조작도 AI에게 시킨다. 남는 일은 연결한다·말한다·본다·정한다.

입문10분2026-08-22
바이브 코딩 코스

머릿속 그림을 키운다

바이브 코딩의 품질은 넘기기 전에 머릿속 그림이 얼마나 큰가로 결정됩니다. 사리는 버릇을 버리고, 누가·언제·어떤 기분일 때 쓰는가 세 질문으로 그림의 해상도를 올리는 법.

입문8분2026-08-22
바이브 코딩 코스

머릿속 그림을 말로 옮긴다

말이 되지 않은 아이디어는 없는 것과 같습니다. 혼자 브레인스토밍 틀로 핵심을 한 문장으로 추리고, AI에게 질문을 시켜 구멍을 메운 뒤, 기능의 말을 문제의 말로 바꾸는 법.

입문8분2026-08-22
바이브 코딩 코스

GitHub에 생각을 적는다

말로 옮긴 생각은 GitHub 리포지토리에 둡니다. AI가 읽을 수 없는 곳에 있는 건 존재하지 않기 때문입니다. 리포지토리·README·Issue는 전부 AI에게 쓰게 하고, 나는 채점만 합니다.

입문11분2026-08-22
바이브 코딩 코스

AI를 위한 규칙을 적는다

CLAUDE.md는 매번 말하지 않아도 AI에게 전달되는 약속 파일입니다. 새로 온 사람에게 건네는 업무 매뉴얼처럼 다섯 항목만 적고, 같은 지적을 두 번 했을 때 한 줄씩 키워 갑니다.

입문8분2026-08-22
바이브 코딩 코스

폴더 구성과 기술 선정

폴더 구성도 기술 선정도 여러분이 정하지 않아도 됩니다. 내가 만지는 파일 세 종류만 알아 두고, 기술은 'AI가 가장 익숙한 정석'을 기준으로 AI에게 고르게 한 뒤 그 이유를 docs/tech-choices.md에 남깁니다.

입문7분2026-08-22
바이브 코딩 코스

인터페이스를 정한다

인터페이스는 기술과 달리 AI에게 맡길 수 없는, 여러분의 생활 문제입니다. 누가·어디서·어떻게 만지는가에서 역산해 만지는 면을 고르고, 주인공 화면 하나를 손으로 그려 docs/interface.md와 함께 리포지토리에 넣습니다.

입문7분2026-08-22
바이브 코딩 코스

아웃풋을 정한다

완성은 정의하지 않으면 오지 않습니다. 첫 공개의 정의를 부끄러울 정도로 작게 적고, 추적할 숫자 하나와 이번엔 안 할 목록을 docs/output.md에 남겨 두면 결승선이 생깁니다.

입문8분2026-08-22
바이브 코딩 코스

전부 통째로 넘긴다

절차를 지시하지 말고 목적과 완료 조건을 위임합니다. Issue 1건을 한 문장으로 넘기고, 중간에 끼어들지 않고, 돌아오면 통과·반려·폐기 중 하나만 고르면 첫 바퀴가 돕니다.

입문9분2026-08-22
바이브 코딩 코스

알아서 공개되는 구조를 만든다

사람이 손으로 공개하는 한 통째로 맡기기는 완성되지 않습니다. GitHub Actions로 자동 테스트·자동 배포·프리뷰 환경을 AI에게 만들게 하면 내 일은 승인 버튼을 누르는 것만 남습니다.

중급8분2026-08-22
바이브 코딩 코스

동시에 여러 개 굴린다

AI는 동시에 몇 건이든 일하지만 병목은 내 판단력이다. 프로젝트는 주인공 하나만 두고, 동시 진행은 같은 프로젝트 안의 Issue 2~3건까지로 제한한다.

중급7분2026-08-22
바이브 코딩 코스

계측을 먼저 심어 둔다

추적할 숫자 하나를 GA4·GTM으로 거짓 없이 주울 수 있게 만드는 작업은 공개 전에 끝낸다. 무엇을 셀지와 나를 제외할지만 사람이 정하고, 심는 일은 AI에게 통째로 넘긴다.

중급8분2026-08-22
바이브 코딩 코스

개선 루프를 돌린다

가설→만들어 본다→공개→관찰→학습→다음 가설의 여섯 단계를 의지가 아니라 틀로 돌린다. 성과는 한 바퀴의 질이 아니라 바퀴 수로 정해지므로 항상 짧게, 반드시 공개를 포함해 돈다.

중급10분2026-08-22
바이브 코딩 코스

리포팅을 AI에게 맡긴다

숫자는 보러 가는 게 아니라 저쪽에서 오게 만듭니다. Claude Code를 GA4에 MCP로 연결해 물으면 답이 오게 하고, 주간 리포트와 네 줄 일지를 리포지토리에 남기면 루프에서 떨어졌다 돌아와도 바로 재개할 수 있습니다.

중급8분2026-08-22
바이브 코딩 코스

접는 기술

바이브 코딩에서 가장 무서운 실패는 틀린 방향으로 고품질 결과물이 쌓이는 것입니다. 다시 만드는 비용이 내려간 세계에서 접을지 고칠지를 가르는 세 가지 기준과, 접을 때 코드 대신 수확해 가는 자산을 정리합니다.

중급8분2026-08-22
바이브 코딩 코스

그래도 사람이 하는 일

열일곱 편을 통틀어 AI에게 넘길 수 없었던 일은 그린다·정한다·책임진다 세 가지뿐입니다. 코스 전 과정을 한 장의 체크리스트로 압축하고, 바이브 코딩의 실력은 프롬프트가 아니라 완료를 정의하는 힘이라는 결론으로 마칩니다.

입문11분2026-08-22
Reference · 필요할 때 찾아보는 문서

시작하기

7

시작하기

Claude Code 시작하기

터미널에서 동작하는 에이전트형 코딩 도구 Claude Code가 무엇인지, 기존 코딩 도우미와 무엇이 다른지 정리합니다.

6분2026-07-15
시작하기

설치와 초기 설정 — Mac·Windows 한 번에

Claude Code 설치는 Mac은 curl 한 줄, Windows는 PowerShell 한 줄로 끝나며 Node.js가 필요 없습니다. OS별 설치 명령, npm·WSL 대체 경로, 설치 후 확인과 자주 겪는 오류 대처법을 정리합니다.

10분2026-08-22
시작하기

Claude Code 로그인과 인증 설정 — Claude.ai 구독과 Console API 계정

Claude Code 로그인은 claude 명령을 실행하면 브라우저로 자동 안내됩니다. Claude.ai 구독과 Claude Console(API 종량제) 계정의 차이, 인증 정보 저장 위치, /login 계정 전환을 정리합니다.

8분2026-08-22
시작하기

첫 세션 실전 — 실행부터 첫 코드 변경까지

Claude Code 첫 세션은 프로젝트 폴더에서 claude 를 실행해 질문하고, 파일을 만들고, 변경을 승인하는 한 바퀴입니다. 연습 폴더 실습과 실제 프로젝트 30분 플랜을 함께 다룹니다.

25분2026-08-22
시작하기

Claude Code 요금제 — Pro / Max / API 중 무엇을 고를까

Claude Code 요금은 구독제(Pro·Max)와 API 종량제 두 갈래입니다. 각 플랜 가격, 토큰 과금 구조, 모델별 단가, 내 사용량에 맞는 플랜 고르는 순서와 비용 절감 요령을 정리합니다.

12분2026-08-22
시작하기

Claude Code 모델 고르기 — Opus·Sonnet·Haiku·Fable과 /model 전환

Claude Code에서 쓸 수 있는 Opus 5·Sonnet 5·Haiku 4.5·Fable 5 네 모델의 차이와 요금, /model 커맨드로 세션 중 전환하는 법, 태스크별로 어떤 모델을 고를지 정리합니다.

12분2026-08-22
시작하기

Claude Code on the Web — 브라우저에서 바로 시작하는 AI 주도 개발

Claude Code on the Web은 GitHub 저장소를 연결해 브라우저만으로 분석·수정·PR 작성까지 끝내는 Claude Code 웹판입니다. 설정 절차, 네트워크 설정, teleport, CLI판과의 구분을 정리합니다.

12분2026-08-22

핵심 개념

8

핵심 개념

에이전틱 루프의 동작 원리

Claude Code가 지시를 받고 나서 파일을 고치기까지, 내부에서 반복되는 판단·행동·관찰의 순환을 설명합니다.

8분2026-07-16
핵심 개념

컨텍스트 윈도우 관리 — /clear·/compact·/context

컨텍스트 윈도우는 Claude가 한 번에 처리할 수 있는 정보의 상한입니다. /context로 사용량을 확인하고 /clear와 /compact를 상황에 맞게 가려 써서 판단 정확도와 속도를 지키는 방법.

18분2026-08-22
핵심 개념

내장 도구 이해하기

파일 읽기·편집·검색·명령 실행 등 Claude Code가 실제로 손을 쓰는 수단과, 각 도구가 언제 선택되는지.

6분2026-07-14
핵심 개념

Claude Code vs Cursor vs Codex 비교

Claude Code는 터미널 에이전트, Cursor는 AI 내장 에디터, Codex CLI는 OpenAI의 터미널 에이전트입니다. 구조·모델·권한·요금을 3자 비교표로 정리하고 어떤 상황에 무엇을 고를지 안내합니다.

18분2026-08-22
핵심 개념

세션 관리 — 시작·종료·재개

세션은 Claude Code와 나눈 대화 한 묶음입니다. claude -c·/resume·/rename·세션 ID 지정으로 과거 작업을 이어가고, /clear 로 새 작업에 집중하는 방법을 정리합니다.

9분2026-08-22
핵심 개념

/rewind 로 대화와 코드 되감기

/rewind 는 Claude Code 대화를 과거 체크포인트로 되돌리는 커맨드입니다. Esc 두 번 단축키, 세 가지 복원 방식, 되감기 한계와 /clear·/compact 와의 차이를 정리합니다.

12분2026-08-22
핵심 개념

스크린샷으로 UI 수정하기

Claude Code는 클립보드의 스크린샷을 프롬프트에 붙여넣어 입력으로 받는 도구입니다. 찍는 법·붙여넣는 법부터 UI 버그·디자인 시안·에러 화면 활용법, 지시 요령과 주의점을 정리합니다.

8분2026-08-22
핵심 개념

비대화 모드(-p)로 스크립트에서 실행하기

비대화 모드는 -p 옵션으로 프롬프트를 넘겨 결과만 받고 종료하는 Claude Code 실행 방식입니다. 출력 형식·도구 허용·커스텀 커맨드 호출·파이프 연동까지 자동화에 필요한 옵션을 정리합니다.

10분2026-08-22

설정과 커스터마이즈

9

설정과 커스터마이즈

CLAUDE.md 작성법

CLAUDE.md는 프로젝트의 문맥과 규칙을 Claude Code에 전하는 지침 파일입니다. /init으로 초안을 만들고, 실제로 동작을 바꾸는 문장만 남겨 짧게 유지하는 작성 원칙과 구조 예시.

17분2026-08-22
설정과 커스터마이즈

settings.json 설정

권한 허용 목록, 환경 변수, 모델 선택 등 하네스 동작을 파일로 고정하는 방법.

6분2026-07-13
설정과 커스터마이즈

훅(Hooks)으로 동작 강제하기

Hooks는 Claude Code 라이프사이클의 특정 시점에 자동으로 실행되는 처리입니다. CLAUDE.md의 '부탁'과 달리 모델 판단과 무관하게 항상 동작하는 '규칙'을 만드는 방법과 대표 이벤트 10종을 정리합니다.

12분2026-08-22
설정과 커스터마이즈

슬래시 명령어와 Skills

반복 작업을 재사용 가능한 절차로 묶는 두 가지 방법과, 둘 중 무엇을 언제 써야 하는지.

7분2026-08-22
설정과 커스터마이즈

CLAUDE.md 실전 템플릿

프로젝트 유형별로 바로 복사해 쓰는 CLAUDE.md 템플릿과, 붙여넣은 뒤 반드시 손봐야 하는 지점.

9분2026-07-19
설정과 커스터마이즈

퍼미션 설정 최적화 — allow·deny·ask

퍼미션은 Claude Code가 어떤 조작을 자동 실행하고 어떤 조작을 확인·차단할지 정하는 설정입니다. allow·deny·ask 문법과 우선순위, defaultMode 비교, 복붙용 추천 설정을 정리합니다.

25분2026-08-22
설정과 커스터마이즈

CLAUDE.md @참조로 다른 파일 불러오기

CLAUDE.md의 @참조는 `@docs/spec.md`처럼 적은 파일을 세션 시작 시 컨텍스트에 함께 읽어 들이는 기능입니다. 사양서를 분리해 본체를 짧게 유지하는 법과 경로 규칙, 흔한 실수를 정리합니다.

10분2026-08-22
설정과 커스터마이즈

CLAUDE.md 배치 장소와 우선순위

CLAUDE.md는 조직 정책·사용자 홈·프로젝트 루트·CLAUDE.local.md 네 곳에 둘 수 있고, 넓은 범위부터 순서대로 전부 읽혀 이어 붙습니다. 팀 공유와 개인 설정을 분리하는 배치 패턴을 정리합니다.

10분2026-08-22
설정과 커스터마이즈

.claude/rules/로 규칙 모듈화하기

.claude/rules/는 CLAUDE.md 규칙을 주제별 파일로 나누고, paths 프론트매터로 특정 파일을 다룰 때만 동적으로 읽히게 하는 모듈러 룰 기능입니다. 컨텍스트 절약 방법과 Glob 패턴 작성법을 정리합니다.

10분2026-08-22