Claude Code 처음부터 실전 활용까지

완벽 사용 가이드

Claude Code
처음부터 실전 활용까지

코딩 경험이 없어도 OK — 터미널 AI 코딩 에이전트로
업무 자동화부터 앱 개발까지 단계별 완전 정복

설치 & 환경 구성 핵심 명령어 CLAUDE.md 설정 MCP 연동 실전 프롬프트 고급 자동화

Claude Code란 무엇인가?
요금제 & 사전 준비
설치 방법 (OS별 완전 가이드)
첫 실행 & 로그인
기본 사용법 — 자연어로 대화하기
핵심 슬래시 명령어 완전 해설
Plan Mode — 복잡한 작업 안전하게
CLAUDE.md — 프로젝트 기억 파일
VS Code 연동 사용법
MCP 연동 — 외부 도구 연결
실전 활용 시나리오 5가지
권한 & 보안 설정
고급 활용 — 커스텀 명령어
자주 묻는 질문 (FAQ)

01. Claude Code란 무엇인가?

Anthropic이 만든 터미널 기반 AI 코딩 에이전트입니다. 단순한 코드 자동완성을 훨씬 넘어섭니다.

Claude Code는 터미널(명령 프롬프트) 안에서 직접 동작하는 AI 코딩 에이전트입니다. 여러분이 자연어로 "로그인 페이지 만들어줘", "이 버그 고쳐줘"라고 입력하면 실제로 파일을 생성하고 코드를 작성해줍니다. ChatGPT처럼 단순히 코드를 알려주는 것이 아니라 직접 파일을 만들고 수정하고 실행까지 합니다.

일반 AI 채팅 도구와 무엇이 다른가?

ChatGPT나 claude.ai에서 "코드 짜줘"라고 하면 코드를 화면에 보여줍니다. 그러면 직접 복사해서 파일에 붙여넣어야 합니다. Claude Code는 다릅니다. "로그인 기능 만들어줘"라고 하면 내 컴퓨터에 실제 파일을 만들고 코드를 작성합니다. 심지어 패키지 설치, 서버 실행, Git 커밋까지 스스로 처리합니다.

Claude Code가 할 수 있는 것들

파일 생성 & 편집

코드 파일, 설정 파일 등을 직접 만들고 수정합니다

버그 찾기 & 수정

에러 메시지를 붙여넣으면 원인을 분석하고 즉시 고쳐줍니다

코드 구조 분석

기존 프로젝트 전체를 읽고 구조와 흐름을 설명해줍니다

Git 관리

커밋 메시지 작성, 브랜치 생성, PR 준비까지 처리합니다

터미널 명령 실행

npm install, pip, 서버 실행 등 명령어를 대신 실행합니다

앱 처음부터 제작

"투두 앱 만들어줘"라고 하면 완성된 앱을 만들어줍니다

비개발자도 쓸 수 있나요?

충분히 가능합니다. "Python을 모르는데 엑셀 자동화 스크립트 만들어줘"처럼 원하는 것을 한국어로 설명하면 됩니다. Claude Code가 코드를 작성하고 실행하는 방법도 함께 안내해줍니다. 반복 업무 자동화, 데이터 정리, 간단한 웹페이지 제작 등은 코딩 지식 없이도 충분히 활용할 수 있습니다.

02. 요금제 & 사전 준비

Claude Code는 무료 플랜에서 사용할 수 없습니다. 시작 전 요금제를 먼저 확인하세요.

요금제 비교

Free

불가

Claude Code 사용 불가

claude.ai 웹 채팅만 가능
Claude Code 접근 불가

시작 추천

Pro

$20

/월

Claude Code 사용 가능
Sonnet 4.6 기본 제공
주간 사용량 제한 있음
개인 프로젝트 입문용

Max

$100

/월~

Pro보다 5배 이상 사용량
Opus 4.6 사용 가능
사용량 한도 이후 API 과금
실무 및 헤비 유저 추천

API 직접 연결

종량제

사용한 만큼 결제

구독 없이 사용 가능
토큰당 과금
많이 쓰면 구독이 더 저렴
팀/기업 환경 적합

Pro 플랜 사용량 한도 주의

Pro 플랜은 주간 사용량 한도가 있습니다. 대형 프로젝트를 하루 종일 돌리다 보면 한도에 걸릴 수 있습니다. 가볍게 시작할 때는 Pro로 충분하지만, 실무에 본격적으로 쓰려면 Max 플랜을 권장합니다.

사전 준비 체크리스트

Anthropic 계정 생성 (claude.ai에서 가입)
Pro 이상 구독 결제 완료
운영체제 확인: macOS / Linux / Windows 모두 지원
Windows 사용자: WSL(Windows Subsystem for Linux) 필요 — 별도 설명 참고
인터넷 연결 확인

03. 설치 방법 — OS별 완전 가이드

2026년 기준, Anthropic 공식 권장 설치 방식은 Native 설치입니다. 명령어 한 줄로 끝납니다.

macOS / Linux 설치

터미널 앱을 열고 아래 명령어를 복사해서 붙여넣고 Enter를 누릅니다.

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

설치가 완료되면 버전을 확인합니다.

확인claude --version
# v1.x.x 형식으로 출력되면 정상 설치

macOS 터미널 여는 법

키보드에서 Command + 스페이스바를 누르면 Spotlight가 열립니다. "터미널"을 입력하고 Enter를 누르면 됩니다. 또는 응용 프로그램 → 유틸리티 → 터미널로 찾을 수 있습니다.

npm으로 설치 (Node.js가 이미 있는 경우)

Node.js 18 이상이 설치된 환경에서는 npm으로도 설치할 수 있습니다.

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

Windows 설치 (WSL 필요)

Windows에서는 WSL(Windows Subsystem for Linux)을 먼저 설치해야 합니다.

PowerShell을 관리자 권한으로 실행

Windows 검색에서 "PowerShell"을 찾아 우클릭 → 관리자 권한으로 실행을 선택합니다.

WSL 설치 명령어 입력

wsl --install

설치 후 컴퓨터를 재시작합니다. 재시작 후 Ubuntu 터미널이 자동으로 열립니다.

Ubuntu 터미널에서 Claude Code 설치

Ubuntu 터미널이 열리면 사용자 이름과 비밀번호를 설정한 뒤, 위의 macOS/Linux 설치 명령어를 동일하게 입력합니다.

자동 업데이트 지원

Native 설치 방식은 Claude Code가 업데이트될 때 자동으로 최신 버전으로 갱신됩니다. 별도로 재설치할 필요가 없습니다. 현재 버전 확인은 claude --version으로 언제든지 가능합니다.

04. 첫 실행 & 로그인

설치 후 처음 실행하면 계정 연동 과정을 거칩니다. 딱 한 번만 하면 됩니다.

작업 폴더로 이동

Claude Code는 현재 내가 위치한 폴더를 기준으로 동작합니다. 작업할 프로젝트 폴더로 먼저 이동합니다.

# 예: 바탕화면의 my-project 폴더로 이동
cd ~/Desktop/my-project

# 새 폴더를 만들어서 시작하는 경우
mkdir my-project && cd my-project

Claude Code 실행

claude

처음 실행하면 브라우저가 자동으로 열립니다.

브라우저에서 계정 로그인

열린 브라우저에서 Anthropic 계정(claude.ai)으로 로그인합니다. Pro 이상 계정이 필요합니다. 로그인이 완료되면 터미널로 자동으로 돌아옵니다.

프로젝트 스캔 완료 확인

Claude Code가 현재 폴더의 파일들을 스캔해 프로젝트 구조를 파악합니다. 완료되면 대화 입력창이 나타납니다. 이제 자연어로 대화를 시작하면 됩니다.

프로젝트 루트에서 실행하는 것이 중요

Claude Code는 실행한 위치의 폴더를 기준으로 파일을 읽고 씁니다. 반드시 프로젝트의 최상위 폴더(루트)에서 실행하세요. 하위 폴더에서 실행하면 상위 파일들을 인식하지 못할 수 있습니다.

05. 기본 사용법 — 자연어로 대화하기

Claude Code 실행 후 나타나는 입력창에 원하는 것을 한국어 또는 영어로 자유롭게 입력하면 됩니다.

대화 시작하기

Claude Code가 실행되면 > 프롬프트가 나타납니다. 여기에 원하는 작업을 입력합니다. 처음에는 현재 프로젝트가 어떤 것인지 물어보는 것부터 시작하면 좋습니다.

예시 대화 > 이 프로젝트가 어떤 구조로 되어 있는지 설명해줘
# Claude가 폴더 구조, 주요 파일, 사용된 기술 스택을 분석해서 설명합니다

> 사용자 로그인 기능을 추가하고 싶어. 어떻게 하면 될까?
# 현재 프로젝트에 맞는 구체적인 방법을 제안하고, 원하면 직접 구현도 해줍니다

> index.html 파일에 네비게이션 메뉴를 추가해줘
# 파일을 직접 열어서 코드를 추가합니다

작업 승인 시스템

Claude Code가 파일을 수정하거나 명령어를 실행하기 전에 반드시 사용자의 승인을 요청합니다. 예상치 못한 변경이 일어나지 않도록 안전장치가 되어 있습니다.

Claude가 하려는 행동	승인 방법	설명
파일 수정/생성	Y 또는 Enter	변경 내용을 미리 보여주고 수락 여부를 물음
터미널 명령 실행	Y 또는 Enter	실행할 명령어를 보여주고 승인 요청
거절하기	N	해당 단계를 건너뛰고 다른 방법을 요청할 수 있음
모두 자동 승인	Shift + Tab	자동 수락 모드 — 주의해서 사용

자동 수락 모드 주의

Shift + Tab으로 자동 수락 모드를 켜면 Claude가 모든 작업을 승인 없이 진행합니다. 중요한 파일이 있는 폴더에서는 사용에 주의하세요. 익숙해지기 전에는 하나씩 직접 확인하는 기본 모드를 사용하는 것을 권장합니다.

실전 대화 예시 모음

파일/코드 작업

> 할 일 목록을 저장하는 Python 스크립트를 만들어줘. 추가, 삭제, 목록 보기 기능이 있어야 해

> app.js 파일에서 사용하지 않는 변수들을 정리해줘

> 이 함수를 더 읽기 쉽게 리팩토링해줘: [코드 붙여넣기]

버그 수정

> 다음 에러가 발생하는데 고쳐줘:
TypeError: Cannot read properties of undefined (reading 'map')

> 로그인하면 계속 흰 화면만 나오는데 원인을 찾아줘

Git 관련

> 지금까지 작업한 내용을 Git 커밋해줘. 커밋 메시지도 적절하게 작성해줘

> 변경된 파일들이 뭔지 보여주고 어떤 내용이 바뀌었는지 설명해줘

06. 핵심 슬래시 명령어 완전 해설

슬래시(/)로 시작하는 명령어들로 Claude Code의 고급 기능을 제어할 수 있습니다.

명령어	기능	언제 사용?
/plan	Plan Mode 진입	복잡한 작업 전에 먼저 계획을 세울 때
/model	AI 모델 변경	Sonnet ↔ Opus 전환할 때
/memory	메모리(CLAUDE.md) 관리	프로젝트 설정 확인 및 수정 시
/allowed-tools	허용 도구 목록 확인/변경	권한 설정을 조정할 때
/cost	현재 세션 비용 확인	토큰 사용량 및 비용 모니터링
/status	계정 및 연결 상태 확인	문제 발생 시 진단용
/clear	대화 컨텍스트 초기화	새 작업을 깔끔하게 시작할 때
/help	도움말 표시	모르는 것이 있을 때
/exit	Claude Code 종료	작업 완료 후 종료

모델 선택 — Sonnet vs Opus

명령어> /model
# 현재 사용 중인 모델 표시 및 변경 메뉴가 나타납니다

모델	특징	추천 상황
Sonnet 4.6 기본	빠르고 비용 효율적	일반적인 코딩, 일상 작업 80%
Opus 4.6	더 깊은 추론, 복잡한 문제 해결	대규모 리팩토링, 아키텍처 설계 20%

80/20 모델 전략

일반적인 코딩 작업의 80%는 Sonnet 4.6으로 충분합니다. 여러 파일에 걸친 대규모 리팩토링, 복잡한 아키텍처 결정, 디버깅이 어려운 문제에서만 Opus 4.6으로 전환하는 것이 비용 면에서 효율적입니다.

07. Plan Mode — 복잡한 작업을 안전하게

실수를 방지하는 가장 중요한 기능입니다. 초보자일수록 반드시 익혀두어야 합니다.

Plan Mode는 Claude가 실제 작업을 실행하기 전에 어떻게 할지 계획을 먼저 보여주는 모드입니다. 계획이 마음에 들면 진행하고, 아니면 수정할 수 있습니다.

/plan 입력 후 작업 지시

> /plan
> 인증 모듈을 세션 방식에서 JWT 토큰 방식으로 전환해줘

Claude가 계획을 단계별로 제시

관련 파일을 분석하고, 어떤 순서로 무엇을 변경할지 목록으로 보여줍니다. 예상되는 영향 범위도 함께 표시됩니다.

계획 검토 & 질문

계획을 보고 "3번 단계에서 A 대신 B 방식으로 해줘"처럼 수정 요청을 할 수 있습니다. 이해가 안 되는 부분은 물어보세요.

승인 후 실행

계획이 만족스러우면 승인하면 Claude가 계획대로 실행합니다. 각 단계마다 여전히 파일별 수락/거절이 가능합니다.

Plan Mode를 꼭 써야 하는 상황

10개 이상의 파일을 동시에 수정해야 할 때
데이터베이스 스키마나 핵심 설정 파일을 변경할 때
처음 보는 코드베이스에서 작업할 때
롤백이 어려운 중요한 변경을 할 때
작업의 영향 범위가 얼마나 넓은지 파악하고 싶을 때

08. CLAUDE.md — 프로젝트 기억 파일

가장 강력한 생산성 도구입니다. 한 번 설정하면 매번 설명할 필요가 없어집니다.

Claude Code는 기본적으로 대화가 끝나면 맥락을 기억하지 못합니다. 하지만 프로젝트 루트에 CLAUDE.md 파일을 만들어두면, 실행할 때마다 자동으로 읽어서 프로젝트 맥락을 유지합니다.

CLAUDE.md가 없으면?

매번 "이 프로젝트는 React 기반이고 TypeScript를 쓰고 있어. 테스트는 Jest로 작성하고 변수명은 camelCase로 써줘"처럼 설명해야 합니다. CLAUDE.md가 있으면 이런 내용을 한 번만 작성해두면 됩니다.

CLAUDE.md 만드는 법

터미널# 프로젝트 루트에서 파일 생성
touch CLAUDE.md

또는 Claude Code 안에서 바로 만들 수도 있습니다.

Claude Code> 이 프로젝트를 위한 CLAUDE.md 파일을 만들어줘
# Claude가 현재 프로젝트를 분석해서 자동으로 초안을 작성해줍니다

CLAUDE.md 작성 템플릿

CLAUDE.md 예시 # 프로젝트 개요
쇼핑몰 백엔드 API 서버입니다.
Node.js + Express + PostgreSQL 스택을 사용합니다.

# 기술 스택
- 런타임: Node.js 20
- 프레임워크: Express 4.x
- 데이터베이스: PostgreSQL 15 (Prisma ORM)
- 테스트: Jest + Supertest
- 언어: TypeScript

# 코딩 규칙
- 변수명: camelCase
- 파일명: kebab-case
- 함수는 반드시 JSDoc 주석 작성
- 에러 처리는 try-catch로 통일

# 주요 명령어
- 서버 실행: npm run dev
- 테스트: npm test
- 빌드: npm run build

# 주의 사항
- .env 파일은 절대 수정하지 말 것
- DB 마이그레이션 전 반드시 백업 확인

CLAUDE.md 위치 규칙

프로젝트 루트의 CLAUDE.md — 해당 프로젝트 전체에 적용
하위 폴더의 CLAUDE.md — 해당 폴더에서 실행할 때 추가로 로드
홈 폴더(~/)의 CLAUDE.md — 모든 프로젝트에 공통 적용
CLAUDE.local.md — Git에 올라가지 않는 개인 설정용 (개인 API 키 등)

09. VS Code 연동 사용법

터미널만으로도 강력하지만, VS Code와 함께 사용하면 파일을 눈으로 보면서 작업할 수 있어 훨씬 편리합니다.

VS Code 확장 설치

VS Code 설치 (없는 경우)

code.visualstudio.com에서 무료로 다운로드할 수 있습니다. Windows, macOS, Linux 모두 지원합니다.

확장 프로그램 설치

VS Code 왼쪽 사이드바에서 확장 프로그램 아이콘(네모 4개)을 클릭합니다. 검색창에 "Claude Code"를 입력하고 Claude Code for VS Code를 설치합니다.

VS Code 내장 터미널에서 실행

VS Code 상단 메뉴 → 터미널 → 새 터미널을 열면 VS Code 내에서 터미널이 실행됩니다. 여기서 claude를 입력하면 됩니다.

VS Code 연동의 장점

실시간 코드 확인

Claude가 수정한 파일이 VS Code에 즉시 반영되어 눈으로 확인 가능

Diff 뷰 확인

변경 전/후를 나란히 비교하는 Diff 뷰를 VS Code에서 편하게 확인

직접 수정 후 반영

Claude가 만든 코드를 VS Code에서 직접 편집하고 저장하면 자동 반영

10. MCP 연동 — 외부 도구 연결

MCP(Model Context Protocol)를 통해 데이터베이스, GitHub, Slack 등 외부 서비스를 Claude Code에 직접 연결할 수 있습니다.

MCP는 Claude Code가 외부 시스템과 대화할 수 있게 해주는 연결 프로토콜입니다. 예를 들어 PostgreSQL MCP를 연결하면 "users 테이블에서 최근 가입자 10명 보여줘"라고 하면 Claude가 직접 데이터베이스를 조회해 결과를 보여줍니다.

MCP 서버 추가 방법

명령어 형식claude mcp add [서버이름] [실행경로] [옵션들]

자주 사용되는 MCP 연동 예시

PostgreSQL 데이터베이스

MCP 추가claude mcp add postgres-server /path/to/postgres-mcp-server \
--connection-string "postgresql://user:pass@localhost:5432/mydb"

# 연결 후 이렇게 사용
> users 테이블 구조를 설명해줘
> 오늘 가입한 사용자 목록 보여줘

GitHub

> 현재 열린 이슈 목록 보여줘
> 이슈 #42를 해결하는 코드를 작성하고 PR 만들어줘

MCP 설정 저장 위치

MCP 서버 설정은 프로젝트 폴더의 .claude/settings.local.json 파일에 자동으로 저장됩니다. 이 파일을 Git에 올리면 팀원들과 설정을 공유할 수 있습니다. 단, 비밀번호나 API 키가 포함된 경우 .gitignore에 추가하세요.

11. 실전 활용 시나리오 5가지

실제로 Claude Code를 어떻게 활용할 수 있는지 구체적인 시나리오로 살펴봅니다.

시나리오 1 — 기존 코드 분석 & 문서화

다른 사람이 짠 코드, 오래된 레거시 코드를 빠르게 파악해야 할 때 매우 유용합니다.

활용 예시 > 이 프로젝트 전체를 분석하고 README.md를 작성해줘

> payment.js 파일의 모든 함수에 JSDoc 주석을 추가해줘

> 이 코드가 어떤 흐름으로 동작하는지 다이어그램으로 설명해줘

기존 프로젝트 열기

→

claude 실행

→

"전체 구조 설명해줘"

→

README 자동 생성

시나리오 2 — 버그 수정 & 디버깅

에러 메시지를 그대로 붙여넣으면 됩니다. 원인 분석부터 수정까지 한 번에 처리합니다.

활용 예시 > 아래 에러가 발생해. 원인 찾아서 고쳐줘:
FATAL ERROR: CALL_AND_RETRY_LAST Allocation failed - JavaScript heap out of memory

> 로그인은 되는데 로그아웃 후 다시 로그인하면 이전 사용자 정보가 남아있어. 고쳐줘

시나리오 3 — 새 기능 개발

기능 요구사항을 설명하면 기존 코드 스타일에 맞게 구현해줍니다.

활용 예시 > 상품 검색 기능을 추가해줘. 상품명과 카테고리로 검색할 수 있어야 하고 페이지네이션도 있어야 해

> 이메일 인증 기능을 추가해줘. 가입 시 인증 메일을 보내고 24시간 안에 클릭해야 가입이 완료되도록 해줘

/plan 입력

→

기능 요구사항 설명

→

계획 검토 & 승인

→

자동 구현

→

테스트 작성

시나리오 4 — 코드 품질 개선

성능 최적화, 보안 취약점 점검, 코드 정리 등을 한 번에 처리합니다.

활용 예시 > 이 API 엔드포인트들에 SQL 인젝션 취약점이 있는지 검사하고 수정해줘

> 데이터베이스 쿼리가 느린 것 같아. 최적화 방법을 제안하고 적용해줘

> 중복된 코드를 찾아서 공통 함수로 분리해줘

시나리오 5 — 비개발자의 업무 자동화

코딩 경험이 없어도 반복 업무를 자동화하는 스크립트를 만들 수 있습니다.

활용 예시 > 엑셀 파일에서 A열 이름, B열 이메일을 읽어서 개인화된 이메일 본문을 C열에 자동으로 채워주는 Python 스크립트 만들어줘

> 특정 폴더의 이미지 파일들을 날짜별 폴더로 자동 분류하는 스크립트 만들어줘

> 매일 오전 9시에 날씨를 가져와서 슬랙으로 알려주는 봇 만들어줘

실제 생산성 효과 (2026년 데이터 기준)

Anthropic 자체 코드의 90%가 Claude Code로 작성됨
공개 GitHub 커밋의 4% (일 약 13만 건)가 Claude Code 작성
일반적으로 1주일 걸리는 작업을 하루 안에 완성
반복 코딩, 문서 작성, 테스트 작성 시간 80% 단축

12. 권한 & 보안 설정

Claude Code가 어떤 작업을 할 수 있는지 직접 제어할 수 있습니다.

권한 확인 방법

명령어> /allowed-tools
# 현재 허용된 도구 목록이 표시됩니다

settings.json으로 세밀한 권한 설정

프로젝트 폴더에 .claude/settings.json 파일을 만들어 허용/차단 목록을 설정할 수 있습니다.

.claude/settings.json {
  "permissions": {
    "allow": [
      "Bash(npm run lint)",  // lint만 허용
      "Bash(npm run test:*)", // 테스트 관련 명령 허용
      "Read(~/.zshrc)"      // 특정 파일 읽기 허용
    ],
    "deny": [
      "Bash(curl *)",       // 외부 요청 차단
      "Bash(rm -rf *)"     // 강제 삭제 차단
    ]
  }
}

.claudeignore — 특정 파일 제외

.gitignore처럼 Claude Code가 읽지 않았으면 하는 파일을 지정할 수 있습니다.

.claudeignore # 환경 변수 파일 제외
.env
.env.local
.env.production

# 비밀 키 파일
secrets/
*.pem
*.key

# 빌드 결과물 (불필요한 토큰 소모 방지)
node_modules/
dist/
build/

보안 필수 체크

.env 파일을 반드시 .claudeignore에 추가하세요
AWS 키, DB 비밀번호 등이 포함된 파일은 접근 차단
공용 컴퓨터에서 작업 후 claude auth logout으로 로그아웃
Git 저장소에 .claude/settings.local.json 올리지 않기 (개인 설정 포함)

13. 고급 활용 — 커스텀 명령어

자주 쓰는 작업을 단축 명령어로 저장해두면 생산성을 크게 높일 수 있습니다.

프로젝트 공용 커스텀 명령어

팀 전원이 사용할 수 있는 명령어를 .claude/commands/ 폴더에 마크다운 파일로 만듭니다.

commands 폴더 생성

mkdir -p .claude/commands

명령어 파일 생성 예시 — 코드 리뷰

# .claude/commands/review.md
이 코드를 다음 기준으로 리뷰해줘:
1. 보안 취약점 (SQL 인젝션, XSS 등)
2. 성능 문제 (불필요한 루프, 메모리 낭비)
3. 코딩 컨벤션 준수 여부
4. 테스트 커버리지 누락 부분
5. 개선 제안 3가지

사용 방법

> /review payment.js
# /명령어이름 으로 바로 실행됩니다

유용한 커스텀 명령어 모음

파일명	용도	호출 방법
optimize.md	성능 분석 및 최적화 3가지 제안	/optimize
test.md	선택한 파일의 유닛 테스트 자동 생성	/test
document.md	함수/클래스에 JSDoc 주석 자동 추가	/document
fix-issue.md	GitHub 이슈 번호를 받아 자동 수정	/fix-issue 42
security.md	보안 취약점 전체 점검	/security
translate.md	코드 내 한국어 주석을 영어로 변환	/translate

개인 전용 커스텀 명령어

특정 프로젝트가 아닌 모든 프로젝트에서 쓸 수 있는 개인 명령어는 홈 폴더에 저장합니다.

터미널# 개인 명령어 폴더 생성
mkdir -p ~/.claude/commands

# 예: 모든 프로젝트에서 /standup 명령으로
# 오늘 변경된 파일 요약 보고서 생성
echo "오늘 변경된 파일들을 분석하고 스탠드업 미팅용 요약을 작성해줘" > ~/.claude/commands/standup.md

14. 자주 묻는 질문 (FAQ)

코딩을 전혀 모르는데 Claude Code를 쓸 수 있나요?

가능합니다. "엑셀 파일을 자동으로 정리하는 프로그램 만들어줘", "매일 뉴스를 요약해서 이메일로 보내줘"처럼 원하는 것을 말하면 Claude가 코드를 작성하고 실행 방법까지 안내해줍니다. 다만 Claude가 요청하는 승인(Y/N)이 무엇인지 이해하고 진행하는 것이 중요합니다.

내 코드가 Anthropic 서버로 전송되나요?

네, Claude Code가 코드를 분석하기 위해 서버로 전송됩니다. Anthropic의 개인정보 처리방침에 따라 처리됩니다. 민감한 정보(API 키, 비밀번호, 개인정보가 포함된 파일)는 .claudeignore에 추가해 전송되지 않도록 설정하세요.

Claude Code가 내 파일을 실수로 삭제할 수 있나요?

기본 모드에서는 모든 작업에 승인을 요청하기 때문에 원치 않는 작업이 진행되지 않습니다. 추가로 settings.json에서 위험한 명령어(rm -rf 등)를 deny 목록에 추가하면 더욱 안전합니다. 중요한 작업 전 Git 커밋을 습관화하는 것도 좋습니다.

인터넷 연결이 없으면 사용할 수 없나요?

네, Claude Code는 Anthropic API를 통해 동작하므로 인터넷 연결이 필수입니다. 오프라인 환경에서는 사용할 수 없습니다.

Pro 플랜 사용량 한도에 걸리면 어떻게 되나요?

한도에 도달하면 해당 주의 남은 기간 동안 Claude Code 사용이 제한됩니다. 한도 초과 시 API 종량제로 계속 사용하거나, Max 플랜으로 업그레이드할 수 있습니다. 한도는 매주 초기화됩니다.

어떤 프로그래밍 언어를 지원하나요?

Python, JavaScript, TypeScript, Java, C++, Go, Rust, PHP, Ruby, Swift 등 거의 모든 주요 언어를 지원합니다. 특정 언어에 대한 제한은 없으며, 덜 알려진 언어라도 충분히 도움을 받을 수 있습니다.

Cursor나 GitHub Copilot과 어떻게 다른가요?

Cursor와 GitHub Copilot은 주로 에디터 안에서 코드 자동완성에 초점을 맞춥니다. Claude Code는 터미널에서 실행되며 프로젝트 전체를 이해하고 자율적으로 파일을 만들고 명령어를 실행하는 에이전트에 가깝습니다. 두 가지를 함께 사용하는 것도 가능하며, 2026년 기준 Cursor + Claude Code 조합이 많이 사용됩니다.

대화가 길어지면 앞 내용을 기억 못 하나요?

네, 대화 컨텍스트가 길어지면 초반 내용을 잊을 수 있습니다. /clear 명령어로 컨텍스트를 초기화하고 새로 시작하거나, CLAUDE.md에 핵심 정보를 저장해두면 이 문제를 해결할 수 있습니다. 긴 작업은 여러 세션으로 나눠서 진행하는 것을 권장합니다.

지금 바로 시작하세요

Pro 구독 후 터미널 명령어 한 줄로 설치, 5분이면 첫 작업을 시작할 수 있습니다.

claude.ai 구독 시작 공식 빠른 시작 가이드