2026년 6월 기준, Anthropic이 공개한 공식 CLI(Command Line Interface, 터미널에서 명령어로 조작하는 도구) 도구인 Claude Code가 꾸준히 주목받고 있다. 일반 챗봇처럼 대화창에서 쓰는 게 아니라 코드 편집기와 터미널에서 직접 동작하면서 파일을 읽고, 코드를 수정하고, 명령을 실행하는 에이전트형 도구다.
이 글에서는 Windows, macOS, Linux 각 환경에서 Claude Code를 설치하고 첫 실행까지 마치는 과정을 순서대로 정리했다. 무료로 시작하는 방법과 유료 플랜 차이도 함께 다룬다.
Claude Code란 — Anthropic 공식 CLI 도구
Claude Code는 Anthropic이 직접 만든 코딩 에이전트 CLI다. 터미널 한 줄로 실행하면 현재 작업 중인 코드베이스를 분석하고, 버그를 찾거나 새 기능을 추가하는 등의 작업을 자율적으로 수행한다. VS Code, JetBrains 계열 IDE에도 연동된다.
Claude.ai 웹사이트에서 쓰는 채팅형 인터페이스와 달리, Claude Code는 실제 파일 시스템에 접근하고 git 명령을 실행하며 테스트를 돌릴 수 있다. Anthropic 내부에서도 Claude Code 자체를 Claude Code로 개발하는 이른바 “자기 참조(self-referential)” 방식으로 쓸 만큼 실무 도구로 자리 잡았다.
Claude Code를 실행하면 기본적으로 claude-sonnet-4-6 모델이 동작한다. 더 높은 추론 능력이 필요하면 claude-opus-4-8(입력 $5/100만 토큰, 출력 $25/100만 토큰)이나 최상위 모델인 claude-fable-5($10/$50)를 선택할 수 있다.
설치 전 확인 — 시스템 요건
Claude Code를 설치하기 전에 아래 요건을 먼저 확인한다. 미충족 상태에서 설치를 진행하면 오류가 난다.
| 항목 | 요건 | 비고 |
|---|---|---|
| 운영체제 | macOS 13+, Ubuntu 20.04+/Debian 10+, Windows 10+ | Windows는 WSL 필요 |
| RAM | 4GB 이상 | 8GB 이상 권장 |
| Node.js | 18.0 이상 (npm 설치 시) | 네이티브 설치는 불필요 |
| 계정 | Claude Pro, Max, Teams, Enterprise 또는 Anthropic Console | 무료 계정은 제한됨 |
| 인터넷 | 필수 (클라우드 기반 모델 호출) | 오프라인 동작 불가 |
Windows 환경에서는 WSL(Windows Subsystem for Linux, 윈도우 안에서 리눅스 명령을 실행할 수 있게 해주는 레이어)이 필수다. PowerShell에서 wsl --install을 실행하면 Ubuntu가 함께 설치된다.
Claude Code 설치 — 방법 두 가지
Anthropic은 현재 네이티브 설치와 npm 설치 두 가지를 공식 지원한다. 2026년 기준으로 네이티브 설치가 공식 권장 방법이지만 npm도 완전히 지원된다.
curl -fsSL https://claude.ai/install.sh | bash 를 붙여넣고 엔터. Node.js가 없어도 바로 설치된다. 백그라운드 자동 업데이트도 지원한다.claude를 입력하면 브라우저가 열리면서 Claude.ai 계정 로그인 화면이 나타난다. Pro/Max/Teams/Enterprise 계정이면 바로 사용 가능.claude --version으로 버전이 출력되면 정상 설치된 것이다. 이제 작업 폴더로 이동해서 claude를 입력하면 된다.npm으로 설치하고 싶다면 Node.js 18 이상이 설치된 환경에서 npm install -g @anthropic-ai/claude-code를 실행한다. 이 방법도 완전히 지원되지만 절대로 sudo와 함께 실행하지 말 것. 권한 오류가 날 때는 nvm(Node Version Manager, 여러 버전의 Node.js를 동시에 관리할 수 있는 도구)을 사용해서 Node.js를 홈 디렉토리에 설치하는 게 올바른 해결법이다.
업그레이드는 npm 설치의 경우 npm install -g @anthropic-ai/claude-code@latest, macOS Homebrew는 brew upgrade claude-code로 한다.
무료로 시작하는 방법 — 계정과 요금제
Claude Code를 사용하려면 Anthropic 계정이 필요하다. 완전 무료로는 기능이 제한되며, 실질적으로 쓰려면 Claude Pro 이상이 필요하다.
Claude.ai에서 이메일로 계정을 만들면 무료 플랜으로 시작할 수 있다. 무료 플랜에서도 Claude Code 자체는 설치되지만 모델 호출 횟수가 크게 제한되어 일상적인 개발 작업에는 부족하다.
| 플랜 | 월 요금 | Claude Code 사용 |
|---|---|---|
| Free | 무료 | 제한적 (횟수 제한) |
| Pro | $20/월 | 사용 가능 (사용량 한도 있음) |
| Max | $100/월~ | 넉넉한 한도, 긴 컨텍스트 |
| Teams / Enterprise | 별도 협의 | 팀 단위, 우선 지원 |
| Console (API Key) | 사용량 과금 | API 키로 직접 연결 |
API 키를 통해 쓰고 싶다면 Anthropic Console에서 계정을 만들고 키를 발급받은 다음 환경변수로 설정하면 된다. export ANTHROPIC_API_KEY=sk-ant-...를 셸 설정 파일(~/.zshrc 또는 ~/.bashrc)에 추가한다. 이 방법은 사용한 토큰만큼 비용을 내는 방식이라 적은 사용량이라면 Pro 구독보다 저렴할 수 있다.
첫 실행 — 기본 사용법
설치와 로그인이 끝났다면 실제 작업 폴더로 이동해서 claude를 입력하는 것으로 바로 시작할 수 있다.
cd 프로젝트폴더 후 claude 입력. Claude Code가 현재 폴더의 파일 구조를 스스로 파악한다. 처음 실행 시 어떤 작업을 할지 자연어로 입력하면 된다./help를 입력하면 사용 가능한 명령 목록이 나온다. /clear는 대화 초기화, /model은 모델 변경, /settings는 설정 화면이다. 자주 쓰는 작업은 슬래시 명령으로 빠르게 실행할 수 있다.원라이너(한 줄 명령)로 바로 실행하고 싶다면 claude "작업 내용을 여기에" 형태로도 가능하다. 예를 들어 claude "현재 폴더의 Python 파일들을 분석해서 개선점을 알려줘"처럼 쓰면 대화창 없이 바로 결과가 나온다.
IDE 연동은 VS Code의 경우 확장 마켓플레이스에서 Claude Code 확장을 설치하면 편집기 안에서 바로 쓸 수 있다. 공식 설정 문서(docs.anthropic.com)에서 JetBrains, Neovim 등 다른 편집기 설정도 확인할 수 있다.
주의할 점 — 권한과 비용 관리
Claude Code는 터미널에서 실제 명령을 실행하고 파일을 수정하는 도구다. 몇 가지 주의사항을 알고 쓰는 게 좋다.
먼저 파일 수정 권한 문제다. Claude Code는 기본적으로 사용자에게 확인을 요청한 뒤 파일을 수정하지만, 자율 모드(autonomous mode)로 설정하면 확인 없이 진행한다. 중요한 파일이 있는 폴더에서는 git으로 버전 관리를 하고 있는지 먼저 확인하는 게 안전하다.
두 번째는 API 사용량 비용이다. API 키 방식으로 쓴다면 토큰(AI 모델이 텍스트를 처리하는 단위, 한국어 기준 대략 한 글자에 1~2토큰) 사용량이 쌓이면서 비용이 발생한다. Anthropic Console의 사용량 대시보드에서 실시간으로 확인할 수 있고, 한도를 설정해두는 것도 가능하다.
세 번째로 코드 보안이다. Claude Code가 코드를 분석하는 과정에서 해당 코드 내용이 Anthropic 서버로 전송된다. 사내 보안 정책에 따라 민감한 코드에 적용 가능한지 검토가 필요할 수 있다. Enterprise 플랜은 데이터 처리 계약을 별도로 체결할 수 있다.
자주 묻는 질문 FAQ
Q1) Claude Code는 완전 무료로 쓸 수 있나요?
Claude.ai 무료 계정으로도 Claude Code를 설치하고 제한적으로 실행할 수 있다. 단 하루 사용량 한도가 낮아서 실제 개발 작업에는 Pro($20/월) 이상이 현실적이다. API 키 방식은 사용한 만큼만 내므로 적은 사용량이라면 저렴하게 시작할 수 있다.
Q2) Windows에서 PowerShell로 설치하면 안 되나요?
Claude Code는 Windows의 PowerShell이나 cmd에서 직접 동작하지 않는다. WSL(Windows Subsystem for Linux)을 먼저 설치한 뒤 WSL 터미널 안에서 설치해야 한다. WSL은 wsl --install 한 줄로 설치된다.
Q3) VS Code와 함께 쓸 수 있나요?
가능하다. VS Code 마켓플레이스에서 Claude Code 공식 확장을 설치하면 편집기 안에서 바로 Claude Code를 호출할 수 있다. JetBrains 계열(IntelliJ, PyCharm 등)도 플러그인으로 지원한다.
Q4) 어떤 프로그래밍 언어를 지원하나요?
언어 제한이 없다. Claude Code는 파일을 읽고 텍스트로 처리하는 방식이라 Python, JavaScript, TypeScript, Java, Go, Rust, PHP, Ruby 등 거의 모든 언어에서 쓸 수 있다. 다만 덜 알려진 언어는 모델이 학습한 코드 양이 적어 결과 품질이 다를 수 있다.
Q5) 설치 후 버전을 어떻게 최신으로 유지하나요?
네이티브 설치는 백그라운드에서 자동으로 업데이트된다. npm으로 설치했다면 npm install -g @anthropic-ai/claude-code@latest를 주기적으로 실행하거나, macOS Homebrew 사용자라면 brew upgrade claude-code를 쓴다.