nuskey8/UnityAgentClient

영어 | 일본어

Agent Client Protocol (ACP)를 사용하여 모든 AI 에이전트(Gemini CLI, Claude Code, Codex CLI 등)를 Unity 에디터와 통합하는 기능을 제공합니다.

Unity Agent Client는 Zed에서 제안한 Agent Client Protocol (ACP)을 사용하여 모든 AI 에이전트가 Unity 에디터에서 실행될 수 있도록 하는 에디터 확장 기능(editor extension)입니다.

• 모든 AI 에이전트를 Unity 에디터에 통합
• ACP와 호환되는 모든 AI 에이전트 지원 (Gemini CLI, Claude Code, Codex CLI 등)
• 에셋(assets) 및 에디터 정보를 컨텍스트(context)로 활용
• 내장된 MCP 서버 제공

Agent Client Protocol은 AI 에이전트와 코드 에디터를 연결하기 위해 Zed에서 제안한 새로운 프로토콜입니다. 이 프로토콜은 JSON-RPC를 기반으로 하며, MCP (Model Context Protocol)와의 통합을 염두에 두고 설계되었습니다.

Zed는 ACP를 사용하여 외부 AI 에이전트를 에디터에 통합할 수 있게 합니다. Unity Agent Client는 이와 유사한 방식을 채택하여, 에디터 확장 기능으로서 ACP 클라이언트(ACP Client)를 구현함으로써 어떤 AI 에이전트라도 Unity 에디터에서 실행될 수 있도록 합니다.

현재 Gemini CLI는 실험적 지원(--experimental-acp)을 제공하며, Zed의 어댑터(adapters)는 Claude Code, Codex CLI 등에 대한 ACP 호환성을 가능하게 합니다. ACP를 지원하는 AI 에이전트 목록은 다음 페이지에서 확인할 수 있습니다:

Unity 6.2부터는 공식 Unity AI를 사용할 수 있습니다. 그렇다면 왜 Unity Agent Client를 사용해야 할까요?

Unity AI는 Unity에서 제공하는 모델을 사용하므로, 사용자가 자신의 필요에 맞는 최적의 모델을 선택할 수 없습니다. 또한, Unity AI는 전용 토큰(포인트)을 필요로 하므로 Unity 프로젝트를 Unity Cloud에 반드시 연결해야 합니다.

Unity Agent Client는 특정 LLM 제공업체나 에이전트에 의존하지 않으므로, 사용자가 선호하는 AI 에이전트를 에디터에 통합할 수 있습니다. 또한, ACP는 MCP와의 통합을 지원하므로 사용자가 원하는 어떤 MCP 서버든 연결할 수 있습니다.

Unity Agent Client는 Unity 2021.3 이상 버전과 Node.js 런타임(runtime)이 필요합니다.

Unity Agent Client는 NuGet에서 설치해야 하는 AgentClientProtocol 패키지에 의존합니다.

NugetForUnity (권장)를 사용하거나 모든 의존성 패키지를 DLL로 프로젝트에 추가하십시오.

Package Manager를 열고 + > Add package from git URL...에 다음 URL을 입력하십시오.

:

Project Settings > Unity Agent Client를 열고

사용하려는 AI 에이전트에 따라 설정을 입력하십시오.

참고

macOS에서는 zsh에서 PATH (경로) 해결이 실패할 수 있습니다. 오류가 발생하면 which 명령어를 사용하여 바이너리의 전체 경로를 확인한 후 Command (명령어)에 입력하십시오.

경고

설정은 프로젝트의 UserSettings 폴더에 저장됩니다. UserSettings 폴더는 보통 .gitignore에 의해 제외되지만, 실수로 API 키 등을 업로드하지 않도록 주의하십시오.

Gemini CLI

Gemini CLI는 현재 실험적인 ACP (Agent Client Protocol) 지원을 제공합니다. 이는 --experimental-acp 옵션을 지정하여 실행할 수 있습니다.

명령어	인자
gemini	--experimental-acp

로그인을 위해 API 키를 사용하는 경우, 환경 변수 (Environment Variables)에 GEMINI_API_KEY를 추가하십시오.

Claude Code

Claude Code 자체는 ACP를 지원하지 않으므로, Zed에서 제공하는 어댑터를 사용하십시오. 다음 리포지토리의 README를 따라 claude-code-acp를 설정하십시오:

명령어	인자
claude-code-acp	-

Codex CLI

Codex CLI 자체는 ACP를 지원하지 않으므로, Zed에서 제공하는 어댑터를 사용하십시오. 다음 리포지토리의 README를 따라 codex-acp를 설정하십시오:

명령어	인자
codex-acp	-

opencode (권장)

opencode는 CLI에서 실행되는 오픈 소스 AI 에이전트로, 기본적으로 모든 LLM (Large Language Model) 제공업체뿐만 아니라 MCP (Model Context Protocol) 및 ACP를 지원합니다.

명령어	인자
opencode	acp

Goose

Goose는 CLI/데스크톱에서 실행되는 오픈 소스 AI 에이전트로, 기본적으로 모든 LLM 제공업체뿐만 아니라 MCP 및 ACP를 지원합니다.

명령어	인자
goose	acp

Window > Unity Agent Client > AI Agent를 열면

세션에 자동으로 연결됩니다.

• 필드에 프롬프트 (prompt)를 입력하고 Send를 눌러 제출합니다.
• 에셋 (assets)을 창으로 드래그 앤 드롭하여 컨텍스트 (context)로 첨부합니다.
• 도구 (tools)를 실행할 때, 에이전트 (agent)가 권한을 요청할 수 있습니다 (권한 요청 여부는 에이전트의 설정에 따라 달라집니다).
• 사용 중인 에이전트가 지원하는 경우, 전송 시 모드 (modes) 또는 모델 (models)을 전환할 수 있습니다.

Unity Agent Client는 에디터 (editor) 내에서의 코딩을 위해 AI 에이전트를 사용하는 것을 권장하지 않습니다. Unity의 제약 사항으로 인해, C# 스크립트를 편집하면 도메인 리로드 (Domain Reload)가 발생하여 세션 (session)이 끊어지게 됩니다. 또한, Unity 에디터는 AI가 편집한 코드를 검토하기에 적합하지 않습니다. 대신, IDE 또는 코드 에디터 (code editors)에 통합된 AI 에이전트를 사용하십시오.

Unity Agent Client는 전체 Unity 프로젝트를 하나의 문서로 활용하기 위해 AI 에이전트를 사용하는 데 초점을 맞춥니다. 에디터 전체를 컨텍스트 (context)로 사용하여 AI를 활용함으로써, 개발 팀원들은 프로젝트에 대한 이해를 높이거나 문제를 식별하고 병목 현상 (bottlenecks)을 찾아내는 도구로 사용할 수 있습니다.

기존의 MCP 기반 방식은 에디터 외부의 도구를 사용해야 했지만, Unity Agent Client는 에디터 내부에서 작동하므로 창을 빈번하게 전환할 필요가 없습니다.

이 라이브러리는 MIT LICENSE 하에 제공됩니다.