Q. 클로드 코드 사용법, 설치부터 어떻게 시작하나요?
A. 클로드 코드는 터미널에 명령어 한 줄로 설치하고, claude를 실행해 Claude 계정으로 로그인하면 바로 쓸 수 있습니다. 설치 후에는 스킬(SKILL.md)을 추가해 반복 업무 자동화까지 확장할 수 있고, 스킬 사이트와 플러그인 마켓플레이스에서 만들어 둔 스킬을 가져와 쓸 수도 있습니다.
이 글은 클로드 코드 공식 문서와 Claude 고객센터 기준으로 정리했습니다. 설치법, 기본 사용법, 스킬 사이트, 업무 자동화 순서로 따라 하면 됩니다.
✅ 핵심만 정리
✔ 설치: macOS·Linux·WSL은 curl -fsSL https://claude.ai/install.sh | bash, Windows PowerShell은 irm https://claude.ai/install.ps1 | iex
✔ 계정: Claude Pro·Max·Team·Enterprise 또는 Console 계정이 필요하고, 무료 플랜은 포함되지 않음
✔ 스킬: SKILL.md 파일 하나가 스킬이며, ~/.claude/skills/ 폴더에 두면 모든 프로젝트에서 사용
✔ 스킬 사이트: Anthropic 공식 마켓플레이스와 anthropics/skills 저장소를 먼저 보고, 커뮤니티 디렉터리는 보조로 활용
✔ 업무 자동화: /loop, 데스크톱·클라우드 예약 작업, claude -p 명령으로 반복 작업을 자동 실행
👉 처음이라면 설치 → 로그인 → 질문 한 번 해보기 → 스킬 하나 설치 순서가 가장 빠릅니다.
1. 클로드 코드는 무엇이고, 누가 쓸 수 있나요?
클로드 코드는 터미널에서 Claude에게 작업을 맡기는 도구입니다. 프로젝트 파일을 필요에 따라 직접 읽기 때문에 컨텍스트를 일일이 붙여넣을 필요가 없습니다. 터미널 외에도 웹, 데스크톱 앱, VS Code·JetBrains, Slack, GitHub Actions 등에서 쓸 수 있습니다.
⭐ 클로드 코드 로그인 가능한 계정
| 계정 유형 | 설명 |
| Claude Pro·Max·Team·Enterprise | 공식 문서가 권장하는 방식. 구독 계정으로 로그인 |
| Claude Console | 선불 크레딧을 쓰는 API 방식 |
| 클라우드 제공업체 | Amazon Bedrock, Google Cloud, Microsoft Foundry 경유 |
| 무료 Claude.ai 플랜 | 클로드 코드 미포함 |
Claude와 클로드 코드는 같은 사용 한도를 공유합니다. 환경 변수 ANTHROPIC_API_KEY가 설정돼 있으면 구독 대신 API 키가 우선 쓰여 API 요금이 청구될 수 있으니 확인하세요.
출처: 빠른 시작 · 고급 설정 · Pro·Max 플랜 안내
2. 클로드 코드 설치법은 어떻게 되나요?
1️⃣1단계. 시스템 요구사항 확인
⭐ 설치 전 확인할 요구사항
| 항목 | 요구사항 |
| 운영체제 | macOS 13.0 이상, Windows 10 1809 이상, Ubuntu 20.04 이상, Debian 10 이상, Alpine Linux 3.19 이상 |
| 메모리·CPU | 4GB 이상 RAM, x64 또는 ARM64 |
| 네트워크 | 인터넷 연결 필수 |
| 셸 | Bash, Zsh, PowerShell, CMD |
| 지역 | Anthropic 지원 국가 |
2️⃣2단계. 운영체제에 맞는 명령어 실행
✨macOS, Linux, WSL :
|
bash
|
✨Windows PowerShell :
|
|
batch
|
🎈PowerShell과 CMD는 명령어가 다릅니다. The token '&&' is not a valid statement separator 오류가 나면 CMD용 명령을 PowerShell에서 실행한 것이고, 'irm' is not recognized 오류가 나면 PowerShell용 명령을 CMD에서 실행한 것입니다.
3️⃣3단계. 설치 확인
설치가 끝나면 새 터미널 창을 열고 아래 명령을 실행합니다. 버전 번호가 나오면 성공입니다.
bash
|
설정 상태까지 자세히 보려면 claude doctor를 실행합니다.
⭐ 설치 방식별 특징
| 방식 | 명령어 | 자동 업데이트 |
| 기본 설치(권장) | 위의 curl·irm 명령 | 백그라운드 자동 업데이트 |
| Homebrew(macOS) | brew install --cask claude-code |
수동 (brew upgrade claude-code) |
| WinGet(Windows) | winget install Anthropic.ClaudeCode |
수동 (winget upgrade Anthropic.ClaudeCode) |
| npm(Node.js 18 이상) | npm install -g @anthropic-ai/claude-code |
수동 |
npm으로 설치할 때는 sudo를 쓰지 않는 것이 공식 권고입니다. 네이티브 Windows에서는 Git for Windows를 함께 설치하면 Bash 도구를 쓸 수 있고, 없으면 PowerShell을 대신 사용합니다. 명령어 실행 후 claude를 찾을 수 없다고 나오면 설치 폴더가 PATH에 없는 경우이므로 공식 설치 문제 해결 문서를 참고하세요.
3. 설치 후 클로드 코드 사용법은 어떻게 되나요?
1️⃣1단계. 작업할 폴더에서 실행
|
bash
|
처음 실행하면 로그인을 요청합니다. 안내에 따라 브라우저에서 인증하면 자격 증명이 저장되어 다시 로그인할 필요가 없습니다. 나중에 계정을 바꾸려면 세션 안에서 /login을 입력합니다.
2️⃣2단계. 자연어로 질문하기
공식 빠른 시작 가이드는 프로젝트가 무엇인지 묻는 것부터 시작하라고 안내합니다. 대화하듯 목표를 설명하면 됩니다.
text what does this project do? |
3️⃣3단계. 변경 승인하기
Claude가 파일을 수정하기 전에 확인을 요청하면 Yes를 선택해 승인합니다. 세션의 권한 모드가 Claude가 먼저 묻지 않고 할 수 있는 작업 범위를 정하며, Shift+Tab으로 모드를 바꿀 수 있습니다.
⭐ 자주 쓰는 셸 명령
| 명령 | 기능 |
claude |
대화형 모드 시작 |
claude "task" |
초기 프롬프트와 함께 시작 |
claude -p "query" |
일회성 쿼리 실행 후 종료 |
claude -c |
현재 폴더의 가장 최근 대화 이어가기 |
claude -r |
이전 대화 재개 |
⭐ 세션 안에서 쓰는 명령
| 명령 | 기능 |
/help |
사용 가능한 명령 보기 |
/clear |
대화 기록 지우기 |
/resume |
이전 대화 이어가기 |
/exit |
종료 |
✨요청은 구체적일수록 결과가 좋습니다. 공식 가이드는 "버그 수정" 대신 "잘못된 자격 증명을 입력한 뒤 빈 화면이 나오는 로그인 버그 수정"처럼 쓰라고 예시를 듭니다. 복잡한 작업은 번호를 붙여 단계로 나눠 요청하는 방식도 권장합니다.
출처: 빠른 시작
4. 클로드 코드 스킬은 무엇이고 어떻게 만드나요?
스킬은 반복해서 붙여넣던 지시문이나 체크리스트, 여러 단계 절차를 파일 하나로 저장해 두는 기능입니다. SKILL.md 파일을 만들면 Claude가 관련 요청에서 자동으로 불러 쓰거나, /스킬이름으로 직접 호출할 수 있습니다. 본문은 사용할 때만 불러오기 때문에 긴 참고 자료를 넣어도 평소 부담이 거의 없습니다.
1️⃣1단계. 스킬 폴더 만들기
개인용 스킬은 ~/.claude/skills/스킬이름/SKILL.md 위치에 둡니다.
2️⃣2단계. SKILL.md 작성하기
파일은 맨 위의 YAML 설정(--- 사이)과 그 아래 지시문 두 부분으로 구성됩니다. 모든 항목이 선택이지만 description은 권장됩니다. Claude가 이 설명을 보고 언제 스킬을 쓸지 판단하기 때문입니다.
|
yaml
|
3️⃣3단계. 호출하기
/스킬이름을 직접 입력하거나, 설명과 맞는 요청을 하면 Claude가 자동으로 불러옵니다. 자동 호출을 막고 싶으면 disable-model-invocation: true를 설정합니다.
⭐ 스킬 저장 위치
| 위치 | 경로 | 적용 범위 |
| 개인 | ~/.claude/skills/<스킬이름>/SKILL.md |
내 컴퓨터의 모든 프로젝트 |
| 프로젝트 | .claude/skills/<스킬이름>/SKILL.md |
해당 저장소 (공유 가능) |
| 플러그인 | <플러그인>/skills/<스킬이름>/SKILL.md |
플러그인이 켜진 곳 |
이름이 겹치면 엔터프라이즈 설정이 개인 스킬보다, 개인 스킬이 프로젝트 스킬보다 우선합니다. 플러그인 스킬은 /플러그인이름:스킬이름 형태로 구분됩니다. 스킬이 기대대로 작동하지 않으면 description에 사용자가 실제로 쓸 법한 단어를 넣고, /스킬이름으로 직접 호출해 확인해 보세요.
출처: Skills 문서
5. 클로드 코드 스킬 사이트는 어디서 찾나요?
스킬을 직접 만들지 않아도 이미 공개된 스킬을 가져다 쓸 수 있습니다. 가져오는 통로는 크게 공식 마켓플레이스, Anthropic 공개 저장소, 커뮤니티 디렉터리로 나뉩니다.
⭐ 스킬·플러그인을 찾을 수 있는 곳
| 구분 | 이름 | 특징 |
| 공식 | claude-plugins-official |
첫 터미널 실행 때 자동 등록. Anthropic이 관리하는 플러그인과 파트너·외부 제작자 플러그인 포함 |
| 공식 | Claude Marketplace(claude.com/marketplace) | 웹에서 전체 목록 검색. 설치 수 표시, 일부는 Anthropic verified 표시 |
| 공식 | anthropics/skills 저장소 |
Anthropic의 예시 스킬 모음. 문서(docx·pdf·pptx·xlsx) 스킬 포함 |
| 공식 | claude-community |
제3자가 Anthropic에 제출한 플러그인 |
| 비공식 | claudemarketplaces.com | Anthropic과 무관한 무료 커뮤니티 디렉터리. 스킬·플러그인·MCP 서버를 설치 수와 GitHub 스타 기준으로 정렬 |
1️⃣1단계. 공식 마켓플레이스에서 플러그인 설치하기
Claude Code 세션에서 /plugin을 입력하면 Discover 탭에서 플러그인을 검색할 수 있습니다. 이름을 알고 있다면 아래처럼 설치합니다.
|
text
|
🎈설치할 때는 사용 범위(나만, 저장소 전체, 이 저장소만 나)를 고르고, 설치 후 /를 입력해 목록에 나타나는지 확인합니다.
2️⃣2단계. Anthropic 예시 스킬 저장소 추가하기
|
text
|
🎈이 저장소의 document 스킬(docx, pdf, pptx, xlsx)은 오픈소스가 아니라 소스 공개(source-available) 라이선스이고, 저장소는 시연·교육 목적이라고 안내합니다. 업무에 쓰기 전에 직접 테스트하세요.
3️⃣3단계. 외부 마켓플레이스 추가하기
|
text
|
⚠️ 플러그인은 훅과 MCP 서버를 포함해 내 컴퓨터에서 실행될 수 있습니다. Anthropic은 제3자 마켓플레이스를 검수하지 않으므로, 설치 전 구성 요소를 확인하고 출처를 알 수 없는 스킬은 설치하지 않는 편이 안전합니다.
출처: 플러그인 설치 · Anthropic 마켓플레이스 · anthropics/skills · 커뮤니티 디렉터리
6. 클로드 코드로 업무 자동화는 어떻게 하나요?
반복 업무를 자동으로 돌리는 방법은 네 가지입니다. 업무가 책상 앞에서 끝나는지, 컴퓨터를 꺼 둬도 돌아야 하는
지에 따라 고릅니다.
⭐ 업무 자동화 방식 비교
| 방식 | 실행 위치 | 컴퓨터 켜짐 필요 | 로컬 파일 접근 | 최소 간격 |
/loop |
내 컴퓨터 | 필요 (세션 열려 있어야 함) | 가능 | 1분 |
| 데스크톱 예약 작업 | 내 컴퓨터 | 필요 | 가능 | 1분 (설정 화면 1시간) |
| 클라우드 예약 작업 | Anthropic 클라우드 | 불필요 | 불가 (새로 clone) | 1시간 |
claude -p + 스크립트 |
내 컴퓨터·CI | 스크립트 실행 시 | 가능 | 직접 설정 |
1️⃣1단계. /loop로 반복 실행하기
세션이 열려 있는 동안 같은 프롬프트를 일정 간격으로 실행합니다. 간격은 s·m·h·d 단위로 씁니다.
text
|
고정 간격 반복은 Claude에게 취소를 요청해야 멈춥니다. 반복 작업은 만든 지 7일이 지나면 자동으로 사라지므로 오래 돌릴 업무에는 맞지 않습니다.
2️⃣2단계. 일회성 알림 걸기
자연어로 말하면 한 번만 실행되고 사라지는 작업이 만들어집니다.
|
3️⃣3단계. 컴퓨터를 꺼 둬도 돌려야 한다면
클라우드 예약 작업을 쓰면 컴퓨터가 꺼져 있어도 실행됩니다. 로컬 파일이 필요하면 데스크톱 예약 작업을 선택합니다. 스킬을 만들어 두었다면 /loop 20m /스킬이름처럼 스킬을 프롬프트로 넣어 반복 실행할 수도 있습니다.
4️⃣4단계. 스크립트에 연결하기
claude -p는 대화창 없이 한 번 실행하고 종료합니다. 파이프로 데이터를 넘기고 결과를 파일로 저장할 수 있습니다.
bash
|
--output-format json 옵션을 붙이면 결과를 구조화된 JSON으로 받을 수 있고, --allowedTools로 허용할 도구를 미리 정해 승인 질문 없이 실행할 수 있습니다. 파일 수정이나 명령 실행 권한을 한꺼번에 열면 의도하지 않은 변경이 생길 수 있으니 필요한 도구만 허용하세요.
출처: 스케줄 실행 · 프로그래매틱 실행 · Skills 문서
7. 처음 쓸 때 놓치기 쉬운 점은 무엇인가요?
⭐ 막히기 쉬운 상황과 해결
| 상황 | 원인 | 해결 |
설치 후 claude를 찾을 수 없음 |
설치 폴더가 PATH에 없음 | 새 터미널을 열고 claude --version 확인, 안 되면 공식 PATH 수정 안내 참고 |
| 로그인 후에도 API 요금이 청구됨 | ANTHROPIC_API_KEY 환경 변수 우선 적용 |
환경 변수 확인 후 /login으로 구독 계정 전환 |
| 스킬이 자동으로 실행되지 않음 | description이 요청과 맞지 않음 |
설명에 실제 사용 표현 추가, /스킬이름으로 직접 호출 |
| 반복 작업이 일주일 뒤 멈춤 | /loop 반복 작업의 7일 만료 |
클라우드·데스크톱 예약 작업으로 전환 |
| 터미널이 낯설어 막막함 | 터미널을 처음 사용 | 공식 터미널 가이드부터 읽기 |
출처: 빠른 시작 · Skills 문서 · 스케줄 실행 · Pro·Max 플랜 안내
⁉️ 자주 묻는 질문
Q1. 클로드 코드는 무료로 쓸 수 있나요?
무료 Claude.ai 플랜에는 포함되지 않습니다. Pro, Max, Team, Enterprise 구독이나 Console 계정이 필요합니다.
Q2. 개발자가 아니어도 클로드 코드를 쓸 수 있나요?
설치와 로그인은 터미널 명령 몇 줄이면 되고, 공식 문서에 터미널 처음 사용자를 위한 가이드가 따로 있습니다. 요청은 자연어로 하기 때문에 코드를 직접 짜지 않아도 파일 정리나 문서 작업을 맡길 수 있습니다.
Q3. 스킬은 어디에 저장하나요?
내 컴퓨터 전체에서 쓰려면 ~/.claude/skills/스킬이름/SKILL.md, 특정 저장소에서만 쓰려면 .claude/skills/스킬이름/SKILL.md에 저장합니다.
Q4. 스킬 사이트에서 받은 스킬은 안전한가요?
Anthropic은 제3자 마켓플레이스를 검수하지 않습니다. 플러그인은 훅과 MCP 서버를 포함할 수 있으므로 설치 전 구성 요소를 확인하고 출처가 불분명한 스킬은 피하세요.
Q5. 컴퓨터를 꺼도 업무 자동화가 돌아가나요?
/loop와 데스크톱 예약 작업은 컴퓨터가 켜져 있어야 합니다. 클라우드 예약 작업은 컴퓨터가 꺼져 있어도 실행되지만 로컬 파일에는 접근하지 못합니다.
🔑 정리하면
1. 클로드 코드 설치법은 OS별 명령어 한 줄이며, claude --version으로 확인합니다.
2. 사용법의 시작은 프로젝트 폴더에서 claude를 실행하고 자연어로 요청하는 것입니다.
3. 스킬은 SKILL.md 하나로 만들 수 있고, 공식 마켓플레이스와 anthropics/skills에서 가져올 수도 있습니다.
4. 업무 자동화는 /loop, 예약 작업, claude -p 중 컴퓨터 켜짐 여부와 로컬 파일 필요 여부로 고릅니다.
| 📚 함께 읽으면 좋은 글 |
| 애플 대학생 할인, 지금 사도 될까? 맥북 교육가·UNiDAYS 인증·에어팟 증정 시기 |
| 카피킬러 표절률 기준|몇 %면 안전할까 |
| 2027 AFPK 시험 일정 확정|접수 2월 22일부터, 시험 시간·합격률·난이도까지 |
사유선택
허위 신고의 경우 서비스 이용제한과 같은 불이익을 받으실 수 있습니다.

ㄴ롷ㅅㄱ
오 정리 세세하다
사유선택
허위 신고의 경우 서비스 이용제한과 같은 불이익을 받으실 수 있습니다.
RORHFDL
명령어 코드는 안 써봤는데 감사합니다
사유선택
허위 신고의 경우 서비스 이용제한과 같은 불이익을 받으실 수 있습니다.
로코쿵
스킬 이대로해봐야징
사유선택
허위 신고의 경우 서비스 이용제한과 같은 불이익을 받으실 수 있습니다.
ㅇㄴㄹㄴㅇㄹㄴ
어렵네요 역시..
사유선택
허위 신고의 경우 서비스 이용제한과 같은 불이익을 받으실 수 있습니다.