低コストAIバックエンド統合

この付録では、Claude Codeと互換性のある低コストAIバックエンド — DeepSeek、GLM/ZhipuAI、LiteLLM — の設定方法を説明します。

1. なぜ低コストバックエンドか

Claude CodeはAnthropicのClaudeモデルをデフォルトで使用します。Claude Proサブスクリプションは月$20で、定額制として毎月決まった回数の質問を利用できます。しかし、プロジェクトを多数進めたり大量のコード生成が必要な場合には、コストが負担になることがあります。

APIベースの低コストバックエンドを使えば使用した分だけ課金されるため、使い方が少なければClaude Proよりはるかに安く済みます。特にClaude Code CLIは、環境変数を変えるだけで別のAIバックエンドへ簡単に切り替えられる柔軟性を提供します。

低コストバックエンドが適している場合

• 大量作業（バッチ処理） — 数十個のエージェントジョブを連続して実行するとき（例：ハンドブックの複数章の生成）、従量課金は定額制サブスクリプションよりはるかに安くなります。
• 実験とプロトタイピング — 新しいハーネスをプロトタイピングしたりエージェント設定をテストしたりするときは、試行錯誤の過程で多くのトークンを消費することがあります。低コストバックエンドは実験コストを抑えてくれます。
• チームや教室での利用 — 複数人でひとつの作業空間を共有するときは、Claude Proのシート1つを分け合う代わりに、各自が自分の低コストAPIキーを使えます。
• コスト管理 — 従量課金では支出上限を厳格に設定できます。エージェントループが無限に回っても、APIキーの残高を超えて請求されることはありません。

2. DeepSeekバックエンド

DeepSeekとは？

DeepSeekは中国の低価格・高性能AIプラットフォームです。DeepSeek-V3などの最新モデルは、コード生成、数学的推論、多言語理解など様々な分野で優れた性能を示します。Claude互換APIを提供しているため、Claude Codeでは環境変数を変えるだけですぐに使い始められます。

主な特徴

• Claude互換API — Anthropic API形式をそのままサポートし、Claude Codeとシームレスに連携
• 手頃な価格 — 月$20のClaude Proより少ない使用量ならはるかに安い
• 極低料金 — DeepSeek-V3基準で100万入力トークンあたり約$0.27、100万出力トークンあたり約$1.10
• 強力なコード生成 — プログラミング言語の理解とコード作成能力に優れる
• オープンソースモデル — DeepSeek-V3/R1系などオープンソースモデルも提供

設定方法

ステップ1：DeepSeek APIキーの発行

https://platform.deepseek.com にアクセスしてアカウントを作成し、APIキーを発行します。無料クレジットの提供有無はプラットフォームの方針によって異なる場合があります。

ステップ2：環境変数の設定

macOS / Linuxの場合:

export ANTHROPIC_API_KEY="your-deepseek-api-key"
export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"

Windows (PowerShell)の場合:

$env:ANTHROPIC_API_KEY="your-deepseek-api-key"
$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"

ステップ3：Claude Codeの実行

環境変数を設定したら、通常どおりClaude Codeを実行します:

claude

3. GLM/ZhipuAIバックエンド

GLM/ZhipuAIとは？

ZhipuAIは中国のAI研究企業で、GLM（General Language Model）シリーズを開発しています。最新モデルのGLM-4は多言語処理能力に優れ、特に韓国語処理能力が高いため韓国語プロジェクトに適しています。DeepSeekと同じくClaude互換APIを提供します。ZhipuAIはグローバルな英語開発者プラットフォームZ.aiも一緒に運営しています。

主な特徴

• Claude互換API — Anthropic API形式をサポートし、Claude Codeと直接連携
• 多言語対応 — 韓国語・日本語・中国語などアジア言語の処理能力に優れる
• 韓国語に最適化 — 韓国語のコマンドと応答で高い品質を提供
• 従量課金 — 使用量に応じた課金でコスト効率が良い
• 無料ティアあり — GLM-4-Flashは無料ティアがあり、有料でも100万入力トークンあたり約$0.10水準の競争力ある価格

設定方法

ステップ1：ZhipuAI APIキーの発行

https://z.ai/model-api（Z.ai、ZhipuAIのグローバル英語開発者プラットフォーム）にアクセスしてアカウントを作成し、APIキーを発行します。

ステップ2：環境変数の設定

macOS / Linuxの場合:

export ANTHROPIC_AUTH_TOKEN="your-zai-api-key"
export ANTHROPIC_BASE_URL="https://api.z.ai/api/anthropic"

Windows (PowerShell)の場合:

$env:ANTHROPIC_AUTH_TOKEN="your-zai-api-key"
$env:ANTHROPIC_BASE_URL="https://api.z.ai/api/anthropic"

ステップ3：Claude Codeの実行

環境変数を設定したらClaude Codeを実行します。DeepSeekと同じ方法です:

claude

料金プラン: 従量課金APIと定額制GLM Coding Plan

GLMバックエンドには2つの利用方法があります。上で設定した従量課金APIはトークン使用量に応じて課金され、z.ai/model-api で発行したAPIキーを使用します。一方GLM Coding PlanはClaude Code、Cline、OpenCodeと互換性のある月額定額制サブスクリプションで、クレジットは5時間単位と週単位でリセットされます。

クレジットはトークンベースでモデルごとの倍率が適用され、5時間ごとおよび毎週リセットされます。すべてのプランにはGLM-5.3、GLM-5-Turbo、GLM-4.7モデルとVision、Web Search、Web Reader、Zread MCPサーバーが含まれます。最新の価格はサブスクリプションページで確認してください。ピーク時間帯（月〜金 14:00-18:00、UTC+8）以外の利用では50%割引が適用されます。

# macOS / Linux
export ANTHROPIC_AUTH_TOKEN="your-zai-api-key"
export ANTHROPIC_BASE_URL="https://api.z.ai/api/anthropic"

# Windows (PowerShell)
$env:ANTHROPIC_AUTH_TOKEN="your-zai-api-key"
$env:ANTHROPIC_BASE_URL="https://api.z.ai/api/anthropic"

設定を自動化するには npx @z_ai/coding-helper を実行する方法もあります。必要に応じて ANTHROPIC_DEFAULT_SONNET_MODEL のような環境変数でデフォルトモデルを指定できます。

詳細はGLM Coding Planサブスクリプションページ、公式料金プランドキュメント、Claude Code連携ガイドを参照してください。

モデル選択ガイド

4. LiteLLMプロキシ

LiteLLMとは？

LiteLLMは複数のAIバックエンドをひとつの統合APIで管理できるオープンソースプロキシです。複数のAIプロバイダ（OpenAI、Anthropic、DeepSeek、ZhipuAIなど）のAPIをひとつのエンドポイントに統合し、自動フェイルオーバー（failover）機能も提供します。

メリット

• 複数バックエンドの統合 — ひとつのAPIエンドポイントで複数のAIプロバイダを利用
• 自動フェイルオーバー — あるバックエンドが応答しないとき、自動的に別のバックエンドへ切替
• モデル単位のルーティング — リクエストごとに異なるバックエンド／モデルへルーティング可能
• 負荷分散 — 複数のプロバイダにわたってリクエストを自動分散
• コスト追跡 — リクエスト単位のトークン使用量とコストを内蔵ログに記録
• 無料のオープンソース — LiteLLM自体は無料（各バックエンドのAPI費用は別途）

インストール

Python環境が必要です。次のコマンドでインストールします:

pip install litellm
# または分離環境を好む場合
pipx install litellm

構成ファイルの作成

プロジェクトディレクトリに litellm_config.yaml ファイルを作成します:

model_list:
  - model_name: claude-sonnet
    litellm_params:
      model: deepseek/deepseek-chat
      api_key: os.environ/DEEPSEEK_API_KEY
  - model_name: claude-opus
    litellm_params:
      model: zhipu/glm-4
      api_key: os.environ/ZHIPU_API_KEY

プロキシの起動

litellm --config litellm_config.yaml

プロキシは http://localhost:4000 で起動します。

最後に、Claude Codeがこのプロキシを使うよう環境変数を設定して実行します:

export ANTHROPIC_API_KEY="any-key"
export ANTHROPIC_BASE_URL="http://localhost:4000"
claude

5. バックエンド比較

各バックエンドの特徴をひと目で比較してみましょう。

6. 実習: バックエンドの切り替え

この実習では、Claude CodeのバックエンドをClaude ProからDeepSeekへ切り替える全過程を段階的に進めます。環境変数の設定だけでバックエンドを切り替えられることを、直接確認してみましょう。

claude --version

export ANTHROPIC_API_KEY="sk-your-deepseek-key"
export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"

$env:ANTHROPIC_API_KEY="sk-your-deepseek-key"
$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"

claude

# macOS / Linux
export ANTHROPIC_AUTH_TOKEN="your-zai-api-key"
export ANTHROPIC_BASE_URL="https://api.z.ai/api/anthropic"

# Windows (PowerShell)
$env:ANTHROPIC_AUTH_TOKEN="your-zai-api-key"
$env:ANTHROPIC_BASE_URL="https://api.z.ai/api/anthropic"