Droid（Factory）接続

Factory の Droid CLI に QCode.cc を BYOK カスタムモデルとして追加：~/.factory/settings.json に provider=anthropic と baseUrl

Droid（Factory）接続 ¶

Droid は Factory 製のターミナル AI コーディングエージェントです。BYOK（自分のキーを使う）カスタムモデルに対応しており、QCode.cc を上流にできます。

どのプロトコルを使うか ¶

Droid は provider フィールドでプロトコルを選びます。Claude を使うなら anthropic です —— QCode の OpenAI エンドポイントは Claude モデルを受け付けません（エンドポイントと API パス）。

使いたいモデル	`provider`	`baseUrl`
Claude	`anthropic`	`https://api.qcode.cc/api`
GPT 系 / 中国系 4 ファミリー	`openai`（OpenAI 互換）	`https://api.qcode.cc/openai/v1`

インストール ¶

curl -fsSL https://app.factory.ai/cli | sh

~/.local/bin/droid にインストールされます。PATH 未設定と表示されたら、スクリプトが出力する行を ~/.zshrc / ~/.bashrc に追加してください。

確認（実際の出力を信頼してください）：

droid --version

設定 ¶

~/.factory/settings.json を編集（なければ作成）します：

{
  "customModels": [
    {
      "model": "claude-sonnet-5",
      "displayName": "QCode Sonnet 5",
      "baseUrl": "https://api.qcode.cc/api",
      "apiKey": "${QCODE_KEY}",
      "provider": "anthropic",
      "maxOutputTokens": 8192
    },
    {
      "model": "claude-haiku-4-5",
      "displayName": "QCode Haiku 4.5",
      "baseUrl": "https://api.qcode.cc/api",
      "apiKey": "${QCODE_KEY}",
      "provider": "anthropic",
      "maxOutputTokens": 4096
    }
  ]
}

キーは環境変数で注入します：

export QCODE_KEY="cr_あなたのQCodeキー"

フィールド	説明
`model`	API に渡すモデル id。qcode.cc/models と一字一句一致させる
`displayName`	モデル選択に表示される名前。任意
`baseUrl`	`/api` まで。Droid が `/v1/messages` を自分で連結します
`apiKey`	`${変数名}` 形式の環境変数参照に対応
`provider`	Claude は `anthropic`
`maxOutputTokens`	1 回の応答の出力上限

Factory 公式によれば、API キーはローカルに留まり Factory のサーバーにアップロードされません。中国本土からはホストを https://asia.qcode.cc/api（香港ノード）に変更してください。

検証 ¶

droid exec --model "claude-sonnet-5" "reply with exactly: OK"

OK が返れば接続できています。

陰性対照（設定が本当に効いている証明）：baseUrl を一時的に存在しないパスに変えて再実行し、失敗することを確認してください。成功しただけでは、設定したレッグを通った証明にはなりません。

よく使う操作 ¶

# 対話モード
droid

# 非対話実行
droid exec "テストを実行して失敗を直して"

# 作業ディレクトリ指定
droid --cwd /path/to/project

# git worktree 内で実行（変更を隔離）
droid -w feature-x

# 自律度
droid --auto medium

Droid（Factory）接続