바이브 코딩 입문51 / 51
부록 2: Claude Code

Claude Code 설치와 사용법

Claude Code는 터미널에서 대화하듯 코딩하는 AI 에이전트입니다. 3장에서 배운 AI 편집기가 편집기 안에서 곁을 지킨다면, Claude Code는 터미널에서 직접 파일을 읽고 고치고 커밋까지 합니다. 6장에서 배운 Rules · Skills · Agent · Loop 가 바로 이 도구에서 그대로 동작합니다.

어디서 도나

VS Code·Cursor 같은 편집기가 아니라 터미널(명령창) 에서 돕니다. Windows는 PowerShell, macOS는 터미널이 그 창구입니다.

무엇이 다른가

“코드를 대신 쳐 주는” 수준을 넘어 스스로 파일을 찾고, 여러 파일을 고치고, 테스트·커밋까지 이어서 합니다. 큰 일을 통째로 맡길 수 있습니다.

6장의 개념이 실물로

Rules(프로젝트 규칙) · Skills(반복 기술) · Agent(위임) · Loop(자율 반복)가 이 안에서 실제로 쓰입니다. 6장을 손으로 만져 보는 자리입니다.

시작 전에 — 준비물 3가지

  • 유료 구독 필요 — Claude Code는 Pro · Max · Team · Enterprise 구독이나 Claude Console 계정이 있어야 씁니다. 무료 Claude.ai 플랜으로는 사용할 수 없습니다.
  • 운영체제 — macOS는 13 이상, Windows는 10(1809) 이상이면 됩니다.
  • 터미널 여는 법 — 부록 A-2 「실전: 자주 쓰는 CLI 명령어」에서 다뤘습니다. Windows는 시작 메뉴에서 PowerShell, macOS는 Spotlight(⌘+Space)에서 터미널 검색.

① Windows에 설치하기

PowerShell에서 한 줄이면 끝납니다. 관리자 권한은 필요 없습니다.

  1. 시작 메뉴에서 PowerShell 을 검색해 실행합니다.
  2. 아래 명령을 붙여넣고 실행합니다.
winget install Anthropic.ClaudeCode
  1. 설치가 끝나면 PowerShell을 완전히 종료한 뒤 다시 실행합니다. 그러면 claude 명령이 바로 잡힙니다.

한 번에 되는 이유 — WinGet이 설치와 함께 PATH까지 자동으로 등록해 줍니다. 그래서 설치 뒤 PowerShell만 새로 열면 바로 claude 가 동작합니다. 나중에 업데이트는 winget upgrade Anthropic.ClaudeCode 로 하면 됩니다.

Git for Windows 권장 — 4장에서 Git Bash를 설치했다면 이미 준비됐습니다. Claude Code가 Bash 도구를 쓰려면 Git for Windows가 있으면 좋고, 없으면 PowerShell로 대신 동작합니다.

자동 업데이트되는 방식을 원하면 네이티브 설치 스크립트도 있습니다 — irm https://claude.ai/install.ps1 | iex (설치 후 PowerShell 재실행). 처음엔 위의 WinGet 방식이 가장 간단합니다.

② macOS(맥북)에 설치하기

Spotlight(⌘+Space)에서 터미널 을 열고 아래 한 줄 을 실행합니다.

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

Homebrew를 쓴다면 이렇게 설치해도 됩니다.

brew install --cask claude-code

설치가 끝나면 터미널을 새로 열어야 claude 명령을 알아봅니다.

③ 제대로 깔렸는지 확인

Windows·macOS 공통입니다. 아래 명령으로 버전이 찍히면 성공입니다.

claude --version

2.1.x (Claude Code) 처럼 버전이 보이면 완료. 뭔가 이상하면 claude doctor 로 설치 상태를 점검할 수 있습니다.

claude doctor

claude가 '인식되지 않습니다'라고 나올 때 (Windows)

설치는 끝났는데 claude 를 치면 아래처럼 “인식되지 않습니다” (CommandNotFoundException) 라고 나올 수 있습니다. 프로그램이 잘못된 게 아니라, 설치 위치가 지금 열려 있는 PowerShell 창의 PATH에 아직 반영되지 않은 것이 대부분입니다.

claude : 'claude' 용어가 cmdlet, 함수, 스크립트 파일 또는
실행할 수 있는 프로그램 이름으로 인식되지 않습니다.

1. PowerShell을 완전히 껐다 켠다 (가장 흔한 해결)

설치 관리자가 PATH를 새로 등록해도, 이미 열려 있던 창은 그 값을 모릅니다. 탭을 새로 여는 게 아니라 PowerShell 창을 모두 닫고 새 창을 연 뒤 다시 확인하세요.

claude --version

2. 창을 닫기 싫으면 — 지금 창에서 PATH만 새로고침

다시 열지 않고, 현재 창에서 바로 PATH를 다시 읽어올 수도 있습니다. 아래 한 줄을 붙여넣고 다시 확인하세요.

$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
claude --version

macOS도 원리는 같습니다 — 설치 뒤 claude 가 안 먹히면 터미널을 새로 열거나, 전체 경로 ~/.local/bin/claude --version 으로 확인하면 됩니다.

④ 첫 실행과 로그인

작업할 프로젝트 폴더로 이동 한 뒤 claude 를 실행하면 대화가 시작됩니다. 처음이면 브라우저가 열리며 로그인 화면이 뜹니다.

cd 프로젝트폴더
claude

브라우저에서 구독 계정(Pro·Max 등)으로 로그인하면 끝입니다. 다음부터는 자동으로 로그인됩니다. 계정을 바꾸려면 대화 중에 /login 을 입력하세요.

⑤ 간단한 사용법 — 말로 시키기

이제부터는 코드가 아니라 ‘말’ 로 시킵니다. 명령어가 아니라 평범한 문장 으로 물어보세요. 한국어로 그대로 써도 됩니다.

① 먼저 둘러보게 하기

  • 이 프로젝트가 뭐 하는 프로젝트야?
  • 메인 진입점(시작 파일)이 어디야?
  • 폴더 구조를 설명해줘

② 고치게 하기

메인 파일에 hello world 함수 하나 추가해줘

Claude Code가 알맞은 파일을 찾아 바뀔 내용을 먼저 보여주고, 승인을 물어본 뒤 고칩니다.

승인 모드 — 기본은 파일을 고치기 전에 매번 물어봅니다. 대화 중 Shift+Tab 을 누르면 모드가 바뀝니다: acceptEdits(자동 승인) · plan(고치지 않고 계획만). 처음엔 기본 모드로 하나씩 확인하며 익히길 권합니다.

③ 커밋도 말로

바뀐 내용 설명과 함께 커밋해줘

⑥ 자주 쓰는 명령

터미널에서 — 시작·이어하기

claude                 # 대화 시작
claude "빌드 오류 고쳐줘"   # 한 번에 시키기
claude -c              # 방금 대화 이어하기
claude -r              # 지난 대화 골라서 이어하기

대화 중에 — 슬래시(/) 명령

  • /help — 쓸 수 있는 명령·기능 보기
  • /clear — 대화 기록을 지우고 새로 시작
  • /init — 프로젝트 규칙 파일 CLAUDE.md 만들기 (6장 Rules)
  • /login — 계정 로그인·전환
  • /exit (또는 Ctrl+D 두 번) — 종료

대화 중 / 만 쳐도 쓸 수 있는 명령이 모두 뜹니다. ↑ 로 이전 명령을 다시 부르고, Tab 으로 자동완성됩니다.

6장과 이어집니다 — Claude Code는 6장의 Rules(CLAUDE.md) · Skills · Agent · Loop 를 그대로 씁니다. /init 로 규칙을 심고, 큰 일은 Agent에게 쪼개 맡기고, 반복되는 작업은 Skill로 만드세요.

AI 편집기(3장)와 Claude Code는 경쟁이 아니라 함께 쓰는 두 창구 입니다. 눈으로 보며 손댈 땐 편집기, 통째로 맡길 땐 Claude Code.

목차