# AI 工具接入總覽

使用一個 Felo API key，將終端編碼工具、編輯器和 Agent 平台接入 Felo 模型。選擇用戶端，再設定 API key、協議位址和模型。

使用一個 Felo API key，將終端編碼工具、編輯器和 Agent 平台接入 Felo 模型。選擇用戶端，再設定 API key、協議位址和模型。

## 開始之前

[API Key](https://openapi.felo.ai/console/api-keys)

你需要一個 Felo API Platform key。同一個 key 可用於模型協議、Agent 使用者端、Search、Web Fetch、PPT、Mindmap、LiveDocs、X Search、YouTube Subtitling、Landing Page 和 SuperAgent API。

```bash
export FELO_API_KEY="YOUR_API_KEY"
```

## 選擇你的工具

- [Codex](https://openapi.felo.ai/zh-TW/docs/agent-clients/codex.md)
- [Claude Code](https://openapi.felo.ai/zh-TW/docs/agent-clients/claude-code.md)
- [OpenCode](https://openapi.felo.ai/zh-TW/docs/agent-clients/opencode.md)
- [OpenClaw](https://openapi.felo.ai/zh-TW/docs/agent-clients/openclaw.md)
- [Hermes Agent](https://openapi.felo.ai/zh-TW/docs/agent-clients/hermes-agent.md)
- [TRAE](https://openapi.felo.ai/zh-TW/docs/agent-clients/trae.md)
- [Cursor](https://openapi.felo.ai/zh-TW/docs/agent-clients/cursor.md)
- [Cline](https://openapi.felo.ai/zh-TW/docs/agent-clients/cline.md)
- [Roo Code](https://openapi.felo.ai/zh-TW/docs/agent-clients/roo-code.md)
- [Kilo Code](https://openapi.felo.ai/zh-TW/docs/agent-clients/kilo-code.md)
- [Magpie](https://openapi.felo.ai/zh-TW/docs/agent-clients/magpie.md)
- [其他 AI 工具](https://openapi.felo.ai/zh-TW/docs/agent-clients/other-tools.md)

## 應該選擇哪個 Base URL？

| 工具要求 | 使用這個 Base URL |
|---------------|-------------------|
| OpenAI-compatible endpoint | `https://openapi.felo.ai/api/v1` |
| Anthropic-compatible endpoint | `https://openapi.felo.ai/api` |
| Chat Completions URL | `https://openapi.felo.ai/api/v1` |
| Messages API host | `https://openapi.felo.ai/api` |
| 模型範例 | [Model ID](https://openapi.felo.ai/zh-TW/models) |

## 驗證設定

選擇 Felo provider 中的模型並傳送簡短訊息；編碼任務請使用支援工具呼叫的模型。

## 疑難排解

| 問題 | 檢查專案 |
|-------|---------------|
| 認證失敗 | 確認 key 已正確複製，並已匯出為 `FELO_API_KEY` |
| 工具呼叫了錯誤的 provider | 檢查目前 workspace 或 session 是否已選擇 Felo provider |
| Base URL 錯誤 | OpenAI-compatible 使用者端使用 `https://openapi.felo.ai/api/v1`，Anthropic-compatible 使用者端使用 `https://openapi.felo.ai/api` |
| 找不到模型 | 選擇一個出現在 Felo 模型列表中的模型 |
| 工具忽略本機設定 | 如果使用者端要求使用者層級設定，請把 provider 設定移到使用者層級設定中 |

## 下一步

- [快速開始](https://openapi.felo.ai/zh-TW/docs/getting-started.md)
- [LLM API 參考](https://openapi.felo.ai/zh-TW/docs/guides/protocols.md)
- [Chat API 參考](https://openapi.felo.ai/zh-TW/docs/api-reference/chat.md)
- [SuperAgent API 參考](https://openapi.felo.ai/zh-TW/docs/api-reference/superagent.md)
