Cherry StudioをClaudeに接続

Cherry Studioは、多くのモデルとチャットできる、すっきりしたデスクトップクライアントで、Anthropicのネイティブ形式に直接対応しています。AI Prime TechゲートウェイをAnthropicタイプのプロバイダーとして追加すれば、単一のホストとキーで、ほかに使っているモデルと同じウィンドウからClaudeを利用できます。

モデルサービスを開く

「設定」に移動し、「モデルサービス」を開きます。ここにはCherry Studioが接続できるすべてのプロバイダーが一覧表示され、新しいプロバイダーも追加できます。プラスボタンを押してプロバイダーを追加すると、タイプの選択を求められます。

タイプの選択は通信形式を決めるため重要です。ゲートウェイ上のClaudeには、OpenAI形式のエンドポイントではなく、ネイティブの/v1/messagesインターフェースを使用するAnthropicタイプを選びます。

Cherry Studioはプロバイダーを一覧で管理するため、ゲートウェイは設定済みのほかのサービスと並び、会話ごとに切り替えられます。そのため、複数モデルに対応するゲートウェイを扱いやすく、単一のプロバイダーエントリに複数のClaudeモデルを登録して、必要に応じてメニューから選べます。ゲートウェイを複数あるエントリのひとつとして扱えることが、Cherry Studioを使いやすいマルチモデル操作環境にしています。アプリを離れずに、会話ごとにプロバイダーを切り替えられます。

Anthropicタイプを選ぶ

プロバイダーのタイプとしてAnthropicを選び、有効にします。するとCherry Studioに、動作を決めるAPIキーとAPIホストの入力欄が表示されます。キー欄にゲートウェイのキーを貼り付けてください。

タイプがネイティブのAnthropicなので、Cherry StudioはゲートウェイがClaude向けに提供するMessages形式でリクエストを送信します。タイプを設定すれば、別途プロトコルを切り替える必要はありません。

ゲートウェイがほかのモデル向けにOpenAI互換のインターフェースも公開している場合、それらはこのエントリに混在させず、OpenAIタイプの別のプロバイダーとして追加します。AnthropicタイプのエントリをClaude専用にすることで、通信形式が明確になり、プロトコル間の混乱を避けられます。プロトコルごとにプロバイダーエントリを分けるという小さな習慣が、後々の多くの混乱を防ぎます。そうすれば、各エントリで考慮する通信形式はひとつだけになります。

APIホストを正しく設定する

APIホストは、最も設定を間違えやすい欄です。Cherry Studioがバージョンパスを自動で付加するため、末尾に/v1を付けず、ホストのルートだけを入力してください。自分で/v1を追加するとパスが重複し、リクエストが失敗します。

つまり、設定値はゲートウェイのホストだけです。プロバイダーを追加した後に404やパスのエラーが発生した場合、ほとんどの場合はAPIホストに余計な/v1が含まれていることが原因です。

ホストの末尾にスラッシュがある場合も同様の不具合が起きるため、後ろに何も付けず、ホストだけを入力してください。リクエストが失敗したら、ほかの箇所を調べる前にAPIホスト欄を確認し、ホスト名より後ろの部分をすべて削除するのが最も手早い診断方法です。不具合が起きたときに、まずこの欄を確認すれば、設定上の問題の大半をその場で解決できます。サフィックスのないホストだけの値にすることが目標です。

末尾の#でURLを固定

Cherry Studioには、小さいながら重要な機能があります。APIホストの末尾に#を付けると、クライアントは何も付加せず、そのURLをそのまま使用します。自動付加が邪魔になる場合に、正確なエンドポイントを指定する方法です。

標準的なゲートウェイでは通常、ホストだけを入力し、Cherry Studioにパスを付加させます。#を使うのは、ゲートウェイが厳密なパスを必要とし、自動付加によってそのパスが崩れてしまう場合だけにしてください。

#は分かりにくい機能だからこそ、覚えておく価値があります。パスがCherry Studioの標準的な想定と一致しないゲートウェイに対応するための手段です。自動付加される/v1/messagesがゲートウェイの期待するパスと一致しない場合、#を使えば完全なURLを手動で指定できます。この#の使い方を覚えておけば、パスが合わなくなったときにすぐ修正方法が分かります。標準外のゲートウェイパスに対応できるオーバーライド機能です。

モデルを選んでチャットする

日常的なチャット向けのclaude-sonnet-4-5や、難しい推論向けのclaude-opus-4-8など、ゲートウェイが提供するIDを使って、利用したいClaudeモデルをプロバイダーの配下に追加します。追加したモデルはCherry Studioのモデルメニューに表示されます。

会話を開始し、メニューからClaudeモデルを選ぶと、ゲートウェイ経由でやり取りできます。プロバイダーがネイティブのAnthropic形式を使うため、Messages形式に依存する機能も想定どおりに動作します。

異なるClaudeモデルとの会話を複数同時に開いておけるため、同じプロンプトをSonnetとOpusがどう処理するかを比較するのに便利です。すべてが同じゲートウェイプロバイダーを通じて動作するので、モデルの切り替えは再設定ではなく、メニューから選ぶだけで済みます。モデルを並べて比較できることは、すべてを単一のプロバイダー経由で動かす、ささやかな楽しみのひとつです。メニューを切り替えるだけで、同じプロンプトをSonnetとOpusに試せます。

# Cherry Studio -> Settings -> Model Services -> + Add
# Provider type: Anthropic   (native /v1/messages)
# API Key:  <your gateway key>
# API Host: https://aiprimetech.io        (root only, NO /v1 -- it auto-appends)
#   end with #  ->  https://aiprimetech.io#   to lock the exact URL
# Model: claude-sonnet-4-5

よくある質問

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