Claude Code AI 에이전트란? Subagent·Skills·MCP·Hooks 사용법 10가지
Claude Code를 처음 접하면 가장 헷갈리는 것이 있습니다.
AI 에이전트, Subagent, Skills, MCP, Hooks가 도대체 뭐가 다른지입니다.
검색해보면 각각의 기능을 설명하는 글은 많은데, 실제로 Claude Code에서 어떤 역할을 하고 언제 사용해야 하는지 초보자 입장에서 한 번에 이해하기는 쉽지 않습니다.
결론부터 말하면 Claude Code는 단순히 질문하면 코드를 만들어주는 챗봇에서 한 단계 더 나아간 에이전틱 코딩 도구라고 이해하면 쉽습니다.
코드를 읽는 것뿐만 아니라 파일을 수정하고, 명령을 실행하고, 테스트하고, 오류를 다시 수정하거나 Git 작업까지 연결할 수 있습니다.
일반 AI 챗봇 → "이 코드를 이렇게 수정하세요"라고 알려줌
Claude Code → 코드를 찾고 → 수정하고 → 테스트하고 → 오류를 확인하고 → 다시 수정함
여기에 Subagent + Skills + MCP + Hooks를 추가하면
혼자 일하는 AI → 여러 역할을 가진 AI 개발팀처럼 확장할 수 있습니다.
Claude Code AI 에이전트란?
AI 에이전트라는 단어부터 어렵게 생각할 필요는 없습니다.
쉽게 말하면 단순히 질문에 답하는 것이 아니라 목표를 받고 필요한 작업을 스스로 나눠 수행하는 AI입니다.
예를 들어 일반적인 AI에게 이렇게 물어볼 수 있습니다.
회원가입 페이지에서
비밀번호 유효성 검사가 안 되는데
어디를 고쳐야 할까?일반 챗봇이라면 코드를 보여달라고 하거나 수정 방법을 설명해주는 형태가 일반적입니다.
Claude Code에서는 프로젝트에 접근할 수 있는 환경이라면 다음과 같은 작업 흐름을 만들 수 있습니다.
프로젝트 구조 확인
↓
회원가입 관련 파일 검색
↓
JSP / Java / JavaScript 분석
↓
오류 원인 확인
↓
코드 수정
↓
테스트 실행
↓
실패하면 다시 수정
↓
변경사항 검토즉 답을 알려주는 AI에서 실제로 작업을 수행하는 AI로 달라진다고 보면 됩니다.
AI Agent와 Skills, MCP는 같은 기능이 아닙니다
여기서 가장 먼저 구분해야 할 부분입니다.
Agent, Skill, MCP, Hook은 모두 서로 다른 역할을 합니다.
| 기능 | 쉽게 표현하면 | 주요 역할 |
|---|---|---|
| Agent | AI 작업자 | 목표를 받고 판단·작업 수행 |
| Subagent | 전문 담당자 | 테스트·보안·DB 등 특정 업무 분담 |
| Skills | 업무 매뉴얼 | 반복 작업방법과 전문지식 제공 |
| MCP | 외부 연결 포트 | GitHub·DB·Slack·Jira 등과 연결 |
| Hooks | 자동 실행 규칙 | 특정 조건에서 명령·검사 자동 실행 |
| CLAUDE.md | 프로젝트 규칙집 | 코딩 규칙·환경·금지사항 제공 |
이 차이를 먼저 이해하면 이후 기능이 훨씬 쉽게 보입니다.
1. Subagent - Claude Code 안에 전문 AI 개발자 만들기
Claude Code에서 가장 이해하기 쉬우면서 활용도가 높은 개념 중 하나가 Subagent입니다.
하나의 AI에게 모든 일을 몰아주는 것이 아니라 역할별로 작업을 나누는 방식입니다.
Claude Code
│
├─ Architect Agent
├─ Java Developer Agent
├─ JSP Developer Agent
├─ SQL Developer Agent
├─ UI Agent
├─ Security Agent
├─ Test Agent
└─ Code Review Agent각 역할이 자신에게 필요한 문제를 분석하고 결과를 메인 에이전트에 전달하는 구조로 생각하면 됩니다.
Subagent를 쓰면 무엇이 좋아질까?
예를 들어 하나의 AI에게 아래처럼 요청한다고 생각해보겠습니다.
회원가입 기능 만들어줘.아주 단순한 프로젝트라면 괜찮습니다.
하지만 실제 서비스에서는 회원가입 하나에도 여러 작업이 얽힙니다.
회원가입
↓
DB 테이블 확인
↓
Java 비즈니스 로직
↓
JSP 화면
↓
JavaScript 검증
↓
비밀번호 보안
↓
중복 이메일 검사
↓
테스트이럴 때 역할을 분리하면 다음과 같이 접근할 수 있습니다.
사용자
"회원가입 기능 만들어줘"
↓
Main Claude Agent
↓
Architect Agent
├─ JSP/UI Agent
├─ Java Agent
├─ Database Agent
├─ Security Agent
└─ Test Agent
↓
결과 취합
↓
최종 수정 및 검증실제로 이렇게 요청할 수 있습니다
회원가입 기능을 검토해줘.
먼저 전체 구조를 분석한 뒤 역할을 나눠서 확인해줘.
1. Architect Agent
- 회원가입 데이터 흐름 확인
2. Java Agent
- 서버 로직과 예외 처리 확인
3. Database Agent
- 중복 이메일과 SQL 확인
4. Security Agent
- 비밀번호 처리와 취약점 확인
5. Test Agent
- 정상 가입과 오류 케이스 테스트
각 작업 결과를 취합한 뒤
필요한 코드만 최소한으로 수정해줘.특히 혼자 개발하거나 유지보수를 담당하는 경우 1인 개발자 + 여러 AI 담당자 구조를 만들 수 있다는 점이 장점입니다.
2. Skills - Claude에게 반복 업무 방법 가르치기
Skills는 AI 에이전트 그 자체가 아닙니다.
오히려 특정 작업을 어떻게 해야 하는지 정리해놓은 재사용 가능한 업무 매뉴얼에 가깝습니다.
예를 들어 회사에서 오래된 JSP·Java 시스템을 관리한다고 생각해보겠습니다.
Claude에게 매번
JDK 1.6 사용해야 하고
Java 7 문법 쓰면 안 되고
MySQL 5.5 사용하고
Servlet 새로 만들지 말고
기존 JSP 구조 유지해줘.라고 설명한다면 상당히 번거롭습니다.
이런 반복되는 작업 규칙을 Skill로 만들어 재사용할 수 있습니다.
.claude/
└── skills/
├── jsp-development/
│ └── SKILL.md
│
├── mysql-development/
│ └── SKILL.md
│
├── legacy-java/
│ └── SKILL.md
│
├── security-review/
│ └── SKILL.md
│
└── deploy/
└── SKILL.mdSkill은 이런 작업에서 효과적입니다
| 작업 | Skill 예시 |
|---|---|
| 웹 UI 제작 | frontend-design |
| 웹앱 동작 확인 | webapp-testing |
| React·Next.js 개발 | React 성능 가이드 Skill |
| PostgreSQL·Supabase | DB Best Practice Skill |
| 보안검사 | static-analysis |
| 업무 자동화 | n8n 관련 Skill |
| 맞춤 업무 | 직접 작성한 SKILL.md |
Agent와 Skill 차이
Agent = 일을 하는 사람
Skill = 그 사람이 참고하는 업무 매뉴얼
예를 들어 Security Agent가 직원이라면
security-review Skill은 보안검사 매뉴얼이라고 생각하면 쉽습니다.
3. MCP - Claude Code를 외부 서비스와 연결하기
MCP(Model Context Protocol)는 Claude Code 활용도를 크게 높여주는 기능입니다.
AI가 프로젝트 내부 파일만 보는 것이 아니라 외부 서비스와 도구에 접근할 수 있도록 연결해주는 표준이라고 이해하면 쉽습니다.
Claude Code
│
├─ GitHub
├─ Jira
├─ Slack
├─ Database
├─ Figma
├─ 사내 API
├─ 문서 시스템
└─ MonitoringMCP가 없을 때
예를 들어 Jira에 등록된 버그를 수정해야 한다고 생각해보겠습니다.
사람이 직접 Jira를 열어 내용을 복사한 뒤 Claude에게 전달해야 합니다.
MCP로 연결했을 때
연결된 환경이라면 작업 흐름을 훨씬 길게 이어갈 수 있습니다.
오늘 Jira에 등록된 로그인 관련 버그를 확인해줘.
관련 JSP와 Java 파일을 찾아서
오류 원인을 분석해.
수정이 필요하면 코드를 수정하고
테스트를 실행한 뒤
변경사항을 정리해줘.MCP는 쉽게 말하면 AI가 회사 내부 도구와 연결되는 통로입니다.
MCP와 API는 뭐가 다른가?
API는 특정 서비스의 기능을 프로그램에서 호출하기 위한 인터페이스입니다.
MCP는 AI 애플리케이션이 여러 도구와 데이터를 보다 일정한 구조로 사용할 수 있도록 연결하는 프로토콜에 가깝습니다.
따라서 MCP 서버 안에서 API를 사용하는 구조도 가능합니다.
4. Hooks - 특정 작업이 발생하면 자동으로 검사하기
Hooks는 Claude Code를 좀 더 자동화하고 안전하게 사용하는 기능입니다.
특정 이벤트가 발생했을 때 정해진 명령이나 검사를 자동으로 실행하는 구조라고 생각하면 됩니다.
예를 들어 Java 파일을 수정했다면
Java 파일 수정
↓
Hook 실행
↓
컴파일
↓
테스트
↓
성공 → 다음 작업
실패 → 오류 전달 후 수정사람이 매번 "컴파일해봐", "테스트해봐"라고 말하지 않아도 자동 검증 구조를 만들 수 있습니다.
위험한 명령을 막는 용도로도 사용할 수 있습니다
Claude
↓
위험한 Shell 명령 실행 시도
↓
PreToolUse Hook
↓
규칙 확인
↓
차단Hooks는 실제 셸 명령 실행과 연결될 수 있기 때문에 편리한 만큼 보안 설정이 중요합니다.
특히 운영 서버, 삭제 명령, 데이터베이스 수정처럼 복구하기 어려운 작업은 자동 승인보다 별도 권한 확인을 두는 것이 좋습니다.
5. CLAUDE.md - 프로젝트의 헌법 만들기
제가 초보자라면 Subagent나 MCP보다 먼저 설정할 기능 중 하나가 CLAUDE.md입니다.
CLAUDE.md에는 Claude Code가 해당 프로젝트에서 계속 지켜야 할 규칙을 적어둘 수 있습니다.
쉽게 말하면 프로젝트 업무 인수인계 문서와 비슷합니다.
레거시 Java 프로젝트 CLAUDE.md 예시
# CLAUDE.md
## Project
- 기존 서비스 구조 최대한 유지
- 불필요한 신규 파일 생성 금지
- 필요한 부분만 최소 수정
## Java
- JDK 1.6 호환
- java.time 사용 금지
- Java 7 이상 문법 사용 금지
## JSP
- 기존 JSP 구조 유지
- Servlet 신규 생성 최소화
- 현재 사용 중인 공통 include 우선 사용
## Database
- MySQL 5.5
- 기존 테이블 임의 변경 금지
- DELETE / DROP 실행 전 반드시 확인
## Coding
- UTF-8 사용
- 기존 변수명과 코딩 스타일 유지
- 수정한 파일 목록 마지막에 출력
## Test
- 수정 후 가능한 테스트 실행
- 실패 시 원인부터 설명한 뒤 재수정이렇게 만들어두면 매번 프로젝트 환경을 처음부터 설명할 필요가 줄어듭니다.
CLAUDE.md와 Skills 차이
| 구분 | CLAUDE.md | Skills |
|---|---|---|
| 목적 | 프로젝트 기본규칙 | 특정 작업방법 |
| 예 | JDK 1.6 사용 | 보안검토 방법 |
| 적용 | 프로젝트 전반 | 필요한 작업 |
| 비유 | 회사 규정 | 업무 매뉴얼 |
6. Agent Orchestration - Claude Code로 AI 개발팀 구성
여기부터는 단순히 AI 하나를 사용하는 것보다 AI 개발팀을 구성한다는 개념에 가까워집니다.
PM Agent
│
┌───────────┼───────────┐
↓ ↓ ↓
Architecture Backend Frontend
Agent Agent Agent
│ │ │
└───────────┼───────────┘
↓
Test Agent
↓
Security Agent
↓
Review Agent중요한 것은 에이전트 수를 무조건 많이 만드는 것이 아닙니다.
하나의 에이전트가 충분히 처리할 수 있는 단순한 작업까지 여러 개로 나누면 오히려 작업량과 컨텍스트 사용량만 늘어날 수 있습니다.
· 서로 독립적으로 분석할 수 있는 작업
· 보안 / 테스트 / DB처럼 전문 역할이 다른 작업
· 여러 파일과 기능을 병렬로 분석해야 하는 작업
· 메인 작업의 Context를 너무 많이 차지하는 조사 작업
7. 자동 테스트 Loop - 코드만 작성하고 끝내지 않기
AI 코딩에서 제가 중요하다고 보는 부분 중 하나가 코드를 만드는 것과 코드가 실제로 동작하는 것은 다르다는 점입니다.
예전 방식은 다음처럼 끝나는 경우가 많았습니다.
코드 생성
↓
끝에이전트 방식에서는 검증 과정을 반복시킬 수 있습니다.
코드 수정
↓
컴파일
↓
테스트
↓
오류 발견
↓
원인 분석
↓
코드 수정
↓
다시 테스트
↓
성공실전 프롬프트 예시
로그인 오류를 수정해줘.
단, 코드만 수정하고 끝내지 말고
1. 오류 재현
2. 원인 분석
3. 최소 범위 수정
4. 테스트 실행
5. 테스트 실패 시 원인 재분석
6. 다시 수정
7. 테스트 성공 여부 확인
순서로 작업해줘.
마지막에는
변경된 파일과 수정 이유를 정리해줘.이런 식으로 요청하면 단순 코드 생성보다 훨씬 실무적인 워크플로에 가까워집니다.
8. Git·PR 자동화 - 수정부터 코드리뷰까지 연결
Claude Code는 Git 작업과 결합했을 때 활용 범위가 더욱 넓어집니다.
코드 수정
↓
git diff
↓
Code Review
↓
Security Review
↓
Test
↓
Commit
↓
Pull RequestGit 자동화 예시
로그인 오류를 분석해서 수정해줘.
수정 후에는
1. git diff 확인
2. 코드 리뷰
3. 보안 문제 확인
4. 테스트
5. 변경사항 요약
까지 진행해.
문제가 없다면
커밋 메시지와 PR 설명에 사용할 내용도 만들어줘.다만 AI가 만들었다는 이유만으로 변경사항을 확인하지 않고 바로 운영 브랜치에 반영하는 것은 추천하지 않습니다.
특히 데이터베이스나 인증·결제·보안과 관련된 코드는 사람이 최종 diff를 확인하는 과정이 필요합니다.
9. Context Engineering - 많은 정보를 주는 게 항상 좋은 것은 아닙니다
AI를 사용할 때 흔히 하는 실수가 있습니다.
"자료를 많이 주면 AI가 더 잘하겠지"라고 생각하는 것입니다.
하지만 실제로는 관련 없는 정보가 너무 많이 들어가면 중요한 정보가 묻힐 수 있습니다.
예를 들어 1만 개 파일이 있는 오래된 프로젝트에서 청구서 오류 하나를 수정한다고 가정해보겠습니다.
전체 프로젝트를 무작정 분석시키기보다 관련 파일과 흐름을 먼저 찾는 편이 효율적입니다.
전체 프로젝트
↓
관련 기능 검색
↓
invoice.jsp
invoice.js
InvoiceDAO.java
invoice 관련 DB
관련 오류 로그
↓
Claude 분석Context Engineering 실전 요청 예시
전체 프로젝트를 전부 읽지 말고
먼저 invoice 관련 파일을 검색해줘.
오류와 관계있는 파일만 추려서
1. 화면
2. Java 로직
3. DB 접근
4. JavaScript
5. 오류 로그
순서로 분석해.
관계없는 파일은 Context에 불필요하게 포함하지 마.특히 오래된 대규모 Java·JSP 프로젝트에서는 이런 식으로 범위를 제한하는 것이 비용과 분석 정확도 측면에서 모두 도움이 될 수 있습니다.
10. Permission과 보안 - AI에게 모든 권한을 주면 안 되는 이유
Claude Code가 강력해질수록 마지막으로 중요해지는 것이 권한 관리입니다.
파일을 읽는 AI와 운영 서버에서 명령을 실행할 수 있는 AI는 위험도가 완전히 다릅니다.
Read Agent
↓
읽기만 허용
Developer Agent
↓
src/ 수정 허용
Database Agent
↓
개발 DB만 접근
Deploy Agent
↓
운영서버 자동 접근 금지Claude Code 주요 권한 모드
| 모드 | 특징 | 추천 상황 |
|---|---|---|
| default | 필요한 작업에 승인 요청 | 일반적인 사용 |
| acceptEdits | 파일 편집을 보다 자동화 | 안전한 개발환경 |
| plan | 분석 중심, 수정·명령 제한 | 코드 검토·사전 분석 |
| bypassPermissions | 권한 확인을 크게 우회 | 격리된 안전환경에서만 주의해서 사용 |
개발 폴더 삭제, 중요한 파일 덮어쓰기, Git 작업, DB 변경, 운영 서버 명령처럼 복구가 어려운 작업까지 자동 실행될 가능성을 고려해야 합니다.
처음에는 Plan → 확인 → 수정 순서로 익히는 편이 안전합니다.
Claude Code 스킬은 어떤 것부터 써야 할까?
모든 Skill이나 Agent를 한 번에 구성할 필요는 없습니다.
하는 작업에 맞춰 필요한 것부터 시작하면 됩니다.
| 사용 목적 | 먼저 볼 기능 |
|---|---|
| 프론트엔드 제작 | frontend-design + webapp-testing |
| React·Next.js | React Best Practice 관련 Skill |
| DB·백엔드 | Postgres/Supabase Skill + Test |
| 자동화 | MCP + Hooks + n8n 계열 Skill |
| 대규모 프로젝트 | CLAUDE.md + Subagent + Context 관리 |
| 보안 검토 | Security Agent + Static Analysis |
| 1인 개발 | Subagent + CLAUDE.md + 자동 테스트 |
초보자라면 이 순서로 시작하는 게 쉽습니다
Claude Code를 처음 접하면 기능이 너무 많아서 처음부터 MCP와 Agent Orchestration까지 구성하고 싶을 수 있습니다.
하지만 저라면 아래 순서로 익힐 것 같습니다.
1단계. Claude Code 기본 사용
파일 찾기 → 코드 설명 → 간단한 수정
2단계. CLAUDE.md 작성
프로젝트 환경과 코딩 규칙 등록
3단계. 테스트까지 요청
수정 → 실행 → 오류 확인 → 재수정
4단계. Skills 적용
반복되는 업무 규칙 재사용
5단계. Subagent 분리
보안·테스트·DB 등 역할 분담
6단계. MCP 연결
GitHub·Jira·Slack·DB 등 외부 서비스 연동
7단계. Hooks·자동화
테스트와 보안 검사를 자동으로 실행
Claude Code 실전 예제 - 회원가입 오류를 AI 개발팀에게 맡긴다면
앞에서 설명한 기능을 하나의 예제로 연결해보겠습니다.
기존 JSP + Java + MySQL 프로젝트에서 회원가입 오류가 발생했다고 가정하겠습니다.
사람이 직접 작업한다면
오류 확인
↓
JSP 찾기
↓
Java 코드 찾기
↓
SQL 확인
↓
로그 확인
↓
수정
↓
테스트
↓
오류
↓
다시 수정Claude Code 에이전트 구조를 적용하면
Main Agent
│
├─ Context Search
│ └─ 회원가입 관련 파일만 검색
│
├─ Architect Agent
│ └─ 전체 데이터 흐름 확인
│
├─ Java Agent
│ └─ 서버 로직 분석
│
├─ Database Agent
│ └─ SQL 및 중복체크 분석
│
├─ Security Agent
│ └─ 입력값·비밀번호 검토
│
└─ Test Agent
└─ 정상·오류 케이스 테스트제가 요청한다면 이런 식입니다
회원가입 오류를 수정해줘.
먼저 전체 프로젝트를 무작정 읽지 말고
회원가입과 관련된 JSP, Java, JS, DAO,
SQL, 오류 로그만 찾아줘.
현재 프로젝트 규칙은 CLAUDE.md를 따라.
작업은 다음 역할로 나눠서 확인해줘.
Architect
- 데이터 흐름과 파일 관계 분석
Java
- 회원가입 서버 로직 확인
Database
- 이메일 중복 확인과 SQL 검토
Security
- 입력 검증과 비밀번호 관련 보안 문제 확인
Test
- 정상 가입
- 중복 이메일
- 잘못된 입력
- DB 오류
케이스 확인
코드 수정은 기존 구조를 최대한 유지하고
필요한 부분만 최소 수정해.
수정 후 테스트하고
실패하면 원인을 다시 분석해서 수정해.
마지막에는
1. 원인
2. 수정 파일
3. 변경 내용
4. 테스트 결과
5. 추가 확인사항
순서로 정리해줘.이 정도만 해도 단순히 "회원가입 고쳐줘"라고 요청하는 것보다 작업 범위와 결과가 훨씬 명확해집니다.
Claude Code AI 에이전트와 Subagent·Skills·MCP를 이용한 개발 자동화 구조 예시
frontend-design 등 Claude Code Skills는 무엇인가?
Skills에는 특정 개발 작업에 맞춘 다양한 형태가 있습니다.
대표적으로 이해하기 쉬운 유형을 정리하면 다음과 같습니다.
frontend-design
랜딩페이지, 대시보드, React 컴포넌트, 웹 UI처럼 디자인 품질이 중요한 프론트엔드 제작에 활용할 수 있습니다.
Claude가 단순히 작동하는 화면만 만드는 것이 아니라 레이아웃과 계층, 타이포그래피 등 UI 품질을 함께 고려하도록 방향을 제공하는 역할입니다.
webapp-testing
코드를 수정했다고 해서 브라우저에서 정상적으로 작동하는 것은 아닙니다.
로그인, 버튼, 폼, 화면전환처럼 실제 웹앱 동작을 검증하는 과정이 필요합니다.
따라서 frontend-design으로 만들고 webapp-testing으로 확인하는 방식이 이해하기 쉽습니다.
skill-creator
남이 만든 Skill만 사용하는 것이 아니라 회사나 개인 프로젝트에 맞는 Skill을 직접 만드는 용도입니다.
같은 긴 프롬프트를 반복해서 입력하고 있다면 Skill로 만들어볼 만합니다.
mcp-builder
회사 내부 API나 데이터베이스, 사내 시스템처럼 공개되어 있지 않은 도구를 Claude와 연결해야 한다면 MCP 서버 자체를 만들어야 할 수 있습니다.
이럴 때 필요한 MCP 구조를 설계하는 용도로 사용할 수 있습니다.
React·Next.js Best Practice
React와 Next.js는 코드가 실행된다고 해서 반드시 성능이 좋은 것은 아닙니다.
불필요한 재렌더링, 큰 번들, 잘못된 데이터 패칭 구조 등을 검토할 때 관련 Skill이 유용할 수 있습니다.
Postgres·Supabase Best Practice
AI가 만들어준 SQL이 문법상 맞더라도 실제 DB 권한과 인덱스, 보안정책까지 적절하다는 의미는 아닙니다.
PostgreSQL·Supabase 프로젝트라면 스키마, RLS, 마이그레이션, 인덱스 등을 검토하는 데 활용할 수 있습니다.
Static Analysis와 Security Skill
기능은 정상인데 보안상 문제가 있는 코드가 만들어질 수도 있습니다.
정적 분석, 취약점 탐지, Semgrep·CodeQL 같은 도구 기반 검사를 워크플로에 추가하면 보안 검토를 좀 더 구조화할 수 있습니다.
n8n Skills
Claude Code를 단순 개발도구가 아닌 업무 자동화 도구처럼 활용한다면 n8n 같은 자동화 플랫폼과 조합할 수 있습니다.
MCP와 함께 사용하면 여러 서비스의 데이터를 가져오고 작업을 실행하는 워크플로까지 확장할 수 있습니다.
Claude Code와 Cursor는 뭐가 다를까?
두 제품 모두 AI 코딩에 사용할 수 있지만 접근방법은 다소 다릅니다.
Cursor는 IDE 중심 경험이 강하고 Claude Code는 터미널과 프로젝트 작업 흐름에서 에이전트가 직접 행동하는 구조를 이해하는 것이 중요합니다.
어느 것이 무조건 더 좋다기보다 개발환경과 작업방식에 따라 선택하면 됩니다.
Claude Code 사용 전 꼭 알아둘 보안 주의사항
Claude Code를 처음 사용하면 AI가 알아서 많은 일을 해주는 것이 편하게 느껴집니다.
하지만 기능이 강력할수록 권한을 보수적으로 관리하는 것이 중요합니다.
운영 서버 권한은 최소화
처음부터 운영서버 전체 접근권한을 주는 것보다 로컬 또는 개발환경부터 적용하는 것이 안전합니다.
DB 삭제·변경 명령 주의
DROP, DELETE, TRUNCATE처럼 되돌리기 어려운 명령은 자동실행보다 사람 확인 단계를 두는 편이 좋습니다.
API Key와 비밀번호 노출 금지
CLAUDE.md나 Skill 파일에 실제 비밀번호와 API Key를 그대로 넣는 방식은 피해야 합니다.
AI가 만든 코드는 마지막으로 사람이 확인
특히 인증, 결제, 개인정보, DB 마이그레이션은 자동 테스트가 성공해도 변경사항을 직접 검토하는 편이 안전합니다.
Claude Code AI 에이전트 자주 묻는 질문
Claude Code와 일반 Claude 채팅은 무엇이 다른가요?
일반적인 대화형 AI는 질문과 답변 중심이지만 Claude Code는 개발 프로젝트에서 파일을 읽고 수정하거나 명령 실행, 테스트, Git 작업 등 실제 개발 작업을 수행할 수 있는 에이전틱 코딩 도구입니다.
Claude Code의 Agent와 Subagent는 같은 건가요?
메인 Agent가 전체 작업을 담당한다면 Subagent는 테스트, 보안, DB, 코드리뷰처럼 특정 역할을 분리해 수행하도록 구성하는 개념으로 이해하면 쉽습니다.
Claude Code Skills와 Agent의 차이는 무엇인가요?
Agent는 작업을 수행하는 주체이고 Skill은 특정 작업을 어떻게 수행해야 하는지 알려주는 재사용 가능한 지침과 자료에 가깝습니다. 쉽게 말하면 Agent가 직원이라면 Skill은 업무 매뉴얼입니다.
MCP는 왜 필요한가요?
MCP를 사용하면 Claude Code가 프로젝트 파일 밖의 GitHub, Jira, Slack, 데이터베이스, 사내 API 같은 외부 서비스와 도구를 활용할 수 있습니다.
CLAUDE.md에는 무엇을 적어야 하나요?
프로젝트의 빌드 방법, 사용 중인 Java·DB 버전, 코딩 규칙, 수정하면 안 되는 파일, 테스트 방법처럼 Claude가 항상 알아야 할 프로젝트 규칙을 적는 것이 좋습니다.
Claude Code에 모든 권한을 줘도 괜찮나요?
권장하지 않습니다. 개발 초기에는 필요한 파일과 명령만 허용하고 특히 운영 서버, 데이터베이스 삭제, 배포와 같이 복구가 어려운 작업은 사람의 확인 단계를 두는 것이 안전합니다.
정리 - Claude Code는 AI 한 명보다 AI 개발환경을 만드는 도구에 가깝습니다
Claude Code AI 에이전트를 어렵게 생각할 필요는 없습니다.
기본적으로는 코드를 이해하고 직접 작업하는 AI 개발자라고 보면 됩니다.
그리고 여기에 각각의 기능을 더하면 역할이 확장됩니다.
Subagent → 전문 역할별 AI 작업자
Skills → 반복해서 사용할 전문 업무 매뉴얼
MCP → GitHub·Jira·DB 등 외부 서비스 연결
Hooks → 테스트·검사·명령 자동 실행
CLAUDE.md → 프로젝트 전체 규칙
Context Engineering → 필요한 정보만 정확히 제공
Permission → AI가 할 수 있는 작업 범위 제한
처음부터 모든 기능을 사용할 필요는 없습니다.
저라면 우선 Claude Code 기본 사용 → CLAUDE.md → 자동 테스트 → Skills → Subagent → MCP → Hooks 순으로 확장할 것 같습니다.
이렇게 접근하면 처음에는 단순한 AI 코딩도구였던 Claude Code가 나중에는 코드 작성, 테스트, 리뷰, 외부 도구 연결까지 담당하는 하나의 개발 워크플로로 바뀌게 됩니다.
※ Claude Code의 기능과 명령, 지원 방식은 업데이트에 따라 달라질 수 있습니다. 설치 및 실제 권한 설정 전에는 최신 Anthropic 공식 Claude Code 문서를 함께 확인하는 것을 권장합니다.
'블로그 수익화 > AI·ChatGPT' 카테고리의 다른 글
| 인공지능 콘텐츠 트렌드: 1인 미디어 시대, 초보자도 쉽게 따라 하는 AI 콘텐츠 제작 로드맵 (0) | 2026.09.13 |
|---|---|
| GPT-6 Astra 사용법｜Plus·Pro에서 안 보일 때 Work·Codex 설정방법 (0) | 2026.09.10 |
| GPT-6 Astra API 가격 얼마? Python 사용법·토큰 비용·Sol 비교 (0) | 2026.09.10 |
댓글