45가지 Claude Code 팁: 기초부터 고급까지
ykdojo가 정리한 8천 스타짜리 가이드의 핵심을 8개 주제로 큐레이션했습니다. 커스텀 상태 줄, 시스템 프롬프트 절반 줄이기, Gemini CLI를 minion으로 쓰기, 컨테이너 안에서 Claude Code를 또 돌리기 — 실전에서 검증된 패턴들입니다.
단순한 단축키 모음이 아니다.
컨텍스트가 떨어지는 순간을 다스리고, 자율 작업의 검증 루프를 닫고, 반복되는 지시를 스킬·플러그인·컨테이너로 끌어올리는 — 에이전트 코딩의 실무 운영 매뉴얼입니다.
"AI 컨텍스트는 우유와 같다 — 신선하고 농축되어 있을 때 가장 좋다."
1. 환경 설정 — 시작 전 정비
도구를 매일 쓴다면 처음 5분의 세팅이 매주 몇 시간을 돌려줍니다. 상태 줄, 별칭, 입력 단축키부터 손에 익혀두세요.
상태 줄을 커스터마이즈하라
모델, 디렉터리, git 브랜치, 미커밋 수, 토큰 사용률을 한 줄에 표시. 컨텍스트 잔량을 시각적으로 추적할 수 있다.
필수 슬래시 커맨드를 익혀라
/usage(레이트 리밋), /chrome(브라우저 통합), /mcp(MCP 서버), /stats(활동 그래프), /clear(대화 초기화) — / 만 눌러도 전체 목록을 볼 수 있다.
터미널 별칭을 등록하라
c=claude, ch=claude --chrome, co=code 같은 짧은 별칭으로 호출 비용을 줄인다. -c, -r 플래그와도 결합된다.
realpath로 절대 경로를 얻어라
다른 폴더의 파일을 가리킬 때 상대 경로 대신 realpath의 출력을 그대로 전달하면 모호함이 사라진다.
입력창 키보드 단축키를 활용하라
Ctrl+A/E(줄 끝/처음), Ctrl+W(단어 삭제), Ctrl+U/K(줄 잘라내기), Ctrl+G(외부 에디터로 열기). bash readline을 그대로 따른다.
2. 컨텍스트 관리 — 우유처럼 신선하고 농축되게
AI 컨텍스트는 우유와 같다. 신선하고 농축되어 있을 때 가장 좋다. 길어질수록 성능이 떨어지므로 능동적으로 잘라내고 다시 시작하라.
주제가 바뀌면 새 대화를 시작하라
긴 컨텍스트는 모델 성능을 떨어뜨린다. 새 주제·새 작업이면 망설이지 말고 새 세션으로 옮긴다.
능동적으로 컨텍스트를 압축하라
auto-compact를 끄고 HANDOFF.md를 직접 작성시키거나 plan mode로 컨텍스트를 정리한 뒤 새 에이전트에 인수인계.
대화 기록을 검색하라
~/.claude/projects/ 안의 .jsonl 파일을 grep/jq로 뒤지거나, Claude Code에게 직접 "오늘 X에 대해 뭐라고 얘기했지?"라고 묻는다.
시스템 프롬프트를 슬림화하라
시스템 프롬프트와 도구 정의가 약 19k 토큰(컨텍스트의 10%)을 잡아먹는다. 패치로 이를 9k 수준까지 줄일 수 있다. MCP는 ENABLE_TOOL_SEARCH로 lazy-load.
대화를 fork/clone 하라
특정 시점에서 다른 접근을 시도할 때 /fork로 분기. half-clone은 후반부만 남겨 토큰 사용량을 줄여준다.
3. 문제 해결 패턴 — 큰 문제를 작게
에이전트 코딩에서도 전통 소프트웨어 엔지니어링 능력은 그대로 가치가 있다. 분해 → 검증 루프 → 반복.
큰 문제를 작은 문제로 쪼개라
한 번에 풀리지 않으면 A→B 대신 A→A1→A2→A3→B로 분해. 가장 작은 부분 문제까지 내려가라.
쓰기-검증 사이클을 완성하라
자율 실행을 맡기려면 결과를 검증할 수단이 있어야 한다. tmux로 인터랙티브 출력을 캡처하거나, 테스트 코드를 함께 작성시킨다.
긴 작업엔 수동 지수 백오프
Docker 빌드, GitHub CI 같은 장기 작업은 1분 → 2분 → 4분으로 간격을 늘려가며 폴링. gh run watch보다 토큰 효율이 좋다.
미지의 영역에서도 용감해져라
낯선 언어/프레임워크여도 일단 들어가 본다. Claude Code와 함께 추측-실험-막다른 길-방향 전환을 빠르게 반복하면 결국 풀린다.
계획하되 빠르게 프로토타이핑하라
어떤 기술/구조/파일 배치를 쓸지는 처음에 결정해야 한다. plan mode 또는 "코드 작성 전에 계획 먼저" 지시로 시작.
과도한 코드는 단순화시켜라
Claude는 코드와 산문 모두에서 부풀리는 경향이 있다. "왜 이 줄을 추가했지?"를 물으며 단순화시킨다.
4. 워크플로우 가속 — 손이 모자랄 때
음성 입력, 멀티탭, 워크트리, 백그라운드 실행, 입출력 트릭 — 동시에 많은 일을 굴리기 위한 도구들.
타이핑 대신 음성으로 말해라
superwhisper/MacWhisper 같은 로컬 음성 전사 도구로 대화 속도를 끌어올린다. 약간의 오타는 모델이 알아서 해석한다.
Git/GitHub CLI를 위임하라
커밋 메시지, 브랜치, PR 생성을 모두 맡긴다. push는 위험하니 보통 자동 허용하지 않는다. draft PR은 안전한 시작점.
터미널 탭으로 멀티태스킹하라
최대 3-4개 작업을 캐스케이드(왼→오른쪽 sweep) 방식으로 운영. 가장 왼쪽 탭은 음성 전사 시스템 같은 영구 작업.
Git worktree로 병렬 브랜치 작업
같은 프로젝트의 여러 브랜치를 충돌 없이 동시에 진행. "워크트리 만들고 거기서 작업해"라고만 말하면 된다.
백그라운드 bash와 서브에이전트
Ctrl+B로 장기 작업을 백그라운드로 보내고 BashOutput으로 추후 확인. 큰 코드베이스는 서브에이전트 여러 개로 병렬 분석.
5. 입출력 트릭 — 데이터를 안팎으로 옮기는 법
터미널과 외부 도구 사이에서 텍스트가 깨끗하게 흘러가도록 하는 작은 기교들.
터미널에서 출력 빼내기
/copy 슬래시 커맨드, pbcopy로 클립보드 직행, 파일로 저장 후 VS Code 열기 — 깔끔한 복사를 위한 여러 경로.
Cmd+A · Ctrl+A는 친구다
AI가 못 가져오는 페이지(사설 페이지, Reddit 글, Gmail 스레드 등)는 전체 선택-복사로 직접 붙여넣어라. YouTube 자막도 동일.
마크다운이 답이다
Google Docs/Notion 대신 마크다운으로 작성. Claude Code와의 시너지가 가장 좋다.
링크 보존엔 Notion 경유
Slack 등에서 복사한 링크 텍스트는 Notion에 한 번 붙이고 다시 복사하면 마크다운 링크로 변환된다.
6. 확장하기 — 스킬, 플러그인, 컨테이너
CLAUDE.md, Skills, Slash Commands, Plugins, MCP — 각각의 쓰임이 다르다. 적재적소를 알면 토큰을 아끼고 통제력을 얻는다.
막힌 사이트는 Gemini CLI로 우회
WebFetch가 못 여는 사이트(Reddit 등)는 Gemini CLI를 fallback으로 쓰는 스킬을 만든다. tmux 패턴으로 호출.
위험한 장기 작업은 컨테이너에서
--dangerously-skip-permissions 세션은 컨테이너에서. SafeClaw로 격리된 worker Claude를 띄워 외부에서 tmux로 조종할 수 있다.
CLAUDE.md vs Skills vs Slash Commands vs Plugins
CLAUDE.md는 항상 로드되는 기본 프롬프트. Skills/Commands는 필요할 때만 로드(2.13에서 통합). Plugins는 이들을 묶어 배포.
CLAUDE.md는 단순하게, 주기적으로 점검
처음엔 비워두고 반복 지시가 생기면 그때 추가. 오래된 지시는 정기적으로 정리한다.
승인된 명령을 감사하라
settings.json의 allow 목록은 시간이 갈수록 위험해진다. cc-safe로 sudo, rm -rf, chmod 777, curl|sh 같은 패턴을 스캔.
테스트를 많이 써라 (TDD 활용)
실패하는 테스트를 먼저 작성·커밋한 뒤 구현을 맡기면 명확한 계약이 생긴다. AI도 자기 코드를 검증할 수 있다.
dx 플러그인을 설치하라
/dx:gha, /dx:handoff, /dx:clone, /dx:half-clone, /dx:reddit-fetch, /dx:review-claudemd를 한 번에 묶은 패키지.
퀵 셋업 스크립트로 일괄 적용
DX 플러그인, cc-safe, 상태 줄, 별칭, 권한 등 추천 설정을 한 줄로 적용하는 setup.sh 제공.
7. Claude Code의 진짜 가능성 — 코딩 그 너머
Claude Code는 IDE가 아니라 디지털 세계 전체의 보편적 인터페이스다. 글쓰기, 리뷰, 리서치, DevOps까지 흡수한다.
글쓰기 어시스턴트
맥락을 풍부히 주고 음성으로 지시 → 초안 → 줄 단위 피드백. 터미널/에디터를 양쪽에 띄우고 핑퐁한다.
인터랙티브 PR 리뷰
gh로 PR을 가져와 파일 단위로, 또는 전체 구조 단위로 페이스를 조절하며 리뷰. 원샷 도구와 다른 강점이다.
리서치 도구로서의 Claude Code
GitHub Actions 실패 분석, Reddit 시장 조사, 코드베이스 탐색 — 적절한 도구(gh, MCP, Cmd+A)와 연결만 해주면 다 한다.
출력을 검증하는 여러 방법을 익혀라
테스트, 비주얼 git 클라이언트, 드래프트 PR, 자기 검증("모든 주장 더블체크하고 표로 만들어") — 다층 검증.
DevOps 엔지니어로 활용
CI 실패는 "근본 원인을 파헤쳐"라고 던진다. /gha 슬래시 커맨드는 flaky 여부, 깨뜨린 커밋, 수정안까지 자동 조사.
범용 인터페이스로서의 Claude Code
ffmpeg 영상 편집, Whisper 전사, CSV 분석, 디스크 정리 — 컴퓨터에서 하고 싶은 모든 일의 첫 진입점.
올바른 추상화 수준을 선택하라
vibe coding과 라인 단위 검토는 이분법이 아니다. 빙산을 멀리서 보거나, 가까이 다가가거나, 다이빙해 들어갈 수 있다.
8. 마인드셋 — 장기적으로 어떻게 잘 쓸 것인가
도구를 익히는 것보다 더 중요한 것은 자세다. 1만 시간이 아니라 10억 토큰의 시대 — 자동화의 자동화로 자유를 늘려라.
자신의 워크플로우에 투자하라
음성 전사기를 직접 만들 필요까진 없지만, CLAUDE.md를 정돈하고 팁을 익히는 시간이 곧 도구에 대한 투자다.
실력을 키우는 가장 좋은 방법은 그냥 쓰는 것
10000시간 룰의 AI 버전: 10억 토큰 룰. 동시에 여러 세션을 돌리며 토큰을 많이 소비하는 것이 곧 직관의 형성.
개인화된 소프트웨어의 시대
전용 음성 전사기, 슬랙 CLI, 슬라이드 템플릿 — 한두 시간이면 "나만 쓰는" 도구를 만들 수 있다.
자동화의 자동화
ChatGPT 시절 명령 복붙을 자동화한 것에서 시작해, 타이핑(음성)을 자동화하고, 반복 지시는 CLAUDE.md/스킬로 옮긴다.
지식을 공유하고 기여하라
포스트, 사내 세션, 이슈 제출 — 공유는 일방향이 아니다. 댓글에서 새로운 트릭을 배우는 경우가 많다.
계속 배워라
Claude Code에 직접 묻기, /release-notes 확인, r/ClaudeAI, Anthropic DevRel(@adocomplete)의 "Advent of Claude".
정리
팁을 외우는 것보다 중요한 건 매 작업에서 토큰을 의식하고, 검증 루프를 닫고, 반복되는 패턴을 즉시 스킬·플러그인으로 옮기는 습관입니다. 그 결과로 만들어지는 것은 더 좋은 코드가 아니라 더 좋은 생성 장치입니다.