# Fx

出典: https://docs.aicentos.com/ja/clients/fx

Language: ja

> Fx で aicentos を使う —— ユーザーレベルの settings.json でカスタムモデル接続を追加

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)
* キーの作成：[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  | コンソールで作成したキー              |
| モデル      | コンソール「モデル広場」のモデル名         |

## 設定手順

### 1. ユーザーレベル設定の編集

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

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