클로드 코드 사용법 입문: 설치부터 첫 작업까지 초보자 가이드

📅 2026년 10월 21일 · 집중 연구 · 클로드 코드 A to Z 1편 · 2026년 10월 공식 문서 기준

💡 한 줄 요약: 클로드 코드(Claude Code)는 대화만 하는 AI가 아니라, 컴퓨터 안의 파일을 읽고 고치고 명령을 실행해 일을 끝까지 해 주는 ‘AI 작업자’입니다. 유료 요금제(Pro 이상)에 가입하고 명령어 한 줄로 설치하면, 한국어로 일을 시키는 것부터 시작할 수 있습니다.

클로드 코드 사용법 입문 설치부터 첫 작업까지 대표이미지 — 클로드 코드 A to Z 1편

📚 클로드 코드 A to Z 시리즈 (전 5편)

1편 · 입문: 클로드 코드 사용법, 설치부터 첫 작업까지 ← 지금 읽는 글
2편 · 핵심 기능: CLAUDE.md·권한 모드·계획 모드·되돌리기
3편 · 고급 기능: 스킬·서브에이전트·훅·MCP·플러그인·자동화
4편 · 활용 사례: 무엇을 만들 수 있나 + 실제 구현 기록
5편 · 수익화: 클로드 코드로 돈을 버는 7가지 길과 함정

📋 이 글에서 알 수 있는 것

클로드 코드는 챗GPT·클로드 채팅과 무엇이 다를까?
어디서 쓸 수 있고, 얼마가 들까?
윈도우·맥에서 설치하고 로그인하는 방법은?
처음 켰을 때 무엇을 입력하면 될까?
초보자가 꼭 알아야 할 명령어와 안전장치는?

요즘 개발자뿐 아니라 블로거, 자영업자, 직장인 사이에서도 클로드 코드 사용법을 묻는 사람이 크게 늘었습니다. 2026년 2월 보도에 따르면 클로드 코드의 기업 구독은 그해 1월 1일 이후 4배로 늘었고, 연 환산 매출은 25억 달러를 넘었습니다. 그런데 막상 시작하려면 ‘터미널’, ‘설치 명령어’ 같은 말에서 막히기 쉽습니다. 이 시리즈는 코딩을 해 본 적 없는 사람도 따라올 수 있도록 1편 입문부터 5편 수익화까지 순서대로 정리합니다. 1편에서는 클로드 코드가 무엇인지, 어디서 얼마에 쓸 수 있는지, 설치하고 첫 작업을 시키는 방법까지 다룹니다.

🧭 클로드 코드란 무엇인가: 대답하는 AI에서 일하는 AI로

클로드 코드는 Anthropic이 만든 ‘에이전트형 코딩 도구’입니다. 일반 AI 채팅이 질문에 답을 써 주고 끝난다면, 클로드 코드는 작업할 폴더 안의 파일을 직접 읽고, 새 파일을 만들고, 고치고, 명령어를 실행해 결과를 확인한 뒤 다음 단계를 스스로 정합니다. 이렇게 ‘계획 → 실행 → 확인 → 수정’을 반복하는 방식을 에이전트 루프라고 부릅니다.

🔎 쉽게 말하면: AI 채팅이 ‘전화로 요리법을 알려 주는 친구’라면, 클로드 코드는 ‘부엌에 직접 들어와 재료를 꺼내 요리하고, 간을 보고, 싱거우면 소금을 더 넣는 요리사’입니다. 그래서 더 많은 일을 맡길 수 있지만, 부엌(컴퓨터)에 들어오게 하는 만큼 무엇을 허락할지 정하는 것이 중요합니다.

구분	AI 채팅(일반 대화형)	클로드 코드
하는 일	답변·코드 예시를 글로 보여 줌	파일을 직접 만들고 고치고, 명령을 실행해 확인
작업 범위	대화창 안	지정한 폴더(프로젝트) 전체, 연결한 외부 도구
결과 확인	사람이 복사해 붙여 넣고 실행	스스로 실행·테스트하고 실패하면 다시 고침
어울리는 일	질문, 아이디어, 짧은 글	웹페이지·자동화 스크립트 만들기, 파일 정리, 오류 고치기

🖥️ 어디서 쓸 수 있나: 6가지 사용 장소

클로드 코드는 처음엔 검은 화면의 ‘터미널’에서만 쓰는 도구였지만, 지금은 여러 곳에서 같은 엔진으로 쓸 수 있습니다. 어디서 쓰든 프로젝트 설정 파일(CLAUDE.md), 설정, 연결 도구가 그대로 따라옵니다.

사용 장소	특징	이런 사람에게
터미널(CLI)	모든 기능을 쓰는 기본형. 명령어로 설치	기능을 전부 써 보고 싶은 사람
데스크톱 앱(맥·윈도우)	Claude 앱의 ‘Code’ 탭. 변경 내용을 화면으로 확인, 여러 작업 동시 진행, 예약 작업	터미널이 낯선 초보자
VS Code·Cursor 확장	코드 편집기 안에서 변경 사항을 나란히 비교	편집기를 이미 쓰는 사람
JetBrains 플러그인	IntelliJ·PyCharm 등에서 사용(CLI 별도 설치 필요)	자바·파이썬 개발자
웹(claude.ai/code)	설치 없이 브라우저에서. 오래 걸리는 작업을 클라우드에 맡기고 나중에 확인	회사 PC 등 설치가 어려운 경우
모바일·Slack·GitHub	휴대폰 Claude 앱에서 작업 확인, Slack에서 @Claude 호출, GitHub에서 @claude 호출	이동 중 확인, 팀 작업

💡 초보자 팁: 터미널이 처음이라면 데스크톱 앱으로 시작해도 됩니다. 공식 문서도 ‘그래픽 화면을 원하면 데스크톱 앱’을 권하며, 앱에는 클로드 코드가 들어 있어 따로 설치할 필요가 없습니다.

💳 얼마가 들까: 요금제와 사용량

클로드 코드는 무료 요금제에서는 쓸 수 없습니다. Pro, Max, Team, Enterprise 구독이나 API 선불 크레딧(Claude Console) 계정이 필요합니다. 2026년 10월 기준 공식 가격(미국 달러)은 다음과 같습니다.

요금제	가격	클로드 코드	사용량
Free	0달러	포함 안 됨	—
Pro	월 20달러(월 결제) / 월 17달러(연 결제, 200달러 선불)	포함	5시간 단위 사용 한도 + 주간 한도
Max	월 100달러부터	포함	Pro의 5배 또는 20배
Team 일반석	1인 월 25달러(월 결제) / 20달러(연 결제)	포함	Pro보다 많음
Team 프리미엄석	1인 월 125달러(월 결제) / 100달러(연 결제)	포함	일반석의 5배
API(Console)	쓴 만큼 토큰 단위 과금	사용 가능	선불 크레딧 차감

자료: claude.com/pricing, 클로드 코드 공식 문서(setup, costs). 웹·데스크톱·모바일 Claude와 클로드 코드는 같은 사용량을 나눠 씁니다.

🔎 쉽게 말하면: 구독은 ‘뷔페’, API는 ‘단품 주문’에 가깝습니다. 구독은 정해진 시간(5시간 단위)과 주간 한도 안에서 먹는 만큼 추가 요금이 없고, API는 한 접시(토큰)마다 값을 냅니다. 개인이 배우는 단계라면 Pro 구독으로 시작해, 한도에 자주 걸릴 때 Max를 고민하는 순서가 일반적입니다.

참고로 회사에서 API로 쓰는 경우, 공식 문서는 엔터프라이즈 환경의 평균 비용을 ‘개발자 1인당 실제 사용한 날 하루 약 13달러, 한 달 150~250달러’로 안내합니다. AI 서비스 가격이 결국 그 뒤의 컴퓨터(연산) 비용에서 나온다는 점은 AI 연산 임대 계약으로 본 스페이스X 실적 해설에서 돈의 흐름으로 볼 수 있습니다.

⚙️ 클로드 코드 사용법 1단계: 설치하기

컴퓨터가 조건을 갖췄는지 먼저 확인

항목	필요 조건
운영체제	macOS 13 이상, Windows 10(1809) 이상, Ubuntu 20.04 이상, Debian 10 이상, Alpine 3.19 이상
메모리	4GB 이상, x64 또는 ARM64 프로세서
인터넷	필요(AI가 클라우드에서 동작)
지역	Anthropic 지원 국가(한국·일본 포함)

운영체제별 설치 명령어(공식 권장: 네이티브 설치)

터미널(맥은 ‘터미널’ 앱, 윈도우는 시작 메뉴의 ‘PowerShell’)을 열고 아래 한 줄을 붙여 넣은 뒤 Enter를 누릅니다. 설치 중에는 진행 표시가 없으니 잠시 기다리면 됩니다.

맥·리눅스·WSL

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

윈도우 PowerShell (화면 앞에 PS C:\ 가 보이면 PowerShell)

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

윈도우 명령 프롬프트(CMD)

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

이 밖에 맥은 Homebrew(brew install --cask claude-code), 윈도우는 WinGet(winget install Anthropic.ClaudeCode)으로도 설치할 수 있습니다. 네이티브 설치는 백그라운드에서 자동 업데이트되고, Homebrew·WinGet은 직접 업데이트해야 합니다.

설치가 끝나면 터미널을 새로 열고 아래를 입력해 버전 숫자가 나오는지 확인합니다. ‘명령을 찾을 수 없다’는 오류가 나면 대부분 경로(PATH) 문제이며, claude doctor로 진단할 수 있습니다.

claude --version

💡 초보자 팁: 윈도우에서는 Git for Windows를 함께 설치하면 클로드 코드가 리눅스식 명령(Bash)을 쓸 수 있어 더 안정적입니다. 설치하지 않으면 PowerShell로 대신 작업합니다.

🔑 클로드 코드 사용법 2단계: 로그인과 첫 실행

작업할 폴더로 이동한 뒤 claude를 입력하면 처음 한 번 브라우저가 열리며 로그인을 요청합니다. Claude 구독 계정으로 로그인하면 끝입니다. 이후에는 다시 로그인할 필요가 없고, 계정을 바꿀 때는 실행 중에 /login을 입력합니다.

cd 내-프로젝트-폴더
claude

🔎 쉽게 말하면: 폴더는 클로드 코드의 ‘작업실’입니다. 어느 폴더에서 claude를 실행하느냐에 따라 클로드가 볼 수 있는 파일이 정해집니다. 처음에는 바탕화면에 빈 연습용 폴더를 하나 만들어 그 안에서 시작하는 것이 안전합니다.

💬 클로드 코드 사용법 3단계: 첫 대화와 첫 작업

클로드 코드는 한국어로 말해도 잘 알아듣습니다. 처음에는 질문으로 시작해 보고, 익숙해지면 작업을 맡깁니다.

단계	입력 예시	무엇이 일어나나
① 둘러보기	이 폴더에 무엇이 있는지 설명해 줘	파일을 읽고 요약
② 기능 묻기	클로드 코드로 무엇을 할 수 있어?	자기 기능을 설명
③ 작은 작업	오늘 날짜와 할 일 3개를 적는 todo.md 파일을 만들어 줘	파일을 만들고 내용을 보여 줌
④ 실행까지	1부터 100까지 더하는 파이썬 파일을 만들고 실행해서 결과를 알려 줘	파일 생성 → 실행 → 결과 확인
⑤ 고치기	방금 파일에 1부터 1000까지로 바꾸는 옵션을 추가해 줘	기존 파일을 수정하고 다시 실행

클로드가 파일을 고치거나 명령을 실행하기 전에 허락을 물으면 ‘Yes’를 고르면 됩니다. 최신 버전(v2.1.283 이상)은 기본으로 ‘자동 모드’로 시작해, 별도의 안전 검사 모델이 위험해 보이는 행동만 막고 나머지는 묻지 않고 진행합니다. 모드는 Shift+Tab으로 언제든 바꿀 수 있고, 자세한 내용은 2편에서 다룹니다.

⌨️ 초보자가 꼭 알아야 할 명령어 10개

명령	어디서	하는 일
`claude`	터미널	대화형으로 시작
`claude "작업 내용"`	터미널	첫 지시와 함께 시작
`claude -p "질문"`	터미널	한 번 답하고 끝냄(자동화에 사용)
`claude -c`	터미널	이 폴더의 가장 최근 대화를 이어서
`claude -r`	터미널	예전 대화 목록에서 골라 이어서
`/help`	클로드 안	쓸 수 있는 명령 보기(`/`만 쳐도 목록이 나옴)
`/clear`	클로드 안	대화를 비우고 새로 시작
`/usage`	클로드 안	사용량·한도 확인
`Esc`	클로드 안	작업을 즉시 멈춤(대화는 유지)
`Esc 두 번` 또는 `/rewind`	클로드 안	이전 시점으로 대화·코드를 되돌림

🛡️ 시작 전에 알아 둘 안전장치

클로드 코드는 실제로 파일을 바꾸고 명령을 실행하기 때문에, 몇 가지 습관만 들이면 실수를 크게 줄일 수 있습니다.

습관	이유
연습용 폴더에서 시작	중요한 파일이 있는 폴더에서 바로 시작하면 실수로 바뀔 수 있습니다.
Git으로 저장 지점 만들기	되돌리기(체크포인트)는 클로드의 파일 편집만 기록합니다. 명령으로 바뀐 것은 기록되지 않으니 Git이 진짜 보험입니다.
비밀번호·API 키를 대화에 붙여 넣지 않기	열쇠는 환경 변수나 별도 파일로 관리합니다.
이상하면 바로 Esc	방향이 틀렸을 때 일찍 멈출수록 시간과 사용량이 덜 듭니다.

⚠️ 주의: ‘모든 권한을 건너뛰는 모드(bypassPermissions)’는 공식 문서가 ‘격리된 컨테이너·가상 머신에서만’ 쓰라고 안내합니다. 개인 컴퓨터에서는 켜지 않는 것이 좋습니다.

🌍 연결 지도: 클로드 코드가 바꾸는 일의 경제

① 변화 — AI가 대답을 넘어 파일을 고치고 실행까지 하는 ‘에이전트’로 진화

⬇

② 1차 영향 — 코드를 직접 쓰지 못해도 웹페이지·자동화 도구를 만들 수 있는 사람이 늘어남

⬇

③ 2차 영향 — 반복 업무(파일 정리·보고서·데이터 집계)의 시간 비용이 크게 줄고, 소규모 사업자도 맞춤 도구를 가질 수 있게 됨

⬇

④ 영향받는 분야 — 소프트웨어 개발 외주, 사무 자동화, 콘텐츠 제작, 교육, AI 연산 인프라

⬇

⑤ 우리 생활 — 월 구독료와 바꾸는 시간, 새로운 부업·일자리 기회, 반대로 단순 작업 일자리의 변화

⚖️ 반대 의견과 주의할 점

“코딩을 몰라도 된다”는 말은 반만 맞습니다. 클로드 코드는 코드를 대신 써 주지만, 무엇을 만들지 정하고 결과가 맞는지 확인하는 일은 여전히 사람의 몫입니다. 공식 문서도 가장 중요한 습관으로 ‘클로드가 스스로 확인할 수 있는 방법(테스트·실행 결과·화면 비교)을 주라’고 강조합니다.

사용량 한도도 고려해야 합니다. 구독 요금제는 5시간 단위와 주간 한도가 있어, 긴 대화를 계속 이어 가면 생각보다 빨리 한도에 닿을 수 있습니다. 작업이 바뀔 때마다 /clear로 대화를 비우는 습관이 사용량을 아끼는 가장 쉬운 방법입니다.

✅ 클로드 코드 사용법, 입문자가 기억할 포인트

포인트	왜 중요한가
폴더가 곧 작업 범위	어느 폴더에서 시작하느냐가 클로드가 볼 수 있는 범위를 정합니다.
구체적으로 말하기	‘고쳐 줘’보다 ‘로그인 화면에서 빈칸이면 오류 문구를 띄워 줘’가 훨씬 정확합니다.
확인 방법을 함께 주기	‘만들고 실행해서 결과를 보여 줘’라고 하면 클로드가 스스로 검증합니다.
작업마다 /clear	대화가 길수록 정확도가 떨어지고 사용량이 늘어납니다.
멈춤과 되돌리기	Esc와 /rewind를 알면 두려움 없이 실험할 수 있습니다.

📘 함께 알면 좋은 용어

에이전트(Agent): 목표를 받으면 스스로 계획을 세우고 도구를 써서 일을 끝까지 하는 AI. 클로드 코드는 컴퓨터 작업용 에이전트입니다.

터미널(Terminal): 글자로 컴퓨터에 명령을 내리는 창. 맥의 ‘터미널’, 윈도우의 ‘PowerShell’이 대표적입니다.

토큰(Token): AI가 글을 읽고 쓰는 단위. 사용량과 요금이 토큰 수로 계산됩니다.

❓ 자주 묻는 질문

Q1. 클로드 코드는 무료로 쓸 수 있나요?
아닙니다. 무료 요금제에는 포함되지 않으며, Pro(월 20달러, 연 결제 시 월 17달러) 이상 구독이나 API 선불 크레딧 계정이 필요합니다.

Q2. 코딩을 전혀 몰라도 클로드 코드를 쓸 수 있나요?
한국어로 원하는 결과를 설명하면 클로드가 코드를 쓰고 실행까지 해 줍니다. 다만 무엇을 만들지 정하고 결과를 확인하는 일은 사람이 해야 하므로, 작은 작업부터 연습하는 것이 좋습니다.

Q3. 윈도우에서도 클로드 코드를 설치할 수 있나요?
네. Windows 10(1809) 이상에서 PowerShell에 ‘irm https://claude.ai/install.ps1 | iex’를 입력해 설치할 수 있고, 터미널이 부담스럽다면 데스크톱 앱의 Code 탭을 써도 됩니다.

➡️ 2편 예고: 클로드에게 프로젝트 규칙을 기억시키는 CLAUDE.md, 6가지 권한 모드, 먼저 계획을 세우게 하는 계획 모드, 실수를 되돌리는 체크포인트까지. 매일 쓰는 핵심 기능을 2편에서 정리합니다.

📚 함께 읽으면 좋은 글

피지컬 AI 관련주 세계 지도 — AI가 화면 밖 현실 세계로 나가는 흐름을 보면, 컴퓨터 안에서 일하는 클로드 코드 같은 ‘소프트웨어 에이전트’와 비교해 이해하기 좋습니다.

참고 자료

Claude Code 공식 문서 – 개요 · Claude Code 공식 문서 – 설치·시스템 요구사항 · Claude Code 공식 문서 – 빠른 시작 · Claude 요금제 안내 · Claude Code 공식 문서 – 비용 관리 · Constellation Research – 클로드 코드 매출 보도(2026.2)

⚠️ 이 글은 2026년 10월 기준 Anthropic 공식 문서와 공개 보도를 바탕으로 정리한 정보 제공용 콘텐츠입니다. 기능·요금·명령어는 업데이트로 바뀔 수 있으니 실제 사용 전 공식 문서를 확인하세요.