기존 도구나 워크플로우를 바꿀 필요 없이, 터미널에서 바로 AI와 협업할 수 있다는 게 핵심이다.
이전글에 작성했지만, 해당 글만 보고 넘어갈 수 있게 최대한 간단히 클로드 코드에 대해 작성하고 넘어 가자.
Claude Code란?
Claude Code는 Anthropic이 2025년 2월에 Research Preview로 공개하고, 5월 "Code with Claude" 이벤트에서 정식 출시한 터미널 기반 AI 코딩 도구다.
단순한 코드 자동완성 도구가 아니라, "에이전트(agent)" 역할을 하는 AI 개발자라고 볼수도 있겠다.
자연어로 요청하면 알아서 계획을 세우고(이 부분이 요즘 꼭 짚고 넘어가야 하는 포인트라고 생각한다), 코드를 작성하고, 테스트하고, Git 커밋까지 해준다.
Claude Code의 핵심 특징
터미널 네이티브 : 새로운 IDE나 확장프로그램 설치 불필요
전체 코드베이스 이해 : 프로젝트 구조와 컨텍스트를 자동으로 파악
직접 액션 실행 : 파일 편집, 명령어 실행, Git 작업까지 자동화
MCP 지원 : Google Drive, Slack, Jira 등 외부 도구와 연동
Claude 4.5 기반: 최신 Sonnet 4.5, Opus 4.5 엔진의 강력한 추론 능력 (2.0 업데이트)
빠른 시작 - 5분 만에 시작하기
Claude Code 2.0부터는 설치가 더욱 간편해졌다. Native Installer가 새로 추가되어 자동 업데이트까지 지원한다.
2.0 업데이트: Native Installer 권장! Native Installer로 설치하면 자동 업데이트가 지원되고, Node.js 없이도 바로 사용 가능하다. Windows도 네이티브 지원으로 WSL 없이 동작한다. ( 예전 글을 작성할 당시엔 WSL을 권장 했었지만, 지금 현재 2.0으로 변경 되기도 하였고, 업데이트도 자동으로 잘 동작하게 하기위해 방법 1로 꼭 설치를 권장 하려 한다. )
방법 1: Native Installer (권장) - 가장 쉽고 빠른 방법. 한 줄이면 끝난다.
Node.js를 이미 쓰고 있다면 npm으로 설치할 수도 있다. 하지만 자동 업데이트는 안 된다.
# npm으로 전역 설치 $npm install -g @anthropic-ai/claude-code@latest
# 확인 $claude --version 2.0.9
⚠️ npm 방식의 단점
자동 업데이트 안 됨 (수동으로 해야 함)
가끔 ENOTEMPTY 오류 발생
Node.js와 npm이 필수
처음 실행하면 Anthropic 계정 연동이 필요하다.
구독형을 개인적으로 추천 한다. 예전엔 구독형 plan인경우 사용 불가능했지만, 현재 구독형도 일부 사용 가능 하고 API방식으로 사용해봤을때 순식간에 토큰이 녹아 버리는걸 경험할 수 있으니, 개인적으로는 일단 pro플랜, 정말 마음에 들었을때 max 플랜으로 넘어가면 좋을 것 같다.
Claude Code Cli 기본 사용법
1. 모델 선택 : Claude Code를 실행하면 가장 먼저 어떤 모델을 사용할지 선택 할 수 있다.
사용 가능한 모델들
모델
특징
Claude Sonnet 4.5
빠르고 효율적
Claude Opus 4.5 / Default (권장)
최고 성능, 복잡한 추론
Claude Haiku 4.5
경량, 빠른 응답
Default 모드 추천 처음 사용한다면 Default 모드를 추천한다. 작업의 복잡도에 따라 자동으로 적절한 모델을 선택해준다.
플랜별 자동 전환 비율: • Max 5x ($100/month): 20% 사용량에서 Opus → Sonnet 전환 • Max 20x ($200/month): 50% 사용량에서 Opus → Sonnet 전환
주의사항 • Pro 플랜 ($20/month) :Claude Code에서 Opus 4.5 사용 불가능, Sonnet 4.5만 사용 가능 • Max 플랜 ($100, $200/month) :Opus 4.5와 Sonnet 4.5 모두 사용 가능 복잡한 작업을 위해 Opus 4.5가 필요하다면 Max 플랜으로 업그레이드하거나 별도로 API 크레딧을 구매해야 한다.
모델 선택 명령어
// 모델 확인 및 선택 방법
# 현재 모델 확인
/model
/model 을 통해 현재 모델을 확인 가능하고
방향키(화살표)로 이동 하여 원하는 모델을 선택 가능하다.
2. 기본 인터페이스
Claude Code가 실행되면 다음과 같은 인터페이스가 나타난다:
▐▛███▜▌ Claude Code v2.0.55
▝▜█████▛▘ Opus 4.5 · Claude Max
▘▘ ▝▝ ~본인 프로젝트 경로
Claude >
여기서 `>` 프롬프트에 자연어로 명령을 입력하거나 슬래시 명령어를 사용할 수 있다.
3. 슬래시 명령어 vs 자연어
Claude Code는 두 가지 방식으로 명령을 내릴 수 있다:
( 슬래시 명령어도 최초 글 작성시점 이후 계속 업데이트 되았고, 2025년 10월 2.0 으로 변경되면서 많이 바뀌어 현시점으로 다시 갱신해 두겠다. )
1) 자연어 명령 방식
ex) 코딩 작업 관련 요청
# 파일 생성/수정
package.json에 새로운 의존성을 추가해줘
# 코드 분석
이 함수에서 성능 병목이 있는지 확인해줘
# 버그 수정
TypeError가 발생하는 이유를 찾아서 고쳐줘
2) 슬래시 명령어
슬래시 명령어 카테고리
2-1) 세션 관리
/clear, /compact, /resume, /rewind, /export
2-2) 상태/모니터링
/status, /cost, /usage, /context
2-3) 설정/환경
/config, /model, /output-style, /permissions
2-4) 프로젝트 관리
/init, /memory, /add-dir
2-5) 개발 도구
/doctor, /review, /security-review, /todos
2-6) 고급 기능
/agents, /bashes, /mcp, /hooks
2-7) IDE/플러그인
/ide, /plugin, /statusline
2-1) 기본 세션 관리
/clear # 대화 컨텍스트 초기화
/compact [지시] # 대화 요약 후 보존 (컨텍스트 절약)
/resume # 이전 세션 목록에서 선택하여 재개
/rewind # 체크포인트로 되돌리기
/export [파일명] # 대화 내용을 파일로 내보내기
/help # 사용 가능한 모든 슬래시 명령어 목록
2-2) 상태 및 모니터링
/status # Claude Code 상태 (버전, 모델, 계정, 연결 상태)
/cost # 현재 세션 토큰 사용량과 비용 확인
/usage # 플랜 사용량 한도 및 남은 용량 확인 (구독자 전용)
/context # 컨텍스트 사용량을 컬러 그리드로 시각화
2-3) 설정 및 환경
/config # Claude Code 설정 인터페이스 열기
/model # AI 모델 선택/변경 (Opus 4.5, Sonnet 4.5 등)
/output-style # 출력 스타일 설정 (Default/Explanatory/Learning)
/permissions # 권한 설정 관리
/privacy-settings # 프라이버시 설정 보기/변경
/terminal-setup # 터미널 키바인딩 설정 (Shift+Enter 등)
/output-style 3가지 모드 • Default: 기본 응답 스타일 • Explanatory: Claude의 사고과정과 "Insight"를 함께 제공 (코드 이해에 도움) • Learning: TODO(human) 마커로 직접 코딩하며 배우기
특히 Learning 모드는 AI에 의존하지 않고 실력을 키우고 싶을 때 추천한다!
2-4) 프로젝트 관리
/init # 프로젝트 초기 설정 (CLAUDE.md 자동 생성)
/memory # 프로젝트 메모리(CLAUDE.md) 관리
/add-dir # 추가 작업 디렉토리 등록
ex) /init
- 초기에 Claude Code를 사용하는 유저들에게 매우 중요하다고 생각 한다. 이때 생성하는 CLAUDE.md 파일은, Claude Code가 프로젝트를 이해하는 데 사용하는 "메모리" 역할을 한다:
// CLAUDE.md 생성
/init
# 또는 /memory 명령어 사용
# 또는 직접 요청
이 프로젝트에 대한 정보를 CLAUDE.md 파일로 만들어줘:
- 기술 스택
- 프로젝트 구조
- 코딩 컨벤션
- 중요한 설정들
CLAUDE.md 장점 프로젝트 루트에 CLAUDE.md가 있으면 매번 컨텍스트를 설명할 필요가 없다. 팀원들과 공유해서 모든 사람이 같은 컨텍스트로 Claude Code를 사용할 수 있다.
권한 모드 4가지: • default: 도구 사용 시 권한 확인 • plan: 읽기 전용 (분석만 가능) • acceptEdits: 파일 편집 자동 승인 • bypassPermissions: 모든 권한 건너뛰기
Respect .gitignore
true
파일 선택 시 .gitignore 규칙 적용 (보안상 true 권장)
Theme
Dark mode
테마 설정: Light mode / Dark mode
Notifications
Auto
알림 설정: Auto / On / Off (장시간 작업 완료 알림)
Output style
Default
응답 스타일: Default / Explanatory / Learning
Editor mode
normal
에디터 모드: normal / vim (vim 사용자를 위한 설정)
Model
Default
AI 모델 선택 (Sonnet 4.5 / Opus 4.5 / Haiku 4.5)
Auto-install IDE extension
true
IDE 확장 자동 설치 (VS Code 등 연동)
💡 추천 설정 조합 • 생산성 극대화: Auto-compact ✅ + Rewind code ✅ + Permission: acceptEdits • 코드 리뷰: Permission: plan (읽기 전용 분석 모드) • 학습 목적: Output style: Learning + Show tips ✅ • 코드 이해: Output style: Explanatory (Claude의 사고과정 확인 가능)
bypassPermissions 모드 주의 모든 권한 검사를 건너뛰는 위험한 모드다. CI/CD 파이프라인이나 격리된 샌드박스 환경에서만 사용하고, 프로덕션 코드나 민감한 프로젝트에서는 절대 사용하지 말 것!
2-5) 개발 도구
/doctor # Claude Code 진단 및 문제 해결
/bug # 버그 리포트 전송 (Anthropic으로)
/review # 코드 리뷰 요청
/security-review # 현재 브랜치의 보안 리뷰 실행
/todos # 현재 todo 항목 목록 보기
/install-github-app # GitHub PR 자동 리뷰 설정
2-6) 고급 기능
/agents # 서브에이전트 관리 (병렬 작업 모니터링)
/bashes # 백그라운드 태스크 목록 및 관리
/mcp # MCP 서버 연결 관리 (외부 도구 연동)
/hooks # 훅 설정 관리 (자동화 트리거)
/vim # vim 모드 진입 (insert/command 모드 전환)
/sandbox # 샌드박스 bash 활성화 (파일시스템/네트워크 격리)
2-7) IDE 및 플러그인
/ide # IDE 연동 관리 및 상태 확인
/plugin # Claude Code 플러그인 관리
/statusline # 상태 표시줄 UI 설정
/pr-comments # PR 코멘트 보기
/clear를 자주 사용하자 Claude Code는 컨텍스트 윈도우가 꽉 차면 성능이 떨어진다. 새로운 작업을 시작할 때마다 /clear로 대화를 초기화하는 습관을 들이자. 토큰도 절약되고 응답 품질도 좋아진다.
그렇다면 토큰이 어떤 방식으로 계산되는지. 궁금할 수 있는데 이는 추후 따로 아주 간단히 작성해 두겠다.
4. 권한 모드 (Permission Mode) 4가지
Claude Code는 상황에 맞게 선택할 수 있는 4가지 권한 모드를 제공한다.
ex) 난 초기 시작은 plan 모드로, 이후 개발은 상남자 스타일인 acceptEdits 모드를 선호한다.
모드
특징
적합한 상황
default
도구 첫 사용 시 권한 확인
신중한 작업, 처음 사용
plan
읽기 전용 (분석만 가능, 수정 불가)
코드 리뷰, 설계 단계
acceptEdits
파일 편집 자동 승인
반복 작업, 빠른 개발
bypassPermissions
모든 권한 검사 건너뛰기
CI/CD, 샌드박스 환경만!
// 모드 전환
# Shift+Tab으로 모드 전환 (UI에서)
# 또는 /config에서 Default permission mode 변경
# CLI에서 직접 지정
claude --dangerously-skip-permissions # bypassPermissions (위험!)
# settings.json에서 설정
{ "defaultMode": "acceptEdits" } # 파일 편집 자동 승인
{ "defaultMode": "plan" } # 읽기 전용 분석 모드
ex) acceptEdits 모드 (Shift+Tab)
shft + tab 클릭시 모드가 변경 된다.
5. 파일 참조 방법
파일 참조와 컨텍스트 추가
Claude Code에서 파일이나 추가 정보를 참조하는 다양한 방법들:
// 다양한 참조 방법들
# @ 기호로 파일 참조
@src/components/UserList.jsx에서 로딩 상태를 추가해줘
# # 기호로 프로젝트 컨텍스트 실시간 추가
# 이 프로젝트는 React 18 + TypeScript를 사용합니다
# URL로 웹 컨텐츠 참조
https://docs.react.dev/learn 이 문서를 참고해서 Hook을 설명해줘
# 여러 파일 동시 참조
@package.json과 @tsconfig.json을 보고 TypeScript 설정을 최적화해줘
# 디렉토리 전체 참조
@src/utils/ 폴더의 모든 함수에 JSDoc 주석을 추가해줘
💡 이미지도 참조 가능 매우 중요한 기능이 아닐까?? Shift + 드래그로 이미지 파일을 터미널에 직접 첨부할 수 있다. Claude가 이미지를 분석해서 코드 컨텍스트로 활용한다. UI 디자인을 보고 컴포넌트를 만들어달라고 할 때 유용하다.
ex) 간단한 명령어로 Claude Code가 제대로 동작하는지 확인해자.
ex) 자연어 명령어 테스트
# 프로젝트 구조 파악
이 프로젝트의 구조를 설명해줘
# 간단한 파일 생성
Hello World를 출력하는 index.js 파일을 만들어줘
# 비용 확인
/cost
활용 예시
코드베이스 탐색하기
새로운 프로젝트나 팀 코드를 파악할 때 예시
🔍 코드베이스 분석 예시
# 프로젝트 전체 구조 파악
프로젝트 구조를 분석해서 아키텍처를 설명해줘
# React 프로젝트 분석
이 React 프로젝트의 주요 컴포넌트들과 데이터 플로우를 정리해줘
# API 엔드포인트 파악
백엔드 API 라우트들을 정리해서 문서화해줘
새 기능 개발하기
기능 요구사항을 자연어로 설명하면 알아서 구현 한다.
기능 개발 예시
# 간단한 API 개발
사용자 로그인 API를 만들어줘. JWT 토큰 사용하고,
비밀번호는 bcrypt로 해싱해서 저장하고,
실패 시 적절한 에러 메시지 반환하도록
# 복잡한 기능 개발
게시판 CRUD API를 Express.js로 만들고,
MongoDB 연동하고, 파일 업로드 기능도 추가해줘.
테스트 코드도 같이 작성해줘
버그 수정하기
에러 메시지를 복사해서 붙여넣기만 하면 끝.
디버깅 예시
# 에러 메시지 직접 붙여넣기
TypeError: Cannot read property 'map' of undefined
at UserList.jsx:15:23
이 에러 고쳐줘
# 증상 설명으로 디버깅
API 호출 후 데이터가 렌더링되지 않는 문제가 있어.
네트워크 탭에서는 200 응답이 오는데 화면에 안 뜨네
응용? 활용 버전!
GitHub PR 자동 리뷰
- GitHub 앱을 설치하면 PR을 올릴 때마다 Claude가 자동으로 리뷰해주는 기능.
개발 도구
/install-github-app # GitHub PR 자동 리뷰 설정
/bug # 버그 리포트 전송
/doctor # Claude Code 진단 및 문제 해결
// GitHub 자동 리뷰 설정
/install-github-app
# 설정 완료 후 자동으로 생성되는 파일
# .github/workflows/claude.yml
리뷰 프롬프트 커스터마이징
# .github/workflows/claude.yml 예시
prompt: |
이 PR을 리뷰해줘. 다음에 집중해줘:
- 보안 취약점
- 성능 이슈
- 버그 가능성
- 코드 품질 개선점
변수명이나 사소한 스타일은 신경쓰지 말고,
실제 문제가 될 수 있는 것들만 간결하게 알려줘.
💡 리뷰어보다 더 꼼꼼하다??? Claude는 지금버전에서도 충분히 검토 가치가 있는 로직 에러나 보안 이슈를 찾아낸다. 지금도 발전하고있고 앞으로 더 발전할 예정이니 지금부터 틈틈이 사용해보면 좋을 것 같다.
실시간 로그 모니터링
Unix 파이프라인과 연동해서 실시간 로그 모니터링도 가능하다.
// 로그 실시간 분석
# 에러 발생 시 슬랙 알림
tail -f /var/log/app.log | claude -p "에러나 warn이 나오면 슬랙으로 알려줘"
# 성능 지표 모니터링
kubectl logs -f deployment/my-app | claude -p "응답시간이 1초 넘으면 알려줘"
# 배포 로그 분석
docker logs -f container_name | claude -p "배포 관련 이슈가 있으면 정리해서 알려줘"
연속 작업 큐와 대화 제어
Claude Code는 여러 작업을 효율적으로 처리할 수 있는 고급 기능들을 제공한다.
작업 큐 관리
순차 실행 : 여러 메시지를 연속으로 입력하면 큐에 쌓여서 순차적으로 처리됨
작업 중단 :Escape 키로 현재 작업 중단 (많이 사용한다. ctrl or command + c가 아니다.)
대화 분기 : Escape 두 번으로 이전 메시지로 돌아가서 다른 방향으로 진행
// 연속 작업 예시
# 여러 작업을 한 번에 요청
1. package.json에 새 의존성 추가해줘
2. 그 다음에 컴포넌트 생성해줘
3. 마지막으로 테스트 파일도 만들어줘
# Claude가 순차적으로 처리
# 중간에 문제가 생기면 Escape로 중단 가능
대화 세션 연결과 재개
장기 프로젝트, 특정 기간동안 개발하던 세션 관련 유용한 기능
// 세션 연결 명령어들
# 가장 최근 세션 이어받기
claude --continue
# 특정 세션 목록 확인하여 선택 이어받기
claude --resume
# 스크립트 내에서 이어받기 예시
claude --continue -p "continue working on the code review"
ex) 나의 session list를 확인하여 이어 가기
- 맨밑에 보면 이 기능을 몰랐을땐 저런식으로 이어 가려는 시도를 했었다.... 부끄럽지만 올려 본다. ㅎㅎㅎㅎ
Cursor와 같은 GUI 툴에서 처럼 계속 특정 session을 이어 갈 수 있다. 복잡한 기능 개발이나 리팩토링 작업을 여러 날에 걸쳐 진행할 때, --continue 옵션으로 이전 컨텍스트를 그대로 이어받을 수 있다. 그렇기 때문에 매번 처음부터 설명할 필요가 없다.
# .claude/commands/cleanup.md
코드를 다음 기준으로 정리해줘:
- 사용하지 않는 import 제거
- 콘솔 로그 삭제
- 일관된 들여쓰기 적용
- ESLint 규칙 준수
# .claude/commands/review.md
다음 관점에서 코드를 리뷰해줘:
- 보안 취약점
- 성능 이슈
- 버그 가능성
- 코드 품질
# .claude/commands/explain.md
이 코드를 초보 개발자도 이해할 수 있게 설명해줘:
- 각 함수의 역할
- 데이터 흐름
- 주요 로직
// 커스텀 커맨드 사용 예시
# 사용자 정의 커맨드 실행
/cleanup @src/components/TestComponent.jsx
/review @src/api/appcard.js
/explain @utils/testUtil.js
# 매개변수와 함께 사용
/deploy staging
/test unit
💡 팀 공유 가능 .claude/commands/ 폴더를 Git에 커밋하면 팀 전체가 같은 커맨드를 사용할 수 있다. 코드 리뷰 가이드라인이나 배포 절차 등을 표준화할 때 유용하다.
VS Code/Cursor 확장 프로그램 연동
터미널 작업이 불편하다면 IDE 확장 프로그램으로 더 편리하게 사용할 수 있다:
🔌 지원하는 IDE들
VS Code : 공식 확장 프로그램 지원
Cursor : 확장 프로그램으로 IDE 내에서 직접 사용
Windsurf : VS Code 기반이라 호환 가능
JetBrains : IntelliJ, PyCharm, WebStorm 등 지원
// IDE 확장 기능들
# 빠른 실행 단축키
Cmd+Esc (Mac) / Ctrl+Esc (Windows/Linux)
# 파일 참조 단축키
Cmd+Option+K (Mac) / Alt+Ctrl+K (Windows/Linux)
# IDE 터미널에서 실행
claude
# 외부 터미널에서 IDE 연결
/ide
✨ IDE 확장의 장점
Interactive Diff: 코드 변경사항을 IDE 내 diff 뷰어로 확인
Selection Context: 현재 선택한 코드가 자동으로 컨텍스트에 포함
Diagnostic Sharing: 린트 에러나 문법 오류가 자동으로 공유
Multiple Instances: 여러 Claude Code 인스턴스를 다른 패널에서 동시 실행
💀 설치 시 주의사항 Cursor의 경우 자동 감지가 안 될 수 있다. 그럴 때는 수동으로 VSIX 파일을 설치하거나, WSL 환경에서는 별도 설정이 필요할 수 있다. VS Code는 보통 문제없이 자동 설치된다.
MCP
Model Context Protocol(MCP)를 통해 다양한 외부 도구와 연동할 수 있다.
# 새로운 텍스트 자동 감지 및 번역
git diff --name-only | xargs grep -l "새로운 텍스트" |
claude -p "이 파일들에서 새로운 한글 텍스트를 찾아서 영어, 일본어로 번역해서 i18n 파일에 추가해줘"
# 번역 일관성 체크
claude -p "모든 언어 파일을 체크해서 누락된 번역이나 일관성 문제를 찾아줘"
활용 예시 및 주의사항
권한 무시 모드
Claude Code는 기본적으로 모든 작업에 대해 허가를 구한다. 귀찮다면 권한 무시 모드로 실행할 수 있다.
일명 상남자 모드. 내가 무척 좋아하고 생산성입장에선 아주 좋다. (다만, 롤백이 매우 어렵다는점)
// 권한 확인 없이 실행
claude --dangerously-skip-permissions
dangerously ??? 이름에 "dangerously"가 들어가 있지만 실제로는 그렇게 위험하지 않다. Cursor의 옛날 YOLO 모드 정도로 생각하면 된다. 몇 주 써봤는데 딱히..... 문제없었다.
터미널 사용 팁
키보드 단축키
Shift+Tab: 권한 모드 전환 (default ↔ acceptEdits ↔ plan)
Escape: Claude 작업 중단 (Ctrl+C가 아니다)
Escape x2: 이전 메시지로 대화 분기
↑ 화살표: 이전 세션 탐색
성능 최적화
상황
권장사항
이유
새 작업 시작
/clear 실행
컨텍스트 정리, 토큰 절약
복잡한 작업
Opus 4.5 사용
더 나은 추론 능력
간단한 작업
Sonnet 4.5 사용
비용 절약
대용량 파일
@파일명으로 참조
선택적 컨텍스트 포함
비용 관리
Claude Code는 API 요금을 사용하므로 비용을 주의깊게 관리해야 한다:
// 비용 모니터링
/cost # 현재 세션 비용 확인
ccusage # 전체 사용량 분석 (별도 설치)
# 비용 절약 팁
/clear # 불필요한 컨텍스트 정리
/model sonnet # 저렴한 모델 (Sonnet 4.5) 사용
2025년 7월 이후 업데이트 사항
- 최근들어 클로드 코드의 업데이트 내역이 너무 많이 추시되고 있어 계속 이후 업데이트 사항중 개발자에게 유용한 부분들이 보이면 추가해보려 한다.
Explanatory 모드는 클로드가 왜 그렇게 코드를 변경했는지, 왜 그런 결정을 내렸는지를 상세하게 설명해준다. 코드 리뷰 받는 느낌이랄까?
- 공식 문서의 내용 참고 : 소프트웨어 엔지니어링 작업 완료에 도움이 되는 교육적 "통찰력(Insight)"을 제공합니다. 구현 선택 사항과 코드베이스 패턴을 이해하는 데 도움이 됩니다.
// Explanatory 모드 예시
> /output-style입력 후 엔터
> 3가지 모드 중 Explanatory 모드를 선택하자.
> 내 리액트 프로젝트를 분석해달라고 요청 해보겠다. 공식 문서에 나온대로 "Insights" 영역이 추가 되었다.
Learning 모드 : 직접 해보며 배우기
"Learn by doing" 컨셉으로, AI가 가이드를 제공하고 사용자가 직접 코드를 수정하도록 유도한다. 주니어 개발자나 새로운 기술을 배울 때 엄청 유용할 것 같다.
- 공식 문서의 내용 참고 : Claude가 코딩하는 동안 "통찰력"을 공유할 뿐만 아니라, 작지만 전략적인 코드를 직접 작성하도록 요청하는 협업적이고 실천을 통해 배우는 모드입니다. Claude Code는 TODO(human)여러분이 구현할 수 있도록 코드에 마커를 추가합니다.
// Learning 모드에서 제공하는 가이드
> /output-style입력 후 엔터
> 3가지 모드 중 Learning 모드를 선택하자.
> 다음과 같이 특정 소스 수정 요청을 해보겠다.
> BunnyGame.tsx' 속도가 PC에서 너무 빠른것같아. 5%만 줄여줘
> TODO(human) 이라고 주석을 달아주고 직접 수정하라고 가이드 해준다.
⏺ Update(src/components/features/bunny/BunnyGame.tsx)
⎿ Updated src/components/features/bunny/BunnyGame.tsx with 3 additions and 3 removals
164 scoreRef.current = 0
165 setObstacles([])
166 setCarrots([])
167 - setGameSpeed(isMobile ? 2.2 : 4.8)
167 + // TODO(human): PC 속도를 5% 줄여주세요 (4.8 → 4.56)
168 setDinoY(0)
169 setIsJumping(false)
170 setIsKeyPressed(false)
...
185 scoreRef.current = 0
186 setObstacles([])
187 setCarrots([])
188 - setGameSpeed(isMobile ? 2.2 : 4.8)
188 + // TODO(human): PC 속도를 5% 줄여주세요 (4.8 → 4.56)
189 setDinoY(0)
190 setIsJumping(false)
191 setIsKeyPressed(false)
...
435 setScore(scoreRef.current);
436
437 if (scoreRef.current > 0 && scoreRef.current % 750 === 0) {
438 - setGameSpeed(prevSpeed => Math.min(prevSpeed + 0.5, 20));
438 + // TODO(human): 속도 증가량도 5% 줄여주세요 (0.5 → 0.475)
439 }
440
441 gameLoopRef.current = requestAnimationFrame(gameLoop);
⏺ 완벽합니다! 이제 PC에서 토끼 게임의 속도가 5% 줄어들도록 TODO 주석을 추가했습니다.
이제 실제 속도 값을 수정해주시면 됩니다:
1. 첫 번째와 두 번째 TODO 주석 위치에서 4.8을 4.56으로 변경
2. 세 번째 TODO 주석 위치에서 0.5를 0.475로 변경
이렇게 하면 PC에서의 게임 속도가 5% 감소하여 더 플레이하기 편해질 것입니다. 모바일 속도(2.2)는 그대로 유지되므로 모바일 사용자의 게임 경험에는 영향을 주지 않습니다.
배운 점: 게임 속도 조절 시에는 초기 속도와 점진적 속도 증가값 모두를 고려해야 하며, 플랫폼별로 다른 설정이 있을 때는 해당 플랫폼만 선택적으로 수정하는 것이
중요합니다.
커스텀 아웃풋 스타일
`/output-style new` 명령어로 나만의 아웃풋 스타일을 만들수도있다고 한다.
자연어로 "~~~ 한 아웃풋 스타일"이라고 요청해도 된다고 하는데 이 부분은 패스하도록 하겠다.
실제 사용 후기와 교훈
워크플로우 변화 : 처음엔 IDE 사이드바로 쓰던 AI가 이제는 메인 인터페이스가 되었다. 코드를 직접 보는 것보다 Claude에게 먼저 묻게 된다. (한때는 chat gpt부터 켰지만, 이젠 클로드 부터 키게 된다.)
안정성 : Cursor처럼 중간에 멈추거나 patch 해결을 못하는 경우가 거의 없다. 특히 큰 파일 수정할 때 차이가 확실히 난다.
러닝 커브 : 터미널 인터페이스라 처음엔 어색했지만, 이또한 사용할만 하다. 거부감을 갖지 말자! 익숙해진다면 최고의 조력자가 아닐까?
GitHub 리뷰 자동화 : PR 리뷰를 자동화한 후 실제 버그를 찾아내는 비율이 사람보다 높다. 사람은 변수명 지적하지만 Claude는 로직 에러를 찾는다.
비용 : Opus 4.5는 확실히 비싸다고 한다. 하지만 생산성 향상을 고려하면 충분히 가치있다. /clear를 자주 써서 토큰을 절약하자.
자주 묻는 질문 ❓
Q: Windows에서 WSL 없이 정말 사용할 수 있나요?
A: 네! 최신 버전부터 Windows 네이티브 지원이 추가되었습니다. 다만 일부 생태계 도구들은 아직 WSL 기반이라 호환성 이슈가 있을 수 있어요.
Q: GitHub 자동 리뷰 기능이 정말 유용한가요?
A: 매우 유용합니다. 특히 AI 도구를 많이 써서 PR 양이 늘어났을 때 빛을 발해요. 사람보다 실제 버그를 더 잘 찾아냅니다. 리뷰 프롬프트만 잘 커스터마이징하면 완벽해요.
Q: 대용량 파일도 정말 잘 처리하나요?
A: 18,000줄 React 컴포넌트도 문제없이 수정합니다. Cursor 같은 다른 도구들이 헤맬 때도 Claude Code는 안정적으로 동작해요. 이게 가장 큰 차별점이라고 생각합니다.
Q: Pro 구독에서 Opus를 못 쓴다는 게 정말인가요?
A: 네, Pro 플랜($20/월)에서는 Opus 4.5를 사용할 수 없어요. 하지만 2.0 업데이트 이후 Max 플랜($100, $200/월)에서는 Opus 4.5 사용이 가능해졌습니다. 복잡한 작업이 많다면 Max 플랜을 고려해보세요.
