[IronBird #0] - 프로젝트 셋업 (GitHub · Git LFS · CLAUDE.md · Claude Code · MCP 서버) - Claude Code 활용기

IronBird 개발일지 #0

프로젝트 셋업

GitHub · Git LFS · CLAUDE.md · Claude Code · MCP 서버

🎯 왜 이 프로젝트를 시작했나

클라이언트 프로그래머 지원을 위한 포트폴리오 준비 중, AI 활용 경험이 필요했다.

목표는 단순히 "AI로 만들어달라"가 아니라, AI를 도구로 쓰면서 내가 판단하고 최적화하는 과정을 기록하는 것.

💡 AI로 [시간단축] → 내가 [문제발견] → 내가 [최적화] → [수치결과]
주어는 항상 나. AI 출력의 품질을 판단할 수 있는 사람이 목표.

📋 프로젝트 개요

프로젝트명	IRONBIRD
장르	종스크롤 우주 슈팅 (갤러그 스타일)
플랫폼	Android (Vulkan)
엔진	Unreal Engine 5.7.4 / C++
목표	30fps 안정 / 드로우콜 100 이하
개발 기간	3~4주 (Claude Code 활용)

🐙 GitHub + Git LFS 세팅

UE5 프로젝트는 바이너리 에셋(.uasset, .umap 등)이 크기 때문에 Git LFS 설정이 필수다. LFS 없이 올리면 나중에 에셋 추가할 때 GitHub 용량 제한에 걸린다.

git lfs install
git lfs track "*.uasset"
git lfs track "*.umap"
git lfs track "*.png"
git lfs track "*.wav"
git lfs track "*.fbx"
git add .gitattributes

.gitignore에서 자동생성 폴더도 반드시 제외해야 레포가 깔끔하게 유지된다.

Binaries/   ← 컴파일 결과물, 빌드 시 자동생성
Intermediate/   ← 중간 빌드 파일
Saved/   ← 로그, 스크린샷 등
DerivedDataCache/   ← 에셋 캐시

🤖 CLAUDE.md 세팅

Claude Code에서 /init 명령어를 실행하면 프로젝트 구조를 실제로 분석해서 CLAUDE.md를 자동 생성해준다.

핵심 설정 의도
"동작 우선, 최적화는 나중에" 원칙을 명시했다.
AI가 처음부터 최적화된 코드를 짜버리면 Before/After 포트폴리오 소재가 사라지기 때문이다.

의도적으로 나쁘게 짜고 직접 개선할 패턴 목록도 명시했다:

Tick 남용 → Timer/Event로 교체
TArray 검색 → TMap O(1)으로 교체
Spawn/Destroy 반복 → Object Pool 도입
하드코딩 수치 → DataTable로 분리

🔌 MCP 서버 세팅

Claude Code는 MCP(Model Context Protocol) 서버를 연결해 기능을 확장할 수 있다. 이번 셋업에서 세 가지 서버를 설치했다.

서버	역할
context7	UE5 공식 문서를 실시간으로 참조. 버전별 최신 API를 컨텍스트에 주입
sequential-thinking	복잡한 문제를 단계별로 분해해 추론. 설계 결정에 활용
unreal-mcpython	UE5 에디터를 AI로 직접 제어. 액터 배치, 에셋 조작 자동화

① context7 · sequential-thinking 설치

두 서버는 npx 기반이라 Claude Code 터미널에서 한 줄씩 실행하면 끝이다.

claude mcp add --scope user context7 -- npx -y @upstash/context7-mcp@latest
claude mcp add --scope user sequential-thinking -- npx -y @modelcontextprotocol/server-sequential-thinking

Windows 주의사항
Windows에서는 npx 실행 시 cmd /c 래퍼가 필요하다. 설치 후 ~/.claude.json을 직접 열어 command를 "cmd", args 앞에 "/c"를 추가해줘야 한다. 그리고 npx가 동작하려면 Node.js와 PowerShell 실행 정책(RemoteSigned) 설정이 선행되어야 한다.

② unreal-mcpython 설치

이 서버는 Python + uv 기반이고, UE5 플러그인 설치까지 필요해서 절차가 조금 더 많다.

1. 사전 도구 설치

pip install uv

2. 레포 클론

git clone https://github.com/GenOrca/unreal-mcp.git C:\unreal-mcp

3. ~/.claude.json에 등록

"unreal-mcpython": {
  "command": "uv",
  "args": [
    "--directory",
    "C:\\unreal-mcp\\mcp-server",
    "run",
    "src/unreal_mcp/main.py"
  ]
}

4. UE5 플러그인 설치

git clone https://github.com/GenOrca/unreal-mcpython.git Plugins\UnrealMCPython

UE5 에디터 재시작 후 편집 → 플러그인에서 UnrealMCPython이 체크되어 있으면 완료다.

최종 결과
Claude Code 내에서 /mcp 명령어 실행 시 세 서버 모두 connected 상태 확인.

📌 다음 포스팅

[IronBird #1] 플레이어 이동 + 터치 입력 구현

Claude Code로 플레이어 폰과 컨트롤러를 생성하고, AI 코드에서 직접 문제를 발견해 수정하는 과정 기록 예정.