1为什么需要 CCSC？
作为 CC Switch 的用户，你可能在管理多个 Claude 服务提供商（Anthropic、国产模型等）。但 CC Switch 的工作方式是修改 ~/.claude/settings.json，这带来了两个问题：
❌ 影响已运行的 Claude 会话
当你在 CC Switch 中切换服务商时，所有正在运行的 Claude 实例也会跟着切换，可能导致意外行为
❌ 仅支持全局作用域
所有 Claude 会话共享相同的环境变量，难以同时使用不同的服务商
✅ CCSC 解决方案
环境隔离 - 只影响由 CCSC 启动的 Claude 进程，不影响全局设置或其他运行中的实例
不污染配置 - 完全不修改 ~/.claude/settings.json
会话级服务商选择 - 每个终端会话可以使用不同的服务商
快速切换 - 无需打开 GUI，快速交互式选择
适用场景
- 同时开发多个使用不同服务商的项目
- 在不同 Claude 模型间测试同一代码库
- 并行运行使用不同服务商的 Claude 会话
2安装
bash
# 使用 npm 安装
npm install -g @terranc/ccsc
# 或使用 bun 安装
bun install -g @terranc/ccsc
# 或直接运行（无需安装）
npx @terranc/ccsc3使用方法
交互式选择
运行 ccsc 进行交互式选择：
bash
ccsc界面包含：
- 左侧面板：服务商列表，支持搜索
- 右侧面板：选中服务商的环境变量预览
传递参数给 Claude
除 -h/--help 和 -V/--version 外，所有参数都直接传递给 Claude：
bash
# 继续上次会话
ccsc --continue
# 跳过权限确认
ccsc --dangerously-skip-permissions
# 打印模式
ccsc --print "Hello"
# 指定模型
ccsc --model claude-sonnet-4-20250514
# 使用 npx 运行
npx @terranc/ccsc --continue帮助命令
bash
# 查看帮助
ccsc --help
# 查看版本
ccsc --version4快捷键
| 按键 | 功能 |
|---|---|
| ↑ / ↓ | 导航服务商列表 |
| PgUp / PgDn | 翻页（每页 10 条） |
| Enter | 确认选择 |
| Esc | 取消 |
| 输入文字 | 搜索/过滤服务商 |
5配置
数据源配置
服务商配置从 CC Switch 的 SQLite 数据库读取。
默认路径：~/.cc-switch/cc-switch.db
| 变量 | 说明 | 示例 |
|---|---|---|
CC_SWITCH_DB_PATH |
数据库文件完整路径 | /custom/path/cc-switch.db |
CC_SWITCH_HOME |
自定义配置目录 | /custom/config |
bash
# macOS / Linux
export CC_SWITCH_DB_PATH=/custom/path/cc-switch.db
# Windows (PowerShell)
$env:CC_SWITCH_DB_PATH = "C:\custom\path\cc-switch.db"
# Windows (CMD)
set CC_SWITCH_DB_PATH=C:\custom\path\cc-switch.db历史记录
服务商使用历史存储在 ~/.ccsc-history，最近使用的服务商会显示在列表顶部。
提示：删除该文件可以清除历史记录。
6常见问题
CCSC 和 CC Switch 有什么区别？
| 特性 | CC Switch | CCSC |
|---|---|---|
| 界面 | GUI 应用 | CLI 工具 |
| 配置修改 | 修改全局配置 | 不修改配置 |
| 会话隔离 | ❌ 所有会话共享 | ✅ 每个会话独立 |
| 多会话并行 | ❌ 不支持不同服务商 | ✅ 支持不同服务商 |
| 环境变量 | 全局设置 | 进程级注入 |
推荐用法：两者配合使用。CC Switch 用于管理服务商配置，CCSC 用于快速启动隔离的 Claude 会话。
找不到数据库文件？
确保你已经安装并配置了 CC Switch，并且至少添加过一个服务商。
bash
# 检查数据库文件是否存在
ls ~/.cc-switch/cc-switch.db
# 如果路径不同，设置环境变量
export CC_SWITCH_DB_PATH=/your/path/cc-switch.db如何同时运行多个不同服务商的 Claude？
打开多个终端窗口，在每个窗口中运行 ccsc 并选择不同的服务商即可。
原理
CCSC 通过进程级环境变量注入，每个 Claude 进程都有独立的环境配置，互不干扰。
7技术栈
Ink
React for CLI - 使用 React 组件构建终端 UI
ink-text-input
文本输入组件，支持搜索过滤
better-sqlite3
SQLite 绑定，读取 CC Switch 数据库
commander
CLI 框架，处理命令行参数
8开发
bash
# 克隆仓库
git clone https://github.com/TerranChao/ccsc.git
cd ccsc
# 安装依赖
npm install
# 构建
npm run build
# 本地测试
node dist/index.js
# 全局链接测试
npm link