Facade Code ドキュメント
エージェントを設定

Claude Code + プロバイダー

Claude Code の CLI はそのままに、別の起動設定を 1 つ追加して Anthropic 互換のモデルプロバイダーに接続します。

プロバイダーの情報を用意する

Claude Code をインストールし、プロバイダーの Anthropic 互換のベース URL、API キー、モデル ID を取得します。OpenAI 互換のエンドポイントは Claude Code では使用できません。

この例では Claude · work という別のエントリーを作成します。既存の Claude Code エントリーの設定は変わりません。

1. プロバイダーの設定を追加する

この設定を facade.json に追加します(エージェント設定を参照)。例の URL、キー、モデル ID は、プロバイダーの値に置き換えてください。

facade.json
{
  "clis": {
    "Claude · work": {
      "type": "claude",
      "model": "YOUR_MODEL_ID",
      "env": {
        "ANTHROPIC_BASE_URL": "https://api.example.com/anthropic",
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_API_KEY": null,
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "YOUR_MODEL_ID",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "YOUR_MODEL_ID",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "YOUR_SMALL_MODEL_ID"
      }
    }
  }
}

各エイリアスには、プロバイダーがサポートするモデルを指定します。Haiku のマッピングは小規模なバックグラウンドタスクに使われ、メインのモデルとは別のモデルを指定できます。

2. エンドポイントとモデルのマッピングを確認する

設定動作
ANTHROPIC_BASE_URLClaude Code をプロバイダーの Anthropic 互換 API に接続します。
ANTHROPIC_AUTH_TOKENプロバイダーのトークンを指定します。
ANTHROPIC_API_KEY: nullこの設定で継承される Anthropic の API キーを削除します。
modelこのエントリーの開始モデルを設定します。
ANTHROPIC_DEFAULT_…_MODELOpus、Sonnet、Haiku のリクエストを、プロバイダーが提供する ID にマッピングします。

この例ではキーを facade.json に保存します。既存の環境変数から読み取る場合は、"ANTHROPIC_AUTH_TOKEN": "${env:WORK_API_KEY}" を使用します。エージェントを起動する前に、エディターでその変数を利用できるようにしておく必要があります。

これらの変数は、このエントリーで起動したエージェントにのみ適用されます。Claude Code のグローバル設定を編集する必要はありません。

3. この設定で Claude Code を起動する

facade.json を保存し、New Agent を選択して Claude · work を選びます。プロジェクトで短いタスクを渡してください。

プロバイダーが使用量を報告する場合、リクエストが正しいアカウントに表示されることを確認します。エージェントが起動しない、またはリクエストが失敗する場合は、Show Agent Launch を実行して作業場所を選択してください。レポートでこのエントリーを探すと、Facade がどのように起動するかを確認できます。

認証エラーやモデルが見つからないエラーについては、トラブルシューティングを参照してください。

例:QwenCloud

QwenCloud の Token Plan キーを使う場合は、ベース URL に https://token-plan.maas.qwencloudapi.com/apps/anthropic を指定します。プランで利用できるモデル ID を選択してください。従量課金のキーでは、リージョン別のエンドポイントを使用します。

QwenCloud の最新のエンドポイントとモデル設定 ↗

Markdown で表示 ↗ドキュメント

ドキュメントを検索

このガイド内を検索します。↑ ↓ で移動、Enter で開き、Esc で閉じます。