Claude Code 사용팁 총정리 - 해커톤 우승자의 70가지 파워 팁 핵심 요약

들어가며

Claude Code를 사용하면서 "이걸 좀 더 잘 쓸 수 있는 방법이 없을까?" 하고 고민해본 적 있으신가요?

이 글은 Anthropic 해커톤 우승자 ykdojo와 Anthropic DevRel Ado Kukic가 공개한 70가지 이상의 실전 팁을 정리한 자료를 바탕으로, 핵심적인 내용을 주제별로 추려 소개합니다. 이 글은 해당 자료를 블로그 형식으로 재구성하여 정리한 것입니다.

1. 에이전틱 개발자의 사고방식 — "분해하고 정복하라"

Claude Code를 잘 쓰는 핵심은 "큰 문제를 잘게 쪼개는 능력"입니다.

잘못된 접근: "로그인 페이지를 만들어줘"

에이전틱 접근:

DB 스키마 설계
ORM 마이그레이션
UI 컴포넌트
API 로직
리다이렉트
테스트

ykdojo는 음성 전사 시스템을 만들 때도 "음성 전사 앱을 만들어줘"라고 하지 않고, 모델 다운로드 → 음성 녹음 → 오디오 전사 → 키보드 단축키 → 텍스트 삽입 → UI 통합 순으로 단계적으로 구축했다고 합니다.

AI는 명확하고 구체적인 지시를 받았을 때 가장 뛰어난 성능을 발휘합니다.

계획 모드 vs. 욜로 모드

계획 모드 (Plan Mode): Shift+Tab 두 번으로 진입. Claude가 코드베이스를 분석하고 계획을 세우지만, 승인 전까지 아무것도 편집하지 않음. Ado는 "90%의 시간 동안 계획 모드를 사용한다"고 합니다.
욜로 모드 (YOLO Mode): claude --dangerously-skip-permissions 플래그로 실행. 모든 작업이 자동 승인됩니다. 반드시 컨테이너 안에서만 사용하세요!

추상화 수준 선택하기

Vibe Coding (높은 추상화): 전체 구조와 흐름만 파악. 일회성 프로젝트, 프로토타입에 적합
Deep Dive (낮은 추상화): 파일 구조, 함수, 코드 라인까지 꼼꼼히 검토. 프로덕션, 보안, 디버깅에 필수

2. 환경 설정과 필수 명령어

꼭 알아야 할 슬래시 명령어

명령어	설명	사용 시점
`/usage`	토큰 사용량과 리셋 시간 표시	매 세션 시작 시
`/clear`	대화 내용 초기화	컨텍스트 오염 시
`/context`	컨텍스트 윈도우 X-Ray	성능 저하 느낄 때
`/stats`	활동 그래프 및 통계	주간 회고 시
`/chrome`	크롬 브라우저 통합	UI 테스트 시
`/export`	대화 내역 마크다운 내보내기	기록 보존 시

! Prefix — 즉시 실행의 마법

! 접두사를 붙이면 Claude의 처리 없이 즉시 셸 명령이 실행됩니다. 토큰 낭비를 방지하고 속도를 높이는 간단하지만 강력한 팁입니다.

> !git status    # 즉시 결과 표시
> !git diff      # Claude는 결과만 읽음

CLAUDE.md — AI를 위한 프로젝트 설명서

새 프로젝트에서 /init을 실행하면 Claude가 코드베이스를 분석하여 CLAUDE.md 초안을 자동 생성합니다. 직접 편집하지 않고 자연어로 지시할 수도 있습니다:

> Update Claude.md: always use bun instead of npm

ykdojo: "처음에는 CLAUDE.md 없이 시작하세요. 같은 말을 반복하게 되면 그때 추가하세요."

터미널 별칭으로 빠른 접근

alias c='claude'
alias cc='claude --continue'
alias cr='claude --resume'
alias ch='claude --chrome'

3. 생산성을 극대화하는 핵심 기술

음성으로 코딩하기

평균 타이핑 속도 분당 40단어 vs 말하기 분당 150단어 = 3.75배 속도 차이. 특히 복잡한 요구사항 설명이나 여러 단계 지시 시 효과적입니다.

도구	플랫폼	특징
superwhisper	macOS	로컬 처리, 빠름 ($30 일회성)
MacWhisper	macOS	Whisper 기반 (무료/프리미엄)

키보드 단축키 완전 정복

단축키	기능
`Esc Esc`	대화/코드 되감기 (Undo)
`Ctrl+R`	역방향 검색 (명령어 히스토리)
`Ctrl+S`	프롬프트 임시 저장 (Stash)
`Ctrl+G`	외부 에디터에서 편집
`Ctrl+B`	실행 중인 명령어를 백그라운드로 이동
`\` + Enter	여러 줄 입력

4. 컨텍스트 관리의 예술 — "AI 컨텍스트는 우유와 같다"

Claude Code는 최대 200,000 토큰의 컨텍스트 윈도우를 가지고 있지만 무한하지 않습니다. ykdojo는 컨텍스트를 우유에 비유합니다 — 신선하고 압축된 상태를 유지하는 것이 핵심입니다.

HANDOFF.md 기법

대화가 길어질 때 컨텍스트를 효율적으로 이관하는 방법입니다:

/context로 사용량 확인 (50k 토큰 이상 시 주의)
HANDOFF.md 생성 요청 (시도한 것, 성공한 것, 실패한 것, 다음 단계)
/clear로 새 세션 시작
@HANDOFF.md 로드하여 작업 이어가기

터미널 탭으로 멀티태스킹

하나의 대화에서 여러 작업을 섞으면 컨텍스트가 오염됩니다. 3-4개의 터미널 탭을 동시에 열어 독립적인 작업을 수행하세요.

탭	용도	예시
탭 1	메인 개발	새 기능 구현
탭 2	버그 수정	긴급 핫픽스
탭 3	리서치	새 라이브러리 테스트
탭 4	DevOps	CI/CD 디버깅

ykdojo: "각 탭은 독립적인 '두뇌'입니다. 작업을 섞지 마세요."

컨텍스트 최적화 전략

10개 미만의 MCP + 80개 미만의 활성 도구 유지
사용하지 않는 MCP는 /mcp로 비활성화
CLAUDE.md 간소화
/clone으로 대화 복제, /half-clone으로 반복제 (컨텍스트 절반 절약)

5. Git과 GitHub 워크플로우

자동 커밋 및 PR 생성

> "변경 사항을 분석하고 적절한 커밋 메시지를 작성한 후 커밋해줘"
> "현재 브랜치의 변경 사항으로 draft PR을 만들어줘"

.github/pull_request_template.md 파일을 만들어두면 Claude가 참고하여 PR 본문을 작성합니다.

Git worktrees로 병렬 브랜치 작업

하나의 저장소에서 여러 작업 디렉토리를 만들어 각각 다른 브랜치를 체크아웃할 수 있습니다:

git worktree add ../myapp-feature-auth feature/auth

ykdojo: "Worktree는 컨텍스트 스위칭 비용을 제거합니다"

보안 감사 — cc-safe

ykdojo가 만든 위험한 명령어 감사 도구입니다. sudo, rm -rf, chmod 777, git push --force 등 위험한 패턴을 감지합니다.

npx cc-safe ~/projects

"한 달에 한 번은 cc-safe를 실행하여 승인된 명령어를 감사하세요"

6. MCP, Hooks, Agents — 고급 기능 활용

MCP: 외부 세계와의 연결

MCP(Model Context Protocol)는 Claude가 외부 서비스 및 API와 직접 통신할 수 있도록 하는 프로토콜입니다.

# Playwright MCP (브라우저 자동화)
claude mcp add -s user playwright npx @playwright/mcp@latest

# Supabase MCP (DB 직접 쿼리)
claude mcp add -s user supabase npx @supabase/mcp@latest

Hooks: AI에게 가드레일 제공

Hooks는 특정 이벤트 발생 시 자동으로 실행되는 셸 명령어로, AI의 확률적 행동에 결정론적 제어를 추가합니다.

Hook	실행 시점	사용 사례
PreToolUse	도구 실행 전	위험한 명령어 차단
PostToolUse	도구 실행 후	로그 기록, 알림
Notification	알림 시	외부 시스템 통합

CLAUDE.md vs Skills vs Slash Commands

기능	로딩 시점	토큰 효율성
CLAUDE.md	모든 대화 시작 시	낮음 (항상 로드)
Skills	필요 시 자동	높음
Slash Commands	수동 호출 시	높음

Ado: "산타는 모든 선물을 혼자 포장하지 않습니다. 엘프들이 있죠. 서브에이전트는 Claude의 엘프입니다."

7. 시스템 최적화와 자동화

시스템 프롬프트 슬림화

ykdojo는 시스템 프롬프트를 19k 토큰에서 10k 이하로 절반 가까이 줄이는 데 성공했습니다. 더 많은 코드 파일과 대화 기록을 컨텍스트에 담을 수 있고, 응답 속도도 향상됩니다.

Headless 모드로 CI/CD 통합

# 기본 사용
claude -p "Fix the lint errors"

# 파이프라인 통합
git diff | claude -p "Explain these changes"

# JSON 출력
echo "Review this PR" | claude -p --json

Ado: "Headless 모드는 AI를 파이프라인에 통합합니다. -p 플래그는 비대화형으로 실행하고 stdout으로 직접 출력"

자동화의 7단계 여정

ykdojo의 자동화 레벨은 이런 순서로 진화했습니다:

ChatGPT에서 코드 복사-붙여넣기
Claude Code로 터미널 통합
음성 전사 시스템으로 타이핑 자동화
CLAUDE.md로 반복 지시 자동화
커스텀 슬래시 명령어로 워크플로우 자동화
Skills로 Claude의 자동 판단 자동화
Hooks로 규칙 강제 자동화

"같은 작업을 3번 이상 반복한다면, 자동화할 방법을 찾으세요"

8. 컨테이너와 샌드박스 — 안전하게 실험하기

YOLO 모드(--dangerously-skip-permissions)를 사용하고 싶다면, 반드시 Docker 컨테이너 안에서 실행하세요:

docker build -t claude-sandbox .
docker run -it --rm \
    -v $(pwd):/workspace \
    -e ANTHROPIC_API_KEY=$ANTHROPIC_API_KEY \
    claude-sandbox
claude --dangerously-skip-permissions

/sandbox 명령어로 특정 명령어만 자동 승인하는 중간 단계도 있습니다:

> /sandbox
> "npm install, npm test, git status, git diff를 자동 승인해줘"

9. 브라우저 통합과 웹 자동화

Claude Code는 Chrome과 직접 통합되어 브라우저를 제어할 수 있습니다:

> "localhost:3000으로 이동하여 로그인 버튼을 클릭해줘.
   콘솔에 에러가 있는지 확인하고, 있다면 코드를 수정해줘"

동적 웹사이트 작업이 필요하면 Playwright MCP를 추가하고, Claude의 브라우저로 접근이 막힌 사이트에는 Gemini CLI를 대체 수단으로 활용할 수 있습니다.

10. 실전 활용 사례

TDD 워크플로우: 실패하는 테스트 작성 → 커밋 → 통과시키는 코드 작성 → 커밋. AI 생성 코드는 빠르지만 실수도 빠르게 만들어지므로 테스트가 안전망 역할을 합니다.
글쓰기 도우미: 기술 문서, 블로그 포스트, 튜토리얼 작성. "마지막 문단에서 이전 내용을 반복하지 마"처럼 구체적으로 지시하는 것이 핵심입니다.
DevOps 엔지니어: GitHub Actions 실패 자동 조사, Docker 이미지 최적화
범용 인터페이스: 비디오 편집(ffmpeg), 오디오 전사(Whisper), 디스크 공간 정리 등 모든 컴퓨터 작업에 활용

"컴퓨터에서 하고 싶은 일이 있으면, 일단 Claude Code에게 물어보세요"

출력 검증 방법

테스트 코드 작성 (엣지 케이스 포함)
GitHub Desktop으로 diff 시각적 검토
Draft PR 화면에서 검토
"모든 주장을 검증하고 결과를 표로 정리해줘"로 자기 검증

11. 고급 기능 — Extended Thinking, LSP, Agent SDK

ultrathink 키워드

프롬프트에 ultrathink을 포함하면 Claude가 응답 전 최대 32k 토큰을 내부 추론에 할당합니다:

> "ultrathink: 이 아키텍처 결정의 장단점을 깊이 분석해줘"

Claude Agent SDK

Claude Code의 에이전트 루프, 도구, 컨텍스트 관리를 SDK로 사용하여 커스텀 CI/CD 파이프라인, 사내 도구 임베딩, 전용 에이전트를 개발할 수 있습니다.

12. 학습 로드맵

초급 (1-3개월)

설치 및 기본 명령어 → CLAUDE.md 설정 → 컨텍스트 관리 기초 → Git 통합 → 별칭/단축키 → 음성 코딩

중급 (3-12개월)

MCP 서버 연동 → Hooks 설정 → Skills 및 Slash Commands → 컨테이너/YOLO 모드 → Subagents/병렬 작업

고급 (1년 이상)

시스템 프롬프트 분석 및 패치 → 맞춤형 MCP 서버 개발 → 멀티 에이전트 오케스트레이션 → Claude Agent SDK 활용

핵심 요약 5가지

큰 문제를 작은 단위로 분해하라
컨텍스트는 우유와 같다 — 신선하게 유지
상황에 맞는 추상화 수준을 선택하라
3번 이상 반복하면 자동화하라
사용이 최고의 학습이다

AI는 부조종사, 주인공은 당신입니다.

출처 및 참고 자료

기반 자료 1: ykdojo의 claude-code-tips — Anthropic 해커톤 우승자의 43가지 팁
기반 자료 2: Ado Kukic의 Advent of Claude — Anthropic DevRel의 31가지 팁
공식 문서: Claude Code 공식 문서
공식 블로그: Anthropic Engineering - Claude Code Best Practices
커뮤니티: r/ClaudeAI

이 글은 위 자료들을 바탕으로 핵심 내용을 재구성하여 정리한 것입니다.

저작자표시 비영리 동일조건 (새창열림)

'Programming' 카테고리의 다른 글

자료구조(배열, (연결)리스트, 스택, 큐), 시간 복잡도, 공간 복잡도 정리 (0)	2025.02.27
정규 표현식(Regex) 기본 문법 정리 (0)	2024.05.20