JA ▾
API キーを取得

getdeepseekapi.comガイド

Claude CodeでのDeepSeek APIの使い方:実際のオプション

Claude CodeでDeepSeek APIの使用方法を確認する場合、まず知っておくべきことは、Claude CodeがAnthropic形式のエンドポイントに接続するのに対し、本サービスはOpenAI形式を使用することです。変換プロキシでギャップを埋め、このページで設定方法を示します。

更新日:

主要ポイント

  • Claude CodeはAnthropic Messages APIを想定していますが、このサービスはOpenAI互換の/v1/chat/completionsを提供しています。
  • LiteLLMのようなローカルプロキシは、2つの形式間で変換できます。
  • Aider、Continue、Clineは、プロキシなしでOpenAI互換のベースURLを直接受け入れます。
  • これはDeepSeek公式APIではありません。IDがuncensoredの独立したオープンウェイトモデルです。
発光するアダプターで接続された2つのミスマッチなコネクタ。API形式間の変換を示すプロキシ

機能するものと機能しないものから始める

1時間の混乱を防ぐための2つの注意点。第一に、本サービスはDeepSeek公式APIではなく、DeepSeekや他社向けのルーターでもありません。独立したプロバイダがモデルIDuncensoredで1つのオープンウェイトモデルをホストしています。DeepSeek独自のモデルが必要な場合は、直接接続してください。第二に、Claude CodeはAnthropic Messages APIを基に構築されています。リクエスト送信先は変更できますが、送信されるデータは依然としてAnthropic形式のJSONです。

このサービスはOpenAI形式でPOST /v1/chat/completionsとGET /v1/modelsを公開しています。Claude Codeを直接接続しても機能しません。パスとペイロードが異なるためです。解決策は変換レイヤーです。Claude CodeからAnthropic形式の呼び出しを受け取り、https://api.getdeepseekapi.com/v1にOpenAI形式の呼び出しとして転送する小さなプロキシをマシン上で実行します。まさにこのためのツールが存在し、次のセクションでそのセットアップを行います。

開始する前に、期待値の確認が必要です。Claude Codeはファイルの読み込み、編集、コマンドの実行のために関数呼び出しを強く活用します。このAPIは関数呼び出しをサポートしており、ストリーミングされるtool_callsも含まれますが、特定のモデルが長いエージェントループをどのように処理するかは、自分のリポジトリでテストすべきものであり、前提としてはいけません。

キーを取得し、エンドポイントを確認する

Googleまたはメールアドレスとパスワードでアカウントを作成し、APIキーページを開きます。新規ユーザーはワンクリックで$0.50のトライアルクレジットを取得できます。これは7日間有効で、支払い情報の登録は不要で、以下のすべてをテストするのに十分です。トライアルキーは2つの同時リクエストと1分あたり60リクエストまで許可することに注意してください。これは一度に複数の呼び出しを行うエージェントツールにとって重要です。

export UNCENSORED_API_KEY="paste-your-key-here"

curl https://api.getdeepseekapi.com/v1/chat/completions \
  -H "Authorization: Bearer $UNCENSORED_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Reply with the word ready."}]}'

完了応答が返された場合、アップストリームの処理は完了です。残る作業はプロキシを接続することだけです。

オプション1:Claude Codeの前にLiteLLMプロキシを配置する

LiteLLMは、Anthropic互換のエンドポイントを提示し、OpenAI互換のバックエンドにルーティングするプロキシサーバーを備えたオープンソースプロジェクトです。エコシステムのこの部分は急速に変化するため、現在の機能セットについてはドキュメントを確認してください。

インストールと設定

pip install 'litellm[proxy]'

cat > litellm-config.yaml <<'EOF'
model_list:
  - model_name: uncensored
    litellm_params:
      model: openai/uncensored
      api_base: https://api.getdeepseekapi.com/v1
      api_key: os.environ/UNCENSORED_API_KEY
EOF

litellm --config litellm-config.yaml --port 4000

openai/プレフィックスはLiteLLMにOpenAI互換アダプターを使用させるためです。その後の名前はモデルとして送信されます。ターミナルを実行したままにしてください。

Claude Codeをプロキシにポイントする

Claude Codeはエンドポイントと認証情報を環境変数から読み取ります。2番目のターミナルで以下を実行します:

export ANTHROPIC_BASE_URL="http://localhost:4000"
export ANTHROPIC_AUTH_TOKEN="any-local-string"
export ANTHROPIC_MODEL="uncensored"
export ANTHROPIC_SMALL_FAST_MODEL="uncensored"
claude

ここでの認証トークンはローカルプロキシが期待するものです。実際のキーはプロキシの環境に保持されます。小さく高速なモデルの設定も重要です。Claude Codeは軽量なバックグラウンドタスクに別のモデルを使用するためです。未設定の場合、プロキシが知らないAnthropicモデル名を呼び出そうとします。新しいバージョンではこの設定の名前が異なる場合があるため、変数が無視される場合はclaude --helpを実行するか、現在のClaude Code設定ドキュメントを参照してください。

オプション2:OpenAIベースURLを直接受け取るツール

Claude Code自体ではなくAIコーディングアシスタントが目的の場合、すでにOpenAI形式を使用しているため、プロキシをスキップするツールがいくつかあります。それぞれがカスタムベースURLとモデル名を設定できます。

  • Aiderはターミナルペアプログラミングツールです。OPENAI_API_BASEとOPENAI_API_KEYを読み取り、モデルにopenai/プレフィックスを付けます。
  • Continueはエディタ拡張機能で、モデルエントリにはapiBaseとOpenAIスタイルのプロバイダーを設定できます。
  • Clineは、設定にOpenAI互換プロバイダーを提供し、ベースURL、キー、モデルIDのフィールドがあります。

Aiderではセットアップは3行で完了します:

export OPENAI_API_BASE="https://api.getdeepseekapi.com/v1"
export OPENAI_API_KEY="$UNCENSORED_API_KEY"
aider --model openai/uncensored

これらのツールはメニューを頻繁に変更するため、上記のフィールド名はガイドとして扱い、各プロジェクトの現在のドキュメントに従ってください。必要な値は変更されません:ベースURL https://api.getdeepseekapi.com/v1、あなたのキー、およびモデルID uncensored。

独自の軽量エージェントループを書く

完全なコーディングアシスタントが過剰な場合、ツール呼び出しを含む短いスクリプトで多くのことができます。このスクリプトは、モデルにファイルの読み込みを要求させ、その後ファイルをrole: "tool"メッセージとしてフィードします。

import json, os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.getdeepseekapi.com/v1",
    api_key=os.environ["UNCENSORED_API_KEY"],
)

tools = [{
    "type": "function",
    "function": {
        "name": "read_file",
        "description": "Read a text file from the project",
        "parameters": {
            "type": "object",
            "properties": {"path": {"type": "string"}},
            "required": ["path"],
        },
    },
}]

messages = [{"role": "user", "content": "What does main.py do? Read it first."}]

for _ in range(5):
    r = client.chat.completions.create(model="uncensored", messages=messages, tools=tools)
    msg = r.choices[0].message
    messages.append(msg)
    if not msg.tool_calls:
        print(msg.content)
        break
    for call in msg.tool_calls:
        args = json.loads(call.function.arguments)
        with open(args["path"]) as f:
            result = f.read()
        messages.append({"role": "tool", "tool_call_id": call.id, "content": result})

ループの上限を5に設定することで、混乱したモデルが無限に実行されるのを防ぎます。実際のツールでは、モデルがプロジェクト外のファイルを読み込めないようにパスを検証することも必要です。

レート制限、コスト、429エラーの修正

エージェントツールはリクエスト数が多くなります。1つのタスクで数十件のリクエストがトリガーされ、それぞれが拡大するコンテキストを再送信します。フルキーでは8件の同時リクエストと1分間300件の制限があります。concurrency付きの429は同時呼び出しが多すぎることを、rate_limited付きの429は1分あたりの呼び出しが多すぎることを意味します。一時的な過負荷時にはRetry-After: 5付きの429が表示されます。LiteLLMにリトライ設定を追加すれば自動リトライ可能です。詳細はドキュメントをご確認ください。

コストは抑えられています。入力は1Mトークンあたり$0.15、出力は1Mトークンあたり$0.50です。エージェントセッションで40回の呼び出しを行い、それぞれが30,000トークンのコンテキストを送信し、600トークンの応答を受け取ると仮定します。入力は1,200,000トークンで、コストは1.2 x $0.15 = $0.18です。出力は24,000トークンで、コストは0.024 x $0.50 = $0.012です。セッション全体で$0.192になります。コンテキストウィンドウは100,000トークンなので、読み込むファイルは焦点を絞ってください。

トライアル終了後、暗号資産(TRC20上のUSDT、Base上のUSDC)で$20〜$500の任意の整数額をチャージできます。ボーナスは$50で+5%、$100で+10%、$200で+15%です。詳細は価格ページおよびドキュメントをご覧ください。

プロキシセットアップのトラブルシューティング

症状原因試すこと
Claude Codeが不明なモデルを報告するバックグラウンドモデル名がマッピングされていない小さく高速なモデル変数もuncensoredに設定します
接続拒否プロキシが実行されていないか、ポートが異なるLiteLLMを起動し、ANTHROPIC_BASE_URLのポートを一致させます
アップストリームから401エラープロキシ環境のキーが間違っているUNCENSORED_API_KEYを再エクスポートし、プロキシを再起動します
ツール呼び出しが失敗またはループするモデルがエージェント形式で苦戦する温度を下げる、プロンプトを短くする、または Aider を代わりに使用する
頻発する 429 エラートライアルキーの同時実行数は 28 個の同時実行スロットを持つフルキーにチャージする

セットアップを安全に保つための習慣が 2 つあります。プロキシを localhost のみで実行し、ネットワーク上の他のユーザーがあなたのクレジットを使用できないようにしてください。また、実際のキーはバージョン管理の対象となるプロジェクトファイルではなく、プロキシの環境変数に保持してください。さらに、最初の長時間セッション中に X-Balance-USD レスポンスヘッダーを確認してください。エージェントのループでは、予想以上にトークンが消費される可能性があるためです。残高が上記の見積もりよりも急速に減少する場合は、入力するファイルを短くするか、ステップ数を制限してください。

失敗したリクエストは課金されません。したがって、実験は低コストで実施できます。プロンプトはトレーニングに使用されません。他のゲートウェイと比較するには、API キーの概要をお読みください。

質問と回答

Claude Code はこの API に直接接続できますか?

いいえ。Claude CodeはAnthropic Messages形式を使用し、本APIはOpenAIのchat completions形式を使用します。これら間にLiteLLMなどの変換プロキシを配置してください。

これは公式のDeepSeek APIですか?

いいえ。当サービスは ID uncensored の独立したオープンウェイトモデルのみをホストしており、DeepSeek やその他のベンダーとは提携していません。

プロキシなしで動作するツールはありますか?

Aider、Continue、Cline など、OpenAI 互換のプロバイダー設定を備えたツールです。Base URL、キー、モデル ID uncensored を設定してください。

ツール呼び出しは機能しますか?

はい。ストリーミングされた tool_calls や、role tool メッセージとして返される結果も含まれます。モデルがどのように処理するかを確認するために、独自のエージェントワークフローをテストしてください。

キーはフォーム 1 つで手に入ります

アカウントを作成し、キーをコピーし、ベースURLを変更します。これでセットアップは完了です。

API キーを取得