# 代理與模型 — AI Game Dev 應用程式與 CLI · AI Game Developer Wiki

在 AI Game Dev 應用程式與 CLI 中選擇 AI 模型、推理強度與代理，控制工具核准，並在自己的 GPU 上執行本機 AI 模型。

本頁面由英文機器翻譯而成。[閱讀英文原文](https://ai-game.dev/docs/wiki/app/agents-and-models)。

AI Game Dev 應用程式讓你選擇由哪個 AI 模型回答、它思考得多用力、由哪個代理角色負責這項任務，以及它能使用哪些工具。本頁說明模型選擇器、供應商與可用性、代理與技能、核准、計畫模式、語音輸入，以及在你自己的電腦上執行的本機模型。

## 模型與供應商

應用程式提供來自多家供應商的託管聊天模型：Anthropic 的 Claude 系列、OpenAI 的 GPT 系列、DeepSeek 與 Google 的 Gemini。確切清單並非內建於應用程式中：它會依你的帳號從 ai-game.dev 取得，因此永遠符合你的方案與地區。新帳號會從伺服器指派的預設模型開始。

決定你是否能使用某個模型的因素：

- **方案。** 部分模型需要特定方案，例如 Studio 或更高階的方案。請參閱[定價頁面](https://ai-game.dev/pricing)。
- **地區。** 可用性取決於你帳單地址所在的國家。請參閱[模型可用性頁面](https://ai-game.dev/model-availability)。
- **年齡。** 少數模型要求你已在帳號中確認自己年滿 18 歲。

無法使用的模型仍會列出，並在其名稱下方顯示原因。

## 在桌面應用程式中選擇模型

1. 開啟一個聊天。輸入區控制列中的模型標籤會顯示目前的模型。
2. 點擊該標籤即可開啟模型清單。
3. 選擇模型。無法使用的模型會說明原因，例如升級提示或「無法在你的地區使用」。清單底部會顯示你的可用性所依據的地區。

支援的模型還有**推理強度**設定。強度越高，越適合困難的設計與除錯任務；強度越低，例行編輯就越快。

每個窗格各自保留自己的模型、推理強度與代理。一個實用的配置是：在一個窗格使用大型模型來規劃並建置功能，在第二個窗格使用較快的模型來回答快速問題。請參閱[工作區](https://ai-game.dev/zh-hant/docs/wiki/app/workspace#panes)。

## 在 CLI 中選擇模型

輸入 `/model` 即可開啟模型選擇器。使用方向鍵與 Enter 選擇；Tab 可切換推理強度。你也可以在啟動時選擇模型：

```bash
gamedev --model <model-id>
```

如果你指定的模型無法供你的帳號使用，CLI 會告知你，並請你改用 `--model` 或 `/model` 另選一個。

**提示**

同樣的工作量，較便宜、較快的模型會佔用你每月額度較小的百分比。請把最大的模型留給真正需要它們的任務。

## 代理與技能

除了模型之外，一個工作階段還有**代理**：一個帶有自身指示的角色，例如專精某類工作的專家。清單包含 Claude agent SDK 內建的代理，以及你專案 Claude 設定中定義的代理或由 Claude 外掛新增的代理。

在 CLI 中：

```text
/agent                    list the agents and show the active one
/agent use <agent-id>     switch this session to an agent
/agent refresh            ask for the agent list again
/skills                   list the skills available in this project
```

在桌面應用程式中，每個窗格各自保留自己的代理，就像各自的模型一樣。

技能、指令與代理可透過 Claude 外掛（**Settings**、**Claude Plugins**，或在 CLI 中使用 `/plugin`）以及套件加入。請參閱[套件](https://ai-game.dev/zh-hant/docs/wiki/app/packages)。

## 工作階段工具

每個工作階段會選擇要攜帶哪些工具。輸入區上方的 **Tools 列**會列出你已安裝套件中的工具（Blender、Music、Knowledge Base、Image Gen、Video、Tripo、Cloud generation），並僅針對此工作階段逐一開啟或關閉。在 CLI 中，開啟 `/config` 並使用 **Tools** 區段。

每個工具都會佔用代理上下文的一部分，因此只攜帶任務所需工具的工作階段會更快，也較不容易選錯工具。變更會從下一則訊息起生效，不需重新啟動聊天。

## 核准與權限

當你的核准政策要求時，代理會在執行工具前先詢問。共有三種模式：

| 模式 | 代理何時詢問 |
| --- | --- |
| 每次詢問 | 在 AI 執行每一個工具之前都詢問，即使在專案內也一樣。最安全，但中斷次數最多 |
| 僅在專案外詢問（預設） | 當它觸及專案資料夾以外的範圍，或試圖變更專案本身的權限設定時。在專案內則不需詢問即可讀取、寫入與執行命令 |
| 永不詢問 | 永不詢問。AI 可以在你機器上的任何位置讀取、寫入與執行命令 |

**警告**

在預設模式下，shell 命令會在專案內未經提示直接執行，因此 AI 可以在你的機器上執行程式碼。「永不詢問」則將此擴及你的整部電腦；請僅在信任該任務時使用。

你也可以信任專案以外的額外資料夾；針對這類路徑的核准提示會提供永遠允許該資料夾的選項。在 **Settings**、**Permissions** 中，或在 CLI 中變更模式：

```text
/permissions                     show the mode and trusted folders
/permissions always              ask every time
/permissions outside-project     ask only outside the project
/permissions never               never ask
/permissions trust <folder>      trust a folder and everything in it
/permissions untrust <folder>    stop trusting a folder
/permissions timeout on          auto-deny a request left unanswered for 5 minutes
```

變更會從下一回合起生效。

## 計畫模式與提問

計畫模式是輸入區中的一個工作階段專屬開關。開啟後，代理可以讀取檔案並搜尋專案，但所有變更都會被拒絕，直到它提出計畫並經你核准。代理也可以提出釐清問題，而你可以趁它工作時排入後續訊息。[計畫模式](https://ai-game.dev/zh-hant/blog/plan-mode-ai-agent-game-development)一文完整走過一個功能的流程。

## 語音輸入

按鍵說話在兩種前端皆可使用：在聊天輸入區按住 Space（或在桌面應用程式中使用麥克風按鈕）、說話，然後放開。語音會在你的電腦上以本機 Whisper 模型轉錄；無需安裝任何東西。在 **Settings**、**Voice** 中設定語言，或在 CLI 中使用 `/voice-language`。

## 在自己的 GPU 上執行本機模型

聊天模型是託管的，但媒體模型可以在你的電腦上執行，免費且不佔用你的額度：

- **本機影像生成**：FLUX、以 SDXL 為基礎的模型、Qwen-Image、Qwen-Image-Edit、Z-Image Turbo 等，由 stable-diffusion.cpp 執行。請在工作階段的 Tools 列中開啟 **Image Gen**。
- **本機影片生成**：LTX-2.5 與 Wan 2.2 TI2V 5B。請開啟 **Video**。

模型是以套件形式提供，只會在你核准後才下載。應用程式會檢查你的 GPU、視訊記憶體與驅動程式，並推薦你的電腦能執行的模型。可在 Packages 視窗的 **Models** 分頁中管理，或在 CLI 中使用 `/images` 與 `/models`。完整清單與硬體需求請見[套件目錄](https://ai-game.dev/zh-hant/docs/wiki/app/packages-catalog#local-image-models)。

雲端媒體模型（影片、語音、音效與音樂）則在 AI Game Dev 伺服器上執行，並會使用你的額度；請參閱[雲端生成](https://ai-game.dev/zh-hant/docs/wiki/app/packages-catalog#cloud-generation)。

## 延伸閱讀

- [最佳實務](https://ai-game.dev/docs/best-practices)：依各引擎撰寫需求。
- [遊戲的本機 AI 影像生成](https://ai-game.dev/zh-hant/blog/local-ai-image-generation-for-games)與[本機 AI 影片生成](https://ai-game.dev/zh-hant/blog/local-ai-video-generation-on-your-gpu)。
- [套件](https://ai-game.dev/zh-hant/docs/wiki/app/packages)：為代理加入工具。

---

Source (HTML): https://ai-game.dev/zh-hant/docs/wiki/app/agents-and-models

Machine-translated (zh-Hant) from the English page: https://ai-game.dev/docs/wiki/app/agents-and-models