告别繁琐的 API 配置切换！CC-CLI 让你一键切换 AI 模型

作为一个经常使用多个 AI 模型的开发者，你是否厌倦了每次切换都要手动修改环境变量？CC-CLI 诞生于这个痛点，让模型切换变得前所未有的简单。

背景

在使用 Claude、ChatGPT、智谱 AI 等多个 AI 模型时，我们经常需要：

切换不同的 API endpoint
更换 API key
修改模型名称
设置不同的环境变量

每次都要手动编辑配置文件或环境变量，不仅繁琐，还容易出错。于是 CC-CLI 应运而生！

什么是 CC-CLI？

CC-CLI 是一个轻量级的命令行工具，帮助你在不同的 AI 模型配置之间快速切换，并直接启动 Claude CLI。

核心特性

零依赖 - 纯 Bash/PowerShell 实现，无需安装任何依赖
跨平台 - 支持 macOS、Linux 和 Windows
交互式选择 - 使用上下键轻松选择模型
一键启动 - 选择模型后直接启动 Claude
配置管理 - 交互式添加、编辑、查看模型配置
安全可靠 - API key 部分隐藏显示，保护敏感信息

快速开始

安装

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/LiukerSun/cc-cli/main/install.sh | bash

Windows PowerShell:

# 设置执行策略（仅首次需要）
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

# 一键安装
irm https://raw.githubusercontent.com/LiukerSun/cc-cli/main/install.ps1 | iex

基本使用

1. 交互式选择模型

cc

会显示一个漂亮的交互式菜单，使用上下键选择模型，按 Enter 确认。

2. 查看所有模型

cc --list

3. 直接指定模型

cc 2    # 直接使用第 2 个模型

4. 添加新模型

cc --add

按照提示输入模型名称、API endpoint、API key 等信息。

5. 查看当前模型

cc --current

实际应用场景

场景 1：多模型对比测试

在开发 AI 应用时，我经常需要在不同的模型之间切换，测试哪个模型效果更好：

# 使用 Claude 3.5 Sonnet 测试
cc 1

# 切换到 GPT-4 测试
cc 2

# 再试试智谱 GLM
cc 3

每个模型配置都保存好了，一键切换，无需每次都输入 API key。

场景 2：开发环境与生产环境切换

开发时使用测试环境的 API，上线时切换到生产环境：

[
    {
        "name": "Claude (Dev)",
        "env": {
            "ANTHROPIC_BASE_URL": "https://dev-api.example.com",
            "ANTHROPIC_AUTH_TOKEN": "dev-key-xxx",
            "ANTHROPIC_MODEL": "claude-3-5-sonnet-20241022"
        }
    },
    {
        "name": "Claude (Production)",
        "env": {
            "ANTHROPIC_BASE_URL": "https://api.anthropic.com",
            "ANTHROPIC_AUTH_TOKEN": "prod-key-xxx",
            "ANTHROPIC_MODEL": "claude-3-5-sonnet-20241022"
        }
    }
]

场景 3：国内外模型切换

有时需要使用国外模型（Claude、GPT），有时需要使用国内模型（智谱、Kimi）：

# 使用 Claude
cc 1

# 切换到智谱 AI
cc 4

# 切换到 Kimi
cc 5

高级功能

Bypass 模式

启用 Claude 的 bypass permissions 模式：

cc -y 2    # 使用第 2 个模型并启用 bypass

传递参数给 Claude

# 传递 --help
cc 1 -- --help

# 传递提示词
cc 2 -- "写一个 Python 爬虫"

# 传递多个参数
cc 3 -- --version --verbose

仅设置环境变量

有时候只想设置环境变量，不启动 Claude：

# 仅设置环境变量
cc -e 2

# 然后在当前 shell 使用
source /tmp/cc-model-env.sh
claude

支持的 AI 模型

CC-CLI 支持所有兼容 Anthropic API 格式的模型：

国际模型

Claude (Official) - Anthropic 官方 API
OpenAI GPT-4 - 通过兼容层使用
Google Gemini - 通过兼容层使用

国内模型

智谱 AI - GLM 系列
Kimi (Moonshot AI) - 长上下文模型
MiniMax - 国产大模型
百度文心 - 通过兼容层使用
阿里通义 - 通过兼容层使用

自定义模型

只要 API 兼容 Anthropic 格式，都可以添加！

技术亮点

1. 零依赖设计

macOS/Linux 使用纯 Bash 实现（兼容 Bash 3.2+）
Windows 使用纯 PowerShell 实现（兼容 PowerShell 5.1+）
无需安装 Python、Node.js 等运行时

2. 跨平台兼容

经过充分测试的平台：

✅ macOS (Bash 3.2+)
✅ Linux (Bash 4.0+)
✅ Windows 10/11 (PowerShell 5.1+)

3. UTF-8 支持

完美处理中文、emoji 等多字节字符，支持无 BOM 的 UTF-8 编码。

4. 配置持久化

自动保存上次选择的模型，下次使用时会有标记提醒。

安全部计

API Key 保护

配置文件权限设置为 600（仅所有者可读写）
cc --show-keys 显示时部分隐藏（显示前 8 位和后 4 位）
建议将 .cc-config.json 添加到 .gitignore

配置文件位置

macOS/Linux: ~/.cc-config.json
Windows: %USERPROFILE%\.cc-config.json

实用技巧

1. 自定义编辑器

# 使用 VS Code 编辑配置
EDITOR=code cc --edit

# 永久设置
echo 'export EDITOR=code' >> ~/.zshrc
source ~/.zshrc

2. 快速切换

记住常用模型的编号，直接使用数字切换：

cc 1  # Claude
cc 2  # GPT-4
cc 3  # 智谱

3. 配置备份

定期备份配置文件：

cp ~/.cc-config.json ~/.cc-config.json.backup

4. 多配置文件

可以为不同项目维护不同的配置：

# 项目 A
cp ~/.cc-config.json ~/project-a/.cc-config.json

# 项目 B
cp ~/.cc-config.json ~/project-b/.cc-config.json

故障排除

常见问题

Q: Windows 上提示"无法加载文件，因为在此系统上禁止运行脚本"

A: 需要设置执行策略：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Q: 配置文件显示乱码

A: 运行修复脚本：

# Windows
./fix-config.ps1

Q: 命令未找到

A: 重启终端或重新加载配置：

# macOS/Linux
source ~/.zshrc

# Windows
. $PROFILE

项目信息

GitHub: https://github.com/LiukerSun/cc-cli
许可证: MIT
作者: LiukerSun
版本: v1.1.0

反馈与贡献

欢迎提交 Issue 和 Pull Request！

提交 Bug: https://github.com/LiukerSun/cc-cli/issues
功能请求: https://github.com/LiukerSun/cc-cli/issues/new
Pull Request: https://github.com/LiukerSun/cc-cli/pulls

总结

CC-CLI 是一个简单但实用的工具，它解决了 AI 开发中一个具体的痛点 - 频繁切换模型配置。通过交互式界面和一键切换，让这个过程变得轻松愉快。

如果你也经常使用多个 AI 模型，不妨试试 CC-CLI，相信它会成为你开发工具链中的一员！

安装命令：

macOS/Linux:

curl -fsSL https://raw.githubusercontent.com/LiukerSun/cc-cli/main/install.sh | bash

Windows:

irm https://raw.githubusercontent.com/LiukerSun/cc-cli/main/install.ps1 | iex

一行命令，开始使用！ 🚀

可乐呢o3o