Repolode
Natfii

Natfii/UnrealClaude

Unreal Engine 5.7 에디터에 Claude Code CLI와 채팅 패널, 에디터 제어용 20개 이상의 MCP 도구를 통합하는 플러그인

스타
940
포크
143
열린 이슈
10
마지막 커밋
4개월 전

어떤 프로젝트인가요?

UnrealClaude는 Claude Code CLI를 도킹형 채팅 패널로 에디터 안에서 실행하는 Unreal Engine 5.7 에디터 플러그인입니다. 응답을 실시간으로 스트리밍하고, 도구 호출을 그룹화하며, 코드 블록을 렌더링합니다. 플러그인은 필요할 때 UE 5.7 API 컨텍스트를 추가하고 모듈, 활성화된 플러그인, 설정, 최근 에셋 등 프로젝트 정보를 수집해 현재 프로젝트에 맞는 답변을 제공합니다.

또한 플러그인은 포트 3000에서 20개 이상의 도구를 제공하는 Model Context Protocol (MCP) 서버를 실행합니다. 도구는 액터 조작, 레벨 관리, Blueprint 및 Animation Blueprint 편집, 에셋 검색과 의존성 조회, 머티리얼, Enhanced Input, 뷰포트 캡처를 지원합니다. 기본 설정에서는 스크립트 실행(Python, Live Coding을 통한 C++, 콘솔 명령)에 권한 확인 대화상자가 필요합니다.

플러그인은 Win64, Linux 또는 macOS(Apple Silicon)용으로 소스에서 빌드해야 합니다. 사용자의 기존 Claude Code 인증을 사용하므로 별도의 API 키를 설정할 필요가 없습니다.

핵심 기능

  • 01UE 5.7 에디터에 도킹되는 채팅 패널과 스트리밍 응답
  • 02액터, 레벨, Blueprint, 머티리얼, 입력을 위한 20개 이상의 도구를 제공하는 MCP 서버
  • 03카테고리 또는 키워드별로 필요할 때 제공되는 UE 5.7 API 문서 컨텍스트
  • 04모듈, 플러그인, 설정, 에셋을 바탕으로 자동 수집하는 프로젝트 컨텍스트
  • 05에디터 세션이 바뀌어도 프로젝트별로 저장되는 대화 기록
  • 06권한 확인 대화상자를 거쳐 실행되는 스크립트

활용 사례

  • 에디터에서 작업하며 UE 5.7 C++ 및 Blueprint 워크플로에 관해 Claude에게 질문하기
  • MCP를 통해 AI 에이전트가 액터를 생성하고, Blueprint를 편집하거나 레벨을 관리하도록 하기
  • 대규모 프로젝트에서 에셋 의존성과 참조 항목 조회하기
  • AI의 도움을 받아 Animation Blueprint 상태 머신 프로토타이핑하기

빠른 시작

  1. 1

    Claude Code CLI를 설치합니다

    npm install -g @anthropic-ai/claude-code
  2. 2

    MCP bridge 서브모듈과 함께 저장소를 클론합니다

    git clone --recurse-submodules https://github.com/Natfii/UnrealClaude.git
  3. 3

    사용 중인 플랫폼과 엔진 버전에 맞춰 소스에서 플러그인을 빌드합니다(플랫폼별 RunUAT 명령은 README 참조)

  4. 4

    Resources/mcp-bridge에서 MCP bridge 종속 항목을 설치한 다음 에디터를 실행합니다

    npm install

사용 전 알아둘 점

  • 사전 빌드된 바이너리는 제공되지 않으므로 사용 중인 플랫폼과 엔진 버전에 맞춰 소스에서 빌드해야 합니다.
  • Unreal Engine 5.7의 Win64, Linux, macOS(Apple Silicon)만 지원합니다.
  • README에 라이선스가 명시되어 있지 않아 재사용 조건이 불분명합니다.
  • Blueprint 편집에는 알려진 버그가 있으며, README에서는 이를 전적으로 신뢰하지 말라고 안내합니다.

토픽

자주 묻는 질문

UnrealClaude은(는) 무엇인가요?
Unreal Engine 5.7 에디터에 Claude Code CLI와 채팅 패널, 에디터 제어용 20개 이상의 MCP 도구를 통합하는 플러그인 UnrealClaude는 Claude Code CLI를 도킹형 채팅 패널로 에디터 안에서 실행하는 Unreal Engine 5.7 에디터 플러그인입니다. 응답을 실시간으로 스트리밍하고, 도구 호출을 그룹화하며, 코드 블록을 렌더링합니다. 플러그인은 필요할 때 UE 5.7 API 컨텍스트를 추가하고 모듈, 활성화된 플러그인, 설정, 최근 에셋 등 프로젝트 정보를 수집해 현재 프로젝트에 맞는 답변을 제공합니다.
UnrealClaude은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
UnrealClaude에는 명시된 라이선스가 없습니다. 코드는 공개되어 있지만 라이선스가 없으면 재사용 허가가 명확하지 않으므로, 사용 전에 작성자에게 문의하는 것이 좋습니다.
UnrealClaude은(는) 아직 유지보수되고 있나요?
6개월 이내 업데이트. UnrealClaude의 마지막 커밋은 2026년 6월 26일입니다.
UnrealClaude은(는) 어디에 사용할 수 있나요?
에디터에서 작업하며 UE 5.7 C++ 및 Blueprint 워크플로에 관해 Claude에게 질문하기 MCP를 통해 AI 에이전트가 액터를 생성하고, Blueprint를 편집하거나 레벨을 관리하도록 하기 대규모 프로젝트에서 에셋 의존성과 참조 항목 조회하기 AI의 도움을 받아 Animation Blueprint 상태 머신 프로토타이핑하기
UnrealClaude는 어떻게 설치하나요?
Claude Code CLI를 설치합니다: npm install -g @anthropic-ai/claude-code MCP bridge 서브모듈과 함께 저장소를 클론합니다: git clone --recurse-submodules https://github.com/Natfii/UnrealClaude.git 사용 중인 플랫폼과 엔진 버전에 맞춰 소스에서 플러그인을 빌드합니다(플랫폼별 RunUAT 명령은 README 참조) Resources/mcp-bridge에서 MCP bridge 종속 항목을 설치한 다음 에디터를 실행합니다: npm install
UnrealClaude은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/Natfii/UnrealClaude

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트