본문 바로가기

클로드 코드 사용법: 설치 후 실제로 쓰는 법 (명령·VS Code)

Claude Code를 설치한 뒤 실제 사용법을 정리했습니다. claude 실행, @파일 참조, diff 승인, 핵심 명령·단축키, 대화형/원샷 모드, VS Code 확장까지.

글갱신

Claude Code를 설치했다면, 이제 쓰는 법입니다. 핵심은 간단합니다 — 프로젝트 폴더에서 claude를 실행하고, 대화로 작업을 지시하면 클로드가 파일을 직접 읽고 고칩니다. 단, 파일을 바꾸기 전에는 항상 변경 내용(diff)을 보여주고 승인을 받습니다.

🟢 현행 모델 라인업 일치 · 모델 안내 · Fable 구독 안내
🟢 현행 모델 라인업 일치 · Claude Opus 5.5 / Claude Sonnet 5.5 / Claude Haiku 5.5 (상위 티어: Claude Fable 5.2). 이 안내는 새 모델이 출시될 때만 바뀝니다.

Fable 구독 안내(2026년 11월 10일 갱신): 2026년 11월 9일 출시된 Claude Fable 5.2가 현행 Fable 모델이고, Fable 5.1과 Fable 5는 레거시로 전환됐습니다. 구독 조건은 세 모델이 같습니다 — Max·Ultra 플랜과 Team·좌석 기반 Enterprise의 프리미엄 시트는 주간 사용 한도의 50% 범위에서 포함되고, Pro 플랜과 표준 시트는 사용량 크레딧으로 이용합니다(Free 미제공). 출시 기념으로 2026년 11월 16일(PT)까지 Pro 플랜과 Team 표준 시트에도 Fable 모델이 주간 한도의 50% 범위에서 포함됩니다. API 요금은 Fable 5.2가 입력 100만 토큰당 $8·출력 $40, Fable 5.1·5는 $10·$50입니다. 일부 사이버보안·생물학 요청은 안전 분류기에 의해 Opus 모델로 대체 응답될 수 있습니다. 자세한 내용은 Fable 5.2 출시 소식과 Fable 5.2 가이드를 참조하세요.

설치 전에 Claude Code가 무엇이고 일반 챗봇·자동완성과 어떻게 다른지 궁금하다면 Claude Code란? 입문을 먼저 보세요.

클로드 코드 기본 흐름 1. 실행 폴더에서 claude → 2. 작업 지시 @파일로 요청 → 3. diff 검토 승인 / 거부 → 4. 반복·롤백 /rewind 파일 변경 전 항상 diff로 보여주고 승인을 받습니다. 잘못되면 /rewind로 되돌립니다.

시작하기

  1. 작업할 프로젝트 폴더에서 터미널을 열고 claude를 실행합니다. 첫 실행 시 브라우저 로그인(OAuth)을 한 번 합니다.
  2. 환영 화면 뒤에 대화형 프롬프트가 뜹니다. 여기에 자연어로 작업을 지시하면 됩니다.
# 프로젝트 폴더로 이동 후
claude

실행한 폴더와 그 하위 파일을 클로드가 볼 수 있으니, 어느 폴더에서 실행하는지를 신경 쓰세요.

작업 지시 + 파일 참조

그냥 자연어로 요청하면 됩니다. 특정 파일을 콕 집으려면 @ 뒤에 경로를 입력합니다(자동완성 지원). 그 파일 내용이 대화에 바로 주입됩니다.

@src/pages/Home.tsx 헤더 문구를 'Welcome'으로 바꿔줘

클로드는 바꿀 내용을 diff(변경 미리보기)로 보여주고 승인을 요청합니다. 승인·거부·수정 요청을 고를 수 있습니다.

알아두면 좋은 명령·단축키

  • / — 사용 가능한 슬래시 명령 목록
  • @경로 — 특정 파일을 컨텍스트에 추가
  • ! — 터미널 명령을 실행하고 그 결과를 클로드에 전달
  • ? — 단축키 보기 / Tab 자동완성 / ↑ 이전 입력
  • Esc — 진행 중인 작업 중단
  • /rewind 또는 Esc 두 번 — 이전 체크포인트로 되돌리기(매 편집마다 스냅샷 저장)
  • /login 계정 전환 · /mcp MCP 서버 관리

두 가지 사용 모드

  • 대화형(기본): claude로 세션을 열고 여러 번 주고받으며 작업. 복잡한 구현에 적합.
  • 원샷: claude -p "src/api 폴더에서 TODO가 남은 곳 전부 찾아줘"처럼 한 번 실행하고 결과만 받기. 스크립트·CI·단순 조회에 적합.

VS Code에서 쓰기

두 가지 방법이 있습니다.

  • 공식 확장("Claude Code for VS Code"): 에디터 사이드바에 패널이 생기고, 변경을 diff 뷰로 보며 클릭으로 승인합니다. (Cursor에서도 VS Code 확장이라 작동)
  • 내장 터미널에서 claude를 직접 실행: 파일 변경이 에디터 탭에 바로 반영됩니다. MCP 설정, ! 명령, 일부 슬래시 명령은 CLI(터미널)에서만 됩니다.

안전장치

Claude Code는 기본적으로 파일 쓰기·명령 실행 전에 승인을 요구합니다(Ask 모드). 위험한 명령(강제 푸시·삭제 등)을 막도록 권한을 설정할 수도 있습니다. 그리고 매 편집이 체크포인트로 저장되어 /rewind로 되돌릴 수 있습니다.

바꾸기 전, 항상 보여주고 승인받기1. 변경 제안무엇을 바꿀지2. diff 미리보기바뀔 부분 표시3. 승인 / 거절내가 결정4. 적용승인한 것만내 승인 없이는 파일을 바꾸지 않습니다 — 동작은 설정·버전에 따라 다를 수 있음

더 잘 쓰는 법

프로젝트의 구조·규칙·자주 쓰는 명령을 CLAUDE.md에 적어두면 매 세션이 빨라지고 실수가 줄어듭니다. 작성법은 CLAUDE.md 작성 가이드를 참고하세요. 외부 도구 연동은 MCP 연결 가이드.

설치·인증 중 막히면 Claude Code 문제 해결을 참고하세요.

코딩이 아닌 일반 작업을 자율로 맡기고 싶다면, 비개발자용 데스크톱 모드인 Claude 코워크가 있습니다.

팀 리포에서 자동으로 돌리려면 Claude Code GitHub 연동으로 @claude 멘션 자동화를 설정할 수 있습니다.

자주 쓰는 명령을 한눈에 보려면 슬래시 명령어 정리에서 내장 명령과 커스텀 명령 만드는 법을 확인하세요.

더 알아보기: Claude Code IDE 연동 가이드 (VS Code·JetBrains)

고지: Claude Code는 Claude Pro·Max·Ultra·Team·Enterprise 구독에 포함되거나 API 종량제로 쓸 수 있습니다(포함 범위·요금은 변동). 명령·단축키·확장 동작은 버전에 따라 바뀔 수 있으니 공식 문서(code.claude.com/docs)에서 최신 정보를 확인하세요. 본 사이트는 Anthropic 공식 사이트가 아닙니다.

함께 보면 좋은 글: Claude vs Claude Code vs Cowork 차이 총정리 · Claude Code 가격 총정리

관련 글

이 글이 도움이 됐나요?

이어서 읽어보세요