Claude Code 가입과 사용법: 2026, 계정부터 첫 실행까지

Q: Pro와 API 키의 차이는?

Pro는 채팅과 Claude Code가 같은 구독 풀입니다. API 키는 Console 잔액이며 ANTHROPIC_API_KEY를 승인하면 구독 로그인을 건너뜁니다.

Q: command not found가 나오면?

새 터미널에서 claude --version. 그래도 실패하면 PATH와 claude doctor입니다.

Q: 브라우저가 터미널로 안 돌아옵니다.

c로 URL을 복사하고, 코드가 나오면 Paste code here if prompted에 붙입니다.

한 줄 안내: claude.ai 채팅에 로그인됐다고 Claude Code 세션이 열린 것은 아닙니다. 보통 무료 플랜, PATH, 또는 구독을 가로채는 API 키가 원인입니다. 아래는 2026년 공식 경로입니다. 어떤 계정을 만들지, 설치, 브라우저 로그인, 내 저장소에서의 첫 실행까지 적습니다.

Free

요금표: Claude Code 없음

Pro

개인에게 가장 흔한 입구

브라우저가 안 열리면 c

열쇠 세 개를 구분하기

claude.ai 채팅(웹, 데스크톱, 휴대폰). 무료 계정으로도 대화는 열립니다.
Claude Code. 터미널(데스크톱 앱도 있음)에서 저장소를 읽고 파일을 고치고 명령을 실행합니다. 요금 페이지에서 Free의 Claude Code는 꺼짐, Pro·Max·Team·Enterprise는 켜짐입니다.
Console API 키. 선불 크레딧의 종량제이며 구독 사용량과 다른 장부입니다. ANTHROPIC_API_KEY를 승인하면 Pro 한도를 건너뛸 수 있습니다.

채팅이 된다는 것은 터미널 제품이 켜졌다는 뜻이 아닙니다. Cursor와 고르는 문제는 Cursor와 Claude Code입니다. 이 글은 가입, 로그인, 첫 성공까지만 다룹니다.

가입과 요금제

개인은 이 순서입니다. 가격은 2026년 10월 claude.com/pricing 표시(세금 별도, 변경될 수 있음)입니다.

이메일로 claude.ai에 가입합니다. 지역을 쓸 수 없다고 나오면 Anthropic 지원 국가 밖입니다. 우회 방법은 적지 않습니다.
Claude Code가 포함된 요금제로 올립니다. 개인은 Pro가 흔합니다. 월 20달러, 또는 연 200달러(월 17달러).
하루 종일 한도에 닿으면 Max입니다. 5배는 월 약 100달러, 20배는 월 약 200달러. 배수는 Pro 대비 5시간 롤링 창이며 무제한이 아닙니다.
회사 좌석은 관리자의 Team / Enterprise 초대를 기다리고, 그 claude.ai 사용자로 로그인합니다. 여분 키는 만들지 않습니다.
토큰 청구서가 필요하면 Claude Console(platform.claude.com) 선불입니다. 구독 풀과 별도입니다.

요금제	2026년 10월 표시 가격	Claude Code
Free	$0	불가. 비교표에서 꺼짐
Pro	월 $20, 연간이면 월 $17	가능. 웹·데스크톱·모바일과 사용량 공유
Max 5x / 20x	월 $100 / $200	가능. Pro의 약 5배 또는 20배
Team / Enterprise	좌석 단위, 관리자 설정	초대된 계정으로 로그인
Console API	선불 종량	가능. 다른 청구서

사용량은 하나. 터미널만 무제한이 아닙니다

웹, 데스크톱, 모바일, Claude Code가 같은 한도를 씁니다. 유료 플랜에는 약 5시간 롤링 세션 한도와 주간 한도가 있습니다. 한도에 닿으면 기다리거나, 올리거나, usage credits로 API 단가에 이어 갑니다. Max에 포함된 월간 API 크레딧과는 다릅니다.

macOS, Linux, Windows 설치

Setup 기준은 macOS 13+, Windows 10 1809+ 또는 Windows Server 2019+, Ubuntu 20.04+, Debian 10+, Alpine 3.19+, RAM 4GB 이상, x64 또는 ARM64, 네트워크입니다.

네이티브 설치를 우선합니다. macOS, Linux, WSL:

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell(프롬프트에 PS):

irm https://claude.ai/install.ps1 | iex

Windows CMD(PS 없음):

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

받는 동안 진행이 안 보여도 정상입니다. 끝나면 새 터미널에서 확인합니다.

claude --version
claude doctor

claude --version은 2.x (Claude Code) 같은 버전을 찍습니다. claude doctor는 설치와 설정의 읽기 전용 검사이며 코딩 세션을 시작하지 않습니다.

Homebrew: brew install --cask claude-code, 이후 brew upgrade claude-code
WinGet: winget install Anthropic.ClaudeCode, 이후 winget upgrade Anthropic.ClaudeCode
npm(Node.js 22 이상. 패키지가 네이티브 바이너리를 받습니다): npm install -g @anthropic-ai/claude-code. sudo는 쓰지 않습니다.

실행 파일은 보통 ~/.local/bin/claude입니다. command not found면 새 터미널을 먼저 열고, 그래도 실패하면 공식 PATH 수정을 봅니다. Windows는 Git for Windows가 있어야 Bash 도구를 씁니다. 설치 오류는 배포 오류 가이드에 모았습니다. 데스크톱 앱도 있지만 첫 실행 설명은 CLI 기준입니다.

cd /path/to/your/project
claude

Pro / Max: 방금 올린 claude.ai 계정.
Team / Enterprise: 관리자가 초대한 사용자.
Console: Console 계정. 최신 버전은 API 키를 먼저 만들지 않고 계정 로그인이 됩니다.
Bedrock, Google Cloud Agent Platform, Microsoft Foundry: 조직 환경 변수, 또는 로그인 화면의 서드파티. claude.ai 브라우저 로그인을 쓰지 않습니다.

브라우저가 안 열리면 터미널에서 c를 눌러 URL을 내 브라우저에 붙입니다. 페이지에 코드가 나오고 터미널이 안 돌아오면 Paste code here if prompted에 붙입니다. WSL2, SSH, 컨테이너, 원격 Mac에서 흔합니다. 성공하면 Login successful이 나오고 Enter로 프롬프트에 들어갑니다.

구독 사용자는 API 키부터 확인

ANTHROPIC_API_KEY를 승인하면 구독 로그인을 건너뛰고 Console로 과금됩니다. Pro / Max 한도를 쓰려면 키를 지우고 /logout한 뒤 claude로 구독 계정을 고릅니다.

계정 전환은 /logout입니다. 업무와 개인을 나란히 두려면 CLAUDE_CONFIG_DIR=~/.claude-work claude처럼 설정 디렉터리를 나눕니다.

첫 실행

쓸 수 있는 작은 저장소를 고릅니다. 다운로드 폴더나 전사 공유는 첫날에 신뢰하지 않습니다.
폴더를 신뢰하냐고 물으면 내 프로젝트만 신뢰합니다.
첫 요청은 좁게. “README만 고치고 설치 절차 세 줄을 추가해. 다른 파일은 건드리지 마. 어떤 줄이 바뀌었는지 알려 줘.”
셸 명령은 읽고 승인합니다. 첫 세션에서는 확인을 끄지 않습니다.
diff를 보고 남길지 되돌릴지 정합니다. /help로 명령, 다음에는 /resume으로 이어 갑니다.

되면 루트에 CLAUDE.md를 둡니다. 스택, 테스트 명령, 건드리지 않을 디렉터리, 비밀은 git에 넣지 않는다는 메모입니다. 호출자를 놓치기 시작하면 Graphify가 다음 층입니다. 가입 조건은 아닙니다.

실제로 쓰는 명령

목적	명령
설치 확인	`claude --version`
설치와 설정만	`claude doctor`
이 프로젝트에서 시작	`claude`
다시 로그인 / 로그아웃	세션 안의 `/login`, `/logout`
명령 목록, 이어 하기	`/help`, `/resume`
네이티브 업데이트	`claude update` (Homebrew / WinGet은 각자 upgrade)

원격 Mac과 SSH

클라우드 Mac이나 SSH에서는 브라우저가 그 머신의 루프백으로 돌아오지 못하는 경우가 많습니다. c로 URL을 복사하고, 내 컴퓨터에서 로그인한 뒤 코드를 원격 터미널에 붙입니다. 공식에 적힌 콜백 실패 경로입니다.

긴 세션, Xcode, 로컬 모델은 같은 메모리를 씁니다. 모델 요금은 Anthropic, 빌드 머신은 전용 Mac으로 나눌 수 있습니다. 크기는 Mac mini 워크스테이션, 무인 상시는 24시간 에이전트입니다. 첫 성공과 섞지 않습니다.

멈출 때

claude를 못 찾음: 터미널을 다시 열거나 ~/.local/bin을 PATH에 넣습니다.
PowerShell이 &&를 거부: CMD용 줄입니다. irm 명령을 씁니다.
CMD가 irm을 모름: PowerShell 명령입니다.
채팅은 되고 Claude Code는 안 됨: 아직 Free입니다. Pro 이상으로 올립니다.
Pro인데 API 청구: ANTHROPIC_API_KEY를 지우고 /logout 후 구독으로 다시 들어갑니다.
지역 불가: 지원 국가 밖입니다. 이메일을 바꿔 정책을 두드리지 않습니다.
403 또는 syntax error near unexpected token: 공식 설치 문제 해결과 흔한 배포 오류.

GPT, Claude, Gemini를 키 하나로 부르는 이야기는 OpenRouter입니다. 위의 claude.ai 로그인을 대신하지 않습니다.

자주 묻는 질문

무료 claude.ai로 Claude Code를 쓸 수 있나요? 없습니다. 요금표에서 Free는 꺼져 있습니다. Pro, Max, Team, Enterprise 또는 Console이 필요합니다.

Pro와 API 키의 차이는? Pro는 채팅과 Claude Code가 같은 구독 풀입니다. API 키는 Console 잔액이며 ANTHROPIC_API_KEY를 승인하면 구독 로그인을 건너뜁니다.

command not found가 나오면? 새 터미널에서 claude --version. 그래도 실패하면 PATH와 claude doctor입니다.

브라우저가 터미널로 안 돌아옵니다. c로 URL을 복사하고, 코드가 나오면 Paste code here if prompted에 붙입니다. SSH와 원격 Mac도 이 경로입니다.

첫 작업은 무엇이 좋나요? diff를 읽을 수 있는 파일 하나 수정이고, 명령 승인은 켜 둡니다. 지식 그래프와 24시간 배포는 이 실행이 성공한 뒤입니다.

ZavCloud Developer Infrastructure

첫 실행 뒤, 긴 세션을 Xcode와 한 노트북에 두지 마세요

모델 요금은 Anthropic 플랜에 남습니다.

긴 세션과 빌드는 전용 Mac으로 나누고 청구도 나눕니다.

전용 Mac 노드 구성

Claude Code 가입과 사용법: 계정부터 첫 실행까지