유니티 프로젝트를 AI에게 설명할 때는 코드 외에 알려줄 것이 많습니다. 어떤 렌더 파이프라인인지, UI를 무엇으로 만드는지, 에셋을 어디에 두는지 같은 정보입니다. 이 설명을 빼면 결과물이 돌아가더라도 프로젝트의 기존 방식과 달라질 수 있습니다.
Unity의 공식 플러그인에서 기대하는 부분은 이런 작업 지침을 함께 제공한다는 점입니다. 그렇다고 설치만 하면 우리 프로젝트의 관례를 모두 안다고 보기는 어렵습니다. 공식적인 작업 방법과 이 저장소에서 지키는 규칙은 구분해야 합니다.
발표 내용과 현재 설치 방법을 나누어 본다
2026년 9월 9일 발표에서는 Claude Code용 플러그인과 초기 스킬 구성을 소개했습니다. 이 글의 설치 절차는 2026년 9월 22일 확인한 공식 저장소 README를 기준으로 합니다. 현재 지원 대상이 확대되어 있으므로 발표 당시 설명을 근거로 ‘Claude Code에서만 가능하다’고 고정해 두지 않습니다.
스킬 수 역시 업데이트에 따라 바뀔 수 있습니다. 몇 개인지보다 지금 하려는 작업의 지침이 있는지 보는 편이 유용합니다. 예를 들어 UI를 고칠 예정이라면 사용 중인 UI 시스템을 먼저 구분하고 그에 맞는 작업을 하는지가 중요합니다.
마켓플레이스 추가만 하면 설치가 끝난 것은 아니다
Claude Code 세션 안에서 다음 두 명령을 순서대로 입력합니다. 일반 셸에 입력하는 명령이 아니라 세션의 slash 명령입니다.
/plugin marketplace add Unity-Technologies/unity-agent-plugin
/plugin install unity@unity-agent-plugin
첫 줄은 플러그인을 찾을 소스를 등록하고, 두 번째 줄이 플러그인을 설치합니다. 둘을 서로 다른 설치 방법처럼 설명하면 첫 단계만 마친 상태에서 기능이 나타나기를 기다리게 됩니다.
일반 터미널을 사용한다면 공식 저장소가 안내하는 형식은 다음과 같습니다.
claude plugin marketplace add Unity-Technologies/unity-agent-plugin
claude plugin install unity@unity-agent-plugin
설치 후에는 새 세션을 시작하거나 필요한 경우 /reload-plugins로 다시 로드합니다. /plugin에서 설치·활성 상태를 확인하고, /unity: 입력 시 스킬 목록이 보이는지도 봅니다. 설치 범위와 지원 옵션은 사용하는 Claude Code 버전의 도움말을 기준으로 확인하세요.
처음에는 프로젝트를 읽게만 해본다
곧바로 큰 기능을 만들게 하기보다 다음처럼 요청해 볼 수 있습니다.
코드는 수정하지 말고 이 프로젝트의 Unity 버전, 렌더 파이프라인, UI 시스템을 확인해줘. 판단에 사용한 파일도 알려줘. 패키지 추가나 업그레이드는 하지 마.
답에 나온 버전이 ProjectSettings와 Packages의 내용과 맞는지 봅니다. UI 시스템이 여러 개라면 억지로 하나라고 결론내리지 않고 어느 씬이나 영역에서 무엇을 쓰는지 설명하는 편이 낫습니다.
이 단계가 맞으면 테스트 씬의 작은 UI 변경으로 넘어갑니다. 예를 들어 기존 버튼의 간격만 조정하고, 텍스트나 동작은 유지하게 합니다. 변경된 파일, 씬 저장 여부, 플레이 중 레이아웃을 직접 확인합니다.
에디터를 제어해야 하는 작업은 CLI·Pipeline 연결도 준비되어 있어야 합니다. 스킬 목록이 나타나는 것과 씬을 실제로 읽고 수정할 수 있는 것은 별도의 확인 사항입니다.
줄이고 싶은 설명과 남겨야 할 설명
유니티 API 사용법을 매번 길게 붙이는 일은 줄어들 수 있습니다. 하지만 저장소의 폴더 규칙, 사용하지 않기로 한 패키지, 성능 목표, 이번 작업의 변경 범위는 계속 전달해야 합니다. 공식 지침이 우리 팀의 결정까지 대신하지는 않습니다.
효과를 비교하려면 같은 작은 작업을 기준으로 잘못된 파일 생성, 필요 없는 패키지 추가, 사람이 다시 수정한 시간 등을 기록합니다. 플러그인이 공식이라는 이유만으로 토큰 비용이나 오류가 반드시 줄어든다고 단정하지 않습니다.
코드 정리까지 맡길 생각이라면 리팩토링 범위와 프리팹 값 보존을 먼저 정해 두면 좋습니다. 도구를 연결한 다음에도 어떤 변경을 허용할지는 여전히 프로젝트 쪽에서 정해야 합니다.