Source: https://aiprimetech.io/ja/learn/use-claude-api-with-factory-droid/

[ホーム](/ja/) / [学習](/ja/learn/) / ClaudeでFactory Droidを動かす 

# ClaudeでFactory Droidを実行 

FactoryのDroidはClaude Codeと同系統のエージェント型CLIで、設定ファイルを通じて独自のモデルを使用できます。接続先をAI Prime Techゲートウェイにすると、ゲートウェイが提供するほかのモデルとともに、ClaudeでDroidのエージェントループを実行できます。 

## 設定ファイルを編集する 

Droidは~/.factory/settings.jsonを読み込みます。使用可能にしたいモデルごとにエントリーを記述するcustomModels配列を追加してください。これが現在の設定ファイルのパスです。旧来のconfig.jsonはレガシー形式で、settings.jsonの機能すべてには対応していません。 

Droidの設定全体を単一のファイルで管理するため、単一のcustomModelsリストでCLIが切り替えられるすべてのモデルを定義します。プロジェクトごとではなく、ユーザーレベルで管理してください。 

現在使うファイルがsettings.jsonだと知っておけば、混乱を大きく減らせます。古いメモやスレッドでは今もconfig.jsonが参照されており、一部の機能は両者で動作が異なるためです。一方では動作してもう一方では動作しない場合、ほとんどの場合はsettings.jsonを信頼すべきです。説明が食い違う場合は、config.jsonよりsettings.jsonを優先すれば、その大半は解決します。Factoryが現在積極的にサポートしているのは新しいファイルであり、変数構文が実際に機能するのもこちらです。 

## モデルを定義する 

各customModelsエントリーには、モデルID、baseUrl、apiKey、provider、maxOutputTokensを指定します。modelをclaude-sonnet-4-5などのゲートウェイのIDに、baseUrlをゲートウェイのホストに設定してください。 

これらのフィールドを組み合わせることで、モデルへの接続方法をDroidに正確に伝えます。Droidは単一のプロバイダーを前提としていないため、各要素を明示的に指定します。これによって、ゲートウェイを接続先にできる柔軟性が生まれます。 

この明示的な指定により、単一のDroid環境から同じゲートウェイ上の複数のClaudeモデルを利用できます。各モデルを個別のcustomModelsエントリーとして定義し、baseUrlとキーを共有します。上流ではすべて同じエンドポイントに接続しますが、CLIはそれぞれを個別に選択できるモデルとして扱います。単一の環境から単一のエンドポイントを通じて複数のClaudeモデルを利用できるのは、まさに各フィールドを明示的に指定するためです。各エントリーはbaseUrlとキーを共有しながら独自のモデルIDを保持するので、ルーティングはゲートウェイが行い、Droidは名前を選ぶだけです。 

## プロバイダーモードを選ぶ 

providerフィールドは通信形式を設定します。ゲートウェイのネイティブなMessagesインターフェースにはanthropic、Responses形式にはopenai、OpenAI形式の/v1チャットエンドポイントにはgeneric-chat-completion-apiを使用します。ゲートウェイ上のClaudeにはanthropicが自然な選択です。 

providerをゲートウェイが実際に提供するインターフェースに合わせることで、初回実行時のエラーを防げます。providerをanthropicにすると、DroidはゲートウェイがClaude向けに提供するネイティブ形式で通信します。 

これらのプロバイダーモードは、複数モデル対応のゲートウェイが公開できるインターフェースにも適切に対応しています。そのため、同じゲートウェイがOpenAI形式のモデルを提供している場合は、generic-chat-completion-apiを使う別のエントリーとして追加します。各エントリーのproviderをそのインターフェースに合わせることが、混在する設定でエラーを防ぐための原則です。すべてのエントリーでproviderをインターフェースに合わせることが、混在するゲートウェイ設定を適切に保つための原則です。ネイティブなClaudeのエントリーとOpenAI形式のエントリーは問題なく共存できます。 

## APIキーを設定する 

キーはapiKeyに指定します。シークレットをファイルではなく環境内に保持できるよう、できれば${AIPRIME_API_KEY}などの${VAR}参照を使用してください。${VAR}の展開はsettings.jsonでは機能しますが、レガシーのconfig.jsonでは機能しない点に注意してください。 

技術的には匿名リクエストを受け付けるゲートウェイであっても、apiKeyフィールドを空にすることはできません。Droidはこのフィールドに値があることを検証するため、必ずキーまたはキーを保持する変数を指定してください。 

この両方の条件から、よくあるつまずきの原因がわかります。古いconfig.jsonに${VAR}を記述すると、そこでは展開されないため、Droidは未解決の文字列をそのまま読み取ります。変数形式にはsettings.jsonを使い、Droidを起動するシェルで変数が実際にエクスポートされていることを確認してください。起動元のシェルで変数がエクスポートされているかの確認は、最後に見落とされがちな点です。Droidが参照できるのは、起動時の環境に存在する変数だけです。 

## 切り替えて実行する 

Droid CLI内で、/modelコマンドを使って設定済みのモデルを切り替えます。claude-opus-4-8用の別のエントリーを追加しておけば、設定を再び変更することなく、より難しいタスク向けにそのモデルへ切り替えられます。 

その後、Droidはゲートウェイ上のClaudeに対してエージェントループを実行します。設定はsettings.jsonに保存されているため、CLIを起動するたびに同じ設定が適用されます。 

SonnetとOpusの両方のエントリーを用意しておけば、着実な実装にはSonnet、より高度な推論が必要な問題にはOpusというように、その場でタスクに合わせてモデルを選べます。すべてゲートウェイ経由で利用でき、再設定は不要です。/modelによる切り替えなら、セッションの途中でもコマンドを入力するだけで変更できます。セッションの途中に/modelコマンドを入力するだけで切り替えられるため、タスクに合わせたモデル選びが手軽になります。セッションを離れることなく、SonnetからOpusへ移行できます。 

コピー

```
// ~/.factory/settings.json
{
  "customModels": [
    {
      "model": "claude-sonnet-4-5",
      "baseUrl": "https://aiprimetech.io",
      "apiKey": "${AIPRIME_API_KEY}",
      "provider": "anthropic",
      "maxOutputTokens": 8192
    }
  ]
}
// export AIPRIME_API_KEY=<key>   (apiKey must NOT be empty)
// Switch models in the CLI with /model
```

## よくある質問 

 ClaudeでFactory Droidを動かすにはどうすればよいですか？

~/.factory/settings.jsonにcustomModelsエントリーを追加し、providerにanthropic、baseUrlにhttps://aiprimetech.io,、モデルID、およびapiKeyを設定します。/modelで切り替えてください。 Claudeにはどのprovider値を使いますか？

ネイティブなMessagesインターフェースにはanthropicを使います。openaiまたはgeneric-chat-completion-apiは、OpenAI形式のエンドポイントを対象とします。 apiKeyを空にできますか？

いいえ。Droidには値が必要です。${AIPRIME_API_KEY}のような${VAR}参照を使用してください。展開はsettings.jsonでは機能しますが、レガシーのconfig.jsonでは機能しません。 モデルを切り替えるにはどうすればよいですか？

Droid CLIの/modelコマンドを使って、customModelsリスト内の任意のエントリーに切り替えます。  

数分でClaudeの利用を開始

APIキーを取得 — Anthropicアカウントもウェイトリストへの登録も不要です。[APIキーを取得](/register) 

AI Prime Techは独立したAPIゲートウェイです。Anthropicとの提携関係はなく、同社の承認を受けておらず、同社の再販業者でもありません。Claudeおよび関連するモデル名は、それぞれの所有者の商標です。    

## Claude APIのその他のガイド

[Claude APIキーの取得方法](/ja/learn/how-to-get-a-claude-api-key/)[Claude API の料金を解説](/ja/learn/claude-api-pricing-explained/)[Claude APIを最も安く利用する方法](/ja/learn/cheapest-way-to-use-claude-api/)[Claude APIでCursorを無制限に利用](/learn/use-claude-api-with-cursor/)[Claude Codeへの無制限アクセス](/ja/learn/use-claude-api-with-claude-code/)[Claude APIゲートウェイとAnthropicへの直接接続の比較](/ja/learn/claude-api-vs-anthropic-direct/)[OpenAI互換API経由でClaudeを使う](/ja/learn/openai-compatible-claude-api/)[Claude モデルを解説：Claude Opus、Sonnet、Haiku、Fable のモデル比較 — すべての Claude API モデル、Anthropic のモデル名と料金（2026）](/ja/learn/claude-api-models-compared/)[暗号資産でClaude APIの料金を支払う](/ja/learn/claude-api-with-crypto-payment/)[ウェイティングリストなしでClaude APIを利用](/ja/learn/claude-api-without-waitlist/)[Claudeのトークン使用量を削減する方法](/ja/learn/how-to-reduce-claude-token-usage/)[Claude APIでClineを無制限に利用](/ja/learn/use-claude-api-with-cline/)[Claude APIでRoo Codeを無制限に利用](/ja/learn/use-claude-api-with-roo-code/)[JetBrains IDEでClaudeを無制限に利用](/ja/learn/use-claude-api-with-jetbrains/)[Claude APIでAiderを無制限に使う](/ja/learn/use-claude-api-with-aider/)[VS CodeでClaudeを無制限に利用](/ja/learn/use-claude-api-with-vscode/)[Claude向けのOpenCode設定：opencode.jsonの設定、モデル、よくあるエラー](/ja/learn/use-claude-api-with-opencode/)[ClaudeでHermesエージェントを無制限に実行する](/ja/learn/run-hermes-agent-with-claude-api/)[ClaudeでOpenClawを無制限に実行](/ja/learn/run-openclaw-with-claude-api/)[Anthropic互換APIとは](/ja/learn/anthropic-compatible-api/)[Claude CodeのAPIキー — ANTHROPIC_API_KEY：取得方法、設定方法、代わりにclaude setup-tokenを使うべき場合](/ja/learn/claude-code-api-key-setup/)[Claude Code APIのコスト — 料金と削減方法](/ja/learn/claude-code-api-costs/)[Claude APIエラーを解説：サーバーエラー500、過負荷529、レート制限429、不正なリクエスト400 — それぞれの解決方法](/ja/learn/claude-api-errors-troubleshooting/)[Claude APIクレジットの購入方法 — Claudeクレジットがどの「Claudeアカウント購入」のオファーよりも優れている理由](/ja/learn/buy-claude-api-credits/)[Claudeの無料API：無料のClaude APIキーはあるのか、2026に実際に無料で使えるものは？](/ja/learn/claude-api-free-trial/)[Claude APIとClaude Pro/Maxサブスクリプション — どちらを選ぶべきか](/ja/learn/claude-api-vs-subscription/)[ClaudeでCodex CLIを実行する](/ja/learn/use-claude-api-with-codex/)[Claudeをn8nに接続する](/ja/learn/use-claude-api-with-n8n/)[LiteLLMからClaudeへのルーティング](/ja/learn/use-claude-api-with-litellm/)[Kilo CodeでClaudeを使う](/ja/learn/use-claude-api-with-kilo-code/)[GitHub CopilotにClaudeを導入する](/ja/learn/use-claude-api-with-github-copilot/)[ゲートウェイ経由でZedをClaudeに接続する](/ja/learn/use-claude-api-with-zed/)[Cherry StudioをClaudeに接続](/ja/learn/use-claude-api-with-cherry-studio/)[LangChainのChatAnthropic：インポート、base_url、ストリーミング、ツール、エラー](/ja/learn/use-claude-api-with-langchain/)[Anthropic Python SDK：インストール、base_urlの設定、ストリーミング、エラー処理](/ja/learn/anthropic-python-sdk/)[Vercel AI SDKでClaudeを使用：createAnthropicのbaseURL、ストリーミング、問題の修正](/ja/learn/use-claude-api-with-vercel-ai-sdk/)[Claude Code APIの仕組みを解説](/ja/learn/claude-code-api/)[アプリケーションへのClaude APIの統合](/ja/learn/claude-api-integration/)[Claudeを無制限に利用する方法 — 「Claude Codeのクラック版」が存在しない理由](/ja/learn/get-unlimited-claude-usage/)