클로드 코드(Claude Code) 입문 가이드 — 설치·모드·CLAUDE.md·MCP·스킬 총정리

핵심 메시지

• 클로드 코드는 터미널에서 동작하는 프롬프트 기반 코딩 도구로, 직접 코드를 쓰지 않고 AI 에이전트에게 원하는 결과를 말하면 코드 생성·디버깅·앱 제작을 대신해 준다.
• 사용하려면 유료 클로드 구독(Pro/Max/Teams/Enterprise)이나 API 크레디트가 필요하며, 맥·리눅스는 curl, 윈도우는 PowerShell의 IRM 명령으로 설치한 뒤 계정 인증과 폴더 신뢰를 거친다.
• 깃(Git)을 설치해 체크포인트를 만들고 깃허브 계정을 'gh auth login'으로 연동하면, 클로드가 작업을 커밋·푸시해 자동으로 저장하므로 실수 시 되돌리기 쉽다.
• shift+tab으로 플랜·기본(ask)·코드(자동 수락) 모드를 오가고, '/model'로 Opus·Sonnet·Haiku를 골라 성능과 비용을 조절하며, 복잡한 작업일수록 먼저 플랜 모드에서 계획을 세우는 것이 좋다.
• 세션을 나가면 대화 맥락이 사라지므로, '/init'으로 CLAUDE.md 파일을 만들어 프로젝트 규칙과 작업 방식을 영구 메모리로 남기면 매번 같은 지시를 반복하지 않아도 된다.

쉽게 이해하기

이 튜토리얼은 사전 지식이 전혀 없는 사람도 클로드 코드를 다룰 수 있도록 설치부터 실전 기능까지 단계별로 안내한다. 클로드 코드는 커서(Cursor)나 유사 도구처럼 코드를 생성하되, 데스크톱 앱이 아니라 터미널·명령줄에서 직접 실행된다는 점이 특징이다.

설치는 운영체제별로 다르다. 맥·리눅스는 안내된 curl 명령을, 윈도우는 PowerShell에서 IRM 명령을 붙여넣어 실행한다. 설치 후 터미널에 'claude'를 입력하면 첫 실행 때 앤트로픽 계정 인증과 현재 폴더 신뢰 여부를 물으며, 이를 마치면 클로드 코드 UI가 뜬다. 초보자에게는 더 쉬운 클로드 데스크톱 앱의 코드 모드도 대안으로 제시된다.

본격 작업 전 강사는 깃 설치와 깃허브 연동을 권한다. 깃은 클로드의 작업을 체크포인트로 남겨 되돌릴 수 있게 해 주고, 깃허브는 코드를 원격에 저장해 다른 기기에서 접근하거나 협업할 수 있게 한다. 흥미로운 점은 이 설치·연동조차 클로드에게 '깃을 설치해 줘', 'gh auth login을 실행해 줘'라고 말해 처리할 수 있다는 것이다.

실제 개발은 커서나 VS 코드 같은 편집기 안의 터미널에서 진행하는 방식이 권장된다. control(또는 command)+백틱으로 터미널을 열고 'claude'를 실행하면, 편집기가 생성 파일과 변경 사항을 실시간으로 보여 준다. 강사는 틱택토와 탑다운 슈팅 게임을 만들며 플랜 모드에서 계획을 세우고 자동 수락으로 실행하는 흐름을 시연한다.

이어서 '/help'로 명령 목록을 보고, escape 두 번으로 입력 지우기·위 화살표로 이전 명령 순환·alt(option)+enter로 줄바꿈 같은 단축키를 소개한다. '/model'로 모델을 바꿔 비용을 조절하고, '/init'으로 CLAUDE.md 영구 메모리를 만들며, '/tasks'로 백그라운드 작업을, '/agents'로 병렬 에이전트를, MCP·훅·스킬로 기능을 확장하는 방법까지 폭넓게 다룬다.

주요 인사이트

• AI 코딩에서 가장 중요한 것은 '무엇을 원하는지 명확히 아는 것'이다. 목표가 모호한 채 에이전트에 끌려가면 디버깅에 오히려 시간이 더 든다. 구체적으로, 한 번에 하나의 작은 작업을 시키면 훌륭한 결과가 나온다.
• 클로드 세션은 무한한 기억을 갖지 않아, 세션을 나가면 맥락이 사라진다. 이 한계를 CLAUDE.md 파일이 메워 프로젝트 규칙과 작업 습관을 지속적으로 참조하게 한다.
• 모델 선택은 비용과 직결된다. Opus는 가장 강력하지만 비싸고, Sonnet은 중간, Haiku는 빠르고 저렴해 작업 성격에 맞춰 골라야 한다.
• 커서·VS 코드 같은 편집기 안에서 클로드 코드를 쓰면 생성되는 파일과 코드 변경을 실시간으로 확인할 수 있어, 터미널에 익숙하지 않은 초보자에게 특히 권장된다.
• '/init', '/agents', MCP, 훅, 스킬처럼 반복 작업을 자동화·확장하는 기능을 익히면, 같은 지시를 매번 되풀이하지 않고도 도구의 잠재력을 끌어낼 수 있다.

자주 묻는 질문

관련 AI 소식