# Fx

來源: https://docs.aicentos.com/zh-TW/clients/fx

Language: zh-TW

> 在 Fx 中使用 aicentos —— 透過使用者層級 settings.json 新增自訂模型連線

Fx 是 Vercel Labs 出品的編碼代理，用 Zig 寫成單一原生二進位檔，與模型無關。自訂模型連線定義在使用者層級的 `~/.fx/settings.json` 中，把 base URL 指向 aicentos 即可。

**先說明一個容易踩的坑：** 專案根目錄裡的 `.fx.json` 是另一回事，它刻意不允許多數欄位（包括模型），防止複製下來的儲存庫把你的模型或端點換掉。**自訂端點必須寫在 `~/.fx/settings.json`**，寫在 `.fx.json` 裡不會生效。

## 準備工作

先在控制台「API Key」頁面為 Fx 建立一個專用 Key（建議命名 `fx`，方便追蹤用量）：

* 控制台：[https://aicentos.com](https://aicentos.com)
* 建立 Key：[https://aicentos.com/keys](https://aicentos.com/keys)
* 餘額不足時儲值：[https://aicentos.com/wallet](https://aicentos.com/wallet)

確認已安裝 Fx：

```bash
curl -fsSL https://fx.sh/setup.sh | bash
fx --version
```

## 需要填寫的設定

| 欄位       | 值                         |
| -------- | ------------------------- |
| 設定檔      | `~/.fx/settings.json`     |
| Base URL | `https://aicentos.com/v1` |
| API Key  | 控制台建立的 Key                |
| 模型       | 控制台「模型廣場」中的模型名稱           |

## 設定步驟

### 1. 編輯使用者層級設定

在 `~/.fx/settings.json` 中按「自訂模型連線」的格式登記一個連線。連線物件的欄位結構以官方文件為準：

* 文件入口：[https://fx.sh/docs](https://fx.sh/docs)
* README：[https://github.com/vercel-labs/fx](https://github.com/vercel-labs/fx)

把連線裡的 API 位址填為：

```
https://aicentos.com/v1
```

API Key 填控制台建立的那一個，模型名稱以控制台「模型廣場」為準。

### 2. 指定使用該連線

Fx 允許在啟動時指定 provider 與模型：

```bash
fx provider local FX_MODEL=gpt-4o fx ask "用一句話回答：1+1 等於幾"
```

也可以用環境變數指定：

```bash
export FX_MODEL="gpt-4o"
```

### 3. 確認目前 provider

Fx 會按 provider 記住選擇，下次啟動沿用上次的 provider。

## 測試

先用一條無副作用的提示詞驗證連通：

```bash
fx ask "用一句話回答：1+1 等於幾"
```

能正常返回即接入成功。若回報驗證錯誤，優先檢查 base URL 是否帶 `/v1`、API Key 是否有多餘空格。

## 注意事項

* **不要改 `.fx.json`**。專案層級檔案只允許 `provider_order`、`provider_strict` 等少數幾個欄位，沒有 `model` 欄位，也不用於設定自訂端點。
* `provider_order` / `provider_strict` 是 Vercel AI Gateway 的路由參數，**只對 Gateway 請求生效，自訂模型連線會忽略它們**，不要指望用它切換上游。
* Fx 官方對自訂模型連線的支援仍在演進中，早期版本可能需要較新的建置才能識別；升級後先跑一次上面的測試指令再正式使用。
* 該二進位安裝腳本會從網路下載，執行前請自行確認來源可信。

## 相關連結

* 專案主頁：[https://github.com/vercel-labs/fx](https://github.com/vercel-labs/fx)