Claude-Code-Proxy

4 months ago 5

A dual-purpose monitoring solution that serves as both a proxy for Claude Code requests and a visualization dashboard for your Claude API conversations.

Claude Code Proxy serves two main purposes:

Claude Code Proxy: Intercepts and monitors requests from Claude Code (claude.ai/code) to the Anthropic API, allowing you to see what Claude Code is doing in real-time
Conversation Viewer: Displays and analyzes your Claude API conversations with a beautiful web interface

Transparent Proxy: Routes Claude Code requests through the monitor without disruption
Request Monitoring: SQLite-based logging of all API interactions
Live Dashboard: Real-time visualization of requests and responses
Conversation Analysis: View full conversation threads with tool usage
Easy Setup: One-command startup for both services

Go 1.20+
Node.js 18+
Anthropic API key
Claude Code

Clone the repository

git clone https://github.com/yourusername/claude-code-monitor.git cd claude-code-monitor
Set up your environment variables
Install and run (first time)

make install # Install all dependencies make dev # Start both services

Or use the script that does both:
Subsequent runs (after initial setup)
Using with Claude Code

To use this proxy with Claude Code, set:

export ANTHROPIC_BASE_URL=http://localhost:3001

Then launch Claude Code using the claude command.

This will route Claude Code's requests through the proxy for monitoring.

Web Dashboard: http://localhost:5173
API Proxy: http://localhost:3001
Health Check: http://localhost:3001/health

Running Services Separately

If you need to run services independently:

# Run proxy only make run-proxy # Run web interface only (in another terminal) make run-web

make install # Install all dependencies make build # Build both services make dev # Run in development mode make clean # Clean build artifacts make db-reset # Reset database make help # Show all commands

Create a .env file with:

PORT=3001 DB_PATH=requests.db ANTHROPIC_FORWARD_URL=https://api.anthropic.com

See .env.example for all available options.

claude-code-monitor/ ├── proxy/ # Go proxy server │ ├── cmd/ # Application entry points │ ├── internal/ # Internal packages │ └── go.mod # Go dependencies ├── web/ # React Remix frontend │ ├── app/ # Remix application │ └── package.json # Node dependencies ├── run.sh # Start script ├── .env.example # Environment template └── README.md # This file