Claude Agent SDK: 언제 사용하고 언제 피해야 할까?

Claude Code로 자동화 도구를 만들다 보면 "이걸 더 프로그래밍 방식으로 제어할 수는 없을까?"라는 생각이 들 때가 있습니다. Anthropic이 최근 공개한 Claude Agent SDK가 바로 그 해답입니다.하지만 모든 도구가 그렇듯, 적재적소에 사용해야 빛을 발합니다. 이 글에서는 Agent SDK가 무엇인지, 그리고 언제 사용해야 하고 언제 피해야 하는지를 실무 관점에서 정리했습니다.Claude Agent SDK란?한 문장으로 정의하면:Claude Code를 Python/TypeScript 라이브러리로 사용할 수 있게 해주는 SDKCLI에서 대화형으로 사용하던 Claude Code의 모든 기능(파일 읽기/편집, 명령 실행, 웹 검색 등)을 프로그래밍 방식으로 제어할 수 있습니다.핵심 기능B..

Private GitHub 레포지토리에서 Claude Code 플러그인 설치하기

들어가며Claude Code 플러그인을 팀 내부에서만 사용하고 싶을 때, GitHub Private 레포지토리에 올려두고 설치할 수 있습니다.그런데 Public 레포와 달리 인증 과정이 필요해요. 이 글에서는 Private 레포에서 플러그인을 설치하는 방법을 정리합니다.왜 일반 방식이 안 되나요?발생하는 에러Error: Failed to clone marketplace repository: HTTPS authentication failed.fatal: could not read Username for 'https://github.com': terminal prompts disabled원인Claude Code는 터미널 프롬프트가 비활성화된 상태로 실행됩니다.일반적인 Git Clone은 이렇게 동작해요:Gi..

Claude Code 플러그인이란?

한 줄 요약Claude Code 플러그인은 Claude CLI의 기능을 확장하는 모듈입니다.뭘 할 수 있나요?반복적인 작업이나 특정 워크플로우를 자동화할 수 있습니다.예를 들어:매주 Jira 이슈 보고서 자동 생성코드 리뷰 체크리스트 자동화회의록 템플릿 생성등등...왜 플러그인으로 만드나요?사실 .claude/skills/ 폴더에 SKILL.md를 직접 넣어도 동작합니다.그런데 플러그인으로 만들면 이런 장점이 있어요:장점 설명버전 관리plugin.json에 버전 명시, 업데이트 추적 가능간편한 설치/plugin install 명령어 한 줄로 설치마켓플레이스 배포GitHub에 올려두면 누구나 설치 가능설치 스코프user/project/local 선택해서 범위 지정일괄 관리/plugin list, /plug..

Claude Code 플러그인 구조 완전 정복

plugin.json부터 marketplace.json까지 들어가며이전 글에서 SKILL.md 작성법을 알아봤습니다. 이번 글에서는 플러그인 전체 구조를 다뤄볼게요.플러그인을 직접 만들거나, 마켓플레이스에 등록하고 싶다면 이 글이 도움이 될 겁니다.전체 구조 한눈에 보기claude-plugin/ # 마켓플레이스 저장소├── .claude-plugin/│ └── marketplace.json # 마켓플레이스 설정│├── jira-reporter/ # 플러그인 A│ ├── .claude-plugin/│ │ └── plugin.json # 플러그인 메타데이터│..

Claude Code SKILL.md 작성 가이드 - 나만의 스킬 만들기

SKILL.md란?SKILL.md는 Claude Code에게 특정 작업을 수행하는 방법을 알려주는 마크다운 파일입니다.쉽게 말해, Claude에게 주는 "업무 매뉴얼"이라고 생각하면 됩니다. 이 파일에 작업 규칙을 정의해두면, 사용자가 자연어로 요청했을 때 Claude가 해당 스킬을 자동으로 인식하고 실행합니다.예시사용자: "backend 팀 이번 달 보고서 만들어줘" ↓Claude: SKILL.md 확인 → "아, 이건 jira-report 스킬이네!" ↓ 정의된 규칙대로 Jira 조회 → 보고서 생성코드 한 줄 없이 마크다운만으로 자동화 워크플로우를 만들 수 있다는 게 핵심이에요.파일 위치{플러그인}/└── skills/ └── {스킬명}/ └..

Claude Code 플러그인 마켓플레이스 만들기 - Jira 보고서 자동화

들어가며Claude Code를 사용하다 보면 반복적인 작업이 생기기 마련입니다. 저는 매주 Jira 이슈를 정리해서 보고서를 만드는 작업이 그랬는데요. "이거 자동화하면 좋겠다"는 생각에 Claude Code 플러그인을 직접 만들어보게 되었습니다.이 글에서는 제가 만든 Claude Plugin Marketplace와 첫 번째 플러그인인 Jira Reporter를 소개합니다.Claude Code 플러그인이란?Claude Code 플러그인은 Claude CLI의 기능을 확장하는 모듈입니다.마크다운 기반의 "스킬(Skill)"을 정의하면, Claude가 자연어 요청을 이해하고 해당 스킬을 자동으로 실행합니다. 복잡한 코드 없이 마크다운만으로 자동화 워크플로우를 만들 수 있다는 게 장점이에요.플러그인 vs 스킬..