터미널 CLI 시작하기

Claude Code CLI는 터미널에서 프로젝트 파일을 읽고, 수정하고, 명령을 실행하는 방식으로 작업합니다. 셸 워크플로우, 원격 서버, 스크립트, CI 작업과 함께 쓰기 좋습니다.

설치

터미널에서 Claude Code로 직접 작업하려면 아래 방법 중 하나로 CLI를 설치하십시오.

네이티브 설치(권장)

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

The token '&&' is not a valid statement separator가 표시되면 CMD가 아니라 PowerShell을 사용 중인 것입니다. 'irm' is not recognized as an internal or external command가 표시되면 PowerShell이 아니라 CMD를 사용 중인 것입니다. PowerShell 프롬프트는 PS C:\로 시작하고, CMD 프롬프트는 PS 없이 C:\로 시작합니다.

네이티브 Windows에서는 Claude Code가 Bash 도구를 사용할 수 있도록 Git for Windows를 권장합니다. Git for Windows가 설치되어 있지 않으면 Claude Code는 셸 도구로 PowerShell을 사용합니다. WSL 환경에는 Git for Windows가 필요하지 않습니다.

네이티브 설치는 최신 버전을 유지하도록 백그라운드에서 자동 업데이트됩니다.

Homebrew

brew install --cask claude-code

Homebrew에는 두 가지 cask가 있습니다. claude-code는 안정 릴리스 채널을 따르며, 일반적으로 최신 버전보다 약 일주일 늦고 주요 회귀가 있는 릴리스는 건너뜁니다. claude-code@latest는 최신 채널을 따르며 새 버전이 배포되는 즉시 받습니다.

Homebrew 설치는 자동 업데이트되지 않습니다. 최신 기능과 보안 수정을 받으려면 설치한 cask에 따라 brew upgrade claude-code 또는 brew upgrade claude-code@latest를 실행하십시오.

WinGet

winget install Anthropic.ClaudeCode

WinGet 설치는 자동 업데이트되지 않습니다. 최신 기능과 보안 수정을 받으려면 주기적으로 winget upgrade Anthropic.ClaudeCode를 실행하십시오.

Debian, Fedora, RHEL, Alpine에서는 apt, dnf 또는 apk로도 설치할 수 있습니다.

설치 후 실행

설치가 끝나면 작업하려는 프로젝트에서 Claude Code를 시작합니다.

cd your-project
claude

처음 사용할 때 로그인하라는 메시지가 표시됩니다. 로그인과 첫 세션 흐름은 빠른 시작을 참고하십시오.