이 페이지의 목차
이 페이지의 목차
확인 날짜 안내
기본은 공식 문서(확장 기능 개요·메모리·스킬·권한 모드 문서) 수집일(2026-10-18, 원본 날짜 미상) 기준이고, 블로그 Steering Claude Code에서 온 문장에는 (2026-06-18 기준)을 적었다. 2026-10-18 점검: 블로그의 "다섯 신호"는 권고라 날짜 계산에서 빼고, 플러그인 묶음 문장은 공식 스킬 문서가 확인하므로 페이지 확인 날짜를 2026-10-18로 올렸다.
Claude Code 확장을 처음부터 다 설정하지 않고, 불편이 생길 때마다 그 불편에 맞는 기능을 하나씩 더하는 방법이다. 원본은 기능마다 알아볼 수 있는 계기가 있고, 대부분의 팀이 대체로 아래 순서로 추가한다고 말한다. Claude Code 확장 기능 개요
준비물(필요한 것)#
| 필요한 것 | 내용 |
|---|---|
| Claude Code와 작업할 프로젝트 폴더 | 시작점은 그 프로젝트의 관례를 담은 CLAUDE.md다 Claude Code 확장 기능 개요. 설치 절차는 이 페이지의 원본이 다루지 않는다 |
시작 파일을 자동으로 만들려면 / | 코드베이스를 분석해 빌드 명령· |
시작점#
Claude Code를 처음 쓰면 프로젝트 관례를 담은 메모리(CLAUDE.md)부터 시작한다. Claude Code 확장 기능 개요 /init(슬래시 명령, 용어 사전)을 실행하면 Claude가 코드베이스를 분석해 빌드 명령, 테스트 방법, 관례를 담은 시작 파일을 만든다. CLAUDE_CODE_NEW_INIT=1을 설정하면 CLAUDE.md·스킬·훅 중 무엇을 만들지 묻는 대화형으로 돈다. Claude Code 메모리 → CLAUDE.md 작성·구성
계기별로 추가하기#
| 이런 일이 생기면 | 이걸 추가한다 |
|---|---|
| Claude가 같은 관례나 명령을 두 번 틀린다 | 메모리 |
| 더 짧게, 더 설명해서, 같은 형식으로 답하라고 계속 요청한다 | 출력 스타일을 설정한다. 먼저 내장 스타일을 확인한다 |
| 작업을 시작할 때 같은 프롬프트를 계속 친다 | 사용자가 부르는 스킬로 저장한다 |
| 같은 플레이북이나 여러 단계 절차를 세 번째로 채팅에 붙여 넣는다 | 스킬로 담는다 |
| Claude가 볼 수 없는 브라우저 탭에서 데이터를 계속 복사해 온다 | 그 시스템을 MCP 서버로 연결한다 |
| 심볼이 어디 정의· | 해당 언어의 code intelligence 플러그인을 설치한다 |
| 다시 볼 일 없는 출력으로 곁가지 작업이 대화를 채운다 | 서브에이전트로 돌린다 |
| 묻지 않아도 매번 무언가 일어나게 하고 싶다 | 훅을 쓴다 |
| 두 번째 저장소에 같은 셋업이 필요하다 | 플러그인으로 묶는다 |
근거: Claude Code 확장 기능 개요 (표는 원본 "Build your setup over time"을 옮긴 것이다. "두 번", "세 번째"는 원본이 든 계기 문장 그대로이며, 횟수 기준선으로 제시된 것은 아니다)
이미 있는 설정을 고칠 때도 같은 계기를 쓴다#
- 반복되는 실수나 거듭 나오는 리뷰 지적은 채팅에서 한 번 바로잡을 일이 아니라 CLAUDE.md를 고칠 일이다. Claude Code 확장 기능 개요 공식 메모리 문서는 계기를 넷으로 든다: 같은 실수를 두 번째로 할 때, 리뷰에서 Claude가 알았어야 할 것이 걸릴 때, 지난 세션에 친 교정을 또 칠 때, 새 팀원에게도 필요한 맥락일 때. Claude Code 메모리
- 손으로 계속 고쳐 쓰는 워크플로는 스킬을 한 번 더 손봐야 한다는 신호다. Claude Code 확장 기능 개요
- (2026-10-18 기준) 공식 스킬 문서는 같은 지시·체크리스트·절차를 채팅에 계속 붙여 넣을 때와, CLAUDE.md의 한 절이 사실이 아니라 절차로 자랐을 때를 스킬을 만들 계기로 든다. Claude Code 스킬 만드는 순서: 업무 절차를 스킬로 만들기
- (2026-06-18 블로그 권고) CLAUDE.md가 커졌다면 블로그 글의 다섯 신호로 옮길 지시를 찾는다: "매번 X면 항상 Y"는 훅, "절대 하지 마라"는 훅·권한, 30줄짜리 절차는 스킬, 범위 없는 API 전용 규칙은
paths:rules, 프로젝트 파일의 개인 선호는 사용자 수준 파일. Steering Claude Code → Claude Code 확장 기능 고르기 - (2026-10-18 기준) 권한 확인 창이 계기일 때: 모든 동작을 직접 보고 싶으면 Manual, 편집은 나중에
git diff로 검토하려면acceptEdits, 분류기 없이 확인 창을 줄이려면 Manual + Bash 샌드박스 auto-allow(설정 절차는 Claude Code 샌드박스 설정하기), 긴 작업에서 확인 창 피로를 줄이려면 자동 모드, CI는dontAsk와 정확한 허용 목록. Claude Code 권한 모드 → Claude Code 권한 모드 고르기 - (2026-10-18 기준) 몇 가지가 잘 돌아가면 스킬·서브에이전트·훅·출력 스타일을 플러그인으로 묶어 팀원이나 여러 프로젝트에 나눈다. Steering Claude Code 플러그인이
agents/,output-styles/등을 담는다는 점은 공식 스킬 문서가 확인한다. Claude Code 스킬
됐는지 확인하는 법#
- CLAUDE.md가 읽혔는지: 세션에서
/context를 실행해 Memory files 목록에CLAUDE.md가 있는지 본다. 시작할 때 어떤 CLAUDE.md와 rules 파일이 로드됐는지도/context로 확인한다. Claude Code 메모리 - 메모리 파일이 어디 있는지:
/memory는 사용자·프로젝트 범위의 CLAUDE.md, CLAUDE.local.md 등 메모리 파일 위치를 보여 주고 파일을 열어 준다. Claude Code 메모리 - 지시 파일에 낡거나 충돌하는 내용이 있는지:
/doctor prompt-audit(v2.1.283 이상)를 실행하면 Claude가 문제와 수정안을 보고하고, 적용하라고 하기 전에는 파일을 바꾸지 않는다. Claude Code 메모리 - 기능을 더한 효과: 원본에는 기능을 더한 뒤 효과를 재는 방법이 따로 없다. 원본은 "The same triggers tell you when to update what you already have"(같은 계기가 이미 있는 것을 고칠 때도 알려 준다)라고 한다 Claude Code 확장 기능 개요. 이를 바탕으로, 같은 계기가 다시 생기는지로 효과를 볼 수 있다(편집자 해석). 스킬이 늘었을 때는
/skill-doctor(v2.1.252 이상, 기능 플래그를 가져오지 않는 세션에서는 없음)로 한 번도 호출되지 않은 스킬을 찾는다(아래 "언제 쓰고" 절). Claude Code 스킬
언제 쓰고 언제 쓰지 않는가#
- 쓴다: 처음 셋업할 때 무엇부터 할지 막막할 때, 팀이나 교육생에게 "확장 기능을 한꺼번에 다 깔지 말라"고 안내할 때.
- 쓰지 않는다: 이미 목표가 분명해 기능을 고르기만 하면 될 때는 Claude Code 확장 기능 고르기가 빠르다.
- 주의: 기능을 더할수록 컨텍스트 비용이 든다. 너무 많으면 스킬이 제대로 트리거되지 않거나 관례를 놓칠 수 있다. Claude Code 확장 기능 개요 → 컨텍스트 비용 스킬은 쓰든 안 쓰든 목록이 매 턴 컨텍스트를 더하므로, 늘어나면
/skill-doctor로 한 번도 호출되지 않은 스킬을 찾아 끈다(2026-10-18 기준). Claude Code 스킬