GitHub Copilot, Claude Code, OpenAI Codex 등을 사용한 Windows 앱 개발 에이전트 플러그인
요약
본 문서는 GitHub Copilot, Claude Code, OpenAI Codex 등 AI 코딩 도구를 활용하여 Windows 앱을 개발하는 에이전트 플러그인 사용법을 안내합니다. `winappcli`는 패키징 및 배포를 담당하며, `winui`는 WinUI 3 기반의 네이티브 앱 빌드와 테스트에 사용됩니다.
핵심 포인트
- AI 코딩 도구 연동으로 Windows 앱 개발 환경 구축 가능
- `winappcli`: MSIX 등 패키징, 서명 및 배포 관리
- `winui`: WinUI 3를 활용한 네이티브 앱 스캐폴딩 및 빌드 지원
- 플러그인은 특정 카탈로그에서 설치해야 중복을 방지함
GitHub Copilot, Claude Code, OpenAI Codex 등과 함께하는 Windows 앱 빌드를 위한 에이전트 플러그인입니다. 이 레포지토리를 마켓플레이스에 한 번 추가한 다음 필요한 플러그인을 설치하세요.
| Plugin | 용도 (What it's for) | 유지보수 위치 (Maintained in) | 호스트 (Hosts) |
|---|---|---|---|
winappcli | WinApp CLI를 사용한 Windows 앱 패키징, 서명 및 배포: MSIX, 인증서, 패키지 식별자(package identity), appxmanifest, Windows SDK 설정 및 Microsoft Store. Electron, .NET, C++, Rust, Flutter, Tauri와 연동됩니다. | microsoft/winappCli | Copilot, Claude Code, Codex, OpenClaw, OpenCode |
winui | WinUI 3 및 Windows App SDK를 사용한 네이티브 Windows 앱: 스캐폴딩(scaffold), 디자인, 빌드, 실행, 테스트, 패키징 및 배포. | microsoft/winappCli | Copilot, Claude Code, Codex, OpenClaw, OpenCode |
Codex, OpenClaw, 그리고 OpenCode에서는 스킬이 로드되며 에이전트는 사용할 수 없습니다.
플러그인은 다음 중 한 곳에 호스팅되거나(plugins/<name>/) 다른 레포지토리에서 유지보수되고 릴리스에 고정(pinned)됩니다. 둘 다 일급 시민(first-class)입니다. winappcli와 winui는 microsoft/winappCli에서 유지보수되므로, 이슈 및 PR은 그곳에 올리세요.
Git (winget install Git.Git)과 아래 호스트 중 하나가 필요합니다. 테이블의 이름으로 <plugin>을 대체하세요.
참고:
각 플러그인은 하나의 카탈로그에서 설치해야 합니다. microsoft/winappCli 자체 카탈로그(<plugin>@winappcli)와 awesome-copilot은 동일한 플러그인을 제공하므로, 두 번째 사본을 설치하면 중복된 스킬이 생깁니다.
copilot plugin marketplace add microsoft/win-dev-skills
copilot plugin install <plugin>@win-dev-skills
또는 Copilot이 winui와 그 전제 조건들을 설치하도록 하세요
다음 프롬프트를 Copilot CLI 세션에 붙여넣으세요:
Install the Copilot CLI plugin
다음 프롬프트를 Copilot CLI 세션에 붙여넣으세요:
codex plugin marketplace add microsoft/win-dev-skills
codex plugin add <plugin>@win-dev-skills
Codex는 에이전트가 아닌 스킬을 로드합니다. 이름으로 스킬을 호출하세요 (예: `/winui-setup`).
중요
**과거에 이 카탈로그를 microsoft-winui로 추가했나요?** 이제 이름은 `win-dev-skills`이며, `codex plugin marketplace upgrade`는
“실시간 미리보기와 사용자 정의 제목 표시줄을 갖춘 WinUI 3 마크다운 에디터를 만들어 주세요.”
카탈로그 항목이 새 버전으로 이동할 때, 호스트가 일반적으로 사용하는 명령어로 업데이트하세요:
copilot plugin marketplace update win-dev-skills; copilot plugin update <plugin>@win-dev-skills
claude plugin marketplace update win-dev-skills; claude plugin update <plugin>@win-dev-skills
codex plugin marketplace upgrade win-dev-skills
`v0.7.1`까지의 태그에는 이 저장소 자체에 `winui` 플러그인이 포함되어 있으므로, `https://github.com/microsoft/win-dev-skills.git#v0.7.1`은 여전히 해당 버전을 설치합니다.
Windows 앱 개발을 위한 새로운 플러그인과 기술(skill)은 이 저장소의 `plugins/<name>/` 아래에 플러그인으로, 또는 다른 저장소에서 유지 관리되는 플러그인의 고정된 항목(pinned entry)으로 환영합니다. `CONTRIBUTING.md`를 참조하세요. 카탈로그 또는 설치 문제의 경우, 여기에 이슈를 열어주세요.
대부분의 기여는 기여자 라이선스 계약(Contributor License Agreement, CLA)에 동의해야 합니다. 자세한 내용은 opensource.microsoft.com/cla를 참조하세요. 이 프로젝트는 Microsoft 오픈 소스 행동 강령(Code of Conduct)을 채택했습니다. 지원 채널은 SUPPORT.md를, 보안 문제에 대한 책임 있는 공개(responsible disclosure)는 SECURITY.md를 참조하세요.
이 프로젝트에는 프로젝트, 제품 또는 서비스의 상표나 로고가 포함될 수 있습니다. Microsoft 상표나 로고의 승인된 사용은 Microsoft의 상표 및 브랜드 가이드라인(Trademark & Brand Guidelines)을 준수해야 하며 따라야 합니다. 이 프로젝트를 수정하여 Microsoft 상표나 로고를 사용하는 경우, 혼란을 야기하거나 Microsoft의 후원을 암시해서는 안 됩니다. 제3자 상표나 로고의 사용은 해당 제3자의 정책을 따릅니다.
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다. 제3자 구성 요소와 그 라이선스는 THIRD_PARTY_NOTICES.md에 나열되어 있습니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub Codex tools의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기