Skip to main content
터미널을 사용해본 적이 없어도 Claude Code를 사용할 수 있습니다. 이 가이드는 터미널을 열고, Claude Code를 설치하고, 처음으로 상호작용하는 방법을 단계별로 안내합니다.
터미널을 사용하고 싶지 않으신가요? Claude Code 데스크톱 앱을 사용하면 터미널을 완전히 건너뛸 수 있습니다. macOS 또는 Windows용으로 다운로드한 후 데스크톱 빠른 시작을 참조하여 시작하세요.

​
macOS 및 Linux

macOS 또는 Linux 터미널에서 Claude Code를 설치하고 시작하려면 다음 단계를 따르세요. Claude Code는 macOS 13.0 이상이 필요합니다. 지원되는 Linux 배포판은 시스템 요구사항을 참조하세요.
1

터미널 열기

macOS: Cmd + Space를 눌러 Spotlight 검색을 열고, Terminal을 입력한 후 Enter를 누릅니다.Linux: 터미널 앱을 엽니다. 대부분의 배포판에서는 Ctrl + Alt + T를 누르거나 애플리케이션 메뉴에서 “Terminal”을 검색합니다.깜박이는 커서가 있는 창이 나타납니다. 이것이 명령을 입력하는 터미널입니다.
2

Claude Code 설치

이 줄을 복사하여 터미널에 붙여넣고(macOS에서는 Cmd + V, Linux에서는 Ctrl + Shift + V) Enter를 누릅니다:
curl -fsSL https://claude.ai/install.sh | bash
이것은 claude.ai에서 Claude Code 설치 프로그램을 다운로드하고 실행합니다. 작동하면서 텍스트가 스크롤되는 것을 볼 수 있습니다. 완료되면 “Claude Code successfully installed!”가 표시됩니다. 대신 오류가 표시되면 아래의 문제 해결 섹션을 확인하세요.
3

Claude Code 시작

claude를 입력하고 Enter를 누릅니다:
claude
Claude 계정으로 로그인하라는 메시지가 표시됩니다. 화면의 지시를 따릅니다. 로그인할 수 있도록 브라우저 창이 열립니다.
4

Claude Code 사용 시작

로그인한 후에는 코드나 다른 주제에 대해 Claude에게 질문을 시작할 수 있습니다. Claude Code는 완전히 텍스트로 실행됩니다. 메시지를 입력하고 Enter를 눌러 전송합니다. 알아야 할 몇 가지 사항:
  • 터미널에서 항목을 클릭할 수 없습니다. 화살표 키를 사용하여 이동합니다.
  • Claude가 실행 중일 때 Esc를 눌러 중단합니다.
  • exit를 입력하거나 Ctrl + D를 눌러 Claude Code를 종료합니다.
  • /help를 입력하여 사용 가능한 명령을 확인합니다.

​
Windows

Windows에서 Git for Windows를 선택적으로 설치하고, PowerShell을 설정하고, Claude Code를 시작하려면 다음 단계를 따르세요. Claude Code는 Windows 10 버전 1809 이상이 필요합니다. 전체 세부사항은 시스템 요구사항을 참조하세요.
1

Windows용 Git 설치(선택사항)

Git for Windows는 Bash 도구를 활성화하는 Git Bash를 제공합니다. 이것이 없으면 Claude Code는 대신 PowerShell을 사용합니다. 직접 Git을 배울 필요가 없습니다.아직 설치하지 않았다면:
  1. git-scm.com/downloads/win으로 이동하여 설치 프로그램을 다운로드합니다.
  2. 설치 프로그램을 실행합니다. 각 화면에서 다음을 클릭하여 기본값을 수락합니다. 설치 프로그램에는 많은 화면이 있지만 아무것도 변경할 필요가 없습니다.
  3. 편집기를 선택하도록 요청하면 기본값을 유지하고 다음을 클릭합니다.
  4. “Adjusting your PATH environment”가 표시되면 권장 옵션을 선택한 상태로 유지합니다.
이미 Git이 있으신가요? 이 단계를 건너뛸 수 있습니다. 확실하지 않으면 어쨌든 설치하세요. 재설치해도 문제가 발생하지 않습니다.
2

PowerShell 열기

PowerShell은 명령을 입력하기 위한 Windows의 기본 제공 터미널입니다. 모든 Windows 컴퓨터에 사전 설치되어 있습니다.Win + X를 누르고 메뉴에서 Windows PowerShell(또는 Terminal)을 선택합니다. 깜박이는 커서가 있는 창이 나타납니다. 여기서 명령을 입력합니다.
Windows에는 두 가지 명령줄 프로그램이 있습니다: PowerShell과 CMD. 모양은 비슷하지만 다른 명령을 사용합니다. 다음 단계에서 PowerShell에 있는지 확인하세요.어느 것에 있는지 확인하는 방법:
  • PowerShell: 각 줄의 시작 부분에 PS C:\Users\YourName>이 표시됩니다.
  • CMD: PS 없이 C:\Users\YourName>이 표시됩니다.
3

Claude Code 설치

이 줄을 복사하여 PowerShell에 Ctrl + V로 붙여넣거나 마우스 오른쪽 버튼을 클릭하고 Enter를 누릅니다:
irm https://claude.ai/install.ps1 | iex
이것은 Claude Code 설치 프로그램을 다운로드하고 실행합니다. irm은 파일을 가져오고 iex는 실행합니다. 작동하면서 텍스트가 스크롤되는 것을 볼 수 있습니다. 완료되면 “Claude Code successfully installed!”가 표시됩니다. 대신 오류가 표시되면 아래의 문제 해결 섹션을 확인하세요.
CMD에 있는 경우 이 명령을 사용하세요:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
4

Claude Code 시작

PowerShell을 닫고 새 PowerShell 창을 열어 새로 설치된 claude 명령을 인식하도록 합니다. 그런 다음 입력합니다:
claude
Claude 계정으로 로그인하라는 메시지가 표시됩니다. 화면의 지시를 따릅니다. 로그인할 수 있도록 브라우저 창이 열립니다.
5

Claude Code 사용 시작

로그인한 후에는 코드나 다른 주제에 대해 Claude에게 질문을 시작할 수 있습니다. Claude Code는 완전히 텍스트로 실행됩니다. 메시지를 입력하고 Enter를 눌러 전송합니다. 알아야 할 몇 가지 사항:
  • 터미널에서 항목을 클릭할 수 없습니다. 화살표 키를 사용하여 이동합니다.
  • Claude가 실행 중일 때 Esc를 눌러 중단합니다.
  • exit를 입력하거나 Ctrl + D를 눌러 Claude Code를 종료합니다.
  • /help를 입력하여 사용 가능한 명령을 확인합니다.

​
다음 단계는?

Claude Code 환영 화면이 표시되면 준비가 완료된 것입니다. 코드를 작성하는 방법을 알 필요가 없습니다. 원하는 것을 평문 영어로 설명하면 Claude가 코드를 작성합니다.

​
무언가 만들기

Claude는 설명에서 프로젝트를 만들 수 있습니다: 
make me a simple webpage that says hello world
Claude가 파일을 만듭니다. HTML 파일을 두 번 클릭하여 브라우저에서 엽니다.

​
컴퓨터의 파일로 작업

Claude는 이미 있는 파일을 읽고 정리할 수 있습니다: 
look at the screenshots on my Desktop and rename them based on what's in each image

​
질문하기

Claude는 사항을 설명하고, 학습을 도와주거나, 프로젝트를 계획할 수 있습니다: 
I want to build a personal budget tracker. What would I need?
아직 프로젝트가 없어도 괜찮습니다. Claude가 새 프로젝트를 시작하는 데 도움을 줄 수 있습니다.

​
Claude Code를 사용하는 다른 방법

터미널을 사용할 필요가 없습니다. Claude Code는 다음에서도 사용할 수 있습니다:

​
자세히 알아보기

  • 빠른 시작: Claude Code를 사용한 첫 프로젝트의 안내 둘러보기
  • Claude Code 작동 방식: Claude가 파일을 읽고, 명령을 실행하고, 편집하는 방식을 이해합니다.
  • 모범 사례: 효과적인 프롬프팅 및 프로젝트 설정으로 더 나은 결과를 얻습니다.
  • 일반적인 워크플로우: 디버깅, 테스트, 리팩토링 등에 대한 단계별 가이드
  • 터미널 구성: 최고의 Claude Code 경험을 위해 터미널을 사용자 정의합니다.

​
문제 해결

​
macOS 및 Linux 문제 해결

macOS 또는 Linux에 설치할 때 문제가 발생하면 다음 일반적인 문제를 확인하세요:
설치 후 command not found: claude가 표시되면 터미널이 설정을 다시 로드해야 합니다. 터미널 창을 닫고 새 창을 열은 후 다시 claude를 시도합니다.여전히 작동하지 않으면 설치 디렉토리를 PATH에 추가합니다. 셸에 대한 명령을 실행합니다:
# Zsh (macOS 기본값)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# Bash (Linux 기본값)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
그런 다음 다시 claude를 시도합니다. 자세한 내용은 PATH 수정을 참조하세요.
bash: line 1: syntax error near unexpected token '<' 또는 터미널에 <!DOCTYPE html>과 같은 HTML 코드가 표시되면 설치 URL이 설치 프로그램 스크립트 대신 웹 페이지를 반환했습니다.페이지에 “App unavailable in region”이 표시되면 Claude Code를 사용할 수 없는 국가입니다. 지원되는 국가를 참조하세요.그렇지 않으면 명령을 다시 실행해 봅니다. 계속 발생하면 Homebrew를 사용하여 설치합니다:
brew install --cask claude-code
dyld: cannot load, dyld: Symbol not found 또는 built for Mac OS X 13.0이 표시되면 macOS 버전이 Claude Code가 지원하는 것보다 오래되었을 가능성이 높습니다.Apple 메뉴를 열고 이 Mac에 대해를 선택하여 버전을 확인합니다. 13.0보다 오래되었으면 소프트웨어 업데이트를 통해 macOS를 업데이트합니다. 자세한 내용은 macOS 문제 해결 가이드를 참조하세요.
다른 오류의 경우 전체 설치 문제 해결 가이드를 참조하세요.

​
Windows 문제 해결

Windows에 설치할 때 문제가 발생하면 다음 일반적인 문제를 확인하세요:
CMD에 있고 PowerShell이 아닙니다. 이 창을 닫고 대신 PowerShell을 엽니다(Win + X를 누른 후 Windows PowerShell 선택).또는 CMD 설치 명령을 사용합니다:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
이는 일반적으로 오래된 Windows 10 시스템에서 발생합니다. 이 줄을 먼저 실행한 후 설치를 다시 시도합니다:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
irm https://claude.ai/install.ps1 | iex
PowerShell 또는 Git Bash를 찾을 수 없습니다. Claude Code는 최소한 하나의 셸이 필요합니다.
  1. powershell.exe가 PATH에 있는지 확인합니다. 기본 위치는 C:\Windows\System32\WindowsPowerShell\v1.0\입니다. 또는 pwsh를 제공하는 PowerShell 7을 설치합니다.
  2. Git Bash를 사용하려면 Windows용 Git을 Windows 섹션의 첫 번째 단계에 따라 설치합니다.
  3. Git이 설치되어 있지만 Claude Code가 찾을 수 없으면 위치를 알려줍니다: 
    $env:CLAUDE_CODE_GIT_BASH_PATH="C:\Program Files\Git\bin\bash.exe"
    그런 다음 다시 claude를 실행합니다. Git이 다른 곳에 설치되어 있으면 다음을 실행하여 경로를 찾습니다: 
    Get-Command git | Select-Object Source
    해당 경로에서 Git\bin 폴더를 찾아 대신 사용합니다.
매번 설정할 필요가 없도록 이를 영구적으로 만들려면 Git Bash 경로 구성을 참조하세요.
컴퓨터를 다시 시작하고 다시 시도합니다. 이것은 일반적으로 문제를 해결합니다.다시 시작해도 도움이 되지 않으면 다음 명령을 실행하여 Claude Code를 PATH에 추가합니다:
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')
PowerShell을 닫고 새 창을 열은 후 다시 claude를 시도합니다. 자세한 내용은 PATH 확인을 참조하세요.
다른 오류의 경우 전체 설치 문제 해결 가이드를 참조하세요.