安裝

從 Fab 安裝

到 Fab Marketplace 搜尋 ClaudeUnreal，購買後加入你的 UE5 專案。在 Edit → Plugins → ClaudeUnreal 啟用外掛。
確認有 Python 3.10+ 與 uv

MCP server 已打包在外掛的 Resources/MCP/ 目錄，你本機只需要 Python 跟 uv。
- macOS / Linux
- Windows
Terminal window
python --version # 需要 3.10 以上 uv --version # 若還沒安裝： curl -LsSf https://astral.sh/uv/install.sh | sh
Terminal window
python --version uv --version # 若還沒安裝 uv：https://astral.sh/uv/install.ps1 | iex
設定 Claude

第一次啟動編輯器時，外掛會自動寫入 .mcp.json。如果你用的是 Claude Desktop 或其他 MCP 客戶端，手動設定如下：
```
{
  "mcpServers": {
    "claude-unreal": {
      "command": "python",
      "args": ["<path>/unreal_bridge_server.py"]
    }
  }
}
```
啟動並驗證

開啟啟用了外掛的 UE5 編輯器，TCP bridge 會在 127.0.0.1:55557 啟動。在 Claude Code 下 ping，有成功訊息就代表連線正常。

選擇你的工作方式

內建 terminal tab 只是其中一個入口。編輯器啟動時插件會自動寫入 .mcp.json 與 .claude/settings.local.json，所以任何在專案根目錄啟動的 Claude Code session，對編輯器的控制能力完全相同。

入口	啟動方式	適合
內建 terminal tab	編輯器工具列上的 Claude 按鈕，或 Tools > Claude Code Terminal	不想離開編輯器
自己的 terminal	在專案根目錄執行 `claude`	terminal 原生使用者
VS Code	用裝有 Claude Code 擴充的 VS Code 開啟專案	IDE 使用者
Cursor / 其他 MCP IDE	見 Use with any MCP client	非 Claude Code 的 agent

所有入口共用同一個 MCP bridge、能力相同——差別只在呈現方式。

插件在編輯器裡的所有介面，都收在工具列的這一顆按鈕底下。點按鈕本身會開啟（或聚焦）Claude Code 面板；點旁邊的箭頭則會展開選單：

按鈕本身也會顯示 session 狀態：角落的彩色圓點代表 session 閒置中（綠）、執行中（青）、或正在等你回答（琥珀）——面板被視埠蓋住時特別有用。如果找不到 Claude CLI，按鈕會變灰，tooltip 會說明如何修正。

Agent Status panel 這一項只有在 Project Settings → Plugins → Claude Unreal 裡開啟 Enable Status Panel 後才會出現。