ccproxy

🥈Silver

ccproxy enables developers to build custom mods for Claude Code, allowing them to hook any request, modify responses, and route intelligently. It benefits operations teams by streamlining AI model interactions and integrating with workflows like Claude Code, OpenAI, and OpenRouter.

389170Updated 2w ago

Intermediate30min to implementautomation

Saves ~180 min per use

Quick InstallView Source

git clone https://github.com/starbaser/ccproxy.git

Works with:

Claude

Overview

About This Skill

How to Use

["Install ccproxy in your development environment: `npm install -g ccproxy` or `pip install ccproxy`","Configure the proxy to target your specific AI service (e.g., OpenAI, Claude Code) by setting the `TARGET_SERVICE` environment variable or config file","Write a custom mod script (JavaScript/Python) that defines your interception logic using ccproxy's hook system. Example: `ccproxy.modifyResponse(condition, transformation)`","Run your application with the proxy active: `ccproxy --config=my-mods.json --target=openai`","Test your modifications by making sample requests and verifying the intercepted/modified responses in the proxy logs. Use `ccproxy --debug` for verbose output"]

Setup & Installation

Quick Install

No install command available. Check the GitHub repository for manual installation instructions.

Alternative Install (Git Clone)

git clone https://github.com/starbaser/ccproxy

Requirements

Claude Code or compatible AI agent
Works with: Claude

Quick Start Guide

Install the Skill

Copy the install command above and run it in your terminal.

Open Your AI Agent

Launch Claude Code, Cursor, or your preferred AI coding agent.

Try It Out

Use the prompt template or examples below to test the skill.

Customize

Adapt the skill to your specific use case and workflow.

Usage Examples

Prompt Template

Use ccproxy to intercept and modify API requests/responses for [TARGET_SERVICE] when interacting with [AI_MODEL]. Specifically, [ACTION]: [MODIFY_REQUEST/LOG_RESPONSE/INJECT_DATA]. Include [CONDITIONS] for when this should trigger. Example: 'Use ccproxy to log all API responses from OpenAI when the request contains the string "summarize" and inject a timestamp into the response metadata.'

Example Output

```json
{
  "intercepted_request": {
    "method": "POST",
    "url": "https://api.openai.com/v1/chat/completions",
    "headers": {
      "Authorization": "Bearer sk-...",
      "Content-Type": "application/json"
    },
    "body": {
      "model": "gpt-4",
      "messages": [{"role": "user", "content": "Summarize the Q3 financial report for Acme Corp"}],
      "max_tokens": 500
    }
  },
  "modified_response": {
    "original_content": "Acme Corp's Q3 revenue grew 15% YoY to $2.4B, driven by strong SaaS sales...",
    "modified_content": "[2024-05-15 14:32:17 UTC] Acme Corp's Q3 revenue grew 15% YoY to $2.4B, driven by strong SaaS sales...",
    "metadata": {
      "processing_time": "125ms",
      "proxy_action": "timestamp_injection",
      "user_id": "user_12345"
    }
  }
}
```

**Workflow Impact:**
The proxy intercepted 3 requests during this session, all containing the word 'summarize' in the prompt. The timestamp injection ensures traceability for audit purposes, while the metadata helps track latency and identify potential bottlenecks in the AI pipeline. This modification required zero changes to the original application code, demonstrating how ccproxy enables non-invasive customization of AI interactions.