게임 개발

게임 프로그래밍할 때 유니티 클로드 코드 플러그인을 써야 하는 이유

유니티 공식 클로드 코드 플러그인을 직접 깔아 써본 기록. 스킬 29개가 실제로 무엇을 덜어주는지, 챗GPT용이라는 소문은 왜 틀렸는지 정리했다.

CodingJoa 8분 정도 걸립니다
검은 배경 가운데에 유니티 큐브 로고와 앤트로픽의 주황색 별 모양 심볼이 세로 구분선을 사이에 두고 나란히 놓인 이미지.

터미널에 명령어 한 줄을 붙여넣고 엔터를 쳤다. 그러고는 클로드 코드 세션에서 평소처럼 짤막한 프롬프트를 하나 던졌다. 전과 달랐다. 이 유니티 프로젝트가 어떤 구조로 굴러가는지 내가 일일이 읊어주지 않았는데도 알아서 붙었다. 유니티 클로드 코드 플러그인이 드디어 나왔고, 나는 그날 저녁 내내 이것만 만지작거렸다.

검은 배경 가운데에 유니티 큐브 로고와 앤트로픽의 주황색 별 모양 심볼이 세로 구분선을 사이에 두고 나란히 놓인 이미지

코드가 줄었다는 말이 아니다

써보고 가장 먼저 체감한 건 “코드가 줄었다"가 아니다. 설명이 줄었다는 쪽에 훨씬 가깝다.

예전에는 클로드 코드에게 유니티 작업을 맡기려면 앞머리에 사족을 잔뜩 달아야 했다. 이 프로젝트는 URP를 쓴다, 머티리얼은 이 폴더에 넣는다, UI는 uGUI가 아니라 UI Toolkit으로 통일했다. 이 대목을 빼먹으면 결과물이 엉뚱하게 나왔고, 그걸 되돌리느라 또 몇 턴을 태웠다.

플러그인을 붙인 뒤로는 그 서두를 거의 생략하게 됐다. 한두 문장짜리 지시만으로 엔진 기능에 바로 손이 닿았다. 나는 이게 AI 코딩 도구의 진짜 진전이라고 본다. 모델이 더 똑똑해지는 것보다, 모델이 내 작업 환경의 관례를 미리 알고 있는 것이 체감 차이를 훨씬 크게 벌린다.

한 번 깔면 세 덩어리가 들어온다

유니티 공식 블로그에 따르면 이 플러그인은 2026년 9월 9일 공개됐다. 유니티 AI 제품 담당 이사 Rachel Zhao는 발표문에서 이걸 “유니티의 엔지니어링 스킬과 Unity CLI, 그리고 라이브 에디터 제어를 위한 Unity MCP 서버를 함께 설치하는 퍼스트파티 플러그인"이라고 소개했다.

구성하는 일
엔지니어링 스킬 29개UI·2D·렌더링·오디오·수익화 등 영역별 작업 지침
Unity CLI터미널에서 에디터 실행, 빌드, 라이선스, 로그 처리
Unity MCP 서버실시간 에디터 제어 — GameObject 생성·수정, 씬/에셋 편집, C# 실행

내가 가장 크게 본 건 세 번째다. 스킬은 결국 잘 정리된 문서에 가깝다. 하지만 MCP 서버가 물리면 에이전트가 에디터를 직접 만진다. 읽고 조언하던 도구가 손을 대는 도구로 넘어가는 선이 여기 그어져 있다.

스킬 29개, 어디가 두툼한가

배분을 훑어보면 무게가 어디 실렸는지 대번에 보인다.

범주스킬 수대표 항목
UI·텍스트5개UI Toolkit, uGUI, IMGUI, TextMeshPro 최적화
2D·스프라이트7개픽셀 퍼펙트, 스프라이트 에디터, 타일맵, RuleTile
그래픽·렌더링3개URP 후처리, Shader Graph, Render Graph 검증
오디오3개오디오 믹서, 최적화, Vivox 음성채팅
씬·게임플레이2개AI Navigation, 3D 물리 충돌
수익화·라이브옵스3개IAP, LevelPlay, 라이브 게임 운영
멀티플레이1개멀티플레이 서비스
플랫폼·현지화2개WebGL 최적화, 로컬라이제이션
시작·도구3개새 프로젝트 생성, Unity CLI, 패키지 관리

이 분포에 유니티의 판단이 그대로 드러난다. UI와 2D는 어렵진 않은데 손이 지독하게 많이 가는 영역이다. RuleTile 하나 세우겠다고 3×3 패턴을 일일이 찍어본 사람은 안다. 유니티는 어려운 문제가 아니라 지겨운 문제를 먼저 자동화 대상으로 골랐다.

/ui 스킬 설명이 특히 눈에 들어왔다. 공식 문서대로면 이건 일종의 교통정리 담당이다. UI 코드를 쓰기 전에 이 프로젝트가 어느 UI 시스템을 쓰는지 먼저 알아채고, 그 다음 UI Toolkit·uGUI·IMGUI 중 맞는 쪽으로 넘긴다. 내가 매번 손으로 타이핑하던 그 한 문장이 스킬 안에 들어가 앉은 셈이다.

설치는 명령어 한 줄

경로는 두 가지다.

  1. 터미널에서 claude plugin install unity@unity-agent-plugin 실행
  2. 클로드 코드 세션 안에서 /plugin marketplace add Unity-Technologies/unity-agent-plugin 입력

터미널이 번거로우면 GUI로도 된다. 클로드 데스크톱 설정에서 Plugins로 들어가면 디렉터리 검색창이 뜨는데, 거기에 Unity를 치면 Partners 탭 아래 Unity Technologies 항목이 하나 나온다. 옆의 + 버튼을 누르면 끝이다.

클로드 설정의 Plugins 화면. Directory 목록에 Skills, Connectors, Plugins가 있고 검색창에 Unity를 입력하자 Partners 탭 아래 Unity Technologies의 Unity 플러그인이 + 버튼과 함께 표시된 모습

지금 프로젝트에만 적용하고 싶으면 --scope local 옵션을 붙인다. 내가 권하는 순서는 이렇다.

  • 클로드 코드를 최신 버전으로 올린다
  • 버려도 되는 테스트 프로젝트를 골라 --scope local로 먼저 깐다
  • 이 프로젝트가 URP인지 Built-in인지부터 확인한다
  • 해당 파이프라인 스킬 하나만 돌려본다
  • 결과가 납득되면 그때 전역 설치로 넘어간다

메인 프로젝트에 곧장 붙이지 않는 이유는 하나다. MCP 서버가 에디터를 실시간으로 제어한다는 건, 뭔가 어긋났을 때 씬과 에셋이 실제로 바뀐다는 뜻이기도 하다. 나는 신세계라고 느꼈지만, 신세계일수록 첫 실험은 날려도 아깝지 않은 곳에서 하는 게 맞다.

‘챗GPT용’이라는 소문은 틀렸다

소식이 퍼지는 과정에서 엉킨 대목이 하나 있었다. 9월 11일 밤 국내 스레드에 “이제 챗GPT로 유니티 게임 개발을 직접 할 수 있다"는 요지의 글이 돌았다. 하지만 플러그인이 붙는 자리는 챗GPT가 아니라 앤트로픽의 클로드 코드다.

유니티 공식 발표가 그렇게 명시하고 있고, ZDNet Korea·인벤·경향게임스 같은 국내 매체도 9월 10일 일제히 “클로드 코드용 공식 유니티 플러그인"으로 보도했다. 클로드 코드는 유니티가 퍼스트파티 플러그인을 내준 첫 번째 코딩 에이전트다.

이런 착오가 되풀이되는 건 단순 실수가 아니라고 본다. 국내에선 ‘AI 코딩 = 챗GPT’라는 등식이 여전히 기본값으로 깔려 있다. 코딩 에이전트 판의 실제 지형과 대중의 인식 사이에 시차가 있는 것이다. 관련 소식을 접하면 어느 모델, 어느 에이전트 얘기인지 한 번씩 짚고 넘어가길 권한다.

커뮤니티 MCP와 뭐가 다른가

유니티 MCP 서버 자체는 새 개념이 아니다. 커뮤니티가 만든 물건이 진작 있었다. 갈리는 지점은 ‘누가 만들고 누가 돌보느냐’다.

구분커뮤니티 도구유니티 퍼스트파티 플러그인
작성·검수제작자마다 제각각유니티 엔지니어 작성, 보안 검토
엔진 업데이트 대응각자 따라가야 함유니티가 스킬과 함께 갱신
프로젝트 구조 파악대화 중에 추측스킬에 미리 내장
MCP 서버 구성손으로 설정함께 자동 설치

유니티는 공식 블로그에서 스킬을 쓰면 “출력 오류가 더 적고, 토큰 효율이 더 높고, 더 적은 턴으로 작업이 끝난다"고 밝혔다. 다만 이건 어디까지나 만든 쪽 설명이고 구체적 수치는 나오지 않았다. 내 체감으로도 오가는 대화가 짧아진 건 분명한데, 몇 퍼센트라고 말할 근거는 내게 없다. 이건 각자 자기 프로젝트에서 재봐야 할 몫이다.

비용은 어떻게 되나

플러그인 설치 자체에 붙는 요금은 없다. 유니티 공식 페이지에도, 클로드 플러그인 페이지에도 이용료 얘기는 없다.

대신 짚어둘 게 있다. 실제 지출은 이미 쓰고 있는 클로드 코드 요금제의 사용량에서 빠져나간다. 에이전트가 에디터를 직접 주무르는 작업은 왕복이 늘어나기 쉽다. 자동화 범위를 크게 잡을 생각이라면 한도 구조부터 확인해두는 편이 낫다.

이 흐름이 향하는 곳

유니티는 연내 다른 코딩 에이전트로도 지원을 넓히겠다고 했다. 다음 차례가 어디인지는 공식 발표에 없다. 확인되지 않은 영역이니 어디가 유력하다는 식의 짐작은 접어두는 게 맞다.

분명한 건 방향이다. 유니티 공식 블로그는 이제 브라우저를 열고 엔진을 내려받는 대신, 코딩 에이전트에게 만들고 싶은 게임을 설명하는 것으로 시작하는 사람이 늘고 있다고 썼다. 사용자가 아니라 에이전트가 엔진을 고르는 일이 실제로 벌어지고 있다는 얘기다.

그렇다면 엔진 제작사 입장에서 퍼스트파티 플러그인은 선택지가 아니다. 에이전트가 엔진을 고르는 세상에서는 공식 매뉴얼을 미리 쥐여준 엔진이 기본값이 된다. 이번 발표를 단순한 편의 기능 추가로 보지 않는 이유가 여기 있다.

마치며

  • 명령어 한 줄로 스킬 29개 + Unity CLI + Unity MCP 서버가 한꺼번에 들어온다.
  • 내가 느낀 가장 큰 변화는 코드량이 아니라, 프롬프트 앞머리에 붙이던 프로젝트 설명이 사라진 것이다.
  • 스킬은 UI 5개·2D 7개로 손 많이 가는 쪽에 쏠려 있다. 어려운 작업보다 지겨운 작업을 먼저 겨냥했다.
  • 챗GPT용이 아니라 클로드 코드 전용이다. 유니티 퍼스트파티 플러그인을 받은 첫 코딩 에이전트다.
  • MCP 서버가 에디터를 실제로 제어하니, 첫 설치는 --scope local로 테스트 프로젝트부터 하는 게 안전하다.

자주 묻는 질문

Q. 챗GPT에서도 이 플러그인을 쓸 수 있나?

못 쓴다. 2026년 9월 기준 클로드 코드 전용이다. 소셜에 “챗GPT용"이라는 설명이 돌았지만 유니티 공식 발표와 국내 매체 보도 모두 클로드 코드를 못 박고 있다.

Q. 설치 비용이 따로 드나?

설치는 무료다. 다만 스킬을 굴리는 과정은 이미 가입한 클로드 코드 요금제의 사용량에서 빠진다. 큰 작업을 자동화할 계획이면 한도부터 확인해두는 게 좋다.

Q. 설치 명령어가 뭔가?

터미널에서 claude plugin install unity@unity-agent-plugin을 실행하거나, 클로드 코드 세션에서 /plugin marketplace add Unity-Technologies/unity-agent-plugin을 입력하면 된다. 설정 화면의 Plugins 디렉터리에서 Unity를 검색해 추가해도 똑같다. 지금 프로젝트에만 적용하려면 --scope local을 붙인다.

Q. 기존 커뮤니티 Unity MCP 서버와 뭐가 다른가?

만들고 검수한 주체가 갈린다. 퍼스트파티 스킬은 유니티 엔지니어가 직접 쓰고 보안 검토를 거쳤으며, 엔진 업데이트에 맞춰 유니티가 갱신한다. 커뮤니티 도구는 품질도 유지보수 여부도 프로젝트마다 다르다.

Q. 어떤 작업에서 효과가 큰가?

URP 후처리, UI Toolkit 화면 구성, 2D 타일맵·스프라이트 편집, IAP·LevelPlay 광고 연동, 멀티플레이 설정처럼 엔진 특유의 설정이 빽빽한 작업에서 효과가 크다는 게 유니티 측 설명이다. 내 경험으로도 프로젝트 관례를 일일이 일러줘야 했던 작업일수록 차이가 도드라졌다.

이 글 공유하기 X Facebook 네이버

이 글의 내용은 작성 시점에 직접 실행하고 확인한 결과와 글쓴이 개인의 판단을 담은 기록입니다. 도구의 버전·가격·동작은 시간이 지나면 달라질 수 있으니, 따라 하실 때는 공식 문서를 함께 확인해주세요. 자세한 내용은 이용약관에 정리해두었습니다.