What is Claude Code Proxy

2025-08-06

πŸš€ Overview

Claude Code Proxy is designed specifically for Mac users who want to:

  • ✨ Use Claude Code with any AI models you prefer

  • πŸ›‘οΈ Maintain data privacy with local deployment

  • πŸ’° Control costs by choosing your own model providers

  • Get it from Mac Storeβ†’


πŸ“‹ How It Works

Step 1: Configure Model

Claude Code Proxy Main Interface

πŸ”‘ Configure API Key

Configure your API key and customize the base URL if you don't want to use OpenAI models.

Example: Use OpenRouter

https://openrouter.ai/api/v1

πŸ’‘ Pro Tip: You can use Ollama or LM Studio if they're OpenAI compatible!


Step 2: Select Your Models

Model Selection

Choose the models you want to use. If the provider doesn't provide a model list, you can enter them manually.


Step 3: Test Connection

Use the πŸ” Detect button to test model communication:

Connection Test

Common Issues & Solutions:

❌ Incorrect Base URL or API Key Error Example

❌ Network Issues Network Error


Step 4: Configure Proxy (Optional)

If you encounter network issues, configure a proxy:

Proxy Configuration

βœ… Success! Test again and it works: Success


🎯 Final Configuration

Your complete model configuration should look like this:

Complete Configuration

πŸš€ Launch Claude Code

  1. Click πŸ’Ύ Save Configuration
  2. Copy the command shown below
  3. Paste it into your Mac Terminal.app

Save and Launch

πŸŽ‰ You're all set! Now you can use Claude Code with your configured models.


πŸ“š Additional Resources

πŸ”§ Need Claude Code?

One-click installation script β†’

πŸ€– Want More Features?

Claude Code collections and guides β†’


Enjoy coding with AI! πŸš€