Factory Droid CLI 接続
難易度 ⌨️ 中級 | インターフェース形式 OpenAI 互換 | base_url
https://byesu.com/v1
Factory Droid CLI（droid）は Factory AI が提供するターミナル向け AI コーディングエージェントで、コマンドラインから直接コードを読み、バグを修正し、リファクタリングや新機能の実装を行えます。カスタムモデルエンドポイントに対応しているため、推論バックエンドを Byesu API に切り替えることができます。
始める前に
まず コンソール → トークン で API トークン（sk-xxxx のような形式）を作成し、トークンに正しいグループを選んでください。グループによって、呼び出せるモデルや経由するルートが決まります。詳しくは グループの選択 を参照してください。
ステップ 1：Droid CLI のインストール
irm https://app.factory.ai/cli/windows | iexcurl -fsSL https://app.factory.ai/cli | shインストールが完了したら、案内に従って PATH を更新し、無料の Factory 公式アカウントで一度ログインする必要があります（これはクライアント本体の認証のみに使われ、モデルが byesu を経由することには影響しません）。
Windows での注意
権限や実行ポリシーのエラーが出た場合は、管理者権限で PowerShell を起動し、Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser を実行してください。
ステップ 2：byesu への接続設定
方法は 2 種類あります。ワンクリックスクリプトの利用をおすすめします。
方法その 1（最速）：ワンクリックスクリプト
実行後、案内に従って base_url と API Key を入力するだけで、スクリプトが自動的に設定ファイルを書き込みます。
iex (irm 'https://raw.githubusercontent.com/QuantumNous/new-api-docs/refs/heads/main/helper/factory-cli-setup.ps1')curl -fsSL https://raw.githubusercontent.com/QuantumNous/new-api-docs/refs/heads/main/helper/factory-cli-setup.sh | bash- base_url には次を入力：
https://byesu.com/v1 - API Key には：byesu コンソールで作成したトークン
sk-xxxxを入力
方法その 2（手動）：設定ファイルを編集
~/.factory/config.json（Windows では %USERPROFILE%\.factory\config.json）を編集し、custom_models 配列に byesu のモデル項目を追加します。
{
"custom_models": [
{
"model_display_name": "GPT-5.5 [byesu]",
"model": "gpt-5.5",
"base_url": "https://byesu.com/v1",
"api_key": "sk-xxxx",
"provider": "openai",
"max_tokens": 128000
},
{
"model_display_name": "Claude Opus 4.8 [byesu]",
"model": "claude-opus-4-8",
"base_url": "https://byesu.com/v1",
"api_key": "sk-xxxx",
"provider": "openai",
"max_tokens": 128000
},
{
"model_display_name": "Gemini 3.1 Pro [byesu]",
"model": "gemini-3.1-pro-high",
"base_url": "https://byesu.com/v1",
"api_key": "sk-xxxx",
"provider": "openai",
"max_tokens": 128000
}
]
}各フィールドの説明：
model：byesu 上の実際のモデル名（gpt-5.5、claude-opus-4-8、gemini-3.1-pro-highなど）。トークンが属するグループがそのモデルに対応しているか、必ず確認してください。base_url：https://byesu.com/v1固定（OpenAI 互換形式、/v1付き）。api_key：あなたのトークンsk-xxxx。provider：すべてopenaiと入力します。model_display_name：CLI の選択メニューに表示される名前。任意に決められます。
Anthropic ネイティブ形式を使う場合
上記では OpenAI 互換エンドポイントを使っています（最も手軽です）。ある項目で Anthropic ネイティブプロトコルを使いたい場合は、その項目の provider を anthropic に変更し、base_url を /v1 を付けない https://byesu.com に変更してください。通常は openai + https://byesu.com/v1 のままで問題ありません。
ステップ 3：起動して動作確認
プロジェクトのディレクトリで起動します。
cd /path/to/your/project
droid対話画面に入ったら、/model（または起動時のモデル選択メニュー）で先ほど設定した … [byesu] モデルに切り替え、適当にファイルを読ませたりコードを説明させたりしてみてください。正常に応答が返ってくれば、接続成功です。
うまくいかないときは？
- 401 / Unauthorized：
api_keyの入力ミス、またはsk-プレフィックスの抜け。トークンが無効化されていないか確認してください。詳しくは よくあるエラー #auth を参照。 - 利用可能なチャネルがない / no channel：現在のトークンのグループが、入力した
modelに対応していません。そのグループ内の別のモデルに変更するか、改めて グループの選択 を行ってください。詳しくは よくあるエラー #no-channel を参照。 - 残高不足 / 402：アカウントの残高が不足しています。まずチャージしてください。詳しくは よくあるエラー #balance を参照。
- 接続失敗 / 404：
base_urlの記述ミスです。OpenAI 互換形式では必ずhttps://byesu.com/v1（/v1付き）でなければなりません。