Skip to content
CC Switch WikiUnofficial Community Wiki

How does the routing (proxy) feature work? Claude Code

Quick fix

The post only states that routing is forwarded through local 127.0.0.1:15721/v1; no verifiable complete configuration solution is available.

Symptom

Section titled “Symptom”
Error output
路由(代理)功能是如何运作的？
English translation

How does the routing (proxy) feature work?

Cause

Section titled “Cause”

This post is a feature question about how Claude Code routing (proxy) mode works, not a confirmed fault report. Comments state that, when proxy/routing is enabled, the request path is `claude code -> ccs (127.0.0.1:15721/v1) -> 选择的provider`, and format conversion may occur in between. When it is disabled, Claude Code requests the selected provider directly, while cc-switch only changes the URL in `settings.json`.

The author further questioned whether the local proxy address or an OpenAI-compatible API address should be entered in the provider JSON, and noted that the meaning of “write to the general configuration” can be misleading. A later reply only said that the content in the general configuration must be edited first; the post does not provide verifiable complete configuration steps or a clear conclusion to this question.

Fix

Section titled “Fix”

  1. The original post does not provide a verifiable solution. To confirm how to fill in local routing and general configuration, continue following the source issue discussion.

Affected Versions

Section titled “Affected Versions”
ToolClaude Code
VersionUnknown
PlatformsUnknown

Source Issues

Section titled “Source Issues”

This page is distilled from 1 real issues

FAQ

Section titled “FAQ”
After enabling routing and claude, how does it find the provider that needs to receive the forwarded request?
The comments only state that the request first reaches `ccs (127.0.0.1:15721/v1)`, then is forwarded to the selected provider; the post does not explain the selection mechanism further.
After enabling routing and claude, why must a 127.0.0.1:15721/v1 configuration still be added under claude providers?
The discussion does not provide a verifiable clear conclusion; one reply mentions that the content in the general configuration must be edited first.
Section titled “Related problems”
Both ANTHROPIC_AUTH_TOKEN and ANTHROPIC_API_KEY setSwitching from DeepSeek or MiMo to Codex writes both authentication variables at once; this issue has no confirmed Codex fix.1 issues mergedAuth conflictLog out of the official Claude login, clear conflicting ANTHROPIC_* variables, set hasCompletedOnboarding to true in ~/.claude.json, and restart the terminal.6 issues mergedAll plugins show disabled: Claude CodeUpgrade to CC Switch v4.0.0 or later; it replaces only routing fields and preserves plugin configuration.5 issues merged

This is an unofficial community wiki with no affiliation to the cc-switch authors or the project itself. Its content is compiled from the project's public GitHub issues. This site distributes no software.