클로드 코드 입문 가이드: 설치부터 command not found 해결, 첫 웹앱 만들기까지

클로드 코드를 처음 시작할 때 가장 많이 막히는 지점은 코딩이 아닙니다.

대부분은 그 전에 멈춥니다.

• 검은 터미널 화면이 낯설고
• 설치 명령어를 어디에 붙여넣어야 할지 헷갈리고
• command not found가 뜨고
• Pro와 Max 요금제 차이가 헷갈리고
• Opus, Sonnet 같은 모델 이름도 낯섭니다

그래서 이 글에서는 영상에서 다룬 내용을 입문자 기준으로 다시 정리했습니다.

한눈에 요약

클로드 코드는 터미널에서 실행하는 AI 코딩 에이전트입니다.

처음 시작할 때는 공식 문서의 설치 명령어를 붙여넣고, claude --version으로 설치를 확인하면 됩니다.

command not found가 뜨면 설치가 완전히 실패했다기보다 PATH 설정 문제이거나 터미널 재시작이 필요한 상황일 수 있습니다.

클로드 코드는 뭐 하는 도구인가요?

클로드 코드는 터미널에서 실행하는 AI 코딩 에이전트입니다.

일반 챗봇처럼 답변만 하는 도구가 아닙니다. 내가 실행한 폴더를 기준으로 파일을 읽고, 만들고, 수정할 수 있습니다.

예를 들면 이렇게 요청할 수 있습니다.

오늘의 운세 웹앱 만들어줘.
생년월일을 입력하면 오늘의 운세를 보여주는 간단한 HTML 페이지로 만들어줘.

그러면 클로드 코드는 단순히 설명만 하는 게 아니라, 실제 파일을 만들고 코드를 작성합니다.

핵심은 이것입니다.

처음엔 요금제부터 헷갈립니다

클로드 코드를 쓰려면 무료 플랜만으로는 부족합니다. 공식 문서 기준으로 Claude Code는 Pro, Max, Team, Enterprise 또는 Console 계정으로 인증해야 합니다.

영상에서는 입문자 기준으로 Pro로 시작하고, 사용량이 부족해지면 Max를 고려하는 흐름으로 안내했습니다.

다만 가격과 제공량은 바뀔 수 있습니다. 결제 전에는 현재 Claude 요금제 화면을 기준으로 다시 확인하세요.

터미널은 개발자만 쓰는 화면이 아닙니다

입문자가 가장 먼저 무서워하는 화면은 터미널입니다.

검은 화면에 글자만 나오니 괜히 잘못 입력하면 컴퓨터가 망가질 것처럼 느껴집니다. 하지만 처음 클로드 코드를 쓸 때 필요한 명령어는 많지 않습니다.

자주 쓰는 명령어는 이 정도입니다.

cd 폴더명
mkdir 폴더명
claude
claude --version

마우스로 클릭해서 컴퓨터를 쓰는 방식이 GUI라면, 명령어로 지시하는 방식이 CLI입니다.

터미널은 CLI로 컴퓨터와 대화하는 창입니다.

설치는 공식 문서 명령어를 복붙하면 됩니다

설치는 복잡하게 외울 필요가 없습니다.

공식 문서에 있는 명령어를 내 운영체제에 맞게 복사해서 터미널에 붙여넣으면 됩니다.

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

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

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

설치가 끝났다면 아래 명령어로 확인합니다.

claude --version

버전이 출력되면 설치가 된 것입니다.

그리고 프로젝트 폴더에서 아래처럼 실행합니다.

claude

Windows 사용자는 Git Bash를 같이 보는 게 좋습니다

Windows에서는 PowerShell, CMD, Git Bash, WSL 같은 선택지가 있어서 더 헷갈릴 수 있습니다.

처음에는 PowerShell에서 설치해도 됩니다. 다만 Git Bash를 설치해두면 Mac이나 Linux에서 많이 쓰는 명령어 흐름과 더 비슷하게 사용할 수 있습니다.

공식 문서에서도 native Windows 환경에서 Git for Windows를 설치하면 Claude Code가 Git Bash를 사용할 수 있다고 안내합니다.

정리하면 이렇게 보면 됩니다.

• Windows에서 빠르게 시작: PowerShell
• Mac/Linux 명령어 흐름과 비슷하게 사용: Git Bash
• Linux 개발 환경이 필요: WSL

입문자는 일단 PowerShell 또는 Git Bash 중 하나로 시작해도 충분합니다.

command not found는 설치 실패가 아닐 수 있습니다

설치 후 claude를 입력했는데 이런 메시지가 나올 수 있습니다.

command not found: claude

이때 많은 분들이 "설치가 망했다"고 생각합니다.

하지만 꼭 그렇지는 않습니다.

대부분은 터미널이 claude 명령어의 위치를 못 찾는 상황입니다.

여기서 나오는 개념이 PATH입니다.

PATH는 터미널이 명령어를 찾을 때 뒤져보는 폴더 목록입니다. 예를 들어 claude라는 명령어를 입력하면, 터미널은 PATH에 등록된 폴더들을 차례대로 보면서 실행 파일을 찾습니다.

그런데 클로드 코드가 설치된 위치가 PATH에 없으면 이렇게 되는 겁니다.

"claude라는 명령어가 어디 있는지 모르겠는데요?"

그래서 해결 방향은 단순합니다.

1. 먼저 설치가 끝난 뒤 터미널을 완전히 닫고 다시 엽니다.
2. 다시 claude --version을 입력합니다.
3. 그래도 안 되면 claude doctor로 설치 상태를 더 자세히 확인합니다.
4. 설치 후 출력된 안내 문구를 확인합니다. Mac은 PATH에 추가하라는 한 줄 명령어가 같이 나오는 경우가 많습니다.
5. Windows라면 환경 변수의 Path 항목에 Claude Code 설치 경로가 들어갔는지 확인합니다.
6. Path를 수정했다면 터미널을 다시 시작한 뒤 claude --version을 다시 실행합니다.

클로드 코드는 실행한 폴더를 기준으로 일합니다

클로드 코드를 아무 폴더에서나 실행하면 안 됩니다.

클로드 코드는 현재 터미널이 위치한 폴더를 작업 기준으로 봅니다.

예를 들어 바탕화면에 fortune-app이라는 폴더를 만들고 싶다면 이렇게 합니다.

cd Desktop
mkdir fortune-app
cd fortune-app
claude

이제 클로드 코드는 fortune-app 폴더 안에서 파일을 만들고 수정합니다.

VS Code나 Cursor 내장 터미널에서도 쓸 수 있습니다

클로드 코드는 별도의 터미널에서만 쓰는 도구가 아닙니다.

VS Code, Cursor, IntelliJ 같은 개발 도구의 내장 터미널에서도 실행할 수 있습니다.

이 방식이 편한 이유는 분명합니다.

• 왼쪽에서 파일 구조를 볼 수 있습니다.
• 가운데에서 코드를 바로 확인할 수 있습니다.
• 아래나 오른쪽 터미널에서 클로드 코드를 실행할 수 있습니다.
• AI가 만든 결과를 바로 열어볼 수 있습니다.

처음부터 개발 도구 안에서 실행하면 "파일을 만들고 확인하고 수정하는 흐름"이 훨씬 자연스럽습니다.

기본 모델은 Sonnet으로 시작해도 충분합니다

클로드 코드에서는 모델 선택도 중요합니다.

작업에 따라 Opus가 필요한 경우도 있지만, 입문 실습과 일반적인 코드 수정은 Sonnet으로도 충분한 경우가 많습니다.

모델은 세 가지 방식으로 바꿀 수 있습니다.

/model

또는 실행할 때 이렇게 지정할 수 있습니다.

claude --model sonnet

자주 Sonnet을 쓸 거라면 사용자 설정 또는 프로젝트 설정의 settings.json에 model 값을 지정할 수도 있습니다.

{
  "model": "sonnet"
}

공식 문서 기준으로 sonnet은 일상적인 코딩 작업에 맞는 모델 alias입니다. 반대로 opus는 더 복잡한 추론 작업에 적합합니다.

프롬프트 1줄로 웹앱을 만들 때의 순서

영상에서는 "오늘의 운세" 웹앱을 예시로 다뤘습니다.

중요한 건 프롬프트 한 줄보다 순서입니다.

바로 구현시키기보다 아래 순서로 가는 것이 좋습니다.

처음에는 이렇게 요청해보세요.

생년월일을 입력하면 오늘의 운세를 보여주는 웹앱을 만들고 싶어.
HTML, CSS, JavaScript만 사용해서 한 폴더 안에서 실행되게 만들어줘.
바로 구현하지 말고 먼저 어떤 파일을 만들지 계획해줘.

계획을 먼저 받으면 좋은 점이 있습니다.

• 어떤 파일이 생길지 미리 볼 수 있습니다.
• 기능 범위가 너무 커지는 것을 막을 수 있습니다.
• 내가 원하는 방향과 다른지 구현 전에 확인할 수 있습니다.
• 수정 비용이 줄어듭니다.

계획이 괜찮다면 그때 이렇게 말하면 됩니다.

좋아. 이 계획대로 구현해줘.

입문자가 자주 하는 실수

자주 묻는 질문

설치 전 체크리스트

마지막으로, 처음 시작할 때는 아래 순서대로만 확인하세요.

1. 내 운영체제를 확인합니다. Mac인지, Windows인지, WSL을 쓸 것인지 정합니다.
2. 공식 문서에서 현재 설치 명령어를 확인합니다.
3. 터미널에 설치 명령어를 붙여넣습니다.
4. claude --version으로 설치를 확인합니다.
5. 문제가 있으면 claude doctor로 상태를 확인합니다.
6. 작업할 폴더로 이동한 뒤 claude를 실행합니다.
7. /model로 현재 모델을 확인하고, 입문 실습은 Sonnet으로 시작합니다.
8. 바로 구현시키지 말고 "먼저 계획해줘"라고 요청합니다.

마무리

클로드 코드는 어렵게 느껴지지만, 실제로 입문자가 막히는 지점은 꽤 정해져 있습니다.

코딩 실력이 부족해서가 아닙니다.

첫 세팅의 흐름을 아직 모르는 것뿐입니다.

터미널이 무엇인지 알고, 설치 명령어를 붙여넣고, command not found가 PATH 문제일 수 있다는 것만 알아도 시작 장벽이 크게 낮아집니다.

그다음은 작은 웹앱 하나를 만들어보면 됩니다.

처음부터 큰 서비스를 만들려고 하지 말고, "오늘의 운세"처럼 작고 눈에 보이는 결과물부터 만들어보세요.