Fx

Fx は Vercel Labs 製のコーディングエージェントで、Zig で書かれた単一のネイティブバイナリとして提供され、モデル非依存です。カスタムモデル接続はユーザーレベルの ~/.fx/settings.json に定義し、Base URL を aicentos に向けるだけで使えます。

まずハマりやすいポイントを説明します： プロジェクトルートの .fx.json は別物です。これはクローンしてきたリポジトリにモデルやエンドポイントを勝手に差し替えられないよう、意図的にほとんどのフィールド（モデルを含む）を禁止しています。カスタムエンドポイントは必ず ~/.fx/settings.json に書いてください。.fx.json に書いても効果がありません。

準備アンカーリンクをコピー

まずコンソールの「API キー」ページで、Fx 専用のキーを作成してください（名前は fx のようにすると使用量の追跡に便利です）：

• コンソール：https://aicentos.com
• キーの作成：https://aicentos.com/keys
• 残高不足のときのチャージ：https://aicentos.com/wallet

Fx がインストール済みか確認します：

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

設定値アンカーリンクをコピー

設定手順アンカーリンクをコピー

1. ユーザーレベル設定の編集アンカーリンクをコピー

~/.fx/settings.json に「カスタムモデル接続」の形式で接続を 1 つ登録します。接続オブジェクトのフィールド構成は公式ドキュメントを基準にしてください：

• ドキュメント入口：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