Skip to content

AiChat.ko

github-actions[bot] edited this page Oct 19, 2026 · 1 revision

AI 채팅

English

AgentMcpChat 에디터 모듈은 에디터 안에 채팅 패널을 추가합니다. 기획자와 아티스트도 코딩 에이전트를 따로 설정하지 않고 프로젝트에 대해 묻고 변경을 맡길 수 있습니다. 각자 자기 계정으로 로그인하며, 패널은 실행 중인 에디터의 서버를 통해 다른 MCP 클라이언트와 같은 도구를 씁니다. 패널은 한국어로 되어 있습니다.

창 > Agent MCP > AI 채팅 또는 레벨 에디터 툴바의 AI 채팅 버튼으로 엽니다.

공급자

공급자 로그인 실행
Claude Code (로그인) Claude 계정 claude CLI
ChatGPT (Codex 로그인) ChatGPT 계정 codex CLI
Gemini (Antigravity 로그인) Google 계정(Google Workspace 포함) agy CLI
ChatGPT (OpenAI API), Gemini (Google API) API 키 에디터에서 HTTP
OpenAI 호환 서버 키 선택 OpenAI chat completions API를 쓰는 서버(예: 로컬 Ollama)

패널의 계정은 공급자마다 CLI가 설치되어 있는지, 로그인되어 있는지 보여 주고 설치 후 로그인, 로그인, 로그아웃(Claude Code, Codex)을 제공합니다. 설치는 각 CLI의 공식 PowerShell 스크립트로 합니다. 툴바의 모델과 추론 선택 목록은 로그인한 계정이 쓸 수 있는 것을 보여 줍니다. Codex 모델은 codex debug models, Antigravity 모델은 agy models에서 가져옵니다.

권한 모드

툴바의 권한은 모델이 무엇을 바꿀 수 있는지 정합니다. 어떤 모드든 변경은 패널의 승인 카드를 기다립니다.

모드 추가로 쓸 수 있는 도구
읽기 전용 Read 도구만
에셋 편집 액터, 레벨, 에셋, 블루프린트, UMG, DataTable, 스트링 테이블, 애니메이션, 오브젝트 도구와 editor_undo, editor_redo
코드 편집 source_write, source_replace, livecoding_compile
에셋 + 코드 편집 둘 다

어떤 모드에서든 열고 보여 주는 것은 할 수 있습니다. editor_open_assets, editor_show_in_content_browser, actor_select, viewport_set_camera는 카드 없이 실행합니다. level_open은 열린 레벨을 바꾸므로 모든 모드에서 허용하되 먼저 묻습니다. tools_call은 제공하지 않습니다.

모드는 두 번 적용됩니다. CLI에는 허용된 도구만 제공하고, CLI가 다른 도구를 부르면 에디터의 승인 게이트가 거부합니다(안전장치 참고). 승인 카드에는 승인, 거부, 이번 질문 동안 모두 승인이 있습니다.

CLI가 접근할 수 있는 범위

CLI는 각자 Saved/AgentMcpChat/<CLI> 폴더에서 내장 도구 없이 실행됩니다. 셸, 파일 접근, 웹이 없고, 프로젝트에는 에디터의 MCP 도구로만 접근하며 코드는 소스 도구로 읽습니다.

  • Claude Code는 --strict-mcp-config, --restricted(사용자 설정 파일과 hook 무시), --permission-prompts none, --tools ""로 실행합니다.
  • Codex는 --ignore-user-config, --ignore-rules, 읽기 전용 sandbox, 웹 검색 끔으로 실행하고 셸, 브라우저, 앱, plugin, 하위 에이전트 기능을 끕니다. 사용자의 ~/.codex/config.toml은 읽지도 바꾸지도 않고, ~/.codex의 로그인만 씁니다.
  • Antigravity는 자기 폴더의 .agents/mcp_config.json으로 서버를 받습니다. agy -p는 권한을 물을 수 없어서, 패널이 ~/.gemini/antigravity-cli/settings.json에 mcp(agentmcp-chat/*) 규칙을 한 번 추가합니다. 변경 여부는 여전히 에디터의 승인 게이트가 정합니다. 거부된 호출 뒤 CLI가 턴을 끝내면 패널이 한 번 다시 시도합니다.

대화

대화 목록은 이전 대화를 보여 주고 새 대화는 새로 시작합니다. 대화는 프로젝트별로 Saved/AgentMcpChat/Conversations/<id>.json에 저장되고, 시작한 CLI 세션을 이어 갑니다. 패널은 한 번에 질문 하나에 답합니다.

설정

사용자별 설정은 프로젝트가 아니라 사용자의 EditorSettings.ini에 저장되므로 API 키가 커밋되지 않습니다. 에디터 환경설정 > 플러그인 > AI 채팅에 있습니다.

설정 의미
공급자, 권한 모드 패널에서도 고름
실행 파일 claude.exe, agy.exe, codex.exe 경로. 비워 두면 설치 위치와 PATH에서 찾음
API 키 OpenAI와 Gemini 키. 비워 두면 OPENAI_API_KEY, GEMINI_API_KEY 사용
OpenAI 호환 서버 사용자 서버의 기본 URL, 키, 모델
제한 API 공급자의 도구 라운드와 요청 제한 시간

고른 모델과 추론 수준도 이 설정에 저장되지만 고르는 곳은 패널뿐입니다.

콘솔 명령 AgentMcpChat.Ask <질문>은 현재 설정으로 질문을 보내고 대화를 로그(LogAgentMcpChat)에 남깁니다. 패널 없이 공급자를 확인할 때 씁니다. AgentMcpChat.Ask reset은 처음부터 다시 시작합니다.

한계

  • Windows 전용입니다. 설치와 로그인 명령이 Windows 기준입니다.
  • Antigravity를 통한 Gemini 모델의 추론 수준은 낮음, 보통, 높음만 됩니다.
  • 패널은 Unreal Engine 5.7.4에서 Claude Code, Codex, Antigravity로 써 봤습니다. API 공급자는 덜 써 봤습니다.

Clone this wiki locally