클로드 코드 사용법 2026: 설치부터 요금제·클라우드 세션까지 입문 가이드

클로드 코드(Claude Code)는 앤트로픽이 만든 에이전트형 코딩 도구로, 내 프로젝트의 코드를 읽고 파일을 고치고 명령을 실행하는 일을 자연어 지시만으로 맡길 수 있다. 2026년 9월 기준 터미널, VS Code·JetBrains 같은 IDE, 데스크톱 앱, 웹 브라우저, 모바일 앱에서 쓸 수 있고, 무료 요금제에는 포함되지 않아 프로(월 20달러) 이상 구독이나 API 계정이 필요하다. 설치는 명령어 한 줄이면 끝나고, 처음 쓰는 사람이 실제로 막히는 지점은 설치가 아니라 어떤 요금제로 얼마나 쓸 수 있는지와 어떤 작업을 어디까지 맡길지다. 이 글은 앤트로픽 공식 문서와 발표만으로 그 순서를 정리한다.

클로드 코드란 무엇인가

클로드 코드(Claude Code)는 코드베이스 전체를 이해하고 여러 파일과 도구를 오가며 기능 추가, 버그 수정, 개발 자동화를 수행하는 앤트로픽의 AI 코딩 에이전트다. 채팅창에 코드를 붙여 넣고 답을 복사해 오는 방식과 달리, 클로드 코드는 내 컴퓨터의 프로젝트 폴더 안에서 직접 파일을 열고 수정하고 테스트 명령을 돌린다. 사람이 하는 일은 무엇을 원하는지 설명하고, 클로드가 제안하거나 실행한 변경을 검토하는 것이다.

2026년 9월 기준 클로드 코드의 기본 오퍼스 모델은 9월 22일 공개된 오퍼스 5.5이고, 페이블 5.1도 100만 토큰 컨텍스트로 쓸 수 있다. 앤트로픽은 오퍼스 5.5가 대부분의 작업에서 페이블 5.1 수준의 성능을 내면서 오퍼스 5보다 실행 비용이 40% 낮다고 밝혔다. 터미널 작업 능력을 모델별로 비교하려면 [AI 에이전트 터미널 작업 순위](/leaderboard/agentic-terminal/)를 함께 보면 된다.

클로드 코드 설치 방법 5단계

클로드 코드 설치는 macOS 13.0 이상, 윈도우 10 1809 이상, 우분투(Ubuntu) 20.04 이상 환경에서 공식 설치 명령 한 줄로 끝난다. 메모리는 4GB 이상이 필요하고 인터넷 연결은 필수다. 공식 빠른 시작 문서의 순서를 입문자 기준으로 줄이면 다음 다섯 단계다.

1. 터미널을 연다. macOS·리눅스·WSL에서는 curl -fsSL https://claude.ai/install.sh | bash, 윈도우 PowerShell에서는 irm https://claude.ai/install.ps1 | iex를 실행한다. 홈브루 사용자는 brew install --cask claude-code, 윈도우 WinGet 사용자는 winget install Anthropic.ClaudeCode로도 설치된다.
2. claude --version을 입력해 버전 번호와 (Claude Code)가 출력되는지 확인한다.
3. 작업할 프로젝트 폴더로 이동한 뒤 claude를 입력해 첫 세션을 시작한다.
4. 처음 실행하면 로그인 안내가 뜬다. 브라우저에서 프로·맥스·팀·엔터프라이즈 구독 계정이나 클로드 콘솔(API) 계정으로 로그인한다.
5. 세션 안에서 /init을 입력한다. 클로드가 코드베이스를 분석해 빌드 명령, 테스트 방법, 프로젝트 규칙을 담은 CLAUDE.md 초안을 만든다.

네이티브 설치는 백그라운드에서 자동 업데이트되지만, 홈브루와 WinGet으로 설치하면 자동 업데이트가 되지 않아 주기적으로 업그레이드 명령을 직접 실행해야 한다. 윈도우에서는 Git for Windows를 함께 설치하면 클로드 코드가 Bash 도구를 쓸 수 있다. 터미널이 낯설다면 데스크톱 앱으로 시작해도 된다.

클로드 코드 요금제: 무료로는 쓸 수 없다

클로드 코드는 2026년 9월 기준 클로드 무료 요금제에 포함되지 않고, 프로(월 20달러)부터 맥스·팀·엔터프라이즈까지 모든 유료 요금제에 들어 있다. 앤트로픽 공식 요금 페이지에 따르면 클로드 코드는 요금제의 나머지 기능과 같은 사용량 한도를 공유한다. 터미널에서 코딩한 만큼 클로드 채팅에 쓸 몫이 줄어드는 구조다.

요금제	가격 (USD)	클로드 코드	5시간 세션 사용량	클라우드 세션
무료	0달러	불포함	기준	불가
프로	월 20달러	포함	무료의 최소 5배	가능
맥스 5x	월 100달러	포함	프로의 5배	가능
맥스 20x	월 200달러	포함	프로의 20배	가능
팀	좌석당 월 20~25달러부터	포함	프로보다 많음	가능
콘솔(API)	선불 크레딧, 토큰당 과금	사용 가능	한도 대신 사용량 과금	불가

한도에 닿으면 5시간 세션 초기화를 기다리거나, 상위 요금제로 올리거나, 사용량 크레딧을 켜서 표준 API 요금으로 계속 쓸 수 있다. 환경 변수 ANTHROPIC_API_KEY가 설정돼 있으면 클로드 코드는 구독 대신 API 키로 과금하므로, 구독으로 쓰려는 사람은 이 변수를 확인해야 한다. 요금제별 한도와 초기화는 [클로드 요금제 총정리](/claude-pricing-plans-2026/)에 자세히 정리했다.

클로드 코드 터미널·IDE·데스크톱·웹 비교: 클라우드 세션까지

클로드 코드는 어디서 실행하든 같은 에이전트이고, 달라지는 것은 코드가 실행되는 위치와 내 로컬 설정을 쓸 수 있는지 여부다. 터미널, IDE, 데스크톱 앱의 로컬 모드는 내 컴퓨터에서 돌고, 웹(claude.ai/code)과 모바일 앱의 Code 탭, 데스크톱 앱의 클라우드 모드는 앤트로픽이 관리하는 가상 머신에서 돈다.

사용 환경	실행 위치	이런 사람에게
터미널 CLI	내 컴퓨터	모든 기능을 쓰려는 개발자
VS Code·JetBrains	내 컴퓨터	편집기 안에서 변경 내용을 보며 작업하려는 사람
데스크톱 앱	로컬 또는 클라우드 선택	터미널 없이 그래픽 화면으로 쓰려는 입문자
웹·모바일	클라우드 가상 머신	설치 없이 깃허브 저장소를 바로 맡기려는 사람
클라우드 세션 (`claude --cloud`)	클라우드 가상 머신	노트북을 닫아도 긴 작업을 이어 가려는 사람

클라우드 세션은 프로·맥스·팀 요금제와, 프리미엄 좌석 또는 Chat + Claude Code 좌석의 엔터프라이즈 사용자가 쓸 수 있다. 세션을 시작하려면 깃허브 연결이 필요하고, 사용량은 다른 클로드 사용과 같은 한도를 나눠 쓰되 클라우드 가상 머신에 대한 별도 컴퓨팅 요금은 없다. 앤트로픽 공식 개발자 계정은 클라우드 세션 정식 출시에 맞춰 기존 구독자에게 프로 100달러, 맥스 250달러의 1회성 크레딧을 준다고 발표했다. 이 크레딧은 사용량 한도와 별개로 클라우드 세션에만 적용되고 계정당 1회이며, 10월 7일까지 받아야 한다.

클로드 코드 기능 정리: CLAUDE.md·스킬·서브에이전트·MCP

클로드 코드의 확장 기능은 CLAUDE.md, 스킬, 서브에이전트, MCP의 4가지만 알아도 입문 단계의 작업 대부분을 다룰 수 있다. 공식 문서도 처음 쓰는 사람에게 CLAUDE.md부터 시작하고 나머지는 필요가 생길 때 하나씩 더하라고 권한다.

• CLAUDE.md: 매 세션 시작 때 자동으로 읽히는 프로젝트 지침 파일이다. "npm 대신 pnpm을 쓴다", "커밋 전에 테스트를 돌린다" 같은 규칙을 적어 둔다. 공식 문서는 클로드가 같은 규칙을 두 번 틀리면 그때 CLAUDE.md에 추가하라고 권한다.
• 스킬: 지식과 작업 절차를 담은 마크다운 파일이다. /deploy처럼 명령으로 직접 부르거나, 관련 작업일 때 클로드가 스스로 불러 쓴다.
• 서브에이전트: 별도 컨텍스트에서 따로 일하고 요약만 돌려주는 보조 에이전트다. 파일을 많이 읽어야 하는 조사를 맡기면 메인 대화가 가벼워진다.
• MCP: 모델 컨텍스트 프로토콜로 데이터베이스 조회, 슬랙 게시, 브라우저 제어 같은 외부 서비스를 클로드 코드에 연결한다.

이 밖에 파일을 고칠 때마다 린터를 돌리는 식의 자동화는 훅(hooks)으로, 이런 설정 묶음을 여러 저장소에 재사용하는 일은 플러그인으로 한다.

바이브코딩 시작하기: 클로드 코드에서 먼저 알아야 할 것

바이브코딩을 클로드 코드로 시작하는 입문자에게 가장 중요한 습관은 코드를 쓰게 하기 전에 계획부터 받는 것이다. 클로드 코드는 2026년 8월 14일부터 프로·맥스·팀 요금제의 새 세션에서 자동 모드를 기본 권한 모드로 쓴다. 자동 모드에서는 분류기가 클로드의 행동을 검토하고 사람에게 매번 묻지 않으므로, 요청이 모호하면 모호한 채로 여러 파일이 바뀐다.

ASAP이 공식 문서의 권장 흐름을 입문자 관점에서 묶으면 원칙은 세 가지다. 첫째, claude --permission-mode plan처럼 계획 모드로 시작하면 클로드는 파일을 읽고 접근 방식을 제안하되 소스 코드는 고치지 않는다. 계획을 읽고 고친 뒤에 실행을 맡기면 되돌릴 일이 줄어든다. 둘째, 작업 단위마다 깃 커밋을 남긴다. 결과가 마음에 들지 않을 때 돌아갈 지점이 있어야 과감하게 맡길 수 있다. 셋째, "테스트 고쳐 줘"가 아니라 파일 이름과 기대 동작, 오류 메시지를 함께 준다. 공식 클라우드 세션 가이드도 구체적인 파일명과 오류 출력을 붙이라고 권한다.

바이브코딩이 입문자에게 주는 착시는 코드를 몰라도 된다는 기대다. 클로드 코드는 코드를 대신 쓰지만 결과를 받아들일지는 여전히 사람이 판단해야 하므로, 변경 내용을 읽는 능력이 곧 결과물의 품질을 정한다. 실무에서 어떤 일을 맡기면 효과적인지는 [직장 내 Claude Code 활용법 7가지](/claude-code-at-work/)에서 사례별로 정리했다.

사용량 한도가 입문자의 실제 비용이다

클로드 코드 입문자가 가장 먼저 부딪히는 벽은 기능이 아니라 5시간 세션 한도다. 클로드 코드는 채팅과 같은 사용량 풀을 쓰고, 긴 대화와 큰 파일, 상위 모델, 여러 작업의 병렬 실행이 모두 소모를 늘린다. 공식 문서도 클라우드 세션을 여러 개 동시에 돌리면 그만큼 한도가 비례해 줄어든다고 적고 있다.

그래서 프로 요금제 입문자에게는 요금제를 올리는 것보다 소모를 줄이는 습관이 먼저다. 작업 하나가 끝나면 새 세션을 열고, 반복해서 설명하던 규칙은 CLAUDE.md에 한 번만 적어 두고, 조사처럼 파일을 많이 읽는 일은 서브에이전트에 넘겨 메인 대화를 가볍게 유지한다. 같은 설명을 되풀이하지 않는 것만으로도 소모가 준다. 남은 한도는 클로드 코드에서 /status로, 웹에서는 설정 > 사용량에서 확인한다. 이렇게 관리해도 업무 시간 내내 한도에 막힌다면 그때가 맥스로 올릴 시점이다.

출처: Claude Code overview (Claude Code Docs) · Quickstart (Claude Code Docs) · Advanced setup (Claude Code Docs) · Extend Claude Code (Claude Code Docs) · Use Claude Code in the cloud (Claude Code Docs) · What's new (Claude Code Docs) · Plans & Pricing (Anthropic) · Use Claude Code with your Pro or Max plan (Claude Help Center) · Introducing Claude Opus 5.5 (Anthropic) · Cloud sessions 정식 출시 발표 (Anthropic @ClaudeDevs)