Claude Code 시작하기 — 터미널에서 AI와 코딩하는 법 (설치부터 실전까지)

AI 코딩 도구 시장에서 2026년 가장 화제인 도구를 꼽으라면 Claude Code입니다. Anthropic이 만든 이 터미널 기반 AI 코딩 에이전트는 단순히 코드 한 줄을 자동완성해주는 수준이 아닙니다. 프로젝트 전체 맥락을 이해하고, 여러 파일을 동시에 수정하며, 자연어로 지시하면 스스로 작업을 이어갑니다.

Cursor나 GitHub Copilot이 IDE 안에서 코드를 제안하는 방식이라면, Claude Code는 터미널에서 프로젝트 전체를 관리하는 에이전트에 가깝습니다. "이 버그 고쳐줘"가 아니라 "이 기능을 만들어줘"라고 말할 수 있는 수준이죠. 이 글에서는 Claude Code를 처음 시작하는 사람을 위해 설치부터 실전 활용까지 단계별로 안내합니다.

Claude Code란

Claude Code는 Anthropic의 공식 터미널 기반 AI 코딩 어시스턴트입니다. 터미널에서 실행되며, 자연어로 지시하면 코드를 읽고, 파일을 편집하고, 명령을 실행하고, Git까지 관리해줍니다. 브라우저나 IDE를 벗어나지 않고 커맨드라인에서 모든 개발 작업을 처리할 수 있는 것이 핵심입니다.

일반적인 AI 코드 자동완성 도구와의 가장 큰 차이점은 에이전틱(agentic) 동작입니다. 단일 파일의 코드를 제안하는 것이 아니라, 프로젝트 전체 구조를 파악하고 여러 파일에 걸쳐 변경사항을 만들어냅니다. 예를 들어 "로그인 기능을 추가해줘"라고 말하면, 라우팅 파일, 컴포넌트 파일, API 핸들러, 데이터베이스 스키마까지 한꺼번에 수정합니다.

요금제와 시작 조건

Claude Code는 무료로 사용할 수 없습니다. 최소 Claude Pro 구독($20/월)이 필요하며, 본격적으로 사용하려면 Max 플랜을 추천합니다.

Pro ($20/월): 가볍게 사용해보기에 적합. 주 2~3회 정도 간단한 버그 수정이나 코드 생성 용도.

Max 5x ($100/월): 일반 개발자 추천. 매일 사용하며 중간 규모 프로젝트를 진행하기에 적합. Opus 모델 접근과 5배 사용량이 핵심.

Max 20x ($200/월): 헤비 사용자용. 여러 인스턴스를 동시에 돌리거나 대규모 프로젝트를 다루는 경우.

API 사용: Anthropic Console 계정으로 토큰 단위 과금도 가능. CI/CD 파이프라인에서 자동화 목적으로 사용할 때 적합.

설치 방법 — 3분이면 완료

2026년 현재 Anthropic이 권장하는 설치 방법은 네이티브 설치입니다. Node.js 같은 별도 의존성 없이 한 줄로 설치됩니다.

Mac / Linux

터미널을 열고 아래 명령어를 입력합니다.

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

몇 초면 설치가 완료됩니다. 설치 확인은 claude --version으로 할 수 있습니다.

Mac (Homebrew)

Homebrew를 사용한다면 brew install --cask claude-code로도 설치 가능합니다.

Windows

WinGet을 사용합니다. winget install Anthropic.ClaudeCode

WSL(Windows Subsystem for Linux) 환경이라면 Mac/Linux와 동일한 curl 명령어를 사용하면 됩니다.

설치 후 터미널에서 claude를 입력하면 로그인 화면이 나타납니다. Claude 계정으로 인증하면 바로 사용할 수 있습니다.

기본 사용법 — 프로젝트 시작하기

Claude Code는 현재 터미널에서 위치한 폴더를 기준으로 동작합니다. 따라서 작업할 프로젝트 폴더로 먼저 이동한 뒤 claude를 실행하는 것이 기본입니다.

cd my-project
claude

실행하면 대화형 인터페이스가 열리고, 자연어로 지시를 내릴 수 있습니다. 몇 가지 유용한 시작 프롬프트를 소개합니다.

프로젝트 파악: "이 코드베이스의 구조를 설명해줘" — 새 프로젝트에 처음 투입됐을 때, 전체 아키텍처와 주요 파일을 빠르게 파악할 수 있습니다.

버그 수정: "user.tsx 34번째 줄의 null 참조 에러를 수정해줘" — 구체적으로 요청할수록 정확한 결과가 나옵니다. "에러 수정해줘"보다 파일명과 위치를 명시하는 것이 핵심입니다.

기능 추가: "다크 모드 토글을 추가해줘. localStorage에 설정을 저장하고 페이지 로드 시 적용되게 해줘" — Claude가 알아서 관련 파일들을 찾아 수정합니다.

테스트 작성: "auth 모듈에 대한 단위 테스트를 작성해줘" — 테스트 프레임워크를 감지하고 적절한 테스트 코드를 생성합니다.

CLAUDE.md — 프로젝트 규칙 설정

프로젝트 루트에 CLAUDE.md 파일을 만들어두면, Claude Code가 매 세션 시작 시 이 파일을 읽고 프로젝트의 규칙을 따릅니다. 팀의 코딩 컨벤션, 선호하는 라이브러리, 아키텍처 결정 사항 등을 적어두면 일관성 있는 코드를 생성해줍니다.

예를 들어 다음과 같이 작성할 수 있습니다.

"이 프로젝트는 Next.js 15 + TypeScript를 사용합니다. 상태 관리는 Zustand, 스타일링은 Tailwind CSS를 사용합니다. 함수형 컴포넌트만 사용하고, 모든 컴포넌트는 components 폴더에 위치합니다. 테스트는 Vitest로 작성합니다."

CLAUDE.md가 없으면 Claude는 합리적인 추측을 하지만, 있으면 첫 번째 프롬프트부터 정확히 팀의 표준을 따릅니다.

핵심 명령어와 팁

/clear: 현재 세션의 컨텍스트를 초기화합니다. 작업 주제가 바뀔 때 사용하면 불필요한 토큰 소모를 줄일 수 있습니다.

/cost: 현재 세션의 토큰 사용량을 확인합니다. API 사용자에게 유용합니다.

모델 전환: 일상적인 작업(함수 작성, 버그 수정, 테스트)에는 Sonnet 모델을, 대규모 리팩토링이나 복잡한 아키텍처 결정에는 Opus 모델을 사용하세요. 약 80%의 작업은 Sonnet으로 충분합니다.

구체적으로 지시하기: "코드 수정해줘"보다 "utils/auth.ts에서 토큰 만료 시 자동 갱신 로직을 추가해줘"처럼 파일 경로와 구체적인 요구사항을 명시하면 훨씬 정확한 결과를 얻을 수 있습니다.

단계별로 진행하기: 한 번에 전체 기능을 만들라고 하지 말고, 구조 확인 → 핵심 로직 → UI → 테스트 순서로 나눠서 지시하면 품질이 올라갑니다.

MCP 연동 — 외부 도구와 연결

Claude Code는 MCP(Model Context Protocol)를 통해 외부 서비스와 연결할 수 있습니다. Slack, Notion, Jira, Figma, Google Drive 등 주요 업무 도구와 통합이 가능합니다.

예를 들어 Slack MCP 서버를 연결하면, Claude Code에서 "Slack #dev 채널에서 오늘 논의된 버그 목록을 가져와서 이슈로 정리해줘"같은 지시가 가능해집니다.

MCP 서버 추가는 claude mcp add 서버이름 서버경로 형태로 간단하게 할 수 있으며, 한번 설정하면 이후 세션에서 자동으로 연결됩니다.

Claude Code vs Cursor vs Copilot — 어떤 상황에 뭘 쓸까

세 도구는 경쟁 관계가 아니라 보완 관계에 가깝습니다.

Claude Code: 터미널에서 프로젝트 단위의 큰 작업을 할 때. 여러 파일에 걸친 기능 추가, 리팩토링, 프로젝트 초기 세팅에 강합니다.

Cursor: IDE 안에서 실시간으로 코드를 작성할 때. VS Code와 동일한 환경에서 AI 제안을 받으면서 코딩하기에 편리합니다.

GitHub Copilot: 기존 IDE에 플러그인으로 추가해서 코드 자동완성을 받을 때. 가볍게 사용하기 좋습니다.

실무에서 가장 많이 채택되는 조합은 Claude Code + Cursor를 함께 쓰는 하이브리드 워크플로우입니다. 큰 틀의 작업은 Claude Code로 처리하고, 세부 수정은 Cursor에서 진행하는 방식이죠.

마무리 — 터미널이 익숙하다면 지금 바로 시작하세요

Claude Code는 터미널에서 일하는 개발자에게 가장 강력한 AI 코딩 도구입니다. 설치는 3분이면 끝나고, CLAUDE.md 하나만 잘 설정해두면 프로젝트마다 일관된 품질의 코드를 생성할 수 있습니다.

아직 AI 코딩 도구를 써보지 않았다면 Pro 플랜($20/월)으로 가볍게 시작해보세요. 한 번 써보면 이전으로 돌아가기 어렵습니다.

이 글에 소개된 서비스와 기능은 2026년 3월 기준입니다. Claude Code는 빠르게 업데이트되고 있으며, 최신 정보는 공식 문서(code.claude.com/docs)에서 확인하세요.