Claude Code モデルをモックで無料テスト

Claude Codeは、自分のマシンで動くCLIとAnthropicのサーバーで動くモデルの2つに分かれる。課金されるのはリクエストを読み答えるモデルの仕事だけなので、その部分だけを定型の応答を返す小さなサーバーに差し替えれば、CLIの実際の挙動はそのままに費用をなくせる。リクエストはMessages APIへのHTTP呼び出しとして送られ、応答は別の呼び出しではなくそれらのリクエストへの返信として返るため、モックは/v1/messagesエンドポイントだけを実装すればよい。

この解説では、この仕組みを使ってCLIが実際に何を送っているかを調べている。実行中に取得したリクエストには、CLIが追加するシステムプロンプト、ツール定義、以前の会話が含まれる。例として筆者はUserPromptSubmitフックを追加し、その出力がCLIの追加プリアンブル内の「UserPromptSubmit hook success:」という見出しの下に渡されることを確認した。同じ方法は以前、/compactが会話を要約に置き換える仕組み、MCPサーバーの説明やスキルがモデルに届く経路、MCPツールが120秒後にバックグラウンドへ移される仕組みの確認にも使われた。

調査だけでなく、モックで障害を模擬できることも示している。HTTP 529応答を決めた回数返すと、CLIの再試行の挙動を観察でき、再試行回数はCLAUDE_CODE_MAX_RETRIESで制御する。筆者は自身のmacOSアプリtanacodeでこのパターンを大規模に運用し、GitHub Actionsで毎日モックと本物のCLIを動かして、Claude Codeの更新による破損を検知している。