whatisgithub

What is claude-desktop-proxy?

can-dy-jack/claude-desktop-proxy — explained in plain English

Analysis updated 2026-05-18

0TypeScriptAudience · developerComplexity · 3/5Setup · moderate

In one sentence

A local desktop proxy that lets Claude Desktop talk to third-party AI models instead of Anthropic's own servers.

Mindmap

mindmap
  root((claude-desktop-proxy))
    What it does
      Intercepts Claude Desktop requests
      Forwards to third-party models
    Tech stack
      Tauri
      React
      TypeScript
      Rust
    Use cases
      Switch model providers
      Manage config groups
    Audience
      Developers
    Platforms
      macOS
      Windows

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Redirect Claude Desktop's requests to a different AI model provider without modifying Claude Desktop itself.

USE CASE 2

Manage multiple model provider configurations and switch between them from one local app.

USE CASE 3

Run a self-hosted proxy that maps Claude model names to upstream models from another vendor.

What is it built with?

TypeScriptTauriReactRust

How does it compare?

can-dy-jack/claude-desktop-proxy0xradioac7iv/tempfsabboskhonov/hermium
Stars000
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatemoderatemoderate
Complexity3/53/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires configuring a gateway URL, API key, and model mappings before Claude Desktop can route through it.

So what is it?

Claude Desktop Proxy is a local desktop application that sits between the Claude Desktop app and the AI models it talks to. Instead of sending your requests directly to Anthropic, it intercepts them and forwards them to third-party model providers of your choosing. You can define multiple configuration groups, each with its own API endpoint, API key, and model mappings, and switch between them as needed. Setup works by pointing Claude Desktop's gateway URL to the proxy running locally on your machine, typically at a localhost address. You then configure the proxy itself with the real API endpoint and key for whichever model provider you actually want to use, along with a list of model names to expose. The proxy translates the Claude model name in each incoming request to the corresponding upstream model name you have mapped, so Claude Desktop believes it is talking to Claude while the request actually goes elsewhere. If a request arrives using a model name that has no configured mapping, the proxy returns an error instead of guessing. The app is built with Tauri, a framework for building desktop apps using web technology, paired with React, and is written in TypeScript. It produces installable packages for both macOS and Windows through GitHub Actions, with release builds published to the project's GitHub Releases page. The README also documents common installation issues, including a blank console window on Windows and a Gatekeeper warning on macOS for unsigned builds, along with the workaround commands for each. The README is written in Chinese, with a separate English translation file linked at the top. The project is tagged under the topics claude, claude-desktop, claude-desktop-proxy, and proxy.

Copy-paste prompts

Prompt 1
Walk me through configuring Claude Desktop's gateway URL to point to claude-desktop-proxy.
Prompt 2
Help me set up a model mapping so requests for claude-sonnet-4-6 get routed to a different provider.
Prompt 3
Explain how to build claude-desktop-proxy locally with npm run tauri:build.
Prompt 4
How do I fix the macOS Gatekeeper damaged app warning for this proxy's release build?

Frequently asked questions

What is claude-desktop-proxy?

A local desktop proxy that lets Claude Desktop talk to third-party AI models instead of Anthropic's own servers.

What language is claude-desktop-proxy written in?

Mainly TypeScript. The stack also includes TypeScript, Tauri, React.

How hard is claude-desktop-proxy to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is claude-desktop-proxy for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.