Claude 配置切换器 (CCC) 🚀

轻松管理多个 Claude API 配置，一键切换，无需重启！

🚀 快速安装（3步搞定）

# 1. 全局安装
npm install -g claude-config-changer

# 2. 配置 Shell
npx ccc-setup

# 3. 重启终端或执行
source ~/.zshrc  # Mac/Linux
. $PROFILE       # Windows PowerShell

就这么简单！现在你可以使用 ccc 切换配置，ccs 启动 Claude Code 了。

📖 这是什么？

Claude 配置切换器是一个简单易用的工具，专门为使用 Claude Code 的用户设计。如果你：

使用多个 Claude API 服务（比如官方API、代理服务等）
经常需要在不同配置之间切换
厌倦了每次都要手动修改配置文件
希望切换后立即生效，不用重启终端

那么这个工具就是为你准备的！

✨ 主要功能

🎯 核心功能

一键切换配置 - 在多个 Claude API 配置间轻松切换
立即生效 - 无需重启终端或重新打开程序
图形化菜单 - 友好的选择界面，清楚显示当前使用的配置
自动检测变化 - Claude Code 运行时自动提示配置更新

🖥️ 平台支持

✅ Windows (PowerShell/命令提示符/Git Bash)
✅ macOS (终端)
✅ Linux (各种Shell)

🛡️ 安全特性

配置文件本地存储，不上传任何信息
API密钥在菜单中自动打码显示
支持多种Shell环境

🚀 快速开始

第一步：检查前置条件

在开始之前，请确保你的电脑已安装：

Node.js (版本 14.0.0 或更高)
- 访问 nodejs.org 下载安装
- 安装后在命令行输入 node --version 检查
Claude CLI
- 确保已经安装并能正常使用 claude 命令

第二步：安装配置切换器

方法一：全局安装（推荐）

打开终端或命令提示符，运行以下命令：

npm install -g claude-config-changer

方法二：使用 npx（无需全局安装）

如果不想全局安装，可以直接使用 npx：

npx claude-config-changer

第三步：配置 Shell 环境

安装完成后，运行以下命令自动配置你的 Shell 环境：

npx ccc-setup

这个命令会：

🔍 自动检测你的操作系统（Windows/Mac/Linux）
📝 找到正确的 Shell 配置文件（.bashrc/.zshrc/PowerShell Profile）
⚙️ 添加必要的配置，让 ccc 和 ccs 命令可用
✅ 提示你下一步操作

支持的 Shell：

✅ Windows PowerShell
✅ macOS/Linux Bash
✅ macOS/Linux Zsh
✅ Git Bash (Windows)

第四步：重新加载配置

根据系统不同，执行相应的命令：

Windows PowerShell：

. $PROFILE

macOS/Linux：

source ~/.zshrc   # 如果使用 zsh
source ~/.bashrc  # 如果使用 bash

或者直接重启终端窗口。

手动配置（如果自动配置失败）

Windows PowerShell 用户

如果 npx ccc-setup 没有自动完成配置，可以手动添加：

打开 PowerShell 配置文件：
```
notepad $PROFILE
```
如果文件不存在，先创建它：
```
New-Item -Type File -Path $PROFILE -Force
```

添加以下内容到配置文件：

# Claude Config Changer - PowerShell wrapper
$global:CCC_HOME = "$(npm root -g)\claude-config-changer"
. "$global:CCC_HOME\shell-wrapper.ps1"

保存并重新加载配置：
```
. $PROFILE
```

如果遇到执行策略错误，运行：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

输入 Y 确认。

macOS/Linux 用户

如果 npx ccc-setup 命令没有自动完成配置，你可以手动配置：

确定你的Shell类型：
```
echo $SHELL
```

编辑对应的配置文件：

# 对于 bash 用户
nano ~/.bashrc

# 对于 zsh 用户
nano ~/.zshrc

# 对于 fish 用户
nano ~/.config/fish/config.fish

添加Shell包装器：

对于 bash/zsh 用户，在配置文件末尾添加：

# Claude Config Changer - shell wrapper for environment refresh
# This enables hot-reload of environment variables and shell functions
if [ -f "$(npm root -g)/claude-config-changer/shell-wrapper.sh" ]; then
    source "$(npm root -g)/claude-config-changer/shell-wrapper.sh"
fi

对于 fish 用户，添加：

# Claude Config Changer - fish wrapper
set -x NPM_ROOT (npm root -g)
if test -f "$NPM_ROOT/claude-config-changer/shell-wrapper.sh"
    bass source "$NPM_ROOT/claude-config-changer/shell-wrapper.sh"
end

重新加载配置：

source ~/.bashrc   # 或 source ~/.zshrc

第四步：添加你的 Claude API 配置（重要！）

这一步非常重要，你需要添加你的 Claude API 信息，否则工具无法工作。

Windows PowerShell 用户（详细步骤）

1. 再次打开配置文件

在 PowerShell 窗口中运行：

notepad $PROFILE

2. 在文件中添加你的 API 配置

重要提示：如果文件中已经有第三步添加的包装器代码，请在它的下方添加以下内容。

找一个空行，然后粘贴以下模板（根据你的实际情况修改）：

# ===== Claude API 配置组 =====
# 说明：每个配置组代表一个不同的API服务
# 重要：所有配置都要用 # 号注释掉，工具会自动激活你选择的配置

# 官方 API（如果你有官方API密钥）
# $env:ANTHROPIC_BASE_URL="https://api.anthropic.com"
# $env:ANTHROPIC_AUTH_TOKEN="sk-ant-api03-在这里填写你的官方密钥"

# 代理服务 1（你的第一个代理服务）
# $env:ANTHROPIC_BASE_URL="https://你的代理地址.com"
# $env:ANTHROPIC_AUTH_TOKEN="你的代理密钥"

# 代理服务 2（如果你有多个代理服务）
# $env:ANTHROPIC_BASE_URL="https://另一个代理地址.com"
# $env:ANTHROPIC_AUTH_TOKEN="另一个代理密钥"

# 测试环境（可选，用于测试）
# $env:ANTHROPIC_BASE_URL="https://test-api.com"
# $env:ANTHROPIC_AUTH_TOKEN="测试密钥"

3. 修改为你的实际配置

示例：假设你有两个API服务

# ===== Claude API 配置组 =====

# 春秋中转站
# $env:ANTHROPIC_BASE_URL="https://xxxxoxue.com"
# $env:ANTHROPIC_AUTH_TOKEN="sk-xxxxxxx"

# 智谱GLM
# $env:ANTHROPIC_BASE_URL="https://open.bigmodel.cnxxxxxx"
# $env:ANTHROPIC_AUTH_TOKEN="xxxxxxxxxx"

注意事项：

⚠️ 每个配置都必须用 # 开头（这是注释符号）
📝 配置名称（如"春秋中转站"）会在菜单中显示
🔑 替换示例中的URL和密钥为你自己的
✅ 保存文件：按 Ctrl + S 保存，然后关闭记事本

4. 重新加载配置

在 PowerShell 窗口中运行：

. $PROFILE

macOS/Linux 用户

1. 打开配置文件

# 对于 bash 用户
nano ~/.bashrc

# 对于 zsh 用户（macOS 默认）
nano ~/.zshrc

2. 添加你的 API 配置

在文件末尾添加（根据你的实际情况修改）：

# ===== Claude API 配置组 =====
# 说明：每个配置组代表一个不同的API服务
# 重要：所有配置都要用 # 号注释掉，工具会自动激活你选择的配置

# 官方 API（如果你有官方API密钥）
# export ANTHROPIC_BASE_URL="https://api.anthropic.com"
# export ANTHROPIC_AUTH_TOKEN="sk-ant-api03-在这里填写你的官方密钥"

# 代理服务 1（你的第一个代理服务）
# export ANTHROPIC_BASE_URL="https://你的代理地址.com"
# export ANTHROPIC_AUTH_TOKEN="你的代理密钥"

# 代理服务 2（如果你有多个代理服务）
# export ANTHROPIC_BASE_URL="https://另一个代理地址.com"
# export ANTHROPIC_AUTH_TOKEN="另一个代理密钥"

3. 保存文件

按 Ctrl + X 退出
按 Y 确认保存
按 Enter 确认文件名

4. 重新加载配置

source ~/.bashrc  # 或 source ~/.zshrc

重要说明：

⚠️ 所有配置都必须用 # 注释掉，工具会自动激活你选择的配置
✅ 当前激活的配置是没有 # 号的那一组
📝 配置组名称：每组配置前的注释（如 # 官方 API）就是在菜单中显示的名称
🔄 保存后立即生效：保存文件后立即可以使用

📱 如何使用（超简单！）

完成上述配置后，你就可以开始使用了！整个过程只需要两个命令：ccc 和 ccs

第一步：切换配置（使用 ccc 命令）

1. 打开终端或 PowerShell

Windows 用户：按 Windows键 + R，输入 powershell，按回车
macOS 用户：按 Command + 空格，输入 terminal，按回车
Linux 用户：按 Ctrl + Alt + T 打开终端

2. 运行配置切换命令

输入以下命令并按回车：

ccc

3. 选择你要使用的配置

你会看到一个交互式菜单，类似这样：

🔧 Claude 配置切换器
选择要激活的配置:

? 选择 Claude 配置: (使用箭头键选择)
❯ 🟢 春秋中转站 (active)     ← 当前激活的配置（绿色圆点）
  ⚪ 智谱GLM               ← 可选配置（白色圆点）
  ⚪ 官方 API              ← 可选配置
  ⚪ 测试环境              ← 可选配置
  ──────────────
  Exit                    ← 退出不做修改

操作方法：

按 ↑ ↓ 箭头键移动选择
按 回车键确认选择
选择 Exit 或按 Ctrl + C 退出

4. 确认切换成功

选择后，你会看到成功消息：

⏳ 正在切换到 "智谱GLM"...
✅ 配置更新成功!
📍 当前使用: 智谱GLM

第二步：启动 Claude Code（使用 ccs 命令）

配置切换完成后，在同一个窗口输入：

ccs

然后按回车，Claude Code 就会使用你刚选择的配置启动！

完整使用示例

假设你要从"春秋中转站"切换到"智谱GLM"并开始使用：

# 步骤 1：查看并切换配置
PS C:\> ccc

🔧 Claude 配置切换器
选择要激活的配置:

? 选择 Claude 配置: 智谱GLM    # ← 选择智谱GLM，按回车

⏳ 正在切换到 "智谱GLM"...
✅ 配置更新成功!
📍 当前使用: 智谱GLM

# 步骤 2：启动 Claude
PS C:\> ccs

# Claude Code 启动，现在使用的是智谱GLM的API

高级技巧

1. 快速查看当前配置

运行 ccc 时，带有 🟢 绿色圆点的就是当前配置。

2. 在使用中切换配置（热重载）

如果你正在使用 Claude，想切换到其他API：

新开一个终端窗口（保持 Claude 运行）
在新窗口运行 ccc 切换配置

Claude 会显示提示：

🔄 检测到配置变化，环境变量已更新:
Base URL: https://新的API地址
Auth Token: 已设置
提示: 请使用ctrl(^) + c 结束本次对话，然后使用ccs开启新的对话

按 Ctrl + C 结束当前 Claude
运行 ccs 使用新配置重新启动

3. 直接传递参数给 Claude

ccs 命令支持所有 Claude 的原生参数：

# 查看 Claude 版本
ccs --version

# 查看帮助
ccs --help

# 其他 Claude 参数
ccs [任何claude支持的参数]

⚠️ 使用注意事项

首次使用前：确保已完成第四步的 API 配置
配置不显示：检查配置文件格式是否正确
命令找不到：重新打开终端窗口，或运行 . $PROFILE（Windows）或 source ~/.bashrc（Linux/macOS）

🛠️ 命令参考

`ccc` - 配置切换器

ccc                    # 显示配置选择菜单
ccc --help            # 显示帮助信息
ccc --config /path    # 使用指定路径的配置文件

`ccs` - Claude Code 启动器

ccs                   # 启动 Claude Code
ccs --help           # 显示 Claude 帮助
ccs --version        # 显示 Claude 版本
ccs [任何claude参数] # 传递参数给 Claude

❓ 常见问题

Q: 安装后提示找不到命令怎么办？

A: 请尝试以下步骤：

确认全局安装成功：
```
npm list -g claude-config-changer
```
检查npm全局路径：
```
npm root -g
```
重新打开终端窗口

手动刷新配置：

# Windows PowerShell
. $PROFILE

# macOS/Linux
source ~/.bashrc  # 或 ~/.zshrc

检查安装是否成功：
```
ccc --help
```

Q: 配置菜单是空的或者显示错误？

A: 请检查配置文件格式：

确保语法正确：
- Windows: 使用 $env:变量名="值"
- macOS/Linux: 使用 export 变量名="值"

确保有配置组名称：

# 正确 ✅
# 我的代理
# export ANTHROPIC_BASE_URL="https://..."

# 错误 ❌ (缺少组名称)
# export ANTHROPIC_BASE_URL="https://..."

检查文件编码：确保配置文件是 UTF-8 编码

Q: 切换配置后没有生效？

A: 请确认：

查看切换确认信息：切换成功后会显示绿色的确认消息
重新启动 Claude：结束当前的 ccs 进程，重新运行

检查环境变量：

# 查看当前配置
echo $ANTHROPIC_BASE_URL      # macOS/Linux
echo $env:ANTHROPIC_BASE_URL  # Windows PowerShell

Q: Windows 上提示权限错误？

A: 请尝试：

以管理员身份运行 PowerShell

允许脚本执行：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

重新安装包：
```
npm install -g claude-config-changer
```

Q: npm安装失败怎么办？

A: 请尝试：

检查网络连接

使用国内镜像：

npm install -g claude-config-changer --registry=https://registry.npmmirror.com

清理npm缓存：
```
npm cache clean --force
```
更新npm版本：
```
npm install -g npm@latest
```

Q: 我可以添加多少个配置？

A: 理论上没有限制。你可以添加任意数量的配置组，每个配置组包含：

一个描述性的名称（注释行）
API 基础 URL
认证令牌

Q: 配置文件存储在哪里？

A: 配置存储在系统的 Shell 配置文件中：

Windows PowerShell: $PROFILE (通常是 Documents\PowerShell\Microsoft.PowerShell_profile.ps1)
macOS/Linux: ~/.bashrc 或 ~/.zshrc

🔧 高级使用

自定义配置文件位置

如果你想使用不同位置的配置文件：

ccc --config /path/to/your/config/file

在脚本中使用

你可以在自动化脚本中使用这些工具：

#!/bin/bash

# 切换到生产环境配置
echo "切换到生产环境..."
# 注意：ccc 在脚本中需要手动配置

# 启动 Claude 处理任务
echo "启动 Claude 处理..."
ccs --version

卸载

如果需要完全卸载：

# 卸载全局包
npm uninstall -g claude-config-changer

# 手动删除配置文件中的相关内容
# Windows: 编辑 $PROFILE
# macOS/Linux: 编辑 ~/.bashrc 或 ~/.zshrc

更新

更新到最新版本：

npm update -g claude-config-changer

备份和恢复配置

备份配置：

# Windows
copy $PROFILE backup_profile.ps1

# macOS/Linux
cp ~/.bashrc ~/.bashrc.backup

恢复配置：

# Windows
copy backup_profile.ps1 $PROFILE

# macOS/Linux
cp ~/.bashrc.backup ~/.bashrc

🎉 新版本特性 (v2.1.0)

✨ 主要更新

🚀 自动化安装流程：新增 npx ccc-setup 命令，自动配置 Shell 环境
🖥️ 完整的 Windows 支持：改进了 PowerShell 集成，Windows 用户体验大幅提升
🔍 智能路径检测：自动查找全局 npm 安装路径，无需手动配置
📝 简化的配置流程：安装后立即提示配置步骤，新手友好
🛡️ 更好的错误处理：提供清晰的错误信息和解决方案

📋 更新日志

v2.1.0 (2024-09-23)

添加 ccc-setup 自动配置命令
改进 Windows PowerShell 支持
修复全局安装路径问题
优化安装后提示信息
更新文档，简化配置步骤

v2.0.2 (之前版本)

修复 Windows 换行符问题
改进跨平台兼容性
优化配置文件权限处理

📦 开发者信息

版本信息

# 查看当前版本
npm list -g claude-config-changer

# 查看所有版本
npm view claude-config-changer versions --json

本地开发

如果你想从源码安装或参与开发：

# 克隆项目
git clone https://github.com/zuogl/claudeCodeConfigChanger.git
cd claudeCodeConfigChanger

# 安装依赖
npm install

# 本地链接
npm link

# 运行测试
npm test

🤝 获取帮助

如果遇到问题：

查看命令帮助：
```
ccc --help
ccs --help
```
检查配置文件：确保格式正确
提交问题：访问 GitHub Issues
查看日志：运行命令时注意错误消息

检查npm包状态：

npm list -g claude-config-changer
npm outdated -g claude-config-changer

📜 许可证

MIT License - 免费使用，欢迎贡献代码！

💝 致谢

感谢所有为这个项目贡献想法和代码的朋友们！

快速提醒：

📦 推荐使用 npm install -g claude-config-changer 全局安装
⚙️ 记得配置Shell环境以启用命令包装器
🔧 首次使用前，请确保在配置文件中正确添加了你的 Claude API 信息
💡 所有配置都要先用 # 注释掉，工具会自动激活你选择的配置！

Name		Name	Last commit message	Last commit date
bin		bin
lib		lib
.gitattributes		.gitattributes
.gitignore		.gitignore
.npmignore		.npmignore
CHANGELOG.md		CHANGELOG.md
README.md		README.md
claude-config-changer-2.1.0.tgz		claude-config-changer-2.1.0.tgz
install.bat		install.bat
install.ps1		install.ps1
install.sh		install.sh
package-lock.json		package-lock.json
package.json		package.json
postinstall.js		postinstall.js
shell-wrapper.ps1		shell-wrapper.ps1
shell-wrapper.sh		shell-wrapper.sh

Latest commit

History

Folders and files

Repository files navigation

Claude 配置切换器 (CCC) 🚀

🚀 快速安装（3步搞定）

📖 这是什么？

✨ 主要功能

🎯 核心功能

🖥️ 平台支持

🛡️ 安全特性

🚀 快速开始

第一步：检查前置条件

第二步：安装配置切换器

方法一：全局安装（推荐）

方法二：使用 npx（无需全局安装）

第三步：配置 Shell 环境

第四步：重新加载配置

手动配置（如果自动配置失败）

Windows PowerShell 用户

macOS/Linux 用户

第四步：添加你的 Claude API 配置（重要！）

Windows PowerShell 用户（详细步骤）

1. 再次打开配置文件

2. 在文件中添加你的 API 配置

3. 修改为你的实际配置

4. 重新加载配置

macOS/Linux 用户

1. 打开配置文件

2. 添加你的 API 配置

3. 保存文件

4. 重新加载配置

📱 如何使用（超简单！）

第一步：切换配置（使用 ccc 命令）

1. 打开终端或 PowerShell

2. 运行配置切换命令

3. 选择你要使用的配置

4. 确认切换成功

第二步：启动 Claude Code（使用 ccs 命令）

完整使用示例

高级技巧

1. 快速查看当前配置

2. 在使用中切换配置（热重载）

3. 直接传递参数给 Claude

⚠️ 使用注意事项

🛠️ 命令参考

ccc - 配置切换器

ccs - Claude Code 启动器

❓ 常见问题

Q: 安装后提示找不到命令怎么办？

Q: 配置菜单是空的或者显示错误？

Q: 切换配置后没有生效？

Q: Windows 上提示权限错误？

Q: npm安装失败怎么办？

Q: 我可以添加多少个配置？

Q: 配置文件存储在哪里？

🔧 高级使用

自定义配置文件位置

在脚本中使用

卸载

更新

备份和恢复配置

🎉 新版本特性 (v2.1.0)

✨ 主要更新

📋 更新日志

📦 开发者信息

版本信息

本地开发

🤝 获取帮助

📜 许可证

💝 致谢

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

`ccc` - 配置切换器

`ccs` - Claude Code 启动器