Deskripsi
Buku Kerja Agen adalah proxy lokal yang berada di antara agen pengkodean, Claude Code atau Codex, dan model yang mendasarinya. Ini menambahkan satu panggilan alat tambahan untuk setiap permintaan: tempat bagi model untuk berpikir dengan keras sebelum menjawab, mencatat keputusan yang diambil, alternatif yang dipertimbangkan, dan biaya masing-masing opsi. Tujuan yang dinyatakan proyek ini adalah untuk memungkinkan pengembang memeriksa apakah rencana yang dinyatakan agen sesuai dengan apa yang sebenarnya dilakukan.
Baca Selengkapnya
Proxy berjalan secara lokal melalui Docker Compose dan mengekspos dasbor di 127.0.0.1:8080, di mana setiap catatan disiarkan saat ditulis, dengan sesi CLI terpisah disimpan dalam baris terpisah. Claude Code menunjuk ke proxy dengan mengatur ANTHROPIC_BASE_URL ke alamat lokal; Codex dikonfigurasi melalui penyedia model kustom. Mode kontinuitas opsional menjaga catatan sebelumnya tetap tersedia di seluruh panggilan alat dalam giliran yang sama (aktif secara default untuk Codex, dan diaktifkan untuk Claude Code dengan bendera lingkungan eksplisit setelah diperiksa terhadap versi Claude Code yang terpasang), dengan batas yang dapat dikonfigurasi pada jumlah sesi, ukuran memori, dan waktu tunggu tidak aktif.
Proyek ini mendokumentasikan biayanya dengan jelas. Karena membuat panggilan tambahan ke model untuk setiap giliran, dan hingga empat ketika model terus menulis catatan, ini kira-kira menggandakan penggunaan token input dan menambahkan ratusan hingga ribuan token output per giliran, dan balasan tidak mulai disiarkan sampai panggilan catatan tersembunyi selesai, hingga 60 detik. Ini juga memperingatkan bahwa catatan buku kerja adalah output model biasa, sehingga kunci API atau rahasia yang disalin dapat muncul di dalamnya.
Buku Kerja Agen tidak membaca atau mengekspos alasan internal yang dilindungi dari model; catatan yang dihasilkan melalui panggilan alat biasa, sama seperti argumen alat lain yang dapat ditulis oleh model. Tidak ada yang ditulis ke disk kecuali operator mengatur jalur arsip, dan dokumentasi proyek secara eksplisit meminta pengguna untuk tidak menggunakannya untuk mengumpulkan atau melatih jejak alasan dari model Anthropic atau OpenAI. Ini dirilis di bawah lisensi Apache 2.0 dan menyatakan bahwa tidak terafiliasi dengan salah satu perusahaan.
Ini adalah proyek kecil, pengembang tunggal, sumber terbuka yang ditujukan untuk pengembang yang menggunakan Claude Code atau Codex dan ingin melihat alasan agen selama sesi pengkodean, bukan produk untuk pengguna non-teknis.
- KategoriPembuat Agen AI
- Model HargaOpen source
- PenerapanDi-host sendiri
- PlatformWeb
Fitur Inti Buku Kerja Agen
Proxy lokal menambahkan panggilan alat "berpikir dengan keras" untuk setiap permintaan Claude Code / Codex
Dasbor langsung (127.0.0.1:8080) yang menyiarkan setiap catatan saat ditulis
Baris terpisah per sesi CLI di dasbor
Kontinuitas lintas permintaan opsional yang menjaga catatan sebelumnya tetap tersedia dalam satu giliran
Batas kontinuitas yang dapat dikonfigurasi (jumlah sesi, ukuran memori, waktu tunggu tidak aktif)
Bekerja dengan Claude Code (melalui ANTHROPIC_BASE_URL) dan Codex (melalui konfigurasi penyedia kustom)
Berjalan sepenuhnya secara lokal melalui Docker Compose; tidak ada yang ditulis ke disk kecuali dikonfigurasi
Lisensi sumber terbuka Apache 2.0
Memulai dengan Buku Kerja Agen
Klon repositori: Dapatkan proyek dari GitHub (softcane/agents-workbook).
Mulai proxy: Jalankan docker compose up -d --build.
Buka dasbor: Kunjungi 127.0.0.1:8080 dan biarkan tab terbuka.
Arahkan CLI Anda ke proxy: Atur ANTHROPIC_BASE_URL untuk Claude Code, atau konfigurasikan pengaturan penyedia model Codex.
Bekerja seperti biasa: Gunakan Claude Code atau Codex, dan saksikan aliran alasannya ke dasbor.
Aktifkan kontinuitas (opsional): Atur WORKBOOK_CONTINUITY_CLAUDE_ENABLED=true untuk menjaga catatan tetap tersedia di seluruh panggilan alat untuk Claude Code.
Kasus Penggunaan Buku Kerja Agen
- Audit rencana vs tindakan
- Tinjauan sesi pengkodean
- Debugging lokal
