MUACO TECH NOTE
Claude Code

[Claude Code] Claude Code 설치와 첫 실행: 터미널에서 시작하기

Claude Code를 내 컴퓨터에 설치하고 로그인한 뒤, 작업 폴더에서 첫 질문을 던지는 데까지 단계별로 따라 할 수 있습니다.

안녕하세요, muaco입니다.

이 글은 Claude Code를 내 컴퓨터에 설치하고 첫 질문을 던지는 데까지 안내합니다. Claude Code는 CLI(터미널에 명령을 쳐서 쓰는 방식)로 동작하는 도구입니다. 실행한 폴더 안의 파일을 직접 읽고 고칩니다. 끝까지 따라 하면 터미널에서 claude 한 줄로 대화 화면이 열립니다. 아래 내용은 2026년 9월 1일에 확인한 공식 문서 기준입니다.

미리 갖춰야 할 준비물

  • 터미널. macOS와 리눅스는 기본 터미널, Windows는 PowerShell이나 명령 프롬프트(CMD)를 씁니다.
  • 유료 계정. 공식 문서는 Claude 구독(Pro, Max, Team, Enterprise), Claude Console 계정(선불 크레딧으로 쓰는 API 계정), 또는 지원되는 클라우드 제공자 접근 중 하나를 요구합니다. 가격 페이지 기준 무료 요금제에는 Claude Code가 없고 Pro는 월납 20달러(연납이면 월 17달러), Team 스탠다드 좌석은 월납 25달러(연납 20달러), Max는 월 100달러부터입니다. 혼자 업무에 쓴다면 Pro가 출발점입니다.
  • 작업할 폴더 하나. 회사 문서 폴더든 연습용 빈 폴더든 상관없습니다.
  • Windows에서 쓴다면 Git for Windows. 문서가 권장합니다. 없으면 Claude Code가 셸 도구로 PowerShell을 대신 씁니다.

따라 하기

  1. 터미널을 엽니다. Windows에서는 화면 앞에 PS C:\가 보이면 PowerShell, C:\만 보이면 CMD입니다.
  2. 설치 명령을 실행합니다. macOS, 리눅스, 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
    Homebrew는 brew install --cask claude-code, WinGet은 winget install Anthropic.ClaudeCode도 됩니다. 다만 이 둘은 자동 갱신되지 않아 brew upgrade claude-code, winget upgrade Anthropic.ClaudeCode로 직접 갱신해야 합니다.
  3. 설치가 됐는지 확인합니다. 
    claude --version
    버전 번호 뒤에 (Claude Code)가 찍히면 성공입니다. 명령을 못 찾는다면 아래 "막히기 쉬운 곳"으로 가세요.
  4. 작업할 폴더로 이동한 뒤 실행합니다. Claude Code는 실행한 위치를 기준으로 파일을 봅니다. 홈 폴더에서 그냥 띄우면 범위가 지나치게 넓어집니다. 문서 표기 그대로입니다. 
    cd /path/to/your/project
claude
    /path/to/your/project 자리에 실제 폴더 경로를 넣습니다. Windows라면 cd C:\Users\내이름\Desktop\연습폴더 같은 모양입니다. 실행되면 화면 위쪽에 작업 디렉터리가 표시됩니다. 의도한 폴더인지 확인하세요.
  5. 로그인합니다. 처음 claude를 실행하면 로그인 안내가 뜹니다. 브라우저에서 인증을 마치면 자격 증명이 저장되어 다음부터는 다시 로그인하지 않습니다. 환경 변수 ANTHROPIC_API_KEY가 설정돼 있으면 로그인 대신 그 키를 승인할지 묻습니다.
  6. 첫 질문을 던집니다. 문서가 예로 드는 첫 질문은 what does this project do?, explain the folder structure입니다. 문서에 따르면 Claude Code가 필요한 파일을 알아서 읽으므로 미리 붙여 넣지 않아도 됩니다.
  7. 첫 수정을 시켜봅니다. add a hello world function to the main file처럼 요청하면 바꿀 파일을 찾아 변경 내용을 보여줍니다. 승인을 물으면 Yes를 고릅니다. Pro, Max, Team 요금제의 대화형 터미널 세션은 Auto 모드로 시작해 분류기가 대신 검토하므로 매번 묻지 않습니다. 다른 요금제는 Manual 모드로 시작합니다. 세션 도중 Shift+Tab으로 모드를 바꿀 수 있습니다.
  8. 끝내고 다시 들어옵니다. 종료는 /exit 또는 Ctrl+D 두 번입니다. 같은 폴더에서 직전 대화를 이어가려면 claude -c, 예전 대화를 골라 이으려면 claude -r을 씁니다. 화면 안에서 /help를 치면 쓸 수 있는 명령이 나옵니다.

막히기 쉬운 곳

  • 설치는 됐는데 command not found: claude가 뜹니다. 설치 폴더가 PATH에 없다는 뜻입니다. 설치 파일은 macOS와 리눅스에서 ~/.local/bin/claude, Windows에서 %USERPROFILE%\.local\bin\claude.exe에 놓입니다. macOS와 리눅스는 echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin"의 출력이 없으면 zsh는 echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc 뒤에 source ~/.zshrc, bash는 같은 줄을 ~/.bashrc에 붙이고 source ~/.bashrc를 실행합니다. Windows PowerShell은 $currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User') 뒤에 [Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')로 사용자 PATH에 설치 폴더를 더합니다. CMD는 시스템 설정의 환경 변수 화면에서 사용자 PATH에 %USERPROFILE%\.local\bin을 더합니다. 어느 쪽이든 터미널을 새로 열어야 반영됩니다.
  • 로그인 화면에서 브라우저가 안 열립니다. WSL2, SSH 접속, 컨테이너에서 흔합니다. 문서는 이때 c를 눌러 인증 주소를 복사한 뒤 브라우저에 직접 붙여넣으라고 안내합니다. 로그인 후 나온 코드를 터미널 입력란에 붙여넣습니다. 붙여넣기가 안 먹으면 claude auth login을 쓰세요. 표준 입력으로 코드를 읽습니다.
  • 로그인은 됐는데 403 오류가 납니다. 문서는 원인을 세 가지로 듭니다. Pro나 Max 사용자는 구독이 살아 있는지, Console 사용자는 계정에 Claude Code 또는 Developer 역할이 있는지 확인하고 회사 프록시 뒤라면 프록시가 API 요청을 가로막는지 봅니다.
  • 구독이 있는데 400 오류와 함께 "This organization has been disabled"가 뜹니다. 예전에 설정해둔 ANTHROPIC_API_KEY가 구독을 밀어내는 증상입니다. unset ANTHROPIC_API_KEY 후 다시 실행하고 ~/.zshrc나 ~/.bashrc에 남은 export 줄을 지우세요. 화면 안에서 /status를 치면 지금 어떤 인증이 쓰이는지 보입니다.

여기서 더 나아가려면

다음 단계로는 프로젝트 폴더에 CLAUDE.md 파일을 두는 방법을 권합니다. 세션마다 읽히는 지시문 파일이라 매번 같은 설명을 반복하지 않아도 됩니다.

이상으로 글 마치겠습니다.

출처

#Claude Code#설치#시작하기#CLI#터미널#Anthropic#AI 코딩 도구#요금제