Claude Code で DeepSeek V4 Flash と Pro を使う:設定とモデル切り替え
APIMaster を使って Claude Code に DeepSeek をセットアップします。Windows、macOS、Linux 向けの settings.json の設定、claude の起動、/model によるモデル選択、チャットの開始方法を解説します。
settings.json で APIMaster を設定し、claude を実行して、会話内で /model MODEL_ID と入力すれば DeepSeek を利用できます。 このガイドで扱う利用可能な ID は deepseek-v4-flash と deepseek-v4-pro です。Claude Code はクライアントであり、DeepSeek は応答するモデルです。
はじめに
環境チェック と Claude Code のセットアップ を完了してください。十分な残高があり、選択したモデルへアクセスできる APIMaster API キー を取得してください。
claude --version
ゲートウェイのベース URL は https://apimaster.ai で、/v1 は付けません。/v1/messages は Claude Code が自動的に追加します。
1. 設定ディレクトリを開く
Windows
Win + R を押し、次のパスを入力して Enter を押します:
%USERPROFILE%\.claude
必要であればフォルダを作成してください。settings.json を開くか、新規作成します。ファイル名が settings.json.txt になっていないことを確認してください。
macOS / Linux
macOS では、Finder で Command + Shift + G を押して次を入力します:
~/.claude
Linux では、同じディレクトリをファイルマネージャーやエディタで開きます。必要であれば作成してください:
mkdir -p ~/.claude
そこで settings.json を開くか、新規作成します。カスタムの Claude Code 設定ディレクトリを設定している場合は、そのディレクトリを使用してください。
2. settings.json を編集する
Windows、macOS、Linux で設定内容は同じです。YOUR_APIMASTER_API_KEY をお使いの APIMaster キーに置き換えてください:
{
"model": "deepseek-v4-flash",
"env": {
"ANTHROPIC_BASE_URL": "https://apimaster.ai",
"ANTHROPIC_API_KEY": "YOUR_APIMASTER_API_KEY",
"ANTHROPIC_AUTH_TOKEN": "",
"CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
"CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
}
}
ファイルが既に存在する場合は、バックアップを取ったうえで、これらのフィールドを既存の JSON オブジェクトと env オブジェクトに統合してください。必要な他の設定はそのまま残します。2つ目の JSON オブジェクトを追加したり、env キーを重複させないでください。JSON ではコメントや末尾のカンマは許可されていません。
一般的な Claude Code ガイドではトークン認証が紹介されています。このガイドでは、当社の統合テストで検証した API キー認証を使用します。ANTHROPIC_API_KEY を使用する場合は ANTHROPIC_AUTH_TOKEN を空のままにし、他の設定やターミナルにある競合する認証情報を削除してください。このゲートウェイには APIMaster のキーを使用してください。
model フィールドは起動時のモデルを設定します。起動後に別のモデルを選択することもできます。このユーザー設定ファイルは非公開に保ち、実際のキーを共有リポジトリにコミットしないでください。ファイルを保存し、新しい設定を読み込むために Claude Code を再起動してください。
3. Claude Code を起動する
プロジェクトディレクトリで開いたターミナルで、次を実行します:
claude
通常の初回起動時のプロンプトに対応し、プロジェクトの信頼確認プロンプトを確認してください。起動時のモデルは deepseek-v4-flash になっているはずです。これは通常のツールとプロジェクト設定を備えた、通常の対話セッションです。
4. モデルを選択してチャットを開始する
Claude Code の会話内 で、次のいずれかのコマンドを入力して Enter を押します:
/model deepseek-v4-flash
/model deepseek-v4-pro
1行に1つずつ実行し、使いたいモデルを選択してください。Claude Code が切り替えを確認したら、短いメッセージを送ります:
Reply with exactly OK.
通常のテキスト返信があれば、基本的な接続は確認できています。その後、チャットを続けたり、プロジェクトの作業を依頼したりできます。同じ会話内で再度切り替えるには、別の /model MODEL_ID コマンドを入力します。
/model だけを入力するとモデルピッカーが開きます。カスタムのゲートウェイ ID はそのデフォルトのリストに表示されない場合があります。 その場合は、上記のように完全な ID を入力してください。スラッシュコマンドは PowerShell や Bash ではなく、Claude Code の内部で使うものです。モデル名は Claude Sonnet や Opus ではなく、DeepSeek のモデルを指します。
ターミナル から起動する際にモデルを選択することもできます。1コマンドずつ実行してください:
claude --model deepseek-v4-flash
claude --model deepseek-v4-pro
今後のセッションのデフォルトを明示的に設定するには、settings.json の model を編集してください。起動フラグ、ANTHROPIC_MODEL 環境変数、プロジェクト設定や管理設定が選択されるモデルに影響を与えることがあります。起動時のモデルが保存した値と異なる場合は、これらを確認してください。
トラブルシューティング
| 症状 | 確認項目 |
|---|---|
| 401 / 予期しないログインプロンプト | APIMaster キー、ベース URL、競合する認証変数を確認し、設定編集後に CLI を再起動してください。 |
| 404 | https://apimaster.ai を使用し、/v1 や /v1/messages を付けないでください。 |
| 設定が反映されない | ファイルの場所、JSON の妥当性、ターミナル・プロジェクト・管理設定による上書きを確認してください。 |
| モデルがピッカーに表示されない | 正確な ID で /model MODEL_ID を入力するか、claude --model MODEL_ID で起動してください。 |
| モデルが利用不可 / 403 | スペル、キーで許可されたモデル、アカウント残高、現在のルートの利用可否を確認してください。 |
unrecognized_model |
当社のテストでカスタム ID で発生が確認されました。実際の回答とツールの結果を確認してください。Claude の組み込み機能のデフォルトは DeepSeek について検証されていません。 |
| ファイルやコマンドの権限エラー | 通常の権限プロンプトを通じて、意図した操作を確認・承認してください。 |
| 429 / 5xx / 応答の中断 | サポート対応のため、可能であればエラー内容、モデル ID、CLI バージョン、UTC時刻、リクエスト ID を保存してください。 |
検証と任意の診断
記録された統合テスト: 2026-09-07 UTC、Claude Code 2.1.239、Linux。ここに記載したすべてのモデルが期待通りのテキストを返し、ツールを通じてローカルファイルを読み取りました。複雑なコーディングタスクはそのテスト範囲外でした。Windows と macOS はこれらの記録された実行には含まれていません。
以前の自動チェックでは、設定を切り離して検証するためにベアモードを使用しました。通常の日常利用では、上記の settings.json と対話手順に従ってください。 ベアモードや --setting-sources "" は通常の統合や保存された設定をスキップするため、このガイドの日常的な起動コマンドに追加しないでください。
保存した設定を使った簡単な非対話チェックには、次を使用します:
claude --model deepseek-v4-flash -p "Reply with exactly OK."
ツールのチェックには、FILE_PROBE_739182 を含む probe.txt を作成し、そのディレクトリで Claude Code を起動し、ツールを使ってファイルを読み取り内容を正確に返すよう依頼します。ツールが実際に実行されたことを確認してください。
これらは限定的な統合チェックであり、Claude Code のすべての機能、長時間セッションの挙動、最大コンテキストを保証するものではありません。Anthropic のゲートウェイドキュメントは、Claude Code を Claude 以外のモデルへルーティングすることを公式にはサポートしていません。このガイドは APIMaster の統合について説明するものです。
FAQ
Claude のサブスクリプションでこれらのリクエストは支払われますか?
いいえ。この APIMaster 構成では、リクエストはお使いの APIMaster キーと残高を使用します。
モデルを切り替えた後もチャットを続けられますか?
はい。開いている会話内でモデル切り替えコマンドを使用し、次のメッセージを送る前に確認を待ってください。モデル間をきれいに比較するには、claude --model MODEL_ID で別セッションを開始してください。
