Fx

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
• 建立 Key：https://aicentos.com/keys
• 餘額不足時儲值：https://aicentos.com/wallet

確認已安裝 Fx：

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

需要填寫的設定复制锚点链接

設定步驟复制锚点链接

1. 編輯使用者層級設定复制锚点链接

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

• 文件入口：https://fx.sh/docs
• README：https://github.com/vercel-labs/fx

把連線裡的 API 位址填為：

https://aicentos.com/v1

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

2. 指定使用該連線复制锚点链接

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

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

也可以用環境變數指定：

export FX_MODEL="gpt-4o"

3. 確認目前 provider复制锚点链接

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

測試复制锚点链接

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

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