- ✨ 预置 Provider：内置
zhipu、88code两个配置，无需硬编码密钥 - 🔄 双端同步：同时更新 Claude Code (
settings.json) 和 Codex (auth.json) - 🎯 自定义 Provider：通过命令行参数自由添加新服务商
- 💾 自动备份：每次切换前自动备份配置，即使文件损坏也能安全恢复
- 🧹 智能清理：切换 Provider 时自动清理旧配置的冗余键
通过 SSH 连接到远程服务器，在没有图形界面的环境下快速切换不同的 AI 提供商，无需手动编辑配置文件。
场景示例：
ssh user@server
ccsw 88code # 切换到 88code 提供商
claude code # 使用新配置开始工作在容器内无 GUI 环境中管理 AI 工具配置，适合开发和测试环境的自动化部署。
场景示例：
# DockerfileRUN git clone https://github.com/Boulea7/ccsw.git && \
cd ccsw && \
./bootstrap.sh && \
export CODE88_ANTHROPIC_AUTH_TOKEN=${API_TOKEN} && \
ccsw 88codeAWS、阿里云、腾讯云等云主机上统一配置管理，支持批量部署脚本。
场景示例：
# 批量配置多台服务器
ansible all -m shell -a "cd ~/ccsw && ccsw zhipu"在自动化测试和部署流程中动态切换 AI 工具的提供商配置。
场景示例（GitHub Actions）：
- name: Switch AI Providerrun: | cd ~/ccsw ccsw 88code claude code analyze --file src/main.py开发、测试、生产环境使用不同的 AI 提供商，一键切换无需记忆复杂配置。
场景示例：
# 开发环境
ccsw zhipu
# 生产环境
ccsw 88code
# 快速回退cd~/.claude && cp settings.json.bak-20250117-143052 settings.json- Python 3.6 或更高版本
- Git（用于克隆仓库）
- 已安装 Claude Code 或 Codex
git clone https://github.com/Boulea7/ccsw.git &&cd ccsw说明：将项目下载到本地，所有操作都在 ccsw 目录中进行。
预期输出：
Cloning into 'ccsw'...
remote: Enumerating objects: 42, done.
remote: Counting objects: 100% (42/42), done.
...
./bootstrap.sh说明：脚本会自动检测你的 Shell（zsh 或 bash），并在配置文件中添加 ccsw 别名。
预期输出：
Detected shell: zsh
Adding ccsw alias to /Users/yourname/.zshrc...
✅ Alias 'ccsw' added successfully!
Please run: source ~/.zshrc
export ZHIPU_ANTHROPIC_AUTH_TOKEN="your_zhipu_token"export CODE88_ANTHROPIC_AUTH_TOKEN="your_88code_token"export CODE88_OPENAI_API_KEY="your_88code_token"# Codex 用，缺省与上同说明：将 API 令牌设置为环境变量，ccsw 会自动读取。建议添加到 ~/.zshrc 或 ~/.bashrc 中。
提示：如果你只使用 Claude Code（不使用 Codex），可以跳过 CODE88_OPENAI_API_KEY。
source~/.zshrc # 如果你使用 bash，则运行 source ~/.bashrc说明：让刚刚添加的 ccsw 别名生效。或者直接重启终端。
ccsw zhipu # 切换到智谱
ccsw 88code # 切换到 88code
ccsw 88 # 使用别名快捷切换（88 = 88code）预期输出：
[claude] Backed up previous settings to /Users/yourname/.claude/settings.json.bak-20250117-143052
[claude] Switched Claude Code environment to: 88code
[codex] Backed up previous auth to /Users/yourname/.codex/auth.json.bak-20250117-143052
[codex] Updated auth.json (OpenAI compatible).
提示：切换完成后，重启 Claude Code 或 Codex，新配置即可生效。
运行以下命令测试 ccsw 是否正常工作：
ccsw --help预期输出：
usage: ccsw.py [-h] [--token TOKEN] [--base-url BASE_URL] ...
Switch Claude Code / Codex providers
...
推荐运行 bootstrap.sh（自动检测 zsh/bash）：
./bootstrap.sh
source~/.zshrc # 或 ~/.bashrc如需手动配置，在 ~/.zshrc（或 ~/.bashrc）中添加：
alias ccsw="python3 $HOME/ccsw/ccsw.py"然后运行 source ~/.zshrc 重新加载配置。
| Provider | Claude Code | Codex | 特殊配置 | 环境变量 |
|---|---|---|---|---|
| zhipu | ✅ | ❌ | 超时 3000s 禁用非必要流量 | ZHIPU_ANTHROPIC_AUTH_TOKEN |
| 88code | ✅ | ✅ | 无 | CODE88_ANTHROPIC_AUTH_TOKENCODE88_OPENAI_API_KEY |
| 自定义 | ✅ | 可选 | 自定义 | 命令行参数 --token |
别名支持：
glm→zhipu88→88code
graph TD
A[用户运行: ccsw zhipu] --> B{检查环境变量}
B -->|存在| C[读取令牌]
B -->|不存在| D[❌ 报错: Token is required]
C --> E[备份当前配置]
E --> F[更新 settings.json]
F --> G[保存配置]
G --> H{是否配置 Codex?}
H -->|是| I[更新 auth.json]
H -->|否| J[跳过 Codex]
I --> K[✅ 切换完成]
J --> K
工作原理：
- 读取令牌：从环境变量或命令行参数获取 API 令牌
- 备份配置：复制当前配置为带时间戳的备份文件
- 更新配置：修改
~/.claude/settings.json的env字段 - 同步 Codex（可选）：如果提供了 OpenAI 兼容端点，同时更新
~/.codex/auth.json - 清理冗余：切换到
88code时自动移除智谱特有的配置键
除了内置的 zhipu 和 88code，你还可以添加自定义 Provider：
python3 ccsw.py myvendor \
--token "<your_token>" \
--base-url "https://api.myvendor.com/anthropic" \
--openai-base-url "https://api.myvendor.com/openai/v1" \
--timeout 30000 \
--disable-nonessential-traffic| 参数 | 必填 | 说明 |
|---|---|---|
--token | ✅ | Anthropic 兼容的认证令牌（内置 Provider 可通过环境变量提供） |
--base-url | ⭕ | Anthropic Base URL（内置 Provider 有默认值） |
--openai-base-url | ⭕ | OpenAI 兼容端点（用于 Codex，可选） |
--codex-token | ⭕ | Codex 用的 API Key（缺省使用 --token 的值） |
--timeout | ⭕ | API 超时时间（毫秒，可为字符串或数字） |
--disable-nonessential-traffic | ⭕ | 禁用 Claude Code 的非必要流量（写入 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1） |
--skip-codex | ⭕ | 只更新 Claude Code，跳过 Codex 配置 |
ccsw myvendor --token "sk-xxx" --base-url "https://api.example.com" --skip-codex本项目只做配置切换，不替代任何 CLI。你仍使用原有工具（Codex、Claude Code、其他 Anthropic 兼容 CLI），但在调用前用 ccsw ... 切到目标提供商即可。
使用流程：
ccsw 88code # 切换配置
↓
重启 Claude Code # 让新配置生效
↓
正常使用 # 享受新服务商
切换后重新打开/重连 Claude Code，或在新终端运行 Codex，即可使用最新的 env。
错误信息：
Token is required. Provide --token or set ZHIPU_ANTHROPIC_AUTH_TOKEN
解决步骤：
graph TD
A[遇到 token 错误] --> B[运行 echo 检查环境变量]
B --> C{输出为空?}
C -->|是| D[导出环境变量]
C -->|否| E[检查 token 格式是否正确]
D --> F[重新运行 ccsw zhipu]
E --> G{token 是否有引号?}
G -->|没有| H[添加引号]
G -->|有| I[联系服务商确认有效性]
快速修复：
# 检查环境变量echo$ZHIPU_ANTHROPIC_AUTH_TOKEN# 如果为空，导出令牌export ZHIPU_ANTHROPIC_AUTH_TOKEN="your_token_here"# 或者在命令中直接指定
ccsw zhipu --token "your_token_here"解决步骤：
graph TD
A[ccsw 命令找不到] --> B[重新加载配置文件]
B --> C{是否生效?}
C -->|否| D[检查 alias 是否正确添加]
D --> E{找到 alias?}
E -->|否| F[重新运行 bootstrap.sh]
E -->|是| G[检查路径是否正确]
G --> H{文件存在?}
H -->|否| I[检查仓库克隆位置]
H -->|是| J[尝试重启终端]
C -->|是| K[✅ 问题解决]
快速修复：
# 方法 1: 重新加载配置source~/.zshrc # 或 source ~/.bashrc# 方法 2: 重启终端# 关闭当前终端，打开新终端# 方法 3: 手动运行脚本（不使用 alias）
python3 ~/ccsw/ccsw.py zhipu每次切换都会创建带时间戳的备份文件，你可以轻松恢复：
# 进入配置目录cd~/.claude
# 列出所有备份文件（按时间倒序）
ls -lt settings.json.bak-*# 复制备份文件恢复（替换 XXXXXXXX 为实际时间戳）
cp settings.json.bak-20250117-143052 settings.json备份文件命名规则：
settings.json.bak-YYYYmmdd-HHMMSS：正常备份settings.json.corrupt-YYYYmmdd-HHMMSS：损坏文件备份
不是。ccsw 是一个小脚本/别名，职责单一：修改本地配置文件的 env 字段。
你仍然需要使用 Claude Code、Codex 等真正的 AI 编程工具。ccsw 只负责在不同服务商之间切换配置。
graph TD
A[问题未解决] --> B[检查备份文件是否存在]
B --> C{备份存在?}
C -->|是| D[恢复最近的备份]
C -->|否| E[检查配置文件是否损坏]
E --> F[删除损坏的 settings.json]
F --> G[重新运行 ccsw]
D --> H{问题解决?}
H -->|否| I[提交 GitHub Issue]
H -->|是| J[✅ 完成]
联系方式：
- 提交 Issue：GitHub Issues
- 查看日志：
~/.claude/settings.json.bak-*文件可帮助诊断问题
- 配置文件位置：固定为
~/.claude/settings.json（Claude Code）和~/.codex/auth.json（Codex） - 备份策略：
- 每次写入前复制为
settings.json.bak-YYYYmmdd-HHMMSS - 当文件损坏时另存为
settings.json.corrupt-YYYYmmdd-HHMMSS
- 每次写入前复制为
- 安全原则：
- 不把密钥写入仓库
.gitignore已忽略本地密钥文件（.env.local）、备份文件与本地配置目录
- 环境变量优先级：
- 命令行参数
--token - 内置 Provider 的环境变量（如
ZHIPU_ANTHROPIC_AUTH_TOKEN） - 缺省值（如果有）
- 命令行参数
- 增加 Provider 配置文件（YAML/JSON）读取，避免修改代码即可扩展
- 增加
--list输出当前配置和可用 Provider - 支持 Windows PowerShell 配置别名的辅助脚本
- 添加交互式切换模式（类似
fzf） - 支持多配置管理（如
work、personal等 Profile）
本项目采用 MIT License，详见 LICENSE。