Claude CodeでDeepSeekを使用する：V4 Flash / Pro セットアップガイド

Claude CodeはDeepSeekを使用できますか？ Claude Code 2.1.239を使用した当社のテストでは、APIMasterのMessagesエンドポイントを介してdeepseek-v4-flashとdeepseek-v4-proを正常に使用できました。 ANTHROPIC_BASE_URLをhttps://apimaster.aiに設定し、APIMasterキーを提供し、モデルを明示的に選択します。この構成により、クライアントがClaude Codeという名前でもDeepSeekが実行されます。

最終テスト日: 2026-09-07、Claude Code 2.1.239、Linux。両方のモデルが期待されたテキストを返し、ファイル読み取りツールのラウンドトリップを完了しました。すべての実行はコード0で終了しました。CLIはunrecognized_modelを出力しましたが、テストしたリクエストは成功しました。これらのチェックは、すべてのClaude Code機能、長時間のセッション、または将来のリリースのサポートを確立するものではありません。Windows / macOSのセットアップコマンドが含まれています。記録されたテストはLinuxで実行されました。

1. CLIとAPIキーの準備

インストールについては、環境ガイドとClaude Codeセットアップガイドに従ってください。バージョンを確認します：

claude --version

選択したDeepSeekモデルへのアクセス権と十分なクォータを持つAPIMaster APIキーを取得します。このチュートリアルでは、以下のセッション設定を使用します。通常のsettings.jsonを上書きする必要はありません。

2. ゲートウェイとキーの設定

これらの設定を通常のCLIセッションから分離するために、新しいターミナルを開きます。

macOS / Linux：

export ANTHROPIC_BASE_URL='https://apimaster.ai'
export ANTHROPIC_API_KEY='YOUR_APIMASTER_API_KEY'
unset ANTHROPIC_AUTH_TOKEN

Windows PowerShell：

$env:ANTHROPIC_BASE_URL = 'https://apimaster.ai'
$env:ANTHROPIC_API_KEY = 'YOUR_APIMASTER_API_KEY'
Remove-Item Env:ANTHROPIC_AUTH_TOKEN -ErrorAction SilentlyContinue

ここではサイトのオリジンを**/v1なしで**使用します。Claude Codeは/v1/messagesを追加します。APIキーはAPIMasterから取得する必要があります。これらのコマンドは、このターミナルとその子プロセスに影響し、保存されたログインファイルには影響しません。共有設定ファイルやリポジトリに実際のキーを置かないでください。

3. 最小限のテストリクエストを送信する

claude --bare --setting-sources "" --no-session-persistence --model deepseek-v4-flash --tools "" --output-format json -p "Reply with exactly: DEEPSEEK_TEST_OK"

期待される結果：is_errorがfalse、resultがDEEPSEEK_TEST_OK、プロセスがコード0で終了します。--modelをdeepseek-v4-proに変更して再度実行します。

テストされたバージョンの--bareモードは、明示的なAPIキー認証を使用し、通常のバックグラウンド統合をスキップします。--setting-sources ""は保存された設定ソースを除外し、--tools ""はこの1つのテキストテストのツールを無効にします。これらは意図的な診断設定であり、通常の使用中にツールを無効にするための要件ではありません。古いCLIバージョンでは、これらのフラグのすべてを受け入れない場合があります。

4. ファイル読み取りツールの検証

現在のディレクトリにprobe.txtを作成し、次の内容にします：

TOOL_PROBE_739182

実行：

claude --bare --setting-sources "" --no-session-persistence --model deepseek-v4-flash --tools Read --allowedTools Read --output-format json -p "Use the Read tool to read probe.txt in the current directory. Reply with only the exact content. Do not guess."

期待される結果：CLIがファイルを読み取り、TOOL_PROBE_739182を返します。deepseek-v4-proでも繰り返します。これにより、モデルがツールを要求し、その結果を受け取り、応答できるかどうかがチェックされます。このテストではReadツールのみが有効です。

同じターミナル設定で通常の対話型作業を行う場合：

claude --bare --setting-sources "" --model deepseek-v4-flash

Proで開始する場合：

claude --bare --setting-sources "" --model deepseek-v4-pro

対話型コマンドは--tools ""を省略するため、デフォルトのツールが使用可能です。通常どおり権限プロンプトを確認してください。--bareはフックや自動プロジェクト指示などの便利な機能をスキップします。最小限のセットアップが機能した後、通常の設定を意図的に有効にし、ゲートウェイやモデルを上書きしないことを確認してください。終了したらこのターミナルを閉じて、このセッションの環境を残さないようにします。

トラブルシューティング

症状	確認事項
unrecognized_model	2.1.239の両方のDeepSeek IDで観察されました。リクエストの完了を妨げませんでした。警告だけを失敗として扱うのではなく、最終結果を確認してください。
401または予期しないログインプロンプト	ANTHROPIC_API_KEYが設定されていることを確認し、このターミナルで競合するANTHROPIC_AUTH_TOKENを削除して、ベアモードを再試行してください。
404	ANTHROPIC_BASE_URLはhttps://apimaster.aiである必要があります。完全な/v1/messagesエンドポイントや/v1で終わるベースではありません。
不明な--bareオプション	テスト済みの2.1.239に対してバージョンを確認してください。必要に応じて一般的なインストールガイドを使用して更新してください。
probe.txtを読み取れない	ファイルのディレクトリから実行してください。ツールテストでは、--tools ""を使用する代わりにReadを有効にしてください。
別のモデルが選択されている	--modelで完全なモデルIDを渡し、保存された設定やモデルエイリアスの上書きを有効にする前に確認してください。
レート制限、クォータ不足、またはアップストリームエラー	エラーボディを読み、クォータとモデルの権限を確認し、サポート用にタイムスタンプを記録してください。

よくある質問

これはClaudeモデルを使用するのと同じですか？

いいえ。ここでのクライアントはClaude Codeです。選択されたモデルはDeepSeekです。特定のClaudeモデルに依存する機能は、このセットアップでは自動的にカバーされません。

Python SDKの例とベースURLが異なるのはなぜですか？

Python OpenAI SDKはhttps://apimaster.ai/v1を使用し、/chat/completionsを追加します。Claude Codeはhttps://apimaster.aiを使用し、/v1/messagesを追加します。各クライアントのドキュメントに記載されているベース形式を使用してください。

このゲートウェイでDeepSeek公式キーを使用できますか？

このチュートリアルでは、APIMasterが発行したキーが必要です。キーは発行元のプロバイダーに固有です。エンドポイントを変更するだけでは、資格情報やクォータは転送されません。

実際のツール使用はテストされましたか、それともテキスト応答のみですか？

両方のモデルで両方がテストされました。ツールテストではローカルファイルを読み取り、その内容を返しました。すべてのツール、バックグラウンドエージェント、または長時間のコーディングタスクがサポートされていることを確立するものではありません。

DeepSeekを続ける

• DeepSeek APIチュートリアル
• Codex CLIでのDeepSeek
• 一般的なClaude Code構成
• Claude Code CLIリファレンス