최근 AI가 단순히 대화하는 수준을 넘어, 내 컴퓨터의 파일을 정리하고 코드를 실행하며 웹 서핑까지 대신해 주는 'AI 에이전트' 시대가 열렸습니다. 그 중심에 있는 OpenClaw를 Windows 환경에서 가장 완벽하게 설치하고 세팅하는 방법을 공유합니다.1. 설치 전 선택: Windows vs WSL2 (Ubuntu)OpenClaw는 두 가지 방식으로 설치할 수 있습니다. 본인의 용도에 맞춰 선택하세요.구분방법 1: Windows 직접 설치 (Native)방법 2: WSL2 활용 설치 (Ubuntu 24.04)추천리눅스가 처음인 입문자안정성을 원하는 개발자 (강력 추천)장점설치 과정이 매우 단순하고 익숙함AI가 내리는 리눅스 기반 명령 실행률이 압도적임단점경로 문제나 권한 에러 발생 가능초기 리눅스 ..

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

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

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

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