Claude Code 설치하고 command not found 오류가 납니다

~/.local/bin이 PATH에 없어서 발생한다. bashrc에 export PATH 추가 후 터미널 재시작.

Claude Code 대화가 길어질수록 응답이 느려져요

정상이다. /compact 입력하면 속도 회복된다.

Claude Code 코딩 잘 몰라도 쓸 수 있나요

가능하다. 잘못된 요청엔 잘못된 결과가 나온다는 점만 기억하면 된다.

Claude Code 비용이 갑자기 많이 나올 수 있나요

Pro~Max 플랜은 월정액이라 추가 과금 없다. 입문자는 Pro($20/월)로 시작 권장.

Claude Code 파일을 실수로 고칠까봐 걱정돼요

파일 수정 전 항상 변경사항을 보여주고 승인을 받는다.

title: "Claude Code 처음 써봤다 — 설치부터 실제 사용까지 직접 해봤습니다"
permalink: /claude-code-beginner-guide

meta_description: "Claude Code 직접 설치하고 써봤습니다. 터미널 AI 에이전트가 뭔지, Cursor·Copilot이랑 뭐가 다른지, 처음 쓸 때 막히는 것까지 한 포스팅에 정리했습니다."

tags: [Claude Code, AI 코딩 도구, Claude Code 사용법, Claude Code 설치, AI 에이전트]
category: AI활용
published: 2026-06-28

Claude Code 처음 써봤다 — 설치부터 실제 사용까지 직접 해봤습니다

"AI가 코드를 짜준다"는 말, 한 번쯤 들어봤을 거다. Claude Code가 딱 그 도구다.

터미널에서 돌아가는 AI 에이전트인데, 파일을 읽고, 코드를 수정하고, 테스트를 실행하고, Git 커밋까지 직접 처리한다. 처음엔 반신반의했는데 써보니 생각보다 훨씬 실용적이다.

이 글에서는 Claude Code가 뭔지, 설치는 어떻게 하는지, 처음 쓸 때 뭐가 막히는지를 직접 경험한 내용 그대로 정리했다.

Claude Code, 한 줄로 말하면

"내 프로젝트 폴더 안에 들어와서 직접 코드 작업을 해주는 AI"다.

채팅창에서 조언을 주는 게 아니다. 실제로 파일을 열고, 고치고, 저장한다. 터미널 명령도 직접 실행한다.

Copilot이나 Cursor랑 헷갈릴 수 있는데 역할이 다르다.

GitHub Copilot: 내가 코드 칠 때 옆에서 자동완성 도와주는 도구
Cursor: AI 기능을 내장한 코드 에디터
Claude Code: AI 에이전트. "인증 모듈에 테스트 짜고 실행해서 실패하면 고쳐줘" 같은 작업을 혼자서 처음부터 끝까지 처리

비유하자면 Copilot은 "코딩할 때 어깨 너머로 봐주는 AI"고, Claude Code는 "작업 지시하면 알아서 처리하는 AI 개발자"다.

2026년 기준 SWE-bench Verified 80.8%를 달성했다. 코딩 벤치마크에서 현재 업계 최고 수준이다. 말만 잘하는 AI가 아니라 실제로 코드 문제를 잘 푼다는 뜻이다.

설치하는 법 — 4가지 방법 중 뭘 써야 하나

시스템 요구사항 먼저

Claude Code를 쓰려면 Claude 구독이 필요하다. 무료 플랜은 없다.

Pro $20/월 — 개인 입문자
Max 5x $100/월 — 한도 자주 초과하는 헤비 유저
Max 20x $200/월 — 전문 개발자
Team $20~25/인/월 — 팀 단위

처음이라면 Pro($20/월)로 시작해도 충분하다. API 키 방식(종량제)도 있는데, 많이 쓰면 더 비싸질 수 있어서 월정액이 낫다.

운영체제는 macOS, Linux, Windows(WSL 권장) 모두 지원한다.

Native Install — 가장 권장하는 방법

자동 업데이트까지 지원되는 공식 권장 방식이다.

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

설치 후 터미널 재시작하면 claude 명령어가 바로 된다.

npm 방식 — Node.js 18 이상이 있을 때

npm install -g @anthropic-ai/claude-code

주의: sudo는 쓰지 말 것. 권한 오류 나면 nvm으로 Node.js 버전 관리 후 재설치.

Homebrew (macOS) / WinGet (Windows)

macOS Homebrew:

brew install --cask claude-code

Windows WinGet:

winget install Anthropic.ClaudeCode

Homebrew 방식은 자동 업데이트가 안 된다. brew upgrade claude-code 주기적으로 직접 실행해야 한다.

처음 실행부터 첫 명령까지

설치가 끝났으면 내 프로젝트 폴더로 이동해서 claude를 치면 된다.

cd /내-프로젝트-폴더
claude

처음 실행하면 브라우저가 열리면서 로그인 화면이 뜬다. 아래 스크린샷과 같은 화면이 나타나면 정상이다. Claude 계정으로 로그인하면 자격증명이 저장되어 그 다음부터는 자동 로그인이다.

📷 스크린샷: 브라우저 로그인 화면 → 인증 완료 → 터미널 프롬프트 순서로 진행된다.

SSH 환경에서 로그인 안 될 때

원격 서버에 SSH로 접속한 상태라면 브라우저가 안 열릴 수 있다. 이때는 로그인 프롬프트에서 c를 누르면 인증 URL이 터미널에 표시된다. 그 URL을 복사해서 로컬 브라우저에서 열고 로그인하면 된다.

첫 명령 예시

로그인하면 프롬프트가 뜬다. 한국어로 입력해도 된다.

> 이 프로젝트가 뭐 하는 건지 설명해줘
> 로그인 버그 있어. 사용자가 빈 폼 제출 가능한 문제야. 고쳐줘
> 변경사항 커밋 메시지 작성해서 커밋해줘

파일 수정 전에 변경사항을 보여주고 승인 요청을 한다. 실수로 날아가는 일은 없다.

이것만 알면 된다 — 핵심 기능 4가지

1. 파일 직접 수정

여러 파일을 동시에 읽고 수정한다. "A 파일과 B 파일에서 이 함수 찾아서 리팩토링해줘" 같은 요청이 가능하다.

> auth 모듈에 input validation 추가해줘
> UserService 클래스 전체 TypeScript로 변환해줘

2. 테스트 실행 + 자동 수정

테스트를 돌리고 실패하면 스스로 고친다. 이게 Copilot이랑 가장 큰 차이다.

> 단위 테스트 작성하고 실행해서 실패하면 고쳐줘
> 테스트 커버리지 80% 이상으로 올려줘

3. Git 자동화

stage, commit, branch, PR 생성까지 직접 처리한다.

> 변경사항 스테이징하고 커밋 메시지 써줘
> 이 기능 PR 초안 작성해줘

4. CLAUDE.md로 반복 설명 없애기

프로젝트 루트에 CLAUDE.md 파일을 두면 Claude Code가 세션 시작할 때마다 자동으로 읽는다.

> /init

이 명령어 하나면 현재 프로젝트 구조를 분석해서 CLAUDE.md를 자동 생성한다. 여기에 "이 프로젝트는 TypeScript, 테스트는 Jest, 커밋은 Conventional Commits 형식"을 적어두면 매번 설명 안 해도 된다.

Cursor · Copilot이랑 다른 점은

직접 비교해봤다. 한 줄 요약부터 보자.

항목	Claude Code	Cursor	GitHub Copilot
가격	$20~$200/월	$20/월	$10/월
동작 방식	터미널 에이전트	AI 내장 IDE	IDE 확장
주요 강점	대형 코드베이스	일상 편집 편의성	넓은 IDE 지원

항목	Claude Code	Cursor	GitHub Copilot
컨텍스트	1M 토큰	중간	제한적
자율 실행	강함	중간	약함
코딩 벤치마크	SWE-bench 80.8%	N/A	N/A

Claude Code가 맞는 경우:

대규모 리팩토링이 필요할 때
여러 파일에 걸친 작업을 한번에 처리하고 싶을 때
테스트 작성 + 실행 + 수정을 자동화하고 싶을 때
Git 작업을 대화로 처리하고 싶을 때

Cursor가 맞는 경우:

메인 에디터로 쓰면서 AI를 함께 활용하고 싶을 때
인라인 diff를 시각적으로 보면서 리뷰하고 싶을 때
터미널이 불편한 개발 환경일 때

많은 개발자들이 두 도구를 병행한다. "Cursor로 일상 편집 + Claude Code로 복잡한 리팩토링" 조합이 가장 흔하다.

자주 묻는 질문

Q. 설치하고 "claude: command not found" 오류가 납니다

~/.local/bin이 PATH에 없어서 발생한다. 아래를 터미널에 입력하고 재시작하면 된다.

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

zsh 쓴다면 ~/.bashrc 대신 ~/.zshrc를 수정한다.

Q. 대화가 길어질수록 응답이 느려져요

정상이다. 컨텍스트가 쌓이면서 처리량이 늘어나는 거다. /compact를 입력하면 대화가 요약본으로 압축되어 속도가 회복된다.

> /compact

Q. 코딩 잘 몰라도 쓸 수 있나요?

가능하다. 2026년에는 기획자, PM도 많이 쓴다. "잘못된 요청엔 잘못된 결과가 나온다"는 점만 기억하면 된다.

Q. 비용이 갑자기 많이 나올 수 있나요?

Pro~Max 플랜은 월정액이라 추가 과금이 없다. API 키 방식은 사용량에 따라 달라진다. 입문자는 Pro($20/월)로 시작 권장. 세션이 길어지면 /compact로 토큰을 절약할 수 있다.

Q. 파일을 실수로 고칠까봐 걱정돼요

Claude Code는 파일 수정 전에 항상 변경사항을 보여주고 승인을 받는다. y/n 또는 accept/reject로 확인하는 구조다. Shift+Tab으로 전체 자동 승인 모드로 전환도 가능하다.

마치며

Claude Code는 "AI가 내 코드를 직접 고쳐준다"는 게 실제로 가능한 도구다.

처음 쓸 때 가장 좋은 시작점은 미루고 있던 작은 버그다. "사용자가 빈 폼 제출 가능한 버그 있어. 고쳐줘"처럼 구체적으로 요청하면 된다.

잘 작동하면 테스트 작성, README 업데이트, Git 자동화로 범위를 넓혀가면 된다.

공식 문서는 code.claude.com/docs에 한국어로 제공된다. 설치부터 막히면 여기서 확인하는 게 제일 빠르다.

엔딕 AI 블로그에서는 AI 도구 실사용 후기를 계속 정리하고 있다. 디스코드 뉴스레터를 구독하면 새 글이 올라올 때 알림을 받을 수 있다.