[Claude Code] 해커톤 우승자의 70가지 파워 팁

출처: ykdojo/claude-code-tips (Anthropic 해커톤 우승자 YK Dojo) + Advent of Claude 2025 (Anthropic DevRel Ado Kukic)

두 가이드의 팁을 주제별로 통합 정리하고, 각 팁마다 바로 쓸 수 있는 명령어·스크립트·설정을 포함함.

1. 초기 설정

1-1. /init — 프로젝트 온보딩 자동화

새 프로젝트에서 가장 먼저 실행할 명령. Claude가 코드베이스를 읽고 CLAUDE.md를 자동 생성함.

# Claude Code 프롬프트에서
/init

생성되는 CLAUDE.md에는 빌드/테스트 명령, 디렉토리 구조, 코드 컨벤션, 아키텍처 결정 사항 등이 담김.

모듈식 규칙 파일도 가능:

.claude/rules/
├── testing.md      # 테스트 관련 규칙
├── api-design.md   # API 설계 규칙
└── security.md     # 보안 규칙

YAML 프론트매터로 특정 경로에만 규칙을 적용할 수도 있음:

---
paths: src/api/**/*.ts
---
# API 개발 규칙
- 모든 API 엔드포인트에 입력 유효성 검사 필수

1-2. CLAUDE.md 메모리 업데이트

코딩 흐름을 끊지 않고 메모리에 기억시키는 법:

# Claude Code 프롬프트에서 직접 말하면 됨
"CLAUDE.md에 추가해줘: 이 프로젝트에서는 npm 대신 항상 bun을 사용"

1-3. CLAUDE.md vs Skills vs Slash Commands vs Plugins 차이

구분	로딩 시점	호출 방식	용도
CLAUDE.md	모든 대화 시작 시 자동 로딩	자동	프로젝트 전반 규칙, 컨벤션
Skills	Claude가 관련성 판단 시에만 로딩	자동 (조건부)	특정 작업 전문 지식 (토큰 절약)
Slash Commands	사용자가 직접 호출할 때만	수동 (/명령)	정확한 타이밍에 실행할 프롬프트
Plugins	설치 후 위 모든 것의 번들	/plugin install	Skills + Commands + Hooks + MCP 등 통합 배포

1-4. 터미널 별칭(Alias) 설정

Claude Code를 자주 쓸수록 짧은 별칭이 효율적임.

# ~/.zshrc 또는 ~/.bashrc에 추가
alias c='claude'
alias gb='github'
alias co='code'

1-5. 커스텀 상태 표시줄 (Status Line)

Claude Code 하단에 모델명, 디렉토리, Git 브랜치, 토큰 사용량 등을 표시할 수 있음.

Opus 4.5 | 📁MyProject | 🔀main (0 uncommitted, synced) | █░░░░░░░░░ 12% of 200k tokens
💬 마지막으로 보낸 메시지 미리보기...

설정 방법:

• /statusline 명령으로 기본 설정 변경 가능
• 고급: ykdojo의 context-bar.sh 스크립트 참고

---

2. 필수 단축키 & 명령어

2-1. ! 접두사 — Bash 즉시 실행

토큰 낭비 없이 쉘 명령을 바로 실행하는 법. 모델 처리 없이 출력이 컨텍스트에 주입됨.

! git status
! npm test
! ls -la src/

2-2. Esc Esc — 되감기

실험적 접근을 시도한 뒤 마음에 안 들면 Esc 두 번으로 이전 체크포인트로 복귀. 대화와 코드 변경 모두 되돌릴 수 있음. (단, Bash 명령은 되돌릴 수 없음)

2-3. Ctrl+R — 프롬프트 역방향 검색

과거에 입력했던 프롬프트를 검색해서 재사용.

키	동작
Ctrl+R	역방향 검색 시작
Ctrl+R (반복)	다음 매치로 이동
Enter	바로 실행
Tab	편집 후 실행

2-4. Ctrl+S — 프롬프트 스태싱

git stash와 같은 개념. 작성 중인 프롬프트를 임시 저장하고, 다른 걸 먼저 보낸 뒤 자동 복원됨.

2-5. 프롬프트 자동 제안 (Tab 완성)

작업 완료 후 회색으로 후속 프롬프트가 제안되면:

키	동작
Tab	수락 후 편집
Enter	수락 후 즉시 실행

/config에서 토글 가능.

2-6. @ 멘션 — 즉시 컨텍스트 추가

@src/auth.ts           # 특정 파일 컨텍스트에 추가
@src/components/       # 디렉토리 전체 참조
@mcp:github            # MCP 서버 활성화/비활성화

Git 저장소에서 약 3배 빠르게 작동하고 퍼지 매칭도 지원함.

2-7. Vim 모드

/vim      # 활성화
/vim      # 다시 입력하면 비활성화 (vim에서 나가기 이렇게 쉬운 적 없었음)

명령	동작
h j k l	이동
ciw	단어 변경
dd	줄 삭제
w b	단어 단위 점프
A	줄 끝에 추가

2-8. 키보드 단축키 전체 요약

단축키	동작
!명령어	Bash 즉시 실행
Esc Esc	대화/코드 되감기
Ctrl+R	프롬프트 역방향 검색
Ctrl+S	프롬프트 스태시
Shift+Tab ×2	Plan 모드 토글
Alt+P / Option+P	모델 전환
Ctrl+O	상세 출력 모드 토글
Tab / Enter	프롬프트 제안 수락

---

3. 컨텍스트 관리

3-1. AI 컨텍스트는 우유 같은 것 — 신선하고 농축될수록 좋음

새 대화를 시작하면 성능이 가장 좋음. 대화가 길어질수록 컨텍스트가 길어지고 성능이 떨어짐. 새로운 주제가 생기면 새 대화를 시작하는 게 최선.

3-2. /compact — 능동적 컨텍스트 압축

자동 압축은 200k 토큰이 가득 찬 후에 일어남 (45k가 자동 압축용으로 예약). 하지만 수동으로 미리 하는 게 더 나음.

추천 워크플로 — 핸드오프 문서 작성:

# Claude에게 이렇게 요청
"지금까지의 작업 상태를 NEXT-STEPS.md에 정리해줘.
시도한 것, 성공한 것, 실패한 것을 설명해서
다음 에이전트가 이 파일 하나만 읽으면 바로 이어서 작업할 수 있도록."

그 다음 새 대화에서:

> NEXT-STEPS.md

이 한 줄이면 새 에이전트가 맥락을 이어받음.

자동 압축을 끄려면 /config에서 설정. 수동 압축 시 더 많은 토큰을 확보할 수 있음.

3-3. /context — 토큰 소비 X-Ray

무엇이 컨텍스트를 먹고 있는지 정확히 확인:

/context

시스템 프롬프트, MCP 서버 프롬프트, CLAUDE.md, 로딩된 Skills, 대화 기록 등의 토큰 사용량을 보여줌.

3-4. 시스템 프롬프트 슬리밍 (실험적)

시스템 프롬프트 + 도구 정의가 기본 약 18k 토큰(9%)을 차지함. ykdojo의 패치 시스템으로 약 11k로 줄일 수 있음 — 39% 절감.

구성 요소	패치 전	패치 후	절감
시스템 프롬프트	3.0k	2.2k	800
시스템 도구	14.6k	8.3k	6,300
합계	~18k	~11k	~7,100 (39%)

패치 스크립트: system-prompt 폴더 참고.

요구 사항: npm 설치 필수 (npm install -g @anthropic-ai/claude-code). 자동 업데이트를 막으려면:

# ~/.zshenv에 추가 (.zshrc가 아님! tmux 등 비대화형 셸에서도 적용되려면 .zshenv 필요)
export DISABLE_AUTOUPDATER=1

---

4. 세션 관리

4-1. 세션 이어하기

터미널이 닫히거나 노트북이 꺼져도 작업을 이어갈 수 있음.

claude --continue          # 마지막 대화 즉시 이어하기
claude --resume            # 과거 세션 목록에서 선택

세션 보존 기간은 cleanupPeriodDays 설정으로 조정 가능 (기본 30일).

4-2. 이름 붙인 세션

/rename api-migration           # 현재 세션에 이름 부여
/resume api-migration           # 이름으로 재개
claude --resume api-migration   # CLI에서도 가능

/resume 화면에서 P로 미리보기, R로 이름 변경 가능.

4-3. Claude Code Remote (텔레포트)

웹에서 시작한 작업을 로컬 터미널에서 이어받기:

# claude.ai/code 에서 세션 시작 후
claude --teleport session_abc123

모바일(iOS/Android)과 데스크톱 앱에서도 동일하게 작동함.

4-4. /export — 대화 내보내기

전체 대화를 마크다운으로 내보내기. 프롬프트, 응답, 도구 호출 기록 모두 포함됨.

/export

4-5. 대화 복제(Clone)로 분기하기 (실험적)

특정 지점에서 다른 접근을 시도하고 싶을 때:

# 스크립트 심볼릭 링크 설정
ln -s /path/to/clone-conversation.sh ~/.claude/scripts/clone-conversation.sh
ln -s /path/to/commands/clone.md ~/.claude/commands/clone.md

# 대화 중에
/clone

첫 메시지에 [CLONED] 태그가 붙어 목록에서 구분 가능.

4-6. 대화 기록 검색

모든 대화 기록은 ~/.claude/에 로컬 저장됨.

# "Reddit" 언급된 대화 찾기
grep -l -i "reddit" ~/.claude/projects/-Users-yk-Desktop-projects-*/*.jsonl

# 오늘 대화 중 특정 키워드 검색
find ~/.claude/projects/-*/*.jsonl -mtime 0 -exec grep -l -i "keyword" {} \;

# 사용자 메시지만 추출 (jq 필요)
cat ~/.claude/projects/.../conversation.jsonl | jq -r 'select(.type=="user") | .message.content'

또는 그냥 Claude에게 "오늘 X에 대해 뭘 얘기했지?" 하고 물어보면 알아서 검색함.

---

5. Git & GitHub 활용

5-1. Git & GitHub CLI 위임

커밋 메시지 작성, 브랜치 관리, PR 생성 등을 Claude에게 맡기면 됨.

# Claude에게 말하기
"현재 변경사항 커밋하고 적절한 메시지 작성해줘"
"draft PR 만들어줘"

팁: pull은 자동 허용하되, push는 수동 승인하는 게 안전함. Draft PR을 먼저 만들게 하면 리뷰 전에 위험을 줄일 수 있음.

5-2. Git Worktree로 병렬 브랜치 작업

여러 브랜치에서 동시에 작업할 때 충돌 없이 진행하는 법:

# Claude에게 말하기
"git worktree 만들어서 feature-x 브랜치에서 작업 시작해줘"

브랜치 + 디렉토리가 분리되어 여러 터미널 탭에서 동시 작업 가능.

5-3. git bisect 자동화

Claude Code에게 git bisect를 자율 실행시키려면 테스트 방법을 제공해야 함. tmux 패턴 활용:

tmux kill-session -t test-session 2>/dev/null
tmux new-session -d -s test-session
tmux send-keys -t test-session 'claude' Enter
sleep 2
tmux send-keys -t test-session '/context' Enter
sleep 1
tmux capture-pane -t test-session -p

이렇게 테스트 스크립트를 만들면 Claude가 각 커밋을 자동으로 테스트하며 문제 커밋을 찾아냄.

---

6. 음성 입력 & 입출력 워크플로

6-1. 음성으로 Claude에게 말하기

타이핑보다 음성이 훨씬 빠름. 로컬 음성 인식 앱 추천:

앱	특징
superwhisper	Mac 로컬 Whisper
MacWhisper	Mac 로컬 Whisper
Super Voice Assistant	오픈소스 (ykdojo 제작)

전사 오류가 있어도 Claude가 의도를 잘 파악함. 사무실에서는 이어폰으로 속삭이면 됨.

6-2. 출력 꺼내기

방법	명령
클립보드 직접 복사	pbcopy 사용 요청 (Mac/Linux)
파일로 저장	"결과를 파일에 저장하고 VS Code로 열어줘"
URL 브라우저에서 열기	"이 URL 브라우저에서 열어줘"
GitHub Desktop	"현재 레포를 GitHub Desktop에서 열어줘"

6-3. Cmd+A / Ctrl+A 활용

Claude가 접근 못하는 페이지(비공개 페이지, Reddit 등)의 내용은 전체 선택 → 복사 → 붙여넣기로 해결. 터미널 출력에도 동일하게 적용됨.

6-4. 마크다운의 위력

Claude Code로 작성 → 마크다운 저장이 가장 효율적인 워크플로. 블로그, LinkedIn 글, 문서 등 모두 마크다운으로 시작.

팁: 마크다운을 다른 플랫폼에 붙여넣을 때 서식이 안 먹히면, Notion에 먼저 붙여넣기 → Notion에서 복사 → 대상 플랫폼에 붙여넣기.

6-5. realpath로 절대경로 얻기

다른 폴더의 파일을 Claude에게 알려줄 때:

realpath some/relative/path
# 출력: /Users/me/projects/some/relative/path

---

7. 사고 모드 & 계획

7-1. Ultrathink — 확장 사고 모드

복잡한 아키텍처 결정이나 까다로운 디버깅에 유용. 최대 32k 토큰의 내부 추론을 할당함.

ultrathink: 우리 API에 캐싱 레이어를 설계해줘

MAX_THINKING_TOKENS가 설정되어 있으면 그 값이 우선 적용됨.

7-2. Plan 모드

Shift+Tab 두 번으로 진입. Claude가 코드를 읽고 분석하고 계획을 세우되, 승인 전까지 아무것도 수정하지 않음.

"90%의 경우 Plan 모드를 기본으로 사용함." — Ado Kukic

최신 버전에서는 계획 거부 시 피드백을 제공할 수 있어 반복이 빨라짐.

7-3. Extended Thinking (API)

API 직접 사용 시 단계별 추론 과정을 확인 가능:

thinking: { type: "enabled", budget_tokens: 5000 }

---

8. 권한 & 보안

8-1. /sandbox — 권한 경계 설정

한 번 경계를 정의하면 그 안에서 Claude가 자유롭게 작동함.

/sandbox

와일드카드 문법도 지원: mcp__server__*로 MCP 서버 전체 허용 가능.

8-2. YOLO 모드 (위험 — 신중히 사용)

claude --dangerously-skip-permissions

모든 권한 요청에 자동 승인. 이름에 "dangerously"가 들어간 이유가 있음 — 격리된 환경(컨테이너 등)에서만 사용 권장.

8-3. Hooks — 라이프사이클 이벤트 제어

확정적 제어를 확률적 AI에 적용하는 방법:

훅	시점
PreToolUse / PostToolUse	도구 실행 전/후
PermissionRequest	권한 요청 시 자동 승인/거부
Notification	Claude 알림 반응
SubagentStart / SubagentStop	에이전트 생성/종료 시

/hooks    # 설정 또는 .claude/settings.json 에서 구성

위험한 명령 차단, 알림 전송, 로깅, 외부 시스템 연동 등에 활용.

---

9. 자동화 & CI/CD

9-1. Headless 모드 (-p)

스크립트와 파이프라인에서 비대화형으로 실행:

claude -p "린트 에러 수정해줘"
claude -p "모든 함수 목록" | grep "async"
git diff | claude -p "이 변경사항 설명해줘"
echo "이 PR 리뷰해줘" | claude -p --json

9-2. Commands — 재사용 가능한 프롬프트

마크다운 파일로 슬래시 명령을 만들 수 있음. 인자도 지원:

/daily-standup                  # 매일 아침 루틴 프롬프트
/explain $ARGUMENTS             # /explain src/auth.ts

9-3. 수동 지수 백오프 (장시간 작업 대기)

Docker 빌드, GitHub CI 등 오래 걸리는 작업을 기다릴 때:

# Claude에게 이렇게 요청
"GitHub CI 상태를 지수 백오프로 체크해줘.
1분, 2분, 4분, 8분 간격으로 확인하고 완료되면 알려줘.
gh run view <run-id> | grep <job-name> 사용해."

gh run watch는 지속적으로 출력하여 토큰을 낭비하므로, 수동 백오프가 더 효율적임.

---

10. 멀티태스킹 & 병렬 작업

10-1. 터미널 탭 캐스케이드 방식

동시에 3~4개 작업까지 집중. 새 작업은 오른쪽 탭으로 열고, 왼쪽→오른쪽으로 순회하며 관리.

탭 1: 음성 전사 시스템 (상시)
탭 2: Docker 컨테이너 설정
탭 3: 디스크 사용량 확인
탭 4: 메인 프로젝트 작업
탭 5: 문서 작성

10-2. Git Worktree + 캐스케이드

위의 캐스케이드 방식 위에 Git worktree를 겹쳐 사용하면 각 탭이 독립된 브랜치에서 동작함.

---

11. 브라우저 & 외부 도구 연동

11-1. Claude Code + Chrome

claude.ai/chrome 확장 설치 후:

• 페이지 탐색, 버튼 클릭, 폼 작성
• 콘솔 에러 읽기, DOM 검사
• 스크린샷 촬영

"버그 고치고 동작 확인해줘"가 한 프롬프트로 가능해짐.

11-2. Gemini CLI를 백업 도구로 활용

Claude Code의 WebFetch가 접근 못하는 사이트(Reddit 등)를 Gemini CLI로 우회하는 스킬:

# ~/.claude/skills/reddit-fetch/SKILL.md 에 설정
# tmux 패턴으로 Gemini와 연동

스킬 파일 전문 참고. Gemini CLI 설치 필요.

---

12. 에이전트 & 확장성

12-1. Subagent (서브에이전트)

각 서브에이전트는 독립된 200k 컨텍스트 윈도우를 가짐. 전문화된 작업을 병렬 실행하고 결과를 메인에 병합.

# Claude에게 말하기
"이 세 파일의 테스트를 각각 서브에이전트로 병렬 작성해줘"

서브에이전트는 백그라운드에서 실행되며 MCP 도구에도 접근 가능.

12-2. Agent Skills

폴더 단위의 지침·스크립트·리소스 패키지. 한 번 만들면 어디서든 사용 가능. Agent Skills는 오픈 표준으로 다른 도구에서도 동작함.

12-3. Plugins

명령, 에이전트, 스킬, 훅, MCP 서버를 하나의 패키지로 번들링:

/plugin install my-setup

마켓플레이스에서 검색·필터링도 지원.

12-4. LSP (Language Server Protocol) 통합

Claude에게 IDE 수준의 코드 인텔리전스를 제공:

• 편집 후 즉시 진단(에러/경고)
• 정의로 이동, 참조 찾기, 호버 정보
• 타입 정보 및 코드 심볼 문서

12-5. Claude Agent SDK

Claude Code의 에이전트 루프·도구·컨텍스트 관리를 SDK로 사용. 10줄로 에이전트 구축 가능:

import { query } from '@anthropic-ai/claude-agent-sdk';

for await (const msg of query({
  prompt: "src/의 모든 public 함수에 대해 API 문서를 마크다운으로 생성해줘",
  options: {
    allowedTools: ["Read", "Write", "Glob"],
    permissionMode: "acceptEdits"
  }
})) {
  if (msg.type === 'result') console.log("Docs generated:", msg.result);
}

---

13. 고급 워크플로 & 철학

13-1. 컨테이너에서 위험한 장시간 작업 실행

--dangerously-skip-permissions는 컨테이너 안에서만 사용하는 게 안전. 리서치, 실험, 시스템 프롬프트 패칭 등에 적합.

Dockerfile 및 설정 참고.

13-2. 워커 Claude 오케스트레이션

로컬 Claude Code → 컨테이너 내 Claude Code를 tmux로 제어:

1. 로컬 Claude가 tmux 세션 시작
2. 컨테이너 접속
3. 컨테이너 내 Claude가 --dangerously-skip-permissions로 실행
4. tmux send-keys로 프롬프트 전송, capture-pane으로 출력 읽기

13-3. 멀티모델 오케스트레이션

Codex, Gemini CLI 등 다른 AI CLI도 컨테이너에서 실행하고 Claude Code가 중앙 인터페이스로 오케스트레이션. 수동으로 터미널 전환하며 복붙할 필요 없음.

13-4. Claude Code를 글쓰기 보조로 활용

1. 맥락 + 상세 지시를 음성으로 전달 → 1차 초안
2. 줄 단위로 검토하며 음성으로 피드백
3. 왼쪽 터미널 + 오른쪽 에디터 나란히 배치

13-5. 워크플로에 투자하기

CLAUDE.md 관리, 커스텀 상태줄, 음성 전사 앱 등 — 도구를 만드는 도구에 시간을 투자하는 것이 장기적으로 가장 큰 생산성 향상을 가져옴.

13-6. 가장 좋은 학습법: 직접 쓰는 것

"록 클라이밍을 잘하는 법? 록 클라이밍을 하는 거죠." — 세계적 록 클라이머

10,000시간 법칙 대신 10억 토큰 법칙. 많이 쓸수록 직관이 생김.

---

14. 퀵 레퍼런스

필수 명령어 모음

명령어	용도
/init	CLAUDE.md 자동 생성
/context	토큰 소비 확인
/compact	컨텍스트 수동 압축
/stats	사용 통계
/usage	사용량 한도 확인
/vim	Vim 모드 토글
/config	설정 열기
/hooks	라이프사이클 훅 설정
/sandbox	권한 경계 설정
/export	대화 마크다운 내보내기
/resume	과거 세션 재개
/rename	현재 세션 이름 지정
/statusline	상태줄 커스터마이징
/theme	테마 선택
/terminal-setup	터미널 통합 설정

CLI 플래그 모음

플래그	용도
-p "프롬프트"	Headless/비대화 모드
--continue	마지막 세션 이어하기
--resume	세션 선택해서 재개
--resume 이름	이름으로 세션 재개
--teleport id	웹 세션 로컬로 이어받기
--dangerously-skip-permissions	YOLO 모드