Claude Code とは
Claude Code は、コードベースの読み取り、ファイル編集、コマンド実行、開発ツールとの統合を行う Anthropic のエージェント型コーディング ツールです。このセットアップでは、Claude Code のゲートウェイ設定(API エンドポイント、認証トークン、各エイリアスのモデル)を使って、接続先を Capriole AI にします。Claude Pro や Max でサインインした Claude Code はプランの 5 時間と週の使用制限を消費しますが、Capriole AI の API キーを使うと API トークン残高を使います。前提条件
始める前に、次を用意してください。- Capriole AI アカウント(こちらから登録)
- Premium プラン(月額 USD 9、無制限のウェブチャットも含む)または Team プラン。API キーにはどちらかが必要です(購読する)
- Capriole AI API キー(キーを取得)
インストール
公式のネイティブ インストーラーで Claude Code をインストールします。設定
モデルの検証
Claude Code 2.1.304 は、下記の設定を使い、「対応モデル」のすべてのモデルで、Capriole AI 経由のファイル読み取り、ファイル書き込み、最終回答の確認に合格しています。~/.claude/settings.json を作成または更新します。
modelは新しいセッションのデフォルト モデルです。/modelで選んだモデルは保存され、次回も使われます。ANTHROPIC_BASE_URLはリクエストの送信先を Capriole AI にします。/v1は付けないでください。Claude Code が/v1/messagesを自動で付加します。ANTHROPIC_AUTH_TOKENはキーを Bearer トークンとして送ります。Capriole AI ではこの形式が必須です。- 3 つの
ANTHROPIC_DEFAULT_*_MODELの値は、opus、sonnet、haikuの各エイリアスを Capriole AI が提供するモデルに割り当てます。haikuは、Claude Code が簡単なバックグラウンド処理に使うモデルです。
Claude Code を実行する
プロジェクト ディレクトリから Claude Code を起動します。/model でモデルを切り替えます。たとえば /model opus で Opus 5.5 に切り替わります。非対話で実行するには、print モードを使います。
対応モデル
Claude Code は Anthropic Messages プロトコルを使うため、Capriole AI の Claude モデルに対応しています。claude-fable-5-1(Fable 5.1、推奨のデフォルト)claude-opus-5-5(Opus 5.5)claude-fable-5claude-opus-5claude-opus-4-8claude-opus-4-7claude-opus-4-6claude-sonnet-4-6claude-latest(常に最新の Claude 旗艦モデルを指します。現在は Fable 5.1)
claude-latest をモデル名として認識しないため、コンテキスト ウィンドウを 200K とみなします。モデル本来のコンテキスト ウィンドウを使うには、claude-fable-5-1 などの具体的な ID を使ってください。
トラブルシューティング
Claude Code が認証エラーを返すのはなぜですか?
ANTHROPIC_AUTH_TOKEN を使うと、Claude Code は Authorization ヘッダーで Capriole AI のキーを Bearer トークンとして送信します。
エンドポイント エラーでリクエストが失敗するのはなぜですか?
ANTHROPIC_BASE_URL が /v1 なしの https://api.caprioletech.com であることを確認してください。
起動のたびに Claude Code が別のモデルに戻るのはなぜですか?
設定とシェルからANTHROPIC_MODEL を削除してください。これが設定されていると、Claude Code は次回の起動時に、/model で保存したモデルではなくそのモデルに戻ります。
/model opus や /model sonnet が失敗するのはなぜですか?
3 つの ANTHROPIC_DEFAULT_*_MODEL の値を維持すると、Claude Code のエイリアスが Capriole AI で設定した Claude モデルに対応します。
設定したエフォート レベルが Claude Code で使われないのはなぜですか?
Claude Code はエフォート レベルをモデルごとに保存します。そのモデルを使用中に/effort で選んでください。ユーザー設定のトップレベルにある effortLevel は Opus 5.5 には適用されません。
トークンカウントが失敗するのはなぜですか?
Capriole AI は/v1/messages/count_tokens を選択した上流に転送します。その上流がトークンカウントに対応していない場合、Claude Code は代わりにトークン数を推定し、セッションはそのまま動作します。
注意事項
~/.claude/settings.jsonの設定は、どのプロジェクトでも、あなたのユーザー アカウント全体に適用されます。YOUR_CAPRIOLE_AI_API_KEYは Capriole AI API キーに置き換えてください。- Claude Code は Anthropic Messages で Claude モデルを利用します。Gemini、Grok、GLM、Kimi には、OpenCode や Kilo Code などの複数プロトコル対応エージェントを使えます。
- 同じキーを他のコーディング エージェントでも使うには、1 つの API キーでコーディング エージェントを使うを参照してください。
- 公式リファレンス:Claude Code セットアップ、モデル設定、LLM ゲートウェイ設定。

