Turn a Black-Box AI Agent Into an X-Ray of Every Call
The Gated Guide · Comment Langfuse
The Langfuse Setup Kit
Turn your black-box AI agent into a full x-ray: every call, every cost, every step, on one screen. Free and open source. About ten minutes to set up.
Read This First
Your agent is a black box. This makes it glass.
Right now your Claude Code agent runs, makes a hundred little decisions, and burns your tokens, and you get to see almost none of it. Langfuse is a free, open-source tool that grabs every one of those hidden calls and lays them out in order on one screen: a timeline of exactly what your agent did, how long each step took, and what each one cost you, down to the fraction of a cent. Once it's wired in, you can click into any run, see the exact steps it took, and scroll straight to the moment something went wrong. This kit is the whole setup.
Part 1 of 5
Get Langfuse and grab your keys
Two ways to run it, both free. Cloud: go to cloud.langfuse.com, sign up, and create a project. Self-host: run it on your own machine with Docker if you want your data to stay local. Either way, open Settings and then API Keys, and create a new key pair. You get a Public key that starts with pk-lf- and a Secret key that starts with sk-lf-. Copy both, you'll need them in a second.
PASTE THIS to self-host in one command (optional)
git clone https://github.com/langfuse/langfuse.git cd langfuse docker compose up
Keep reading
Free, for an email.
Unlocks 13 more sections, 1 copy-paste prompt, the document version, and every other guide on the site, for free. Enter your email once to keep reading.
19,000+ follow where these guides come from.No spam. Unsubscribe in one click.