@koffuxu: https://x.com/koffuxu/status/2054527573439181206
Summary
cc-switch is a desktop application that helps users switch the underlying large model used by Claude Code with one click through a visual interface, without manually modifying configuration files. The article introduces how to install and configure it to access the DeepSeek model, and explains how it works.
View Cached Full Text
Cached at: 05/14/26, 04:30 AM
No more manual configuration file changes: 3 steps to integrate Claude Code with DeepSeek V4
Claude Code + third-party models — changing the model requires modifying three places: settings.json, .zshrc, and restarting the terminal.
With the cc-switch tool, this entire process becomes a single click. Below are the installation and configuration steps, using DeepSeek as an example — 3 steps. No fluff, let’s go.
System Environment
💡 Hardware: MacBook Pro 2023
Chip: Apple M2 Pro
OS: macOS 14.5
Installation
- Visit the GitHub repo: https://github.com/farion1231/cc-switch. Open a terminal and run the following two commands to complete the installation.
brew tap farion1231/ccswitch brew install --cask cc-switch
- Open cc-switch: press
Cmd + Space, typeccswitch, and you’ll see the desktop app already installed. Open it as shown below:
Configuration & Usage
Configure Claude Code to use the DeepSeek model
-
Go to the DeepSeek website (https://platform.deepseek.com/api_keys), complete registration, create an API key, and copy it.
-
Open the cc-switch app, click the
+button in the top-right corner, then configure as follows:- API Key: The key you obtained in the previous step.
- Model Mapping: Configure as shown below.
-
Add this configuration to cc-switch, then enable the newly added DeepSeek profile.
Verification
When you open a terminal and run claude, you’ll see that it has automatically switched to DeepSeek V4 by default.
Other Questions
How does it achieve model switching?
It’s very straightforward: it writes the configuration directly into the native configuration files of each CLI tool.
User clicks the switch
↓
Reads the corresponding provider configuration from the SQLite database (~/.cc-switch/cc-switch.db)
↓
Writes it into the native configuration files of each CLI tool (e.g.,~/.claude.jsonfor Claude Code)
↓
Changes take effect
What I used to do manually — writing aliases in .zshrc — is exactly the same thing that cc-switch does, except cc-switch adds a GUI and automation.
How do I switch if I have an official Claude Pro subscription?
cc-switch includes a built-in Official Login preset. When you switch to it, it will:
- Clear all
ANTHROPIC_*environment variables. - Reset
customApiKeyResponsesto empty (no pre-approved third-party keys). - Claude Code, unable to find environment variables, falls back to reading
oauthAccount→ using your Pro subscription.
So just click the preset in the cc-switch interface; Claude Code doesn’t need to restart (hot-switch).
Closing Words
In a previous article, I wrote about how to configure Claude Code to use domestic large models seamlessly by editing configuration files. The method involved settings.json + ~/.zshrc to freely use different models with Claude Code.
Compared to other tools on the market, this approach is lightweight and fully configurable. I’ve been using it since last year without any plugins or extra tools. But the downside is obvious: you need to modify configuration files, which is still somewhat challenging for beginners.
Moreover, there’s one issue that can’t be solved: some models don’t support the Anthropic protocol — they only support the OpenAI protocol. In that case, a protocol conversion layer is needed.
Today, I’m showing you step by step how to visually configure large models for Claude Code using the cc-switch tool.
Alright, that’s all for the installation and usage of cc-switch. In the next article, I’ll cover how to integrate more free large models via cc-switch.
Similar Articles
@aehyok: Connecting Claude Desktop to China's DeepSeek Model via CC Switch — I noticed that even the CC Switch author cited Brother Yu's post. So I followed Brother Yu @xiangxiang103's guide and tried it myself. It took Brother Yu five minutes; for me, three minutes were more than enough.
The author connected Claude Desktop to the DeepSeek model using the CC Switch tool, following Brother Yu's tutorial, and it only took three minutes.
@Khazix0918: https://x.com/Khazix0918/status/2046082879109959807
This article is a beginner's guide to installing and using Claude Code for Chinese users, covering installation methods for both Mac and Windows (including setups without a VPN), as well as how to integrate domestic models (such as GLM-5.1) as alternatives to Claude's native models.
@Soranlan: https://x.com/sweexx9/status/2057560520916414628/video/1… This project is definitely going to be popular, but you need to be careful. Someone created a GitHub repo that redirects Claude Code traffic to Dee…
Introduces a GitHub repo that redirects Claude Code traffic to over a dozen free models like DeepSeek and Kimi, already used by 20,000+ developers. The article emphasizes that this tool reveals the trend of replaceability across layers: frontend interaction, workflow, model providers, etc.
@jianshuo: Only when you can see it can you talk about understanding. I wrote ccglass; install it via npm and you can see what Claude Code is secretly sending to the large model—system prompts, 48 tools, token accounts—all laid out.
ccglass is a zero-dependency local logging reverse proxy and web dashboard that lets you see in real-time the system prompts, tools, and token usage sent by coding agents like Claude Code to the large model.
@pritipatelfgoo: Claude Code free forever! This open-source tool free-claude-code proxies traffic to 10+ free/local backends such as DeepSeek, Kimi, NVIDIA NIM, OpenRouter, Ollama local models, achieving zero-cost usage...
free-claude-code is an open-source tool that proxies Claude Code's traffic to more than 10 free or local backends such as DeepSeek, Kimi, Ollama, etc., enabling permanent free usage of Claude Code. Supports CLI, VSCode, JetBrains, and Discord.