🚀 Claude Proxy
A secure HTTP API proxy for Anthropic Claude with comprehensive safety controls, permission management, and seamless integration with VS Code AI assistants.
⚡ Quick Start (One Command)
git clone https://github.com/saxyguy81/claude-proxy.git && cd claude-proxy && ./install.sh && code .
That's it! The API proxy starts automatically when you open VS Code.
🎯 Features
🔒 Enterprise-Grade Safety
- Permission Management: Interactive approval for dangerous operations
- Dangerous Pattern Detection: Blocks
rm -rf, format, delete, etc. - Tool Restrictions: Configurable allowlists for Claude tools
- Request Monitoring: Complete logging of all API interactions
🌐 Universal API Compatibility
- OpenAI API Format:
/v1/chat/completions endpoint - Claude API Format:
/v1/messages endpoint - Model Mapping: Automatic translation between API formats
- Standards Compliant: Works with any OpenAI-compatible tool
🛠️ VS Code Integration
- Automatic Startup: Server starts when you open workspace
- Pre-configured Extensions: Cline, Continue, Roo Code ready to use
- Background Tasks: Start/stop/restart through VS Code commands
- Real-time Monitoring: Permission prompts and request logs
🚀 Supported AI Assistants
✅ Cline - Pre-configured, zero setup
✅ Continue - Pre-configured, zero setup
✅ Roo Code - Environment variables set
✅ Cursor IDE - Manual configuration (5 minutes)
✅ Any OpenAI-compatible tool - Just point to http://localhost:8081/v1
🏗️ Architecture
┌─────────────────┐ HTTP API ┌─────────────────┐ Safety Layer ┌─────────────────┐
│ AI Assistant │ ──────────────→ │ API Proxy │ ─────────────────→ │ Claude CLI │
│ (Cline, etc.) │ ←────────────── │ (Port 8081) │ ←───────────────── │ (Anthropic) │
└─────────────────┘ JSON/HTTP └─────────────────┘ Permission Mgmt └─────────────────┘
📋 Manual Setup (5 Minutes)
1. Install and Start
git clone https://github.com/saxyguy81/claude-proxy.git
cd claude-proxy
npm install
npm start
For Cline Extension
{
"cline.apiProvider": "openai",
"cline.openaiApiKey": "dummy-key-not-needed",
"cline.openaiBaseUrl": "http://localhost:8081/v1",
"cline.openaiModelId": "gpt-4"
}
For Continue Extension
{
"continue.apiBase": "http://localhost:8081/v1",
"continue.apiKey": "dummy-key-not-needed",
"continue.modelName": "gpt-4"
}
For Roo Code
export OPENAI_API_BASE=http://localhost:8081/v1
export OPENAI_MODEL=gpt-4
For Cursor IDE
- Settings → Models → Custom API Base:
http://localhost:8081/v1 - Model:
gpt-4 - API Key:
dummy-key-not-needed
🔍 Verify It's Working
# Health check
curl http://localhost:8081/health
# List models
curl http://localhost:8081/v1/models
# Test chat completion
curl -X POST http://localhost:8081/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-4",
"messages": [{"role": "user", "content": "Hello!"}],
"max_tokens": 50
}'
🛡️ Safety in Action
When an AI assistant tries to use dangerous tools, you'll see:
🔐 Permission Request
Tool: Bash
Command: rm -rf temp/
⚠️ DANGEROUS PATTERN DETECTED: rm -rf
Allow this operation? [y/N/always]:
⚙️ Configuration
Default Config (claude-proxy.json)
{
"allowedTools": ["Read", "Edit", "Bash", "Write", "Glob", "Grep"],
"requirePermissionFor": ["Bash", "Edit", "Write"],
"dangerousPatterns": ["rm -rf", "format", "delete", "DROP TABLE", "sudo"],
"safety": {
"requireApproval": true,
"autoApprovePatterns": ["ls", "pwd", "cat"]
},
"maxConcurrentRequests": 5
}
VS Code Workspace Settings
The automated setup creates .vscode/settings.json with:
- Extension configurations for Cline, Continue
- Environment variables for terminals
- Auto-start task configuration
🧪 Testing & Quality
- 60 comprehensive tests - All passing
- 78.62% code coverage - Production ready
- API Server: 76.51% coverage
- Safety Proxy: 98.22% coverage
- Zero lint errors - Clean codebase
📚 Documentation
🔧 Commands
# Development
npm start # Start the API proxy
npm test # Run test suite
npm run lint # Check code quality
# VS Code Integration
npm run start # Start with auto-reload
code . # Open in VS Code (auto-starts proxy)
🚨 Troubleshooting
Port Already in Use
# Kill existing processes
pkill -f api-cli.js
# Or use different port
npm start -- --port 8082
VS Code Extensions Can't Connect
- Check server status:
curl http://localhost:8081/health - Verify extension settings in VS Code
- Restart VS Code or reload window
🔄 Updates
git pull origin main
npm install
./install.sh
🤝 Contributing
- Fork the repository
- Create a feature branch
- Make your changes with tests
- Run
npm test and npm run lint - Submit a pull request
📝 License
MIT - see LICENSE file for details.
🙏 Acknowledgments
- Anthropic for Claude and the Claude CLI
- VS Code extension developers for Cline, Continue, and other AI assistants
- Open source community for tools and libraries
🔗 Ready to get started?
Run the one-line setup: git clone https://github.com/saxyguy81/claude-proxy.git && cd claude-proxy && ./install.sh && code .
Your AI coding assistant will be running securely through the proxy in under 2 minutes! 🎉