説明
エージェントワークブックは、コーディングエージェントであるClaude CodeまたはCodexと基盤となるモデルの間に位置するローカルプロキシです。すべてのリクエストに1つの追加ツールコールを加えます：モデルが回答する前に考えを声に出して記述する場所で、行っている決定、考慮した代替案、各選択肢のコストを記録します。このプロジェクトの明示された目標は、開発者がエージェントの計画が実際に行うことと一致しているかを確認できるようにすることです。
続きを読む
プロキシはDocker Composeを介してローカルで実行され、127.0.0.1:8080でダッシュボードを公開します。モデルがノートを書いている間、各ノートがストリーミングされ、別々のCLIセッションが別の行に保持されます。Claude Codeは、ANTHROPIC_BASE_URLをローカルアドレスに設定することでプロキシを指し示します。Codexはカスタムモデルプロバイダーを介して構成されます。オプションの継続モードは、同じターン内でツールコール間に以前のノートを利用可能に保ちます（Codexではデフォルトでオン、Claude CodeではインストールされたClaude Codeバージョンと照合された後に明示的な環境フラグで有効化されます）。セッション数、メモリ、アイドルタイムアウトに関する設定可能な制限があります。
プロジェクトはそのコストを明確に文書化しています。すべてのターンでモデルに追加のコールを行い、モデルがノートを書き続けるときには最大4回のコールを行うため、入力トークンの使用量はほぼ倍増し、ターンごとに数百から数千の出力トークンが追加されます。また、隠れたノートコールが終了するまで応答のストリーミングは開始されず、最大60秒かかることがあります。さらに、ワークブックノートは通常のモデル出力であるため、貼り付けたAPIキーや秘密が表示される可能性があることを警告しています。
エージェントワークブックは、モデルの保護された内部推論を読み取ったり公開したりすることはありません。ノートは、モデルが書くことができる他のツール引数と同様に、通常のツールコールを通じて生成されます。オペレーターがアーカイブパスを設定しない限り、ディスクに書き込まれることはありません。また、プロジェクトの文書は、AnthropicやOpenAIのモデルからの推論トレースを収集またはトレーニングするために使用しないようにユーザーに明示的に求めています。Apache 2.0ライセンスの下でリリースされており、いずれの会社とも提携していないと述べています。
これは、Claude CodeまたはCodexを使用し、コーディングセッション中にエージェントの推論を可視化したい開発者を対象とした、小規模な単一開発者によるオープンソースプロジェクトです。非技術的ユーザー向けの製品ではありません。
- カテゴリーAI エージェントビルダー
- 料金モデルオープンソース
- デプロイセルフホスト
- プラットフォームWeb
エージェントワークブックの主要機能
ローカルプロキシがすべてのClaude Code / Codexリクエストに「声に出して考える」ツールコールを追加
ライブダッシュボード（127.0.0.1:8080）が書かれるノートをストリーミング
ダッシュボード上のCLIセッションごとに別々の行
ターン内で以前のノートを利用可能に保つオプションのクロスリクエスト継続
設定可能な継続制限（セッション数、メモリサイズ、アイドルタイムアウト）
Claude Code（ANTHROPIC_BASE_URL経由）およびCodex（カスタムプロバイダー設定経由）の両方で動作
完全にローカルでDocker Composeを介して実行され、構成されない限りディスクに書き込まれない
Apache 2.0オープンソースライセンス
エージェントワークブックをはじめる
リポジトリをクローン：GitHubからプロジェクトを取得（softcane/agents-workbook）。
プロキシを起動：docker compose up -d --buildを実行。
ダッシュボードを開く：127.0.0.1:8080にアクセスし、タブを開いたままにする。
CLIをプロキシに向ける：Claude Code用にANTHROPIC_BASE_URLを設定するか、Codexのモデルプロバイダー設定を構成する。
通常通り作業：Claude CodeまたはCodexを使用し、その推論がダッシュボードにストリーミングされるのを観察する。
継続を有効にする（オプション）：Claude Codeのツールコール間でノートを利用可能に保つためにWORKBOOK_CONTINUITY_CLAUDE_ENABLED=trueを設定。
エージェントワークブックの使用例
- 計画対行動の監査
- コーディングセッションのレビュー
- ローカルデバッグ
