Claude Code를 설치했다면, 이제 쓰는 법입니다. 핵심은 간단합니다 — 프로젝트 폴더에서 claude를 실행하고, 대화로 작업을 지시하면 클로드가 파일을 직접 읽고 고칩니다. 단, 파일을 바꾸기 전에는 항상 변경 내용(diff)을 보여주고 승인을 받습니다.
🟢 현행 모델 라인업 일치 · 모델 안내 · Fable 구독 안내
Fable 5·5.1 구독 안내(2026년 9월 7일 갱신): 2026년 9월 1일 출시된 Claude Fable 5.1이 현행 Fable 모델이고, Fable 5는 레거시로 전환됐습니다. 구독 조건은 두 모델이 같습니다 — Max·Team Premium 플랜은 주간 사용 한도의 50% 범위에서 포함되고, Pro·Team Standard 플랜은 사용량 크레딧(입력 100만 토큰당
설치 전에 Claude Code가 무엇이고 일반 챗봇·자동완성과 어떻게 다른지 궁금하다면 Claude Code란? 입문을 먼저 보세요.
시작하기
- 작업할 프로젝트 폴더에서 터미널을 열고
claude를 실행합니다. 첫 실행 시 브라우저 로그인(OAuth)을 한 번 합니다. - 환영 화면 뒤에 대화형 프롬프트가 뜹니다. 여기에 자연어로 작업을 지시하면 됩니다.
# 프로젝트 폴더로 이동 후
claude실행한 폴더와 그 하위 파일을 클로드가 볼 수 있으니, 어느 폴더에서 실행하는지를 신경 쓰세요.
작업 지시 + 파일 참조
그냥 자연어로 요청하면 됩니다. 특정 파일을 콕 집으려면 @ 뒤에 경로를 입력합니다(자동완성 지원). 그 파일 내용이 대화에 바로 주입됩니다.
@src/pages/Home.tsx 헤더 문구를 'Welcome'으로 바꿔줘클로드는 바꿀 내용을 diff(변경 미리보기)로 보여주고 승인을 요청합니다. 승인·거부·수정 요청을 고를 수 있습니다.
알아두면 좋은 명령·단축키
/— 사용 가능한 슬래시 명령 목록@경로— 특정 파일을 컨텍스트에 추가!— 터미널 명령을 실행하고 그 결과를 클로드에 전달?— 단축키 보기 /Tab자동완성 /↑이전 입력Esc— 진행 중인 작업 중단/rewind또는Esc두 번 — 이전 체크포인트로 되돌리기(매 편집마다 스냅샷 저장)/login계정 전환 ·/mcpMCP 서버 관리
두 가지 사용 모드
- 대화형(기본):
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로 되돌릴 수 있습니다.
더 잘 쓰는 법
프로젝트의 구조·규칙·자주 쓰는 명령을 CLAUDE.md에 적어두면 매 세션이 빨라지고 실수가 줄어듭니다. 작성법은 CLAUDE.md 작성 가이드를 참고하세요. 외부 도구 연동은 MCP 연결 가이드.
설치·인증 중 막히면 Claude Code 문제 해결을 참고하세요.
코딩이 아닌 일반 작업을 자율로 맡기고 싶다면, 비개발자용 데스크톱 모드인 Claude 코워크가 있습니다.
팀 리포에서 자동으로 돌리려면 Claude Code GitHub 연동으로 @claude 멘션 자동화를 설정할 수 있습니다.
자주 쓰는 명령을 한눈에 보려면 슬래시 명령어 정리에서 내장 명령과 커스텀 명령 만드는 법을 확인하세요.
더 알아보기: Claude Code IDE 연동 가이드 (VS Code·JetBrains)
함께 보면 좋은 글: Claude vs Claude Code vs Cowork 차이 총정리 · Claude Code 가격 총정리