AI CLI 통합 가이드
Claude Code, Codex CLI, Gemini CLI 등 터미널 기반 AI 도구에서 Unity를 제어하는 방법.
ChatGPT 사용자는 여기를 보세요
초보자 친화적ChatGPT(Codex CLI)로 Unity를 제어하고 싶은 분들을 위한 자세한 가이드를 준비했습니다.
이 페이지 소개
이 페이지는 Claude Desktop, Cursor, VS Code (Copilot) 이외의 AI 도구로 Unity를 제어하려는 사용자를 위한 가이드입니다.
Claude Desktop, Cursor, VS Code (Copilot)을 사용하시는 분은 설정 가이드 를 참조하세요 (원터치 설정 가능).
필요 사항
- Node.js 18 이상 (설치하지 않은 경우 nodejs.org 에서 다운로드)
- 아래 CLI 도구 중 하나
- Synaptic AI Pro v1.1.4 이상
CLI 도구 설치
사용하는 AI 서비스에 맞는 도구를 설치하세요.
Claude Code
AnthropicAnthropic 공식 CLI. 강력한 코드 이해 및 생성 능력.
npm install -g @anthropic-ai/claude-codeCodex CLI
OpenAIOpenAI 공식 CLI. ChatGPT Plus 이상 구독 필요.
npm install -g @openai/codexGemini CLI
GoogleGoogle 공식 CLI. 무료 사용량 제공 (60요청/분).
npm install -g @google/gemini-cliVS Code / Cursor 확장
기타VS Code나 Cursor 확장 (Codex 확장 등)을 사용하는 경우에도 이 방법이 필요합니다.
확장은 에디터의 MCP 설정을 사용할 수 없어 HTTP API로 연결합니다.
사용 방법 (5단계)
Setup Window 열기
Unity 메뉴에서 Tools → Synaptic Pro → Setup Window 선택
HTTP 탭으로 전환
HTTP Server 탭을 클릭해서 전환
프롬프트 복사
Copy Prompt Template 버튼 클릭
CLI에 붙여넣기
Claude Code, Codex CLI, Gemini CLI 등에 프롬프트 붙여넣기
포인트
HTTP 엔드포인트를 호출할 뿐이므로 CLI는 어느 디렉토리에서든 실행할 수 있습니다. 서버는 Unity에서 시작하므로 CLI에서 cd 명령이 필요 없습니다.
이제 AI에게 말하면 됩니다. "빨간 큐브 만들어줘" 같은 명령을 시도해 보세요.
💡꿀팁: Skills로 자동화
CLI의 Skills 기능을 사용하면 매번 템플릿을 붙여넣을 필요가 없습니다.
설정 방법:
- Unity Setup Window의 HTTP 탭에서 프롬프트 복사
- CLI에 "이 내용으로 skill 만들어줘" 라고 지시
- 이후부터 템플릿이 자동으로 적용됨
Thanks: Synaptic AI 사용자
HTTP 서버 시작
Start HTTP Server 버튼을 클릭하면 완료!
완료!
이제 AI에게 말하면 됩니다. "빨간 큐브 만들어줘" 같은 명령을 시도해 보세요.
대화 예시
문제 해결
'node: command not found' 오류
Node.js가 설치되지 않았습니다. nodejs.org에서 설치하세요.
'Connection refused' 오류
Unity Editor가 실행 중인지 확인하세요. Synaptic AI Pro가 설치되어 있는지도 확인하세요.
AI가 서버를 시작할 수 없음
Unity 프로젝트 폴더에서 작업 중인지 확인하세요. Assets/Synaptic AI Pro/MCPServer 폴더가 있는지 확인하세요.
[Windows] curl 명령이 작동하지 않음
Windows PowerShell에서 'curl'은 Invoke-WebRequest의 별칭일 수 있습니다. 'curl.exe http://localhost:8086/health'를 사용해 보세요.