/ 디렉터리 / 플레이그라운드 / Wegent
● 커뮤니티 wecode-ai ⚡ 바로 사용

Wegent

제작: wecode-ai · wecode-ai/Wegent

YAML로 에이전트 팀을 정의 — Wegent가 실행하고, 공유 메모리를 관리하며, 전문가 간에 작업을 라우팅합니다.

Wegent는 에이전트 팀을 선언적 아티팩트로 취급합니다: 역할, 핸드오프, 공유 메모리의 YAML 스펙을 작성하면 Wegent가 런타임을 제공합니다. 단일 에이전트 프롬프트가 부족할 때 유용합니다.

왜 쓰나요

핵심 기능

라이브 데모

실제 사용 모습

준비됨

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "wegent-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/wecode-ai/Wegent"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "wegent-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/wecode-ai/Wegent"
      ],
      "_inferred": true
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "wegent-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/wecode-ai/Wegent"
      ],
      "_inferred": true
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "wegent-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/wecode-ai/Wegent"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "wegent-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/wecode-ai/Wegent"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json
{
  "context_servers": {
    "wegent-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/wecode-ai/Wegent"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add wegent-skill -- git clone https://github.com/wecode-ai/Wegent

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: Wegent

전문가 팀 구성

👤 Claude Code 사용자 ⏱ ~15 min intermediate

언제 쓸까: 하나의 에이전트로 부족하고 전문가 간 핸드오프가 필요할 때.

흐름
  1. 스펙
    team.yml 작성 — 역할 + 핸드오프.✓ 복사됨
    → 스펙 준비됨
  2. 실행
    wegent run team.yml task.md.✓ 복사됨
    → 에이전트들이 순차 작업
  3. 검사
    트레이스 확인.✓ 복사됨
    → 문서화된 실행

결과: 맞춤 오케스트레이터 코드 없이 멀티 에이전트 실행.

조합

다른 MCP와 조합해 10배 효율

wegent-skill + harness-skill

Harness로 팀을 설계; Wegent로 실행

wegent-skill과 harness-skill 조합: Harness로 팀 설계, Wegent로 실행✓ 복사됨

도구

이 MCP가 노출하는 것

도구입력언제 호출비용
run / inspect (문서 참조) 두 가지 플로우 호출 1회

비용 및 제한

운영 비용

API 쿼터
공급자별
호출당 토큰
N × 일반
금액
무료 OSS; LLM 비용
역할별 token 예산 상한 설정

보안

권한, 시크릿, 파급범위

최소 스코프: multi-provider keys
자격 증명 저장: 키는 환경변수에
데이터 외부 송신: 설정된 공급자로 전송

문제 해결

자주 발생하는 오류와 해결

핸드오프 루프

역할별 명시적 종료 조건 추가

대안

Wegent 다른 것과 비교

대안언제 쓰나단점/장점
직접 작성한 오케스트레이션단일 팀 요구사항일 때선언적 스펙 없음

더 보기

리소스

📖 GitHub에서 공식 README 읽기

🐙 열린 이슈 보기

🔍 400+ MCP 서버 및 Skills 전체 보기