JYP Garden

Claude Code

Properties1
tagsentity, tool, knowledge

8 min read

Claude Code

Summary

Anthropic의 터미널 네이티브 코딩 에이전트. CLAUDE.md + Skills + Hooks + MCP + Subagents로 구성된 하네스 구현. 이 LLM Wiki 자체가 Claude Code 위에서 실행된다.

Anthropic의 터미널 네이티브 코딩 에이전트. CLAUDE.md + Skills + Hooks + MCP + Subagents로 구성된 하네스 구현. 이 LLM Wiki 자체가 Claude Code 위에서 실행된다.

개요

Claude Code는 anthropic이 개발한 CLI 기반 코딩 에이전트다. 단순한 코딩 도우미가 아닌, 완전한 harness-engineering 구현체다.

이 위키 자체가 Claude Code 하네스다: CLAUDE.md(Schema) + Skills(ingest/query/lint) + Agents(ingest-orchestrator/wiki-doctor) + Hooks(PreToolUse/Stop) = three-layer-architecture의 Schema 레이어.

주요 사실

  • 아키텍처: 터미널 네이티브 (CLI), anthropic 개발 (출처: harness-engineering-reference)
  • CLAUDE.md: 자동 로드되는 프로젝트 수준 지침. 계층 구조(전역 > 프로젝트 > 서브디렉터리)
  • Skills: 도메인별 추론 패턴 파일 (.claude/skills/<name>/SKILL.md), 진입 시 자동 로드. Progressive disclosure 설계로 언어·surface·태스크별 문서만 지연 로드 (출처: claude-api-skill). SKILL.md 3-tier 번들 표준: YAML frontmatter + 본문 <500줄 + scripts/references/assets/ 3폴더 (출처: claude-code-ecosystem-map-2026)
  • claude-api 빌트인 스킬: Messages API + Claude Managed Agents 공식 문서 커버. /claude-api migrate 서브커맨드로 코드베이스 전체 모델 마이그레이션 자동화 (출처: claude-api-skill)
  • Claude Managed Agents (beta): Anthropic 서버 관리 stateful 에이전트 — managed-agents-2026-04-01 beta header, Agent(once)→Session(every run) 플로우 필수 (출처: claude-api-skill)
  • Hooks: 5개 이벤트 — PreToolUse / PostToolUse / Notification / Stop / PreCompact, exit code 0/1/2로 성공·피드백·차단 제어 (출처: claude-code-harness-guide)
  • MCP: Model Context Protocol 지원, 권장 5-6개 이하 활성 서버
  • Subagents: Agent Teams 지원 (멀티 에이전트 조율)
  • 3계층 권한: Tier 1(읽기전용 자동) / Tier 2(상태변경 확인) / Tier 3(명시적 승인/차단)
  • ETH Zurich 연구(2026): 인간 작성 CLAUDE.md ~4% 향상
  • 실전 도구 선택(2026-05-13): 메이커 에반은 Claude Code를 약 400시간 사용한 뒤, Star 수보다 실제 업무 검증과 큐레이션이 중요하다고 정리했다. 추천 흐름은 obra-superpowers/gstack로 계획·검증 루프를 늦추고, 마지막에 openai-codex 기반 codex:review를 추가하는 방식이다. (출처: yt-BZPaZzjLIOY-Claude-Code-핵심도구6개)

생태계 현황 (2026-04-24 기준)

커뮤니티 리포가 공식을 Star 수에서 앞질렀다 — obra-superpowers(~152k⭐) > anthropics/skills(~117k⭐). claude-code-plugin-ecosystem 참조.

  • 계층적 CLAUDE.md 패턴 실증: ~/.claude/CLAUDE.md(전역 100줄 이하) → 프로젝트 → 로컬 3계층. 상세는 skills/ 위임 (출처: claude-code-ecosystem-map-2026)
  • 생태계 규모: 55개 리포, 6개 카테고리(CLAUDE.md·Slash Commands·Hooks·Sub-agents·CI/CD·Skills)
  • wshobson-agents: 생태계 최대 규모 plugin-format 시스템 (27.9k⭐)

실전 운영 패턴: 콘텐츠 자동화 하네스

yt-shinyeongseon-claudecode-naver-blog-automation-2026 사례는 Claude Code를 “코드 생성기”가 아니라 업무 하네스 런타임으로 쓰는 전형을 보여준다.

  • 인터뷰형 온보딩으로 브랜드팩트/톤/금칙어를 구조화
  • 기존 글 샘플을 주입해 문체·구조를 맞춤화
  • 키워드 입력으로 초안/메타/태그/이미지 후보를 일괄 생성
  • 최종 발행은 사람이 검수·게시(human-in-the-loop)

즉, Claude Code의 강점은 단발성 글쓰기보다, 반복 가능한 제작 파이프라인을 로컬 워크플로우와 결합해 팀 단위로 재현 가능하게 만드는 데 있다.

yt-jaychoi-ai-video-editing-automation-2026 사례에서는 이 패턴이 영상 편집으로 확장된다.

  • 스킬 설치/의존성 셋업을 Claude Code가 오케스트레이션
  • STT 타임스탬프 기반 컷 편집과 자막 생성
  • 모션그래픽 레이어를 후속 단계로 분리해 반복 수정
  • 누적 스타일을 스킬로 저장해 다음 영상의 초기 품질을 끌어올림

요금 정책 변경 (2026-06-15)

프로그래메틱-크레딧 도입으로 구독이 두 버킷으로 분리:

  • 인터랙티브 (터미널 직접 사용): 기존 구독 한도 유지
  • 프로그래메틱 (claude -p, Agent SDK, GitHub Actions 등): 별도 크레딧 200만 사용 가능

기존 5,000~$7,500) 대비 최대 40배 비용 증가. 외부 도구·오픈소스 클라이언트 사용에 사실상 패널티.

→ 상세: yt-SG51INjDoeM-클로드-코드-요금-정책-변경-총정리

관련 개념

관련 엔티티

소스

그래프 뷰

백링크