02 - 클로드 코드: 터미널에서 에이전트 개발
AI 지원 개발 도구 분야에서 Claude Code는 다음과 같은 독특한 위치를 차지하고 있습니다. 그리고 하나 에이전트 CLI 터미널에 상주하고, 코드베이스를 읽고, 명령을 실행하고, IDE를 열지 않고도 파일을 편집하고 복잡한 작업 흐름을 관리할 수 있습니다. 접근권한이 있는 챗봇이 아닙니다 코드: 개발 환경에서 동일한 자연스러움으로 작동하는 자율 에이전트입니다. 당신과 함께 일할 선배 동료가 누구인지.
이 기사는 설치부터 구성까지 Claude Code에 대한 완전한 심층 분석입니다. 내부 아키텍처부터 실제 워크플로우까지, 권한 시스템부터 생성까지 고급화 맞춤형 에이전트의 당신이 경험이 풍부한 개발자인지, 생산성 또는 에이전트 도구를 평가하는 팀 리더가 필요한 모든 것을 여기에서 찾을 수 있습니다. 이 도구를 익히려면.
무엇을 배울 것인가
- Claude Code는 무엇이며 기존 AI 비서와 어떻게 다른가요?
- 설치, 구성 및 디렉터리 구조
.claude/ - 내부 아키텍처: 도구 호출, 컨텍스트 창, 권한 모델
- 사용 가능한 모든 도구: 읽기, 쓰기, 편집, Bash, Grep, Glob, Task, WebSearch
- 권한 시스템과 후크 메커니즘
- 에이전트 동작을 유도하기 위해 효과적인 CLAUDE.md를 작성하는 방법
- 하위 에이전트, 병렬 실행 및 격리 작업 트리
- 브라우저, 데이터베이스 및 외부 서비스를 위한 MCP(Model Context Protocol) 통합
- 실용적인 워크플로: TDD, 코드 검토, 디버깅, 자동 커밋
- Cursor, GitHub Copilot 및 기타 IDE 기반 도구와의 비교
- 모범 사례, 알려진 제한 사항 및 해결 전략
Claude Code란 무엇입니까: 터미널의 에이전트 패러다임
에이전트 개발을 위한 Claude Code 및 공식 Anthropic CLI. 와 달리 채팅 창과 편집기 간에 코드를 복사하여 붙여넣는 기존 챗봇, 클로드 코드 당신의 터미널에 살아요 파일 시스템에 직접 액세스할 수 있으며, 셸 명령을 실행하고, 파일을 읽고 수정하고, 코드베이스에서 패턴을 검색하고, 수동 개입 없이 다단계 워크플로우를 조율합니다.
용어 대리인의 악기의 특성을 이해하는 데 기본이 됩니다. AI 에이전트는 단순히 질문에만 답변하는 것이 아닙니다. 행위. 클로드 코드는 다음을 분석합니다. 프로젝트 컨텍스트, 필요한 변경 계획, 시리즈를 통해 구현 도구 호출의 경우 결과를 확인하고 작업이 완료될 때까지 반복합니다. 그리고 차이점은 누군가에게 "X를 어떻게 하지?"라고 묻는 것 사이에 그리고 유능한 동료에게 “X를 하라”고 말하세요.
챗봇과 에이전트: 근본적인 차이점
Un 챗봇 프롬프트에 대한 응답으로 텍스트를 생성합니다. 에이 대리인 도구에 액세스할 수 있으며 실제 세계에서 작업(파일 읽기, 실행)을 수행할 수 있습니다. 명령, 코드 편집, 웹 검색. Claude Code는 귀하의 회사에서 일하는 에이전트입니다. 관찰-추론-행동의 지속적인 주기를 갖춘 개발 환경 목표 완료.
Claude Code 및 Claude 모델(현재 Opus 4.6, Sonnet 4.6 및 변형)을 기반으로 함 특별히 설계된 기본 도구 세트를 통해 코드베이스와 인터페이스합니다. 소프트웨어 개발 작업을 위해. 2026년 2월 GitHub는 Claude Code를 Agent HQ 플랫폼, 생태계 내 참조 에이전트 역할 통합 전문 개발의.
설치 및 구성
Claude Code 설치는 직접 이루어지며 Node.js 18+ 및 npm이 필요합니다. 프로세스에는 다음이 포함됩니다. 3단계: 패키지 설치, 인증 설정, 사용자 정의 환경의.
기본 설치
# Installazione globale
npm install -g @anthropic-ai/claude-code
# Verifica installazione
claude --version
# Primo avvio - si apre il browser per l'autenticazione
claude
# Oppure con API key diretta
export ANTHROPIC_API_KEY=sk-ant-...
claudeClaude Code는 처음 시작할 때 브라우저(OAuth) 또는 다음을 통해 인증을 제공합니다. 직접 API 키. 개인적인 용도로는 API 키로 충분합니다. 팀 및 조직용 e 중앙 집중식 자격 증명 관리 기능을 갖춘 Anthropic Console을 통한 액세스가 권장됩니다.
.claude/ 디렉토리
초기화 후 Claude Code는 디렉터리를 생성합니다. .claude/ 루트에
프로젝트의 (그리고 선택적으로 전역 구성을 위한 사용자의 홈 디렉터리에).
이 디렉토리는 구성의 신경 중심입니다.
.claude/
├── settings.json # Configurazione permessi e tool
├── agents/ # Definizioni agenti personalizzati
│ ├── planner.md
│ ├── code-reviewer.md
│ └── security-reviewer.md
├── commands/ # Comandi slash personalizzati
│ └── review.md
├── hooks/ # Hook pre/post tool execution
│ └── pre-commit-check.sh
├── rules/ # Regole di comportamento
│ └── coding-style.md
├── skills/ # Skill personalizzate
│ └── angular-patterns.md
└── README.md # Documentazione localesettings.json 파일
파일 settings.json 권한, 승인된 도구 및
에이전트의 전역 동작. 경험을 위해 구성할 첫 번째 파일
생산적이다.
{
"permissions": {
"allow": [
"Read",
"Glob",
"Grep",
"Edit",
"Write",
"Bash(npm run lint)",
"Bash(npm run test)",
"Bash(npm run build)",
"Bash(git status)",
"Bash(git diff)",
"Bash(git log)"
],
"deny": [
"Bash(rm -rf *)",
"Bash(git push --force)",
"Bash(git reset --hard)"
]
},
"alwaysThinkingEnabled": true,
"model": "claude-opus-4-6"
}구성 보안
섹션 deny 그리고 프로젝트의 안전에 매우 중요합니다. 블록 명령
파괴적인 rm -rf, git push --force e
git reset --hard 우발적인 손상이나 환각으로 인한 손상을 방지합니다.
모델의. 거부를 유발할 수 있는 명령을 추가하는 것이 좋습니다.
되돌릴 수 없는 데이터 손실.
CLAUDE.md: 에이전트 지침
파일 CLAUDE.md Claude Code의 커스터마이징의 핵심입니다. 위치
프로젝트 루트에는 에이전트가 각 프로젝트에서 자동으로 읽는 지침이 포함되어 있습니다.
세션. 그것을 다음과 같이 생각하십시오. 새 팀 구성원을 위한 온보딩 문서:
프로젝트, 규칙, 아키텍처 및 기대치를 설명합니다.
효과적인 CLAUDE.md의 구조
# CLAUDE.md
## Project Overview
Questo e un portfolio Angular 21 con SSR.
Stack: Angular 21, TypeScript 5.9, Express, Firebase Hosting.
## Architecture
- Standalone components (no modules)
- Signals per state management
- OnPush change detection
- Component-scoped CSS
## Coding Standards
- TypeScript strict mode
- Immutable data patterns
- File max 800 righe
- Funzioni max 50 righe
- kebab-case per file, PascalCase per classi
## Commands
- `npm start` - Dev server
- `npm run build` - Production build con SSR
- `npm test` - Run tests
- `npm run deploy` - Deploy Firebase
## Important Patterns
- Ogni articolo blog = 4 file (IT/EN component + template)
- Registrazione in src/app/articles/index.ts
- Blog entries in src/app/services/blog.service.ts
- Angular template: escape { } con HTML entities nei code block
## Do NOT
- Non modificare file di configurazione Firebase
- Non committare direttamente su main
- Non usare NgModules (solo standalone)
- Non usare subscribe() - preferire async pipe o toSignal()잘 작성된 CLAUDE.md는 에이전트 오류를 대폭 줄이고 품질을 향상시킵니다. 출력의. 가장 중요한 섹션은 다음과 같습니다. 프로젝트 개요 (컨텍스트 일반), 건축학 (기술적 결정), 코딩 표준 (규칙) 이자형 하지 마십시오 (명시적 제약).
규칙 디렉토리: 모듈식 규칙
CLAUDE.md 외에도 Claude Code는 다음 디렉터리를 지원합니다. .claude/rules/ 어디서
도메인별로 구성된 규칙을 삽입합니다. 이 모듈식 접근 방식은 다음과 같은 경우에 바람직합니다.
복잡한 프로젝트.
# Coding Style Rules
## Immutability (CRITICAL)
ALWAYS create new objects, NEVER mutate existing ones.
Use spread operator, Object.assign(), or immutable libraries.
## File Organization
- Many small files > few large files
- 200-400 lines typical, 800 max
- Extract utilities from large modules
- Organize by feature/domain, not by type
## Error Handling
- Handle errors explicitly at every level
- Provide user-friendly messages in UI code
- Log detailed context server-side
- Never silently swallow errors메모리 시스템
클로드 코드에는 메커니즘이 있습니다 영구 메모리 세션 사이.
파일 MEMORY.md 디렉토리에 .claude/ 업데이트되었습니다
작업 세션 동안 배운 교훈을 바탕으로 에이전트가 자동으로: 패턴
발견, 일반적인 오류, 프로젝트별 구성 및 아키텍처 결정.
# Project Memory
## Angular Template Gotchas
- Curly braces in code blocks: wrap in ngNonBindable
AND escape { with { and } with }
- <T> generic types: escape < with < and > with >
- @ decorators in code: escape with @
## Blog Article Pattern
- Each article = 4 files: IT component + template, EN component + template
- Registration in src/app/articles/index.ts
- Blog entries in src/app/services/blog.service.ts
- Max ID: 288 (as of April 2026)아키텍처 및 내부 기능
Claude Code를 효과적으로 사용하려면 내부적으로 어떻게 작동하는지 이해하는 것이 필수적입니다. 아키텍처는 세 가지 기둥을 기반으로 합니다. 작용주기, il 도구 시스템 그리고 컨텍스트 창 관리.
에이전트 사이클
Claude Code에 메시지를 보내면 시스템은 다음이 나올 때까지 반복되는 루프에 들어갑니다. 작업 완료 시:
- 리셉션 - 에이전트는 축적된 모든 컨텍스트와 함께 메시지를 받습니다.
- 추리 - 모델은 요청을 분석하고 필요한 조치를 계획합니다(확장된 사고).
- 도구 호출 - 에이전트는 하나 이상의 도구(읽기, 편집, Bash 등)를 호출합니다.
- 관찰 - 도구 결과가 컨텍스트에 추가됩니다.
- 반복 - 모델은 결과를 평가하고 추가 조치가 필요한지 결정합니다.
- 답변 - 작업이 완료되면 에이전트가 요약을 제공합니다.
이 주기는 하나의 복잡한 작업에 대해 수십 번 반복될 수 있습니다. 예를 들어, 새로운 기능을 구현하려면 다음이 필요할 수 있습니다. 기존 파일 읽기(읽기), 검색 패턴(Grep/Glob), 새 파일 생성(Write), 기존 파일 수정(Edit), 실행 테스트(Bash), 오류 수정 및 반복.
컨텍스트 창 관리
컨텍스트 창은 모델이 단일 창에서 처리할 수 있는 정보의 양입니다. 상호 작용. Claude Code는 여러 환경에서 컨텍스트를 지능적으로 처리합니다. 메커니즘:
- 선택적 로딩 - 전체 코드베이스를 메모리에 로드하지 않습니다. 사용 Glob 및 Grep은 관련 파일을 찾고, Read는 필요한 파일만 읽습니다.
- 자동 압축 - 상황이 한계에 다다르자 클로드는 코드는 가장 관련성이 높은 정보를 유지하고 삭제하여 대화를 압축합니다. 쓸모없는 세부 사항.
- 하위 에이전트 - 많은 맥락이 필요한 복잡한 작업의 경우 Claude Code 격리된 컨텍스트를 사용하여 하위 에이전트에 하위 작업을 위임할 수 있습니다(작업 도구).
- 확장된 사고 - 모델은 최대 31,999개의 토큰을 예약합니다. 대화의 맥락에서 분리된 내부 추론.
다짐: 언제, 어떻게 일어나는가
클로드 코드가 맥락이 있을 때 대화를 요약하는 압축 및 프로세스 너무 커집니다. CLAUDE.md 지침, 아키텍처 결정, 수정된 파일, 현재 상태 및 오류 만났다. 그러나 이전 반복의 특정 세부 정보가 손실될 수 있습니다. 매우 긴 작업의 경우 작업을 짧은 세션으로 나누는 것이 좋습니다. 초점.
주요 도구
Claude Code에는 전체 스펙트럼을 포괄하도록 설계된 기본 도구 세트가 있습니다. 개발 운영. 각 도구에는 특정 역할과 정확한 사용 규칙이 있습니다.
읽기 및 검색 도구
| 도구 | 기능 | 언제 사용하는가 |
|---|---|---|
| 읽다 | 특정 파일의 내용을 읽습니다. | 파일의 정확한 경로를 알고 있는 경우 |
| 지구 | 이름 패턴으로 파일 검색 | 파일을 찾으려면: **/*.ts, src/**/*.spec.ts |
| 그렙 | 파일 내 콘텐츠 검색 | 코드베이스에서 패턴, 함수, 클래스를 찾으려면 |
작성 및 편집 도구
| 도구 | 기능 | 언제 사용하는가 |
|---|---|---|
| 쓰다 | 전체 파일을 생성하거나 덮어씁니다. | 새 파일 또는 전체 재작성 |
| 편집하다 | 파일의 특정 부분을 대체합니다. | 기존 파일을 외과적으로 수정하는 경우 |
실행 도구
| 도구 | 기능 | 언제 사용하는가 |
|---|---|---|
| 세게 때리다 | 터미널에서 쉘 명령 실행 | 빌드, 테스트, git, npm, 모든 CLI 명령 |
| 작업 | 격리된 컨텍스트로 하위 에이전트 실행 | 전용 컨텍스트가 필요한 복잡한 작업의 경우 |
웹 및 검색 도구
| 도구 | 기능 | 언제 사용하는가 |
|---|---|---|
| 웹검색 | 웹 검색 수행 | 문서, 업데이트, 모범 사례 |
| 웹 가져오기 | URL 콘텐츠 다운로드 및 분석 | 문서, API 참조, 기사를 읽으려면 |
실제 예: 전체 도구 사용 주기
# L'utente chiede: "Aggiungi un nuovo campo 'priority' al modello Task"
# 1. Claude Code cerca il modello esistente
Glob: src/app/models/**/*.ts
# Risultato: src/app/models/task.model.ts
# 2. Legge il file del modello
Read: src/app/models/task.model.ts
# Risultato: export interface Task { id: string; title: string; }
# 3. Modifica il modello aggiungendo il campo
Edit: src/app/models/task.model.ts
# old_string: "title: string;"
# new_string: "title: string;\n priority: 'low' | 'medium' | 'high';"
# 4. Cerca tutti i file che usano il modello
Grep: pattern "Task" in src/app/**/*.ts
# Risultato: 5 file trovati
# 5. Legge e aggiorna ogni file che crea oggetti Task
# ... (ciclo di Read + Edit per ogni file)
# 6. Esegue i test per verificare
Bash: npm run test
# Risultato: 2 test falliti
# 7. Corregge i test che falliscono
# ... (ciclo di Read + Edit per i test)
# 8. Riesegue i test
Bash: npm run test
# Risultato: All tests passed허가 제도
Claude Code의 권한 시스템은 다음 원칙에 따라 설계되었습니다. 최소 권한: 에이전트는 명시적으로 수행하는 작업만 수행할 수 있습니다. 승인됨. 이는 특히 에이전트의 경우 안전을 위해 필수적입니다. 프로덕션 코드베이스에서 작동합니다.
허가의 세 가지 모드
| 방법 | 행동 | 사용 사례 |
|---|---|---|
| 허용하다 | 확인을 요청하지 않고 도구가 실행됩니다. | 보안 작업: 파일 읽기, 검색 |
| 묻다 | Claude Code는 실행 전 확인을 요청합니다. | 대부분의 작업에 대한 기본값 |
| 부인하다 | 도구가 완전히 차단되었습니다. | 위험한 작업: 삭제, 강제 푸시 |
권한은 세 가지 수준으로 구성할 수 있습니다. 글로벌
(~/.claude/settings.json), 프로젝트
(.claude/settings.json) 그리고 세션 (프롬프트를 통해
대화식). 프로젝트 권한은 전역 권한보다 우선합니다.
세션이 프로젝트를 덮어씁니다.
Bash에 대한 세분화된 권한
Bash 도구는 특정 명령을 기반으로 세분화된 권한을 지원합니다. 이를 통해 안전한 명령은 승인하고 위험한 명령은 차단합니다.
{
"permissions": {
"allow": [
"Bash(npm run lint)",
"Bash(npm run test)",
"Bash(npm run build)",
"Bash(git status)",
"Bash(git diff)",
"Bash(git log *)",
"Bash(git add *)",
"Bash(git commit *)"
],
"deny": [
"Bash(rm -rf *)",
"Bash(git push --force *)",
"Bash(git reset --hard *)",
"Bash(git clean -f *)",
"Bash(git branch -D *)"
]
}
}심층방어의 원칙
권한에만 의존하지 마십시오. 결합: (1) settings.json의 제한적인 권한, (2) 하지 말아야 할 일에 대한 CLAUDE.md의 명시적인 지침, (3) 실행 전 작업 및 (4) 표준 git 후크(사전 커밋, 사전 푸시) 최후의 방어선으로. 보안은 계층화되어 있습니다.
후크 시스템
Claude Code 후크는 자동으로 먼저 실행되는 스크립트입니다. (PreTool사용) 또는 이후 (PostTool사용)의 호출 도구를 사용하거나 세션이 종료될 때(멈추다). 그들은 가장 메커니즘입니다 에이전트 동작을 사용자 정의하고 제어하는 데 강력합니다.
후크 유형
| Hook | 활성화되면 | 일반적인 사용 사례 |
|---|---|---|
| PreTool사용 | 도구를 실행하기 전에 | 매개변수 검증, 조건부 차단, 로깅 |
| PostTool사용 | 도구를 실행한 후 | 자동 서식 지정, 린팅, 결과 확인 |
| 멈추다 | 세션이 종료되면 | 최종 검증, 정리, 보고서 생성 |
예: 자동 서식을 위한 후크
{
"hooks": {
"PostToolUse": [
{
"tool": "Edit",
"command": "npx prettier --write $CLAUDE_FILE_PATH",
"description": "Auto-format dopo ogni modifica"
},
{
"tool": "Write",
"command": "npx prettier --write $CLAUDE_FILE_PATH",
"description": "Auto-format dopo creazione file"
}
],
"PreToolUse": [
{
"tool": "Bash",
"command": "echo 'Executing: $CLAUDE_TOOL_INPUT'",
"description": "Log ogni comando Bash"
}
],
"Stop": [
{
"command": "npm run lint",
"description": "Lint finale prima di chiudere"
}
]
}
}
Hooks는 다음과 같은 환경 변수를 통해 상황에 맞는 정보를 받습니다.
$CLAUDE_FILE_PATH (작업 중인 파일) e
$CLAUDE_TOOL_INPUT (도구 매개변수). 이를 통해 다음을 만들 수 있습니다.
정교한 조건부 논리.
고급 후크: 중요한 파일 수정 방지
PreToolUse 후크는 중요한 파일(예: 구성)의 수정을 방지할 수 있습니다.
프로덕션 또는 자격증명 파일)을 허용하기 전에 파일 경로를 확인하세요.
편집 또는 쓰기 작업. 경로가 금지된 패턴과 일치하는 경우(예:
**/production.config.*), 후크는 오류를 반환하고 작업을 차단합니다.
에이전트 및 하위 에이전트: 다중 작업 오케스트레이션
클로드 코드의 가장 강력한 능력 중 하나이자 작업 도구, 이를 통해 격리된 컨텍스트로 하위 에이전트를 시작합니다. 각 하위 에이전트는 별도의 "샌드박스"에서 작동합니다. 자체 컨텍스트를 사용하여 결과를 기본 프로세스로 반환합니다.
하위 에이전트를 사용해야 하는 경우
- 독립적인 병렬 작업 - 보안을 동시에 분석하고, 구성 요소의 성능 및 접근성
- 격리된 컨텍스트 - 하위 작업에 특정 컨텍스트가 필요한 경우 주된 임무를 수행하지 않는 것
- 다각적 분석 - "관점"으로 동일한 코드를 검사합니다. 다르다(보안 전문가, 성능 엔지니어, UX 검토자)
- 오래 지속되는 작업 - 프로세스가 진행되는 동안 긴 작업을 위임합니다. 메인 계속 더
예: 다중 관점 코드 검토
# Prompt al task principale:
"Fai una code review completa del componente
src/app/components/payment-form/"
# Claude Code lancia 3 subagenti in parallelo:
# Subagente 1: Security Review
Task: "Analizza il componente payment-form per
vulnerabilità di sicurezza: XSS, injection,
gestione dati sensibili, CSRF."
# Subagente 2: Performance Review
Task: "Analizza le performance del componente
payment-form: change detection, memory leaks,
ottimizzazione rendering, lazy loading."
# Subagente 3: Accessibility Review
Task: "Verifica l'accessibilità del componente
payment-form: ARIA labels, keyboard navigation,
focus management, color contrast."
# I 3 risultati vengono combinati nel report finale맞춤형 에이전트
디렉토리 .claude/agents/ 다음을 사용하여 특수 에이전트를 정의할 수 있습니다.
구체적인 지시와 성격. 이 디렉터리의 각 Markdown 파일은
호출 가능한 에이전트.
# Code Reviewer Agent
## Role
Sei un senior code reviewer con 15 anni di esperienza.
Sei rigoroso ma costruttivo.
## Review Checklist
Per ogni file analizzato, verifica:
1. Naming: variabili, funzioni e classi hanno nomi chiari
2. Complexity: nessuna funzione > 50 righe
3. Immutability: nessuna mutazione di stato
4. Error handling: tutti gli errori gestiti
5. Types: nessun `any`, tipi specifici ovunque
6. Security: input validati, nessun dato hardcoded
## Output Format
Classifica ogni issue trovata:
- CRITICAL: bug o vulnerabilità (blocca il merge)
- HIGH: problemi architetturali (da risolvere)
- MEDIUM: miglioramenti di qualità (consigliati)
- LOW: suggerimenti stilistici (opzionali)격리 작업 트리
현재 브랜치를 위험에 빠뜨리지 않고 실험적인 변경이 필요한 작업의 경우 Claude는
코드는 i를 지원합니다 자식 작업 트리. EnterWorktree 도구는 작업 트리를 생성합니다.
고립된 .claude/worktrees/ HEAD를 기반으로 한 새로운 지점으로.
세션이 종료된 후 사용자는 작업 트리를 유지하거나 삭제할 수 있습니다.
MCP 통합: 모델 컨텍스트 프로토콜
Il 모델 컨텍스트 프로토콜(MCP) 그리고 다음을 허용하는 개방형 표준입니다. MCP 서버를 통해 외부 서비스와 통신하기 위한 Claude Code입니다. 이는 확장됩니다 로컬 파일 시스템을 넘어 에이전트의 기능을 크게 향상시킵니다.
MCP 아키텍처
MCP 아키텍처는 Claude Code가 클라이언트 역할을 하고 i가 클라이언트 역할을 하는 클라이언트-서버 모델을 따릅니다. MCP 서버는 추가 도구를 노출합니다. MCP 서버는 다음에 대한 액세스를 제공할 수 있습니다: 웹 브라우저, 데이터베이스, 외부 API, 클라우드 서비스, CI/CD 시스템 등.
일반적인 MCP 사용 사례
| MCP 서버 | 기능성 | 사용예 |
|---|---|---|
| 브라우저 자동화 | 웹 탐색, 클릭, 스크린샷, 양식 작성 | E2E 테스트, 스크래핑, 워크플로우 자동화 |
| 데이터베이스 | SQL/NoSQL 쿼리, 스키마 탐색 | 데이터 디버깅, 스키마 마이그레이션 |
| GitHub | PR, 이슈, 코드 리뷰, 액션 | GitHub 워크플로 자동화 |
| 피그마 | 설계 판독, 부품 추출 | 디자인에서 코드 생성 |
{
"mcpServers": {
"browser": {
"command": "npx",
"args": ["@anthropic-ai/claude-code-mcp-browser"],
"description": "Browser automation server"
},
"postgres": {
"command": "npx",
"args": ["@modelcontextprotocol/server-postgres"],
"env": {
"DATABASE_URL": "postgresql://user:pass@localhost:5432/mydb"
}
}
}
}MCP 및 보안
각 MCP 서버는 해당 서버에 대해 구성된 리소스에 액세스할 수 있습니다. 데이터베이스 서버 데이터베이스에 대한 액세스 권한이 있으면 서버 브라우저가 웹을 탐색할 수 있습니다. 신청하는 것이 필수입니다 MCP 서버에 대해서도 최소 권한 원칙: 읽기 전용 자격 증명을 사용합니다. 가능하다면 개발 데이터베이스에 대한 액세스를 제한하고 프로덕션 자격 증명을 노출하지 마십시오.
맞춤형 기술 및 명령
시스템 기술 Claude Code를 사용하면 기능을 정의할 수 있습니다. 세션 중에 에이전트가 호출할 수 있는 특수 설정입니다. 에이전트와는 다르게 (성격과 접근 방식을 정의), 기술이 정의 절차 사양 반복되는 작업을 위해.
사용자 정의 슬래시 명령
슬래시 명령은 구문으로 호출할 수 있는 단축키입니다. /nomecomando
세션 중. 디렉토리에 Markdown 파일로 정의되어 있습니다.
.claude/commands/.
# /review Command
Esegui una code review completa dei file modificati
nell'ultimo commit.
## Steps
1. Esegui `git diff HEAD~1` per ottenere le modifiche
2. Per ogni file modificato:
a. Leggi il file completo per contesto
b. Analizza le modifiche per:
- Bug potenziali
- Violazioni degli standard di coding
- Problemi di sicurezza
- Opportunità di miglioramento
3. Genera un report con severity levels:
CRITICAL, HIGH, MEDIUM, LOW
4. Suggerisci fix specifici per issues CRITICAL e HIGH맞춤형 스킬
디렉토리의 스킬 .claude/skills/ 명령보다 더 정교하다
기술적인 맥락, 예시, 다단계 절차가 포함될 수 있습니다.
# Angular Blog Article Creation Skill
## Context
Questo progetto usa Angular 21 con articoli blog
che richiedono 4 file per articolo (IT + EN).
## Procedure
1. Crea il component TypeScript (IT):
src/app/articles/{series}/{name}.component.ts
2. Crea il template HTML (IT):
src/app/articles/{series}/{name}.component.html
3. Crea il component TypeScript (EN):
src/app/articles/{series}/{name}.en.component.ts
4. Crea il template HTML (EN):
src/app/articles/{series}/{name}.en.component.html
5. Registra in src/app/articles/index.ts
6. Aggiungi BlogPost in blog.service.ts
## Template Rules (CRITICAL)
- Escape { } nei code block con HTML entities
- Wrap code blocks in ngNonBindable
- Escape <T> generics con < >
- Escape @ decorators con @Claude Code를 사용한 실용적인 작업 흐름
이론도 중요하지만 Claude Code의 진정한 가치는 일상적인 작업 흐름에서 드러납니다. 가장 일반적인 소프트웨어 개발 작업에 이를 사용하는 방법을 살펴보겠습니다.
1. 테스트 주도 개발(TDD)
# Prompt:
"Implementa un servizio UserService con TDD.
Deve supportare: getById, create, update, delete.
Usa il pattern Repository per l'accesso ai dati."
# Claude Code:
# 1. Crea i test PRIMA dell'implementazione (RED)
Write: src/app/services/user.service.spec.ts
# Test per getById, create, update, delete
# 2. Esegue i test - devono FALLIRE
Bash: npm run test -- --filter=UserService
# Risultato: 4 test FAILED (come previsto)
# 3. Implementa il servizio (GREEN)
Write: src/app/services/user.service.ts
# Implementazione minima per far passare i test
# 4. Esegue i test - devono PASSARE
Bash: npm run test -- --filter=UserService
# Risultato: 4 test PASSED
# 5. Refactoring (IMPROVE)
Edit: src/app/services/user.service.ts
# Migliora la struttura mantenendo i test verdi
# 6. Verifica copertura
Bash: npm run test -- --coverage2. 대화형 디버깅
# Prompt:
"Il componente Dashboard non renderizza i dati.
La console mostra 'Cannot read properties of undefined'.
Trova e correggi il bug."
# Claude Code:
# 1. Cerca il componente
Glob: src/**/dashboard*
# 2. Legge il componente e il template
Read: src/app/components/dashboard/dashboard.component.ts
Read: src/app/components/dashboard/dashboard.component.html
# 3. Cerca il servizio che fornisce i dati
Grep: pattern "DashboardService" in src/
# 4. Legge il servizio
Read: src/app/services/dashboard.service.ts
# 5. Identifica il problema: la risposta API ha una
# struttura diversa da quella attesa
# 6. Corregge il mapping dei dati
Edit: src/app/services/dashboard.service.ts
# 7. Aggiunge null check nel template
Edit: src/app/components/dashboard/dashboard.component.html
# 8. Verifica la build
Bash: npm run build3. 자동 커밋 작업 흐름
Claude Code에는 Git 커밋을 생성하기 위한 워크플로가 내장되어 있습니다. 변경하고, 설명 메시지를 생성하고, 파일 준비를 관리합니다.
# Prompt:
"Committa le modifiche correnti"
# Claude Code:
# 1. Analizza lo stato del repository
Bash: git status
Bash: git diff
Bash: git log --oneline -5
# 2. Identifica i file rilevanti da committare
# 3. Aggiunge i file specifici (mai git add -A)
Bash: git add src/app/services/user.service.ts
Bash: git add src/app/services/user.service.spec.ts
# 4. Crea il commit con messaggio descrittivo
Bash: git commit -m "feat: add UserService with
Repository pattern and full CRUD operations"
# 5. Verifica il risultato
Bash: git status4. 안내식 리팩토링
# Prompt:
"Il file src/app/components/mega-form.component.ts
ha 1200 righe. Scomponilo in componenti più piccoli
seguendo il Single Responsibility Principle."
# Claude Code:
# 1. Analizza il file monolitico
Read: src/app/components/mega-form.component.ts
# 2. Identifica le responsabilità distinte
# 3. Crea componenti separati:
Write: src/app/components/form-header/form-header.component.ts
Write: src/app/components/form-fields/form-fields.component.ts
Write: src/app/components/form-validation/form-validation.component.ts
Write: src/app/components/form-submit/form-submit.component.ts
# 4. Aggiorna il componente originale come orchestratore
Edit: src/app/components/mega-form.component.ts
# 5. Aggiorna i test
# 6. Verifica la build e i test
Bash: npm run build && npm run test클로드 코드 vs 커서 vs GitHub Copilot
올바른 도구를 선택하는 것은 상황, 작업 유형 및 상황에 따라 다릅니다. 개인 취향. Claude Code, Cursor 및 GitHub Copilot은 대안이 아닙니다. 상호 배타적: 그들은 보완적인.
| 나는 기다린다 | 클로드 코드 | 커서 | GitHub 코파일럿 |
|---|---|---|---|
| 인터페이스 | CLI/터미널 | IDE(VS 코드 포크) | IDE 플러그인 |
| 방법 | 에이전트(자율) | 에이전트 + 인라인 | 어시스턴트 + 에이전트 |
| 자치 | 높음(자율 사이클) | 중간-높음 | 평균 |
| 문맥 | 전체 파일 시스템 | 프로젝트 열기 | 파일 열기 + 색인 |
| 도구 실행 | 전체 쉘 | 통합단말기 | 제한된 |
| MCP 지원 | 토종의 | 지원됨 | 확장을 통해 |
| 맞춤화 | CLAUDE.md + 규칙 + 후크 | .cursor규칙 | 부조종사 지침 |
| 다음에 이상적입니다. | 복합업무, 자동화, CI/CD | 일일 개발 | 완료, 조각 |
| 비용 | 종량제(API) 또는 Max 요금제 | $20/월 프로 | $10-19/월 |
언제 어떤 도구를 사용해야 하는가
- 클로드 코드 - 복잡한 엔드투엔드 작업(완전한 기능 구현, 20개 파일 리팩터링, CI/CD 구성), 터미널 운영, 자동화 워크플로, SSH를 통해 원격 서버에서 작업합니다.
- 커서 - 보고 싶을 때마다 매일 개발, 대화형 편집 편집기에서 실시간 편집, AI와의 페어링 프로그래밍, 신속한 프로토타이핑.
- GitHub 코파일럿 - 작성하는 동안 빠른 자동 완성, 이미 코딩 흐름에 있고 제안이 필요한 경우 빠른 스니펫 생성 인라인.
많은 개발자에게 가장 생산적인 조합은 다음과 같습니다. 커서 그것을 위해 매일 대화형 개발, 부조종사 인라인 완성을 위해 빠르고 클로드 코드 복잡한 작업, 자동화 및 운영을 위해 터미널. 이는 서로 다른 수준에서 작동하고 서로를 보완하는 도구입니다.
효과적인 사용을 위한 모범 사례
실제 프로젝트에서 Claude Code를 몇 달간 집중적으로 사용한 후, 다음과 같은 사례를 소개합니다. 이는 실망스러운 경험과 매우 생산적인 경험 사이의 차이를 만듭니다.
1. 상세한 CLAUDE.md 작성
CLAUDE.md는 ROI가 가장 높은 투자입니다. 잘 작성된 파일은 오류를 줄인다 50~70% 정도의 에이전트입니다. 항상 포함: 프로젝트 개요, 기술 스택, 코딩 규칙, 빌드/테스트 명령, 아키텍처 패턴 및 섹션 제약 조건이 있는 명시적인 "Do NOT"입니다.
2. 구체적이고 상황에 맞는 프롬프트를 사용하세요
# VAGO (risultato imprevedibile):
"Migliora il componente form"
# SPECIFICO (risultato prevedibile):
"Nel componente src/app/components/contact-form/:
1. Aggiungi validazione email con regex
2. Aggiungi campo telefono opzionale
3. Mostra errori inline sotto ogni campo
4. Usa il pattern reactive forms di Angular
5. Mantieni lo stile CSS esistente"3. 집중 세션에서 작업
컨텍스트 압축으로 이어지는 너무 긴 세션을 피하십시오. 당신은 선호 단일 목표에 초점을 맞춘 15~30분 세션입니다. 업무가 복잡할 때, 하위 작업으로 나누고 별도의 세션에서 처리하세요.
4. 항상 빌드를 확인하세요
중요한 변경 주기가 끝날 때마다 Claude Code가 빌드를 실행하고 테스트. 변경 사항이 정확하다고 가정하지 마세요. 모델이 커밋할 수 있습니다. 컴파일 타임이나 런타임에만 나타나는 미묘한 오류입니다.
5. 복잡한 프로젝트에는 규칙 시스템을 사용하세요
규칙이 많은 프로젝트의 경우 디렉토리를 사용하십시오. .claude/rules/ 파일 포함
도메인으로 구분: coding-style.md, security.md,
testing.md, git-workflow.md. 이는 A보다 유지 관리가 더 쉽습니다.
단일 CLAUDE.md 모놀리식.
6. 자동화를 위한 후크 구성
자동 서식 지정을 위한 PostToolUse 후크(Prettier, ESLint)는 전체 카테고리를 삭제합니다. 스타일 오류. 검증을 위한 PreToolUse 후크로 작업 방지 위험하다. 후크 구성에 10분을 투자하면 수정 시간이 절약됩니다. 매뉴얼.
제한 사항 및 해결 방법
클로드 코드는 완벽하지 않습니다. 제한 사항을 이해하는 것은 제한 사항을 관리하는 데 필수적입니다. 기대를 충족하고 완화 전략을 채택합니다.
제한사항 1: 컨텍스트 창
컨텍스트에는 고정된 제한이 있습니다. 매우 큰 프로젝트의 경우 모델이 "볼" 수 없습니다. 전체 코드베이스를 동시에. 자동 압축은 도움이 되지만 누출될 수 있습니다. 중요한 세부 사항.
해결 방법: 작업을 집중된 하위 작업으로 나눕니다. CLAUDE.md 사용 파일을 읽을 필요가 없는 아키텍처 컨텍스트를 제공합니다. 하위 에이전트 사용 (작업 도구)를 사용하여 병렬 분석을 위임합니다.
제한사항 2: 환각
모델은 정확해 보이지만 미묘한 논리적 오류가 포함된 코드를 생성할 수 있습니다. 존재하지 않는 API 또는 특정 버전에서 지원되지 않는 패턴에 대한 참조 프레임워크.
해결 방법: 항상 빌드 및 테스트를 통해 확인하세요. CLAUDE.md 파일에 지정 프레임워크의 정확한 버전. 외부 API로 작업할 때 문서를 제공하세요. WebFetch를 통해 또는 작업 예제를 첨부하세요.
제한 사항 3: 대화형 작업
Claude Code는 키보드 입력이 필요한 대화형 명령을 처리할 수 없습니다.
(어떻게 git rebase -i 또는 확인 프롬프트). 명령은 다음과 같아야 합니다.
비대화형.
해결 방법: 가능한 경우 비대화형 플래그를 사용하세요.
(-y, --yes). git의 경우 대신 특정 명령을 사용하십시오.
대화형.
제한 사항 4: 바이너리 파일 및 이미지
Claude Code는 이미지(및 다중 모드)를 읽을 수 있지만 이미지를 생성하거나 수정할 수는 없습니다. 이미지, 비디오, PDF와 같은 바이너리 파일.
해결 방법: 이미지 작업의 경우 다음과 같은 CLI 명령을 사용하십시오. Bash 도구를 통한 ImageMagick 또는 ffmpeg.
제한사항 5: 비용
API 기반 사용은 길고 집중적인 세션의 경우 비용이 많이 들 수 있습니다. 매 에이전트 루프는 추론과 도구 결과 모두에 토큰을 사용합니다.
해결 방법: Max 플랜을 이용하시면 월 고정 비용으로 이용해보세요 그리고 자주. 최적화 메시지는 구체적이어야 합니다(반복 횟수 감소). 하위 에이전트 사용 가능한 경우 병렬화합니다(빠름 = 총 토큰 수 감소).
흔히 저지르는 실수: 결과를 맹목적으로 신뢰하는 것
Claude Code의 가장 흔한 실수는 확인 없이 모든 출력을 수락하는 것입니다. 템플릿은 다음을 수행할 수 있습니다. 잘못된 디렉터리에 파일 생성, 잘못된 가져오기 사용, 도입 수정과 직접적으로 관련되지 않은 파일의 회귀 또는 다음과 같은 코드를 생성합니다. 컴파일되지만 논리적인 버그가 있습니다. 항상 빌드 및 테스트를 통해 확인하세요.. 프로토타입을 위한 순수 바이브 코딩; 프로덕션 코드에는 사람의 검토가 필요합니다.
결론
Claude Code는 개발자가 상호 작용하는 방식의 질적 도약을 나타냅니다. AI와 함께. It's not simply a chatbot that suggests code: it's a 자율 에이전트 개발 환경에서 작동하고, 프로젝트 컨텍스트를 이해하고, 관리할 수 있는 복잡한 엔드투엔드 작업.
도구의 강력한 기능은 파일 시스템에 대한 직접 액세스와 쉘, 세분화된 권한 시스템, 사용자 정의 자동화를 위한 후크, 하위 에이전트 병렬 작업 및 MCP 통합을 통해 로컬 코드베이스 이상으로 기능을 확장합니다. 이 모든 것은 공동작업자를 위한 브리핑 역할을 하는 CLAUDE.md 파일에 의해 제어됩니다. 전문가.
그러나 권력에는 책임이 따른다. Claude Code는 개발자가 적극적인 역할을 유지하고 있다 감독자 및 조정자: 목표를 정의합니다 명확하고 적절한 가드레일을 설정하고 결과를 확인하고 필요한 경우 개입합니다. 이는 "설정하고 잊어버리는" 도구가 아닙니다. 그것을 안내하십시오.
시리즈의 다음 기사
- 03 - 상담원 워크플로: 에이전트의 복잡한 문제를 분해하는 방법 AI, 다단계 조정 및 효과적인 위임 패턴
- 04 - 다중 에이전트 시스템: 간의 협업 아키텍처 에이전트, 통신 프로토콜 및 기업 사용 사례
- 05 - AI 생성 코드 테스트: TDD, 속성 기반 전략 AI 생성 코드의 품질 테스트 및 검증
기억해야 할 핵심 사항
- 클로드코드(Claude Code)는 파일시스템에 접근하여 터미널에서 동작하는 에이전트 CLI이며, 셸 및 개발 도구
- CLAUDE.md는 가장 중요한 투자입니다. 상담원의 행동을 안내합니다. 오류를 50-70% 줄입니다.
- 권한 시스템(허용/요청/거부)은 최소 권한 원칙을 구현합니다. 코드베이스를 보호하기 위해
- PreToolUse/PostToolUse 후크는 유효성 검사 및 형식화를 자동화합니다.
- 하위 에이전트(작업 도구)를 사용하면 병렬 실행 및 다관점 분석이 가능합니다.
- MCP는 에이전트의 기능을 브라우저, 데이터베이스 및 외부 서비스로 확장합니다.
- Claude Code, Cursor 및 Copilot은 대안이 아니라 보완적입니다.
- 항상 빌드 및 테스트를 확인하세요. 순수한 바이브 코딩과 프로토타입, 생산의 경우 인간의 감독이 필요하다
- 짧고 집중적인 세션(15~30분)은 세션보다 더 나은 결과를 제공합니다. 길고 일반적인