Claude Code — 터미널에서 코드를 읽고 고치는 AI 에이전트(스스로 판단해 작업을 수행하는 프로그램) — 를 쓰다 보면 "이걸로 뭘 더 할 수 있지?"라는 질문이 자연스럽게 떠오릅니다. 이 글은 usingclaude.com에 이미 올라와 있는 실전 예제 글들을 유형별로 정리한 목차형 허브입니다. 새로운 예제를 지어내지 않고, 검증된 기존 가이드를 헤드리스 자동화·훅·작업 흐름 제어·명령어·워크플로·MCP 여섯 갈래로 묶어 각 글의 핵심 커맨드만 먼저 보여드립니다. 전체 지도를 파악하는 데 5분이면 충분합니다.
🟢 현행 모델 라인업 일치 · 모델 안내 · Fable 구독 안내
Fable 5·5.1 구독 안내(2026년 9월 7일 갱신): 2026년 9월 1일 출시된 Claude Fable 5.1이 현행 Fable 모델이고, Fable 5는 레거시로 전환됐습니다. 구독 조건은 두 모델이 같습니다 — Max·Team Premium 플랜은 주간 사용 한도의 50% 범위에서 포함되고, Pro·Team Standard 플랜은 사용량 크레딧(입력 100만 토큰당
이 허브로 무엇을 할 수 있나요
이 허브를 훑어보면 Claude Code로 자동화·규칙·MCP 연동까지 무엇을 할 수 있는지 5분 안에 지도를 그릴 수 있습니다. 각 항목은 usingclaude.com에 이미 발행된 실전 가이드로 연결되며, 이 글 자체는 그 가이드들의 핵심 커맨드만 뽑아 정리한 목차입니다. 아직 Claude Code를 설치하지 않았다면 먼저 Claude Code 설치 가이드를 따라 CLI(명령줄 인터페이스 — 마우스 없이 글자 명령으로 프로그램을 조작하는 방식) 환경부터 준비하세요.
용어 빠른 풀이
- 헤드리스(headless) — 대화형 화면 없이 명령어 한 줄로 실행하고 결과만 받는 방식
- 훅(Hooks) — 특정 시점마다 자동으로 실행되는 사용자 정의 규칙
- 서브에이전트(subagent) — 특정 작업만 전담하는, 독립된 컨텍스트를 가진 전문 AI
- MCP(Model Context Protocol) — AI와 외부 도구·데이터를 연결하는 표준 규약
- CI(Continuous Integration) — 코드 변경을 자동으로 빌드·테스트하는 파이프라인
헤드리스 모드로 스크립트·CI 자동화하기
Claude Code를 자동화에 쓰려면 화면 없이 실행되는 헤드리스 모드(claude -p)부터 시작하는 것이 가장 빠른 길입니다. 스크립트나 CI 파이프라인에서 Claude를 호출하는 방법, GitHub PR·이슈에서 @claude 멘션으로 자동 작업을 시키는 방법을 아래 두 글이 다룹니다.
| 예제 | 핵심 커맨드 | 설명 |
|---|---|---|
| 헤드리스 모드 자동화 | claude -p "프롬프트", --output-format json, -c | 대화형 세션 없이 응답만 받고 즉시 종료 — 스크립트·서버 자동화에 사용 |
| GitHub 연동 | /install-github-app, @claude 멘션 | PR·이슈 댓글에 멘션하면 GitHub Actions 위에서 자동으로 코드를 분석·수정 |
위 흐름도는 헤드리스 실행·훅·PR 생성·GitHub 연동을 하나로 잇는 예시입니다. 각 단계는 실제로 위 두 글과 아래 훅 섹션에서 다루는 기능을 그대로 이어붙인 것으로, 처음부터 전부 구현할 필요 없이 필요한 단계만 골라 적용해도 됩니다.
훅(Hooks)으로 규칙 자동화하기
훅은 세션의 특정 시점마다 자동 실행되는 사용자 정의 규칙으로, 자동 포맷·위험 명령 차단·테스트 게이트 같은 가드레일을 사람이 매번 챙기지 않아도 확실하게 적용합니다. 이벤트·매처·액션 3요소로 구성되며, 대화형으로는 /hooks 명령, 영구 설정은 .claude/settings.json(프로젝트) 또는 ~/.claude/settings.json(전역)에 저장합니다.
| 이벤트 | 실행 시점 | 대표 용도 |
|---|---|---|
PreToolUse | 도구 실행 직전 | 위험한 명령 차단(종료 코드 2 반환 시 실행 자체를 막음) |
PostToolUse | 도구 실행 완료 후 | 자동 포맷, 테스트 실행 |
Stop | 세션 종료 시 | 정리 작업, 로그 기록 |
SessionStart / SessionEnd | 세션 시작·종료 시점 | 환경 준비·정리 |
자세한 설정 방법과 매처("Edit|Write", "Bash" 같은 조건 필터) 문법, 핸들러 종류(command·prompt·agent·http)는 Claude Code 훅 가이드에서 전체 예제를 확인할 수 있습니다.
서브에이전트·Plan 모드·어드바이저 — 작업 흐름 제어
큰 작업을 안전하게 나누려면 서브에이전트로 곁작업을 분리하거나, Plan 모드로 수정 전에 계획부터 검토하거나, 어드바이저로 막힌 순간에만 더 강한 모델을 부르는 세 가지 방법을 조합할 수 있습니다.
| 예제 | 핵심 커맨드 | 설명 |
|---|---|---|
| 서브에이전트 | /agents | 특정 작업만 전담하는 전문 AI를 만들어 테스트 로그 등 대량 출력을 메인 대화에서 분리 |
| Plan 모드 | Shift+Tab 또는 claude --permission-mode plan | 파일 수정 전에 계획을 먼저 세우고 승인받은 뒤 진행 |
| 어드바이저 | /advisor | 빠른 모델이 막혔을 때 더 강한 모델에게 자문을 구함 |
슬래시 명령어와 단축키 빠르게 익히기
Claude Code를 매일 쓴다면 /로 시작하는 슬래시 명령어와 몇 가지 단축키만 익혀도 작업 속도가 눈에 띄게 빨라집니다. 자주 쓰는 프롬프트는 .claude/commands/에 마크다운 파일로 저장하면 그 파일명이 곧 커스텀 명령이 됩니다.
| 구분 | 대표 예시 | 설명 |
|---|---|---|
| 내장 슬래시 명령어 | /clear, /compact, /model, /init | 대화 초기화, 컨텍스트 압축, 모델 선택, CLAUDE.md 생성 |
| 세션 단축키 | Esc, Shift+Tab, Ctrl+L, ↑ | 작업 중단, 권한 모드 순환, 화면 정리, 이전 명령 불러오기 |
| 커스텀 명령 만들기 | .claude/commands/이름.md | 저장한 파일명이 그대로 /이름 명령이 됨 |
전체 목록은 슬래시 명령어 가이드와 단축키 치트시트에서 확인하세요.
실전 워크플로 5가지 — 탐색부터 PR까지
Claude Code로 실제 개발 업무를 처리하는 흐름은 크게 코드 탐색·디버그·리팩터·테스트 작성·PR 생성 다섯 가지로 나눌 수 있습니다. 공통 원칙은 "먼저 읽고 계획한 뒤 고치는" 순서를 지키는 것입니다.
| 워크플로 | 핵심 커맨드/기능 | 설명 |
|---|---|---|
| 코드 탐색 | @파일경로 | 낯선 코드·기능 위치를 읽기 전용으로 파악 |
| 디버그 | 에러 메시지와 함께 질문 | 버그 원인 추적과 수정을 함께 요청 |
| 리팩터 | 점진적 진행 요청 | 레거시 패턴을 현대 패턴으로 단계별 전환 |
| 테스트 작성 | @파일 + 스타일 지정 | 기존 테스트 스타일과 엣지 케이스에 맞춘 테스트 생성 |
| PR 생성 | gh pr create, --from-pr <번호> | 변경사항을 PR로 만들고 이전 PR 세션으로 복귀 |
각 워크플로의 실제 프롬프트 예시와 /compact로 컨텍스트를 정리하는 팁은 Claude Code 활용 예시에 정리되어 있습니다.
MCP로 외부 도구 연결하기
MCP(Model Context Protocol)는 AI와 외부 도구·데이터를 연결하는 표준 규약으로, "AI를 위한 USB-C 포트"에 비유됩니다. Claude Code에 MCP 서버를 붙이면 GitHub·Slack·Notion·데이터베이스 같은 외부 시스템을 대화 중에 직접 다룰 수 있습니다. 예제 카테고리는 아니지만 실전에서 자동화·헤드리스 작업과 함께 가장 많이 묶이는 영역이라 이 허브에도 대표 가이드를 정리합니다.
| 예제 | 핵심 커맨드 | 설명 |
|---|---|---|
| MCP란? | — | MCP 개념과 왜 표준 규약이 필요한지 설명 |
| MCP 서버 연결 | claude mcp add --transport http 이름 URL, claude mcp list | local·project·user 스코프로 MCP 서버를 추가·조회·삭제 |
| 추천 MCP 서버 | — | GitHub·Slack·Notion·PostgreSQL 등 용도별 대표 서버 목록 |
GitHub·Slack·Notion·PostgreSQL·Playwright·Filesystem·Figma 등 서버별 상세 연결 가이드는 MCP 카테고리에 모여 있습니다.
자주 묻는 질문
Q. Claude Code 예제를 어디서부터 시작해야 하나요?
가장 빠른 시작점은 헤드리스 모드와 슬래시 명령어입니다. claude -p로 비대화형 자동화를 먼저 체감하고, /clear·/compact 같은 기본 명령어에 익숙해지면 훅·서브에이전트·MCP로 범위를 넓히는 순서가 무리가 없습니다.
Q. 훅과 서브에이전트는 어떻게 다른가요?
훅은 특정 시점마다 정해진 규칙대로 자동 실행되는 결정적 동작이고, 서브에이전트는 작업을 위임받아 독립된 컨텍스트에서 스스로 판단하는 전문 AI라는 점이 다릅니다.
Q. GitHub Actions 자동화를 쓰려면 무엇이 필요한가요?/install-github-app 명령으로 GitHub 앱을 설치하고, 리포지토리 시크릿에 ANTHROPIC_API_KEY를 등록해야 합니다. 키 값은 코드나 글에 직접 넣지 말고 반드시 GitHub Secret으로만 보관해야 합니다.
Q. MCP도 이 예제 허브에서 다루나요?
네, MCP는 별도 카테고리로 운영되지만 자동화·헤드리스 작업과 자주 함께 쓰이므로 대표 가이드 3개를 이 허브에 정리했습니다. 서버별 상세 설정은 MCP 카테고리에서 더 찾을 수 있습니다.
이 허브는 새 예제를 만들지 않고 기존 실전 가이드를 유형별 지도로 다시 정리한 글입니다. 각 표의 링크를 따라가면 명령어와 설정 파일까지 전체 내용을 확인할 수 있습니다.