클로드 코드 설치를 해보자

3줄 요약

• Claude Code는 공식 설치 스크립트로 macOS, Windows, Linux에서 명령어 한 줄이면 설치할 수 있습니다.
• npm을 통한 설치는 더 이상 권장되지 않으며 네이티브 설치가 공식 권장 방식입니다.
• CLI 도구이기 때문에 특정 IDE에 종속되지 않고 터미널이 있는 어디서든 동일하게 사용할 수 있습니다.

이 글에서 다루는 것

이 포스팅은 클로드 코드 사용법 시리즈의 두 번째 편입니다. 이번 글에서는 Claude Code를 설치하고 첫 실행까지 마치는 과정을 다룹니다.

설치 자체는 어렵지 않습니다. 터미널에서 명령어 한 줄이면 끝납니다. 다만 환경에 따라 사전 준비가 필요한 경우가 있어서 시스템 요구사항부터 설치, 인증까지 순서대로 정리합니다.

시스템 요구사항

Claude Code를 설치하기 전에 아래 조건을 확인합니다.

운영 체제

운영 체제	최소 버전
macOS	13.0 이상
Windows	10 (1809) 이상
Ubuntu	20.04 이상
Debian	10 이상

하드웨어 및 네트워크

• RAM: 4GB 이상
• 네트워크: 인터넷 연결 필수 (AI 모델과의 통신이 필요합니다)
• Shell: Bash 또는 Zsh에서 최적으로 작동합니다

Windows 사용자 참고

Windows에서 Claude Code를 사용하려면 Git for Windows가 필요합니다. 설치되어 있지 않다면 Claude Code보다 먼저 설치해 주세요.

설치

Claude Code의 권장 설치 방식은 공식 설치 스크립트를 사용하는 네이티브 설치입니다.

참고로 설치 방법은 추후 변경될 수 있으니 아래 방식으로 설치되지 않는다면 공식 가이드(링크)를 참고해주세요.

macOS / Linux / WSL

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

Windows PowerShell

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

Windows CMD

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

네이티브 설치는 백그라운드에서 자동 업데이트를 지원합니다. 한 번 설치하면 항상 최신 버전이 유지되므로 별도로 업데이트를 신경 쓸 필요가 없습니다.

참고: 과거에는 npm을 통한 설치(npm install -g @anthropic-ai/claude-code)도 가능했지만 현재는 더 이상 권장되지 않습니다. 기존에 npm으로 설치한 경우 claude install 명령으로 네이티브 설치로 전환할 수 있습니다.

 

설치가 완료되면 claude doctor 명령으로 설치 상태를 확인할 수 있습니다.

claude doctor

인증

Claude Code를 처음 실행하면 인증 과정이 필요합니다. 개인 사용자 기준으로 두 가지 방법이 있습니다.

Claude Pro 또는 Max 플랜 (권장): Claude.ai에서 Pro 또는 Max 플랜을 구독하면 Claude Code와 웹 Claude를 하나의 구독으로 사용할 수 있습니다. Claude.ai 계정으로 로그인하면 됩니다.

첫 실행

인증이 끝나면 작업할 프로젝트 폴더로 이동한 뒤 claude 명령을 실행합니다.

cd 프로젝트폴더
claude

이게 전부입니다. Claude Code가 실행되면 자연어로 대화하듯 코딩 작업을 시작할 수 있습니다.

CLI 환경의 장점

TIP : IDE란 무엇인가?
IDE(Integrated Development Environment)는 통합 개발 환경이라는 뜻입니다. 코드를 작성하고 실행하고 디버깅하는 데 필요한 기능을 하나의 프로그램 안에 모아 놓은 도구입니다.
대표적인 IDE로는 VS Code, IntelliJ, Cursor, Antigravity 등이 있습니다. 코드 편집기에 파일 탐색, 터미널, 디버거, 버전 관리 등의 기능이 합쳐져 있어서 개발자가 여러 프로그램을 오갈 필요 없이 한 화면에서 작업할 수 있습니다.
바이브 코딩 도구 중에는 특정 IDE의 확장 프로그램(Extension) 형태로 제공되는 것들이 있습니다. GitHub Copilot이 대표적입니다. 이런 도구는 해당 IDE 안에서만 동작합니다. Claude Code는 이와 다른 방식을 택했는데 바로 아래에서 다룹니다.

TIP : 왜 CLI인가?
Claude Code는 GUI 앱이 아니라 CLI(Command Line Interface) 도구입니다. 터미널에서 텍스트 명령으로 동작하는 방식입니다. 왜 이런 형태를 선택했는지 생각해 보면 CLI가 가져다주는 장점이 꽤 뚜렷합니다.

IDE에 종속되지 않는다

<Antigravity IDE의 터미널에서 클로드 코드 실행>

가장 큰 장점입니다. CLI 도구이기 때문에 VS Code, IntelliJ, Cursor, Antigravity 등 어떤 IDE를 쓰든 터미널만 열면 바로 사용할 수 있습니다. 특정 IDE의 확장 프로그램으로 설치하는 방식이 아니므로 개발 환경을 바꿔도 동일한 도구를 그대로 쓸 수 있습니다.

IDE별 확장 프로그램은 해당 IDE 안에서만 동작합니다. 하지만 CLI 도구는 터미널이 있는 모든 환경에서 동작합니다. 오늘은 VS Code에서 내일은 IntelliJ에서 작업하더라도 Claude Code 사용 경험은 동일합니다.

프로젝트와 같은 공간에서 작업한다

CLI는 프로젝트 디렉토리에서 바로 실행됩니다. 별도의 창으로 전환하거나 파일을 따로 열 필요가 없습니다. 코드가 있는 곳에서 곧바로 AI와 대화할 수 있습니다. Claude Code는 실행한 디렉토리의 파일 구조를 인식하기 때문에 프로젝트의 맥락을 자연스럽게 파악합니다.

원격 환경에서도 사용할 수 있다

SSH로 접속한 서버에서도 그대로 쓸 수 있습니다. GUI가 필요 없으므로 클라우드 인스턴스나 Docker 컨테이너처럼 화면이 없는 환경에서도 동일하게 작동합니다. 로컬 머신에서 쓰던 것과 같은 경험을 원격에서도 가져갈 수 있다는 뜻입니다.

자동화와 연동이 쉽다

CLI 도구는 쉘 스크립트나 CI/CD 파이프라인과 자연스럽게 연동됩니다. 반복적인 작업을 스크립트로 만들거나 다른 도구의 출력을 Claude Code의 입력으로 전달하는 것이 가능합니다. GUI 도구에서는 이런 연동이 쉽지 않습니다.

정리

Claude Code 설치는 권장되는 네이티브 방식을 사용하면 명령어 한 줄로 끝납니다.

단계	설명
사전 준비	Windows는 Git for Windows 설치
설치	공식 스크립트 실행 (자동 업데이트 포함)
인증	Claude Pro/Max 계정으로 로그인하여 인증
실행	프로젝트 폴더에서 claude 실행

 

다음 포스팅에서는 Claude Code를 실행한 뒤 기본적인 사용 방법을 다룹니다.