Margrop
Articles304
Tags463
Categories7

Categories

1password AC ACP AI AI Coding Assistant AI编程助手 AI辅助编程 AP API AppDaemon Aqara CC-Switch CI/CD CLI Tools CLI工具 Caddy Claude Code Cloudflare Codex Cookie 认证 Cron D1 Date Diagrams.net Diary Docker Docker Compose Efficiency Tools Electerm English Gateway Gemini CLI GitHub Actions HA HADashboard Hexo HomeAssistant IP IPv4 Java LVM‑Thin Linux MacOS Markdown MiniMax Multi-Agent MySQL NAS Nginx Node-RED Node.js OOM OpenAI OpenClaw OpenCode OpenResty PPPoE Portainer PostgreSQL ProcessOn Prometheus Proxmox VE RPC SOCKS5 SSL Session Shell Subagent TTS TimeMachine UML Uptime Kuma VPN VPS Web WebSocket Windows Workers activate ad adb adblock agent aligenie aliyun alpine annotation aop authy autofs backup baidupan bash bitwarden boot brew browser caddy2 cdn centos cert certbot charles chat chrome classloader client clone closures cloudflare cmd command commit container crontab ctyun ddsm demo dependency deploy developer devtools dll dns docker domain download draw drawio dsm dump dylib edge exception export fail2ban feign firewall-cmd flow frp frpc frps fuckgfw function gcc gfw git github golang gperftools gridea grub gvt-g hacs havcs heap hello hexo hibernate hidpi hoisting homeassistant hosts html htmlparser https iKuai idea image img img2kvm import index install intel io ios ip iptables iptv ipv6 iso java javascript jetbrains jni jnilib jpa js json jsonb jupter jupyterlab jvm k8s kernel key kid kms kodi koolproxy koolproxyr kvm lan lastpass launchctl learning lede letsencrypt linux live low-code lvm lxc m3u8 mac macos mariadb markdown maven md5 microcode mirror modem modules monitor mount mstsc mysql n2n n5105 nas network nfs node node-red nodejs nohup notepad++ npm nssm ntp oop openfeign openssl os otp ovz p14 packet capture pat pdf pem perf ping pip plugin png powerbutton print pro proxy pve pvekclean python qcow2 qemu qemu-guest-agent rar reboot reflog remote remote desktop renew repo resize retina root route router rule rules runtime safari sata scipy-notebook scoping scp server slmgr so socks source spk spring springboot springfox ssh ssl stash string supernode svg svn swagger sync synology systemctl systemd tap tap-windows tapwindows telecom template terminal tls tmux token totp tvbox txt ubuntu udisk ui undertow uninstall unlocker upgrade url v2ray vhd vim vlmcsd vm vmdk web websocket wechat windows with worker wow xiaoya xml yum zip 中国电信 云电脑 交换机 人机协作 代理 体检 值班 健康检查 光猫 公网IP 内存 内存优化 内网 内网IP 内网渗透 写作 升级 协作 博客 反向代理 启动 周一 周末 夏令时 多智能体 多节点 多节点管理 天猫精灵 天翼云 安全 安装 定时任务 容器 容器网络 导入 小米 常用软件 广告屏蔽 序列号 应用市场 异常 心跳 心跳检查 感悟 打工 打工人 技术 抓包 排查 描述文件 故障 故障排查 效率 效率工具 无服务器 日记 时区 显卡虚拟化 智能家居 智能音箱 服务器 服务管理 架构 梯子 模块 流程 流程图 浏览器 漫游 激活 火绒 焦虑 玄学 生活 电信 画图 监控 直播源 直觉 磁盘 端口 端口扫描 管理 续期 网关 网络 网络风暴 群晖 脚本 脚本优化 腾讯 自动化 虚拟机 认证 证书 语雀 超时 路由 路由器 软件管家 软路由 运维 运维监控 连接保活 连接问题 通信机制 部署 配置 钉钉 镜像 镜像源 门窗传感器 问题排查 防火墙 阿里云 阿里源 集客

Hitokoto

Archive

Managing Five AI Coding Assistants Simultaneously: How I Escaped Configuration Hell with CC Switch CLI

Managing Five AI Coding Assistants Simultaneously: How I Escaped Configuration Hell with CC Switch CLI

Managing Five AI Coding Assistants Simultaneously: How I Escaped Configuration Hell with CC Switch CLI

You probably won’t believe this, but just last week, I was simultaneously using five AI coding assistants — Claude Code, Codex, OpenCode, OpenClaw, and Gemini CLI.

Why so many? Because different tools excel at different things. Some are better at code review, others generate test cases faster, and some integrate better with my workflow.

But then one day, my go-to API reseller sent an email: “Hey, we’re changing our endpoint! Please update your configuration.”

I read that email and felt my stomach drop.

Five tools. Five configuration formats. Five different file paths.

This is the story of how I climbed out of “Configuration Hell” — and found CC Switch CLI along the way.

Background: Five Tools, Five “Dialects”

Let me show you just how messy my configuration files used to be:

Claude Code uses ~/.claude/settings.json, with field names like anthropicApiKey and apiUrl.
Codex uses ~/.codex/config.toml, with field names like api_key and base_url.
Gemini CLI is the special one — it uses ~/.gemini/.env environment variable format.
OpenCode uses ~/.config/opencode/opencode.json, but the format isn’t quite the same as Claude’s.
OpenClaw has its own ~/.openclaw/openclaw.json configuration system.

Every time I needed to switch API providers, I had to:

  1. Open one config file
  2. Check the docs to confirm the field name
  3. Modify it
  4. Save
  5. Repeat the above four times

This isn’t coding — this is filling out forms.

What’s even more annoying is that some field names look similar but aren’t quite the same — base_url vs apiUrl vs endpoint. Every time I had to double-check I hadn’t made a mistake.

Before vs After CC-Switch
Figure 1: My configuration file management before CC Switch — scattered everywhere, all different formats

The Pain Point: How Long Does It Take to Switch Providers?

Let me calculate the time:

Suppose I need to switch all tools from “Reseller A” to “Reseller B”:

  • Claude Code: Open ~/.claude/settings.json, find the apiUrl field, modify, save → 3 minutes
  • Codex: Open ~/.codex/config.toml, find base_url, modify, save → 3 minutes
  • Gemini CLI: Modify the environment variables in ~/.gemini/.env → 2 minutes
  • OpenCode: Open ~/.config/opencode/opencode.json, find the corresponding field → 3 minutes
  • OpenClaw: Open ~/.openclaw/openclaw.json, find the corresponding field → 3 minutes

Total: 14 minutes. And that’s the “smooth” scenario. If you accidentally modify the wrong field, troubleshooting adds even more time.

The scary part: if you have multiple environments (office, home, different projects), you’d have to repeat this for each one.

This isn’t coding — this is running errands.

The Turning Point: Discovering CC Switch CLI

After reaching my limit, I started searching for “AI coding assistant configuration management tools.” That’s when I found two projects:

  1. farion1231/cc-switch — The original desktop GUI version, written in Rust + Tauri
  2. SaladDay/cc-switch-cli — The CLI version, same functionality but better suited for someone like me who works over SSH

I chose cc-switch-cli because:

  • Most of my work happens on remote servers
  • Command-line operations can be scripted and automated
  • The TUI interface fits perfectly with my workflow

Installation is a single command:

1
curl -fsSL https://github.com/SaladDay/cc-switch-cli/releases/latest/download/install.sh | bash

After installation, just type cc-switch to enter the interactive TUI interface.

What Exactly Is CC Switch CLI?

CC Switch CLI is a cross-platform command-line tool written in Rust, designed specifically to unified management of Provider configurations for multiple AI coding assistants.

Supported applications:

  • Claude Code (default)
  • Codex
  • Gemini CLI
  • OpenCode
  • OpenClaw

It has six core functional modules:

Module What It Does
🔌 Provider Management One-click API provider switching, with speed testing
🛠️ MCP Server Management Unified management of MCP configurations across tools
💬 Prompts Management Backup and switch System Prompts
🎯 Skills Management Install and manage community Skills extensions
🌉 Proxy Management Local multi-app proxy routing control
⚙️ Configuration Management Backup, restore, WebDAV sync

Feature Overview
Figure 2: CC Switch CLI’s six core functional modules

Deep Dive into Core Features

1. Provider Management — One-Click Provider Switching

This is CC Switch’s core feature. Say I have multiple API provider configurations:

1
2
3
4
5
6
7
8
9
10
11
# List all configured providers
cc-switch provider list

# View the currently active provider
cc-switch provider current

# Switch to a specified provider
cc-switch provider switch apiyi-proxy

# Test provider API latency
cc-switch provider speedtest apiyi-proxy

CC Switch stores all provider information in a SQLite database (~/.cc-switch/cc-switch.db), then generates the corresponding configuration files for different applications.

For example, when switching to Claude Code, it updates ~/.claude/settings.json; when switching to Codex, it updates ~/.codex/config.toml. You don’t need to know what each tool’s configuration file looks like — CC Switch handles everything.

Provider Switch Workflow
Figure 3: CC Switch’s complete workflow when executing a Provider switch

2. Cross-Application Unified Management

This is the feature that surprised me most — one --app parameter handles all tools.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# List Claude's providers
cc-switch --app claude provider list

# List Codex's providers
cc-switch --app codex provider list

# View OpenClaw's providers
cc-switch --app openclaw provider list

# Sync MCP servers to Codex
cc-switch --app codex mcp sync

# View Gemini's prompts
cc-switch --app gemini prompts list

This means: No matter how many AI coding tools you use, you can operate them all with the same set of commands.

3. Prompts Management — Prompts You Won’t Lose

Have you ever spent hours crafting the perfect System Prompt, only to lose it when you switched environments?

CC Switch’s Prompts management can:

  • Backup System Prompts for all applications (CLAUDE.md, AGENTS.md, GEMINI.md, etc.)
  • Create multiple prompt presets and switch between them anytime
  • Sync to the cloud via WebDAV, so you won’t lose anything even when switching computers
1
2
3
4
5
6
7
8
9
10
11
# List all prompt presets
cc-switch prompts list

# Create a new preset
cc-switch prompts create "Code Review Mode"

# Activate a preset
cc-switch prompts activate 代码审查模式

# Export to file
cc-switch config export ~/cc-switch-backup.json

4. Skills Management — One-Click Community Skills Installation

CC Switch also supports Skills extension management. Find a good Skill on GitHub? Install and enable it with one command:

1
2
3
4
5
6
7
8
9
10
11
# Search for available Skills
cc-switch skills discover "testing"

# Install
cc-switch skills install superpower-tdd

# Enable the Skill
cc-switch skills enable superpower-tdd --app claude

# Sync to application directory
cc-switch skills sync

This is way more convenient than manually cloning repos and copying files to the correct directories.

5. Configuration Backup & WebDAV Sync

CC Switch automatically backs up configurations to ~/.cc-switch/backups/, keeping the last 10 versions.

1
2
3
4
5
6
7
8
9
10
11
12
# Create a backup
cc-switch config backup --name "before-provider-switch"

# Restore a backup
cc-switch config restore

# Configure WebDAV sync (supports services like Nutstore)
cc-switch config webdav set \
--base-url https://dav.example.com \
--username user \
--password pass \
--enable

With WebDAV sync, my provider configurations from the office automatically sync when I open my laptop at home.

6. Environment Checks

1
2
3
4
5
# Check which AI CLI tools are installed locally
cc-switch env tools

# Check for environment variable conflicts
cc-switch env check

This feature helped me discover ANTHROPIC_API_KEY environment variable conflicts multiple times — some tools set the API Key in environment variables, which caused the configuration file settings to be ignored.

Real-World Usage Experience

After using it for a week, here’s my honest assessment:

Pros:

  1. Drastically reduces repetitive operations: Used to take 14 minutes to switch providers, now one command does it
  2. Centralized configuration management: All provider information in one SQLite database, everything at a glance
  3. High degree of automation: Backup, restore, and sync can all be scripted
  4. Friendly interactive TUI: Don’t remember a command? Just type cc-switch for menu navigation
  5. Multi-language support: Can switch between Chinese and English interfaces

Cons:

  1. Learning curve: New users need to understand how the --app parameter works
  2. Some documentation is outdated: GitHub’s README is updated, but some third-party docs haven’t kept up
  3. No GUI: Users accustomed to desktop apps might find it inconvenient (but I prefer CLI)

My Daily Routine Now

After using CC Switch, my workflow now looks like this:

Arriving at the office in the morning:

1
2
# Check which provider I'm using today
cc-switch provider list

Switching providers:

1
2
3
4
5
6
# One-click switch
cc-switch provider switch rightcode

# Verify success
cc-switch --app claude provider current
cc-switch --app codex provider current

Backing up configuration:

1
2
# Automatic backup
cc-switch config backup

The whole process takes less than a minute, and there’s no risk of editing the wrong file.

Reflection: Configuration Management Is a Discipline

The more AI coding assistants I use, the more I realize: Configuration management is a discipline in itself.

More tools means each tool has its own configuration file format — this is historical baggage, but it’s also reality. However, we can’t be led around by reality.

CC Switch CLI’s solution is clear: So you don’t have to remember what each tool’s configuration file looks like — one set of commands handles everything.

It’s not perfect, but it’s the closest thing I’ve found to achieving “unified management.” If you’re also using multiple AI coding assistants, give it a try.

After all, we’re paying for AI’s capabilities — not paying with our time filling out forms.


Author: An engineer who climbed out of Configuration Hell

Image Descriptions:

CC Switch Central Hub
Image 1: CC Switch as a central hub, unified management of multiple AI coding assistant configurations

TUI Interface Screenshot
Image 2: CC Switch interactive TUI interface, supports menu navigation and real-time status viewing

Author:Margrop
Link:http://blog.margrop.com/post/2026-05-09-cc-switch-cli-ai-cli-provider-switch-en/
版权声明:本文采用 CC BY-NC-SA 3.0 CN 协议进行许可