Series 21 — Claude Code Field Guide · Part I

처음 30분

설치 직후 반드시 해야 할 다섯 가지. "그냥 쓰는 것"과 "세팅하고 쓰는 것"은 완전히 다른 도구가 된다.

Part I — The $1B Terminal

터미널이 IDE를 이긴 날

2025년 6월, Anthropic이 Claude Code를 출시했다. 터미널에서 동작하는 AI 코딩 에이전트. 화려한 GUI도 없고, 코드 하이라이팅도 기본 수준이다. 그런데 출시 6개월 만에 연간 매출 10억 달러를 돌파했다. ChatGPT조차 이 속도는 내지 못했다.

$1B 출시 6개월 만에
연간 매출 달성
85% AI 코딩 도구를
사용하는 개발자 비율
1,890만 Claude 플랫폼
월간 사용자

Cursor가 IDE 통합으로, GitHub Copilot이 자동완성으로 시장을 점유하는 동안, Claude Code는 다른 방향을 선택했다. 터미널 하나에 모든 것을 건 것이다. 파일 탐색, 코드 수정, Git 조작, 테스트 실행, 배포까지 — 모두 하나의 대화 안에서 처리한다.

그런데 대부분의 사용자는 Claude Code의 10%도 활용하지 못하고 있다. ykdojo가 정리한 45가지 팁 중에서, 실전에서 가장 큰 차이를 만드는 것들만 추렸다. 이 시리즈는 그 큐레이션이다.

1편은 설치 직후 처음 30분 안에 해야 할 것들이다. 이 30분이 앞으로 수백 시간의 생산성을 결정한다.

Part II — Status Line

상태 표시줄을 바꿔라

Tip 00 — Customize Your Status Line

지금 어떤 모델을, 얼마나 쓰고 있는지 모른다면 문제다

Claude Code의 기본 상태 표시줄은 거의 아무 정보도 보여주지 않는다. 커스텀 상태 표시줄을 설정하면 현재 모델, Git 브랜치, 토큰 사용량, 대화 요약을 한눈에 볼 수 있다.

Claude Code는 상황에 따라 다른 모델을 사용한다. Haiku로 간단한 작업을 처리하고, Opus로 복잡한 추론을 하고, Sonnet으로 일반적인 코딩을 한다. 문제는 지금 어떤 모델이 동작 중인지 기본 UI에서는 알 수 없다는 것이다.

토큰 사용량도 마찬가지다. Max 요금제($200/월)의 레이트 리밋에 걸려야 "아, 많이 썼구나" 알게 되는 건 너무 늦다. 상태 표시줄은 이 모든 정보를 실시간으로 보여주는 계기판이다.

~/.claude/settings.json { "status_line": { "enabled": true, "show_model": true, "show_git_branch": true, "show_token_usage": true, "show_conversation_summary": true } }

ykdojo는 10가지 컬러 테마의 커스텀 상태 표시줄 스크립트를 공개했다. 핵심은 설정이 아니라 습관이다. 토큰 사용량을 보는 습관이 생기면, 컨텍스트 관리(2편의 핵심 주제)가 자연스러워진다.

Part III — Five Commands

외워야 할 다섯 가지

Tip 01 — Learn Essential Slash Commands

이 다섯 개만 알면 된다

Claude Code에는 수십 개의 슬래시 커맨드가 있지만, 매일 쓰는 건 다섯 개다. 나머지는 필요할 때 찾으면 된다.

/usage 레이트 리밋 현황을 확인한다. Pro($20/월)와 Max($100~200/월)에 따라 사용 가능한 토큰이 다르다. 갑자기 느려지면 이것부터 확인한다.
/clear 대화를 초기화하고 새로 시작한다. 컨텍스트가 오염되었거나, 새 작업으로 전환할 때. 가장 자주 쓰는 커맨드.
/compact 현재 대화를 압축한다. 대화가 길어져서 성능이 떨어질 때 사용. 하지만 2편에서 설명할 이유로, 수동 압축이 더 낫다.
/mcp MCP(Model Context Protocol) 서버를 관리한다. 외부 도구(DB, API, 브라우저 등)를 Claude Code에 연결할 때.
/stats 현재 세션의 활동 통계를 보여준다. 얼마나 작업했는지, 어떤 파일을 수정했는지 한눈에 파악.
/help 사용 가능한 모든 커맨드를 보여준다. 기억나지 않는 커맨드가 있을 때 여기서 찾는다.

핵심은 /clear와 /usage다. /clear는 "새 시작"이고, /usage는 "현재 상태 확인"이다. 이 두 가지를 습관적으로 쓰는 것만으로 대부분의 성능 문제를 예방할 수 있다.

/clear는 포기가 아니라 전략이다.
오염된 컨텍스트에서 계속 작업하는 것이
진짜 시간 낭비다.

Part IV — Aliases

3초의 차이가 300시간을 만든다

Tip 07 — Set Up Terminal Aliases

매번 claude --continue를 치는 건 비효율이다

터미널 별칭을 설정하면 2-3글자로 Claude Code를 실행할 수 있다. 하루에 수십 번 반복되는 입력이니, 초 단위의 절약이 시간 단위로 누적된다.

~/.bashrc 또는 ~/.zshrc # Claude Code 기본 실행 alias c="claude" # 이전 대화 이어서 alias cr="claude --resume" # 원라이너 명령 실행 alias cc="claude -c" # 프로젝트 폴더로 이동 후 실행 alias cw="cd ~/projects && claude" # VS Code에서 현재 폴더 열기 alias co="code ."

가장 자주 쓰는 별칭은 c(실행)와 cr(이어서)이다. 특히 cr은 중요하다. 대화를 /clear로 정리한 뒤, 이전 대화를 잠깐 참조하고 싶을 때 --resume 플래그가 필요한데, 이를 매번 타이핑하는 건 번거롭다.

cc(원라이너)도 과소평가된 기능이다. 대화를 시작하지 않고 단일 명령만 실행하고 싶을 때 유용하다.

원라이너 예시 $ cc "이 프로젝트의 README.md를 한국어로 번역해줘" $ cc "package.json의 의존성 중 보안 취약점이 있는지 확인해줘" $ cc "최근 5개 커밋의 변경사항을 요약해줘"

별칭 설정은 1분이면 끝난다. 하지만 이 1분이 앞으로 수천 번의 타이핑을 줄인다. 도구에 투자하는 시간은 복리로 돌아온다.

Part V — Getting Output Out

결과를 꺼내는 법

Tip 06 — Getting Output Out of Your Terminal

터미널 안에서만 보고 끝내지 마라

Claude Code의 출력은 터미널에 갇혀 있다. 코드 리뷰를 위해, 문서화를 위해, 팀과 공유하기 위해 결과를 밖으로 꺼내는 방법을 알아야 한다.

01

/copy

마지막 응답을 클립보드에 복사한다. 가장 빠른 방법. 슬랙이나 문서에 바로 붙여넣기 가능.

02

파일로 출력

"결과를 output.md에 저장해줘"라고 요청하면 Claude가 파일로 작성한다. 긴 분석이나 리포트에 적합.

03

VS Code 연동

co(alias)로 VS Code를 열면, Claude가 수정한 파일을 즉시 확인할 수 있다. diff 뷰로 변경사항을 검토.

이 중에서 실전에서 가장 많이 쓰는 건 파일로 출력이다. 특히 분석 결과, 리팩토링 계획, 아키텍처 문서 같은 긴 텍스트는 터미널에서 읽는 것보다 파일로 저장한 뒤 에디터에서 읽는 게 훨씬 효율적이다.

실전 패턴 # 분석 결과를 파일로 $ c > 이 프로젝트의 아키텍처를 분석해서 ARCHITECTURE.md에 정리해줘 # 코드 리뷰 결과를 파일로 > src/auth/ 디렉토리의 코드 리뷰 결과를 review.md에 작성해줘 # 마이그레이션 계획을 파일로 > PostgreSQL에서 MySQL로 마이그레이션 계획을 migration-plan.md에 작성해줘
Part VI — The Setup Flow

30분 셋업 순서

지금까지의 내용을 순서대로 정리하면 이렇다. 이 순서대로 30분을 투자하면, 앞으로의 모든 작업이 달라진다.

01 상태 표시줄 모델, 토큰, 브랜치
실시간 모니터링
02 별칭 설정 c, cr, cc
3글자로 실행
03 커맨드 숙지 /clear, /usage
매일 쓸 두 가지

3단계가 끝나면 기본 도구가 준비된 것이다. 하지만 도구만으로는 부족하다. Claude Code를 진짜 잘 쓰는 것의 80%는 "컨텍스트 관리"에 달려 있다. 2편에서 그 이야기를 한다.

도구에 투자하는 시간은 복리로 돌아온다.
30분의 설정이 300시간의 생산성을 만든다.

Tip 12 — Invest in Your Own Workflow

설정은 끝났다
이제 제대로 써야 한다

다음 편 "컨텍스트는 우유다"에서는 Claude Code를 잘 쓰는 것의 80%를 차지하는 컨텍스트 관리를 다룬다. 왜 대화가 길어지면 성능이 떨어지는지, 그리고 어떻게 관리해야 하는지.