claude-code-server CLAUDE.md

CLAUDE.md

このファイルは、Claude Code (claude.ai/code) がこのリポジトリでコードを作業する際のガイダンスを提供します。

ルール

• 日本語で会話してください。
• 新しい施策を試す前に、思考プロセスをユーザーに説明してください。

テストコードのルール

テストコードは以下のルールに従って作成してください：

1. テストメソッド命名規則

テストメソッド名は以下の形式で命名してください：

test_{対象機能}_{テスト条件}_と_期待結果であること

例：

def test_models_endpoint_GETリクエストを送信した場合_claude_sonnet_4だけが返されること(self, server_process):
def test_chat_completion_正常なチャットリクエストを送信した場合_回答が得られること(self, server_process, client):
def test_chat_completion_チャットリクエストで無効なAPIキーでリクエストを送信した場合_例外が発生すること(self, server_process):

2. AAAパターンの実装

すべてのテストメソッドは以下の3つのセクションに明確に分割してください：

def test_example_テスト条件_期待結果であること(self, fixtures):
    #------------------------------
    # 準備 (Arrange)
    #------------------------------
    # テストデータの設定、モックの準備など
    
    #------------------------------
    # 実行 (Act)
    #------------------------------
    # テスト対象の機能を実行
    
    #------------------------------
    # 検証 (Assert)
    #------------------------------
    # 結果の検証とアサーション

3. テストメソッドの構造化

• 準備 (Arrange): テストに必要なデータ、オブジェクト、モックを設定
• 実行 (Act): テスト対象の機能を実行（1つの操作に集中）
• 検証 (Assert): 期待される結果と実際の結果を比較・検証

4. テストケースの焦点化

• 各テストメソッドは1つの具体的なシナリオに集中する
• 複雑な並行処理や複数の条件を組み合わせたテストは避ける
• 基本的な動作確認を重視し、エッジケースは別のテストで扱う

5. BDDスタイルの採用

テスト名と内容は「〜の場合、〜であること」という形式で、ビジネス要件を明確に表現してください。

プロジェクト概要

これは、claude-code CLIをラップしてClaude AIの機能を標準APIインターフェース経由で提供する、OpenAI API互換サーバーです。LiteLLMをプロキシサーバーとして使用してOpenAI互換のリクエストを処理し、claude-code CLIに転送します。

アーキテクチャ

システムは2つの主要コンポーネントで構成されています：

1. LiteLLM Proxy (litellm_config.yaml): ポート4000でOpenAI互換APIリクエストを処理
2. Custom Provider (claude_code_server/provider.py): claude-code CLIコマンドを実行するCustomLLMクラス

フロー: OpenAI APIリクエスト → LiteLLM → ClaudeCodeProvider → claude-code CLI → レスポンス

主要な実装詳細

• CustomLLM継承: ClaudeCodeProviderはLiteLLMのCustomLLM基底クラスを拡張
• 非同期サポート: completion()とacompletion()メソッドの両方を実装
• プロバイダー登録: litellm_config.yamlのcustom_provider_mapで登録
• モデルマッピング: claude-sonnet-4 → claude-code-server/claude-code