Claude Code 連携

Claude Code を Puyun AI に接続し、Anthropic プロトコルで任意の大規模言語モデルを呼び出します。

概要

Claude Code は Anthropic 公式のコマンドライン AI プログラミングアシスタントで、ネイティブで Anthropic Messages API プロトコルを使用します。Puyun AI のプロトコル自動変換機能により、Claude Code から OpenAI や Gemini などの他のモデルを呼び出すことができ、OpenAI インターフェースへの適合作業は一切不要です。

設定方法

方法1:環境変数

ターミナルで以下の環境変数を設定します:

bash
export ANTHROPIC_API_KEY="sk-your-api-key"
export ANTHROPIC_BASE_URL="https://ai.tracup.com"

その後、Claude Code を直接実行します:

bash
claude

方法2:設定ファイル

Claude Code の設定ファイルで設定します。

~/.claude/settings.json を編集し、以下を追加します:

json
{
  "env": {
    "ANTHROPIC_API_KEY": "sk-your-api-key",
    "ANTHROPIC_BASE_URL": "https://ai.tracup.com"
  }
}

方法3:プロジェクトレベルの設定

プロジェクトのルートディレクトリに .claude/settings.json を作成します:

json
{
  "env": {
    "ANTHROPIC_API_KEY": "sk-your-api-key",
    "ANTHROPIC_BASE_URL": "https://ai.tracup.com"
  }
}

異なるモデルの使用

設定完了後、--model パラメータでモデルを指定できます:

bash
# Claude Sonnet の使用
claude --model claude-sonnet-4-6

# GPT-4o の使用(プロトコル自動変換)
claude --model gpt-4o

# Gemini 2.5 Pro の使用(プロトコル自動変換)
claude --model gemini-2.5-pro

# DeepSeek の使用(プロトコル自動変換)
claude --model deepseek-chat

接続の確認

以下のコマンドを実行して、設定が成功したか確認します:

bash
claude --model claude-sonnet-4-6 -p "Hello, 接続確認"

正常なレスポンスが返ってくれば、接続設定は成功です。

サービス階層

Claude Code の呼び出しは、アカウントのサービス階層に影響を受けます:

階層推奨ユース説明
Test機能検証Claude Code が正常に接続できるかの確認に適しています
Flex日常的な開発コストパフォーマンスに最も優れ、個人開発者に推奨
Enterpriseチーム本番最も安定しており、チームコラボレーションに推奨

よくある質問

接続タイムアウト

接続タイムアウトが発生した場合は、以下をご確認ください:

  1. ANTHROPIC_BASE_URLhttps://ai.tracup.com に設定されているか(/v1 を含めない)
  2. API Key が正しいか
  3. ネットワークから ai.tracup.com にアクセスできるか

モデルが利用不可

モデルが存在しないというエラーが返された場合:

  1. モデル名のスペルが正しいことを確認
  2. 現在のサービス階層でそのモデルが利用可能か確認
  3. ホームページで利用可能なモデル一覧の全容を確認

レスポンス形式の異常

Claude Code がレスポンスを解析できない場合:

  1. 使用しているモデルが Anthropic プロトコル変換に対応していることを確認
  2. Claude ネイティブモデルに切り替えて、変換の問題かどうかを検証
  3. 問題が続く場合は、テクニカルサポートにお問い合わせください