jianshuo/ccglass

解決する課題

多くのAIコーディングエージェント（Claude CodeやCodexなど）は、標準のシステムプロキシ設定を無視するネイティブアプリやNode.js環境を使用しています。そのため、複雑なCA証明書を使用したり、パッチを当ててアプリを壊したりすることなく、システムプロンプト、ツールスキーマ、完全なメッセージ履歴といったLLMプロバイダーへの実際のトラフィックを検査することはほぼ不可能です。

仕組み

ccglass は、軽量なローカルリバースプロキシおよびWebダッシュボードとして機能します。クライアントのベースURL環境変数（例：ANTHROPIC_BASE_URL や OPENAI_BASE_URL）をlocalhostにリダイレクトすることで、コーディングエージェントとAI API間のプレーンなHTTP通信を傍受します。URLがハードコードされているツールに対しては、TLS MITMを使用したフォワードプロキシモードを提供し、対象トラフィックを復号してログに記録します。キャプチャされたすべてのリクエストは、スペースを節約するためにコンテンツアドレス指定形式で保存され、Webインターフェースを通じてリアルタイムで確認できます。

対象ユーザー

AIコーディングエージェントやIDE拡張機能（Cursor、Cline、Continueなど）を使用している開発者で、エージェントの動作をデバッグしたり、送信される正確なプロンプトを監査したり、トークン使用量やコストを追跡したい方に最適です。

主な特徴

• ライブリクエストストリーム: 完全なシステムプロンプト、ツール呼び出し、メッセージ履歴をリアルタイムで表示します。
• エージェントループの可視化: モデルによるツール選択とローカル実行結果の間のフローを示すシーケンス図を表示します。
• ターン間差分比較: 2つのリクエストを比較し、ターン間でどのコンテキストが追加または変更されたかを正確に確認できます。
• コストとトークンの追跡: 入力/出力/キャッシュトークンと、リクエストごとの推定米ドルコストをリアルタイムで計算します。
• 幅広い互換性: Claude Code、DeepSeek-TUI、Ollama、OpenRouter、およびさまざまなIDE拡張機能を含む、幅広いプロバイダーをサポートしています。
• 自己検査 (MCP): Claude Codeと併用する場合、エージェントはMCPツールを使用して、チャット内で自身のプロキシリクエストを検査できます。