CCCLI - Claude Code CLI 配置管理工具

简化 Claude CLI 配置管理，让多环境切换更轻松

English | 中文

中文

简介

CCCLI 是一个专为 Claude CLI 设计的配置管理工具，帮助开发者轻松管理多个 API 配置、快速切换环境，并提供便捷的快捷配置模板。

功能特性

• 🎯 多环境配置管理 - 支持创建和管理多个独立的 API 配置
• ⚡ 快速切换配置 - 一键在不同配置之间切换
• 🚀 预设模板支持 - 内置 Kimi、阿里、Poe、智谱等热门 AI 服务模板
• 🔄 配置导出备份 - 支持将配置导出为 JSON 格式
• 🌐 代理配置 - 方便地为不同配置设置代理
• 💻 Shell 自动补全 - 提供命令行自动补全功能
• 🎨 交互式配置 - 支持友好的交互式配置向导

安装

全局安装

npm install -g @monxterlab/cccli

本地安装

如果你希望在项目中本地安装，可以使用以下方式：

# 安装到当前项目
npm install --save-dev @monxterlab/cccli

# 通过 npx 运行
npx cc <command>

# 或者通过 npm scripts 运行
npm run cc -- <command>

在 package.json 中添加脚本：

{
  "scripts": {
    "cc": "cc",
    "cc:set": "cc set",
    "cc:active": "cc active",
    "cc:list": "cc list"
  }
}

然后运行：

npm run cc:list
npm run cc:set my-config ANTHROPIC_BASE_URL https://api.example.com

前置要求

• Node.js >= 16.0.0
• npm 或 yarn

快速开始

1. 初始化配置模板

cc q --init

2. 创建你的第一个配置

# 使用快捷模板创建配置
cc q zhhipu your-zhipu-api-key

3. 激活配置

cc active zhhipu

4. 验证配置

cc get zhhipu

命令参考

基础命令

| 命令 | 说明 | 示例 | |------|------|------| | list | 列出所有配置 | cc list | | get <name> | 查看指定配置详情 | cc get zhhipu | | set <name> <key> <value> | 设置配置项 | cc set zhhipu ANTHROPIC_BASE_URL https://api.example.com | | unset <name> [key] | 删除配置或配置项 | cc unset zhhipu | | active <name> | 激活指定配置 | cc active zhhipu |

快速配置命令

| 命令 | 说明 | 示例 | |------|------|------| | q <template> <key> | 使用模板快速创建配置 | cc q zhhipu sk-xxx | | q --list | 列出所有可用模板 | cc q --list | | q --init | 初始化默认模板 | cc q --init |

导出命令

| 命令 | 说明 | 示例 | |------|------|------| | export json | 导出所有配置为 JSON | cc export json |

代理配置

| 命令 | 说明 | 示例 | |------|------|------| | proxy <name> <url> | 为配置设置代理 | cc proxy zhhipu http://127.0.0.1:7890 | | env <name> <key> <value> | 设置环境变量 | cc env zhhipu HTTP_PROXY http://proxy.com |

系统命令

| 命令 | 说明 | |------|------| | upgrade | 升级工具到最新版本 | | --version | 显示版本信息 | | --help | 显示帮助信息 |

可用模板

| 模板名称 | 服务提供商 | 基础 URL | |----------|----------|----------| | kimi_coding | Kimi | https://api.kimi.com/coding | | kimi | Moonshot | https://api.moonshot.cn/anthropic | | ali_coding | 阿里云 | https://coding.dashscope.aliyuncs.com/apps/anthropic | | poe | Poe | https://api.poe.com | | zhhipu | 智谱AI | https://open.bigmodel.cn/api/anthropic |

配置文件位置

• Windows: %USERPROFILE%\.cccli\config.json
• macOS/Linux: ~/.cccli/config.json

使用示例

场景 1：管理多个 AI 服务

# 配置 Kimi
cc q kimi sk-kimi-api-key
cc active kimi

# 切换到智谱AI
cc q zhhipu sk-zhipu-api-key
cc active zhhipu

场景 2：导出配置备份

# 导出所有配置
cc export json > backup.json

# 查看导出的配置
cat backup.json

场景 3：使用代理

# 为特定配置设置代理
cc proxy zhhipu http://127.0.0.1:7890

Shell 自动补全

Bash

echo 'source <(cc completion bash)' >> ~/.bashrc
source ~/.bashrc

Zsh

echo 'source <(cc completion zsh)' >> ~/.zshrc
source ~/.zshrc

PowerShell

Add-Content $PROFILE "Invoke-Expression (& { (cc completion powershell | Out-String) })"
. $PROFILE

故障排除

问题：命令未找到

# 确认全局安装路径
npm root -g

# 添加到 PATH（如果需要）
export PATH="$PATH:$(npm root -g)/.bin"

问题：配置文件权限错误

# Linux/macOS
chmod 600 ~/.cccli/config.json

查看详细错误信息

cc --debug <command>

贡献

欢迎提交 Issue 和 Pull Request！

许可证

MIT License

English

Overview

CCCLI is a configuration management tool designed for Claude CLI, helping developers easily manage multiple API configurations and quickly switch between environments with convenient preset templates.

Features

• 🎯 Multi-environment configuration management - Create and manage multiple independent API configurations
• ⚡ Quick configuration switching - One-click switching between different configurations
• 🚀 Preset templates - Built-in templates for Kimi, Alibaba, Poe, Zhipu and other popular AI services
• 🔄 Configuration export and backup - Export configurations to JSON format
• 🌐 Proxy configuration - Easily set up proxies for different configurations
• 💻 Shell auto-completion - Command-line auto-completion support
• 🎨 Interactive configuration - Friendly interactive configuration wizard

Installation

Global Installation

npm install -g @monxterlab/cccli

Local Installation

If you prefer to install locally in your project, you can use:

# Install to current project
npm install --save-dev @monxterlab/cccli

# Run via npx
npx cc <command>

# Or run via npm scripts
npm run cc -- <command>

Add scripts to your package.json:

{
  "scripts": {
    "cc": "cc",
    "cc:set": "cc set",
    "cc:active": "cc active",
    "cc:list": "cc list"
  }
}

Then run:

npm run cc:list
npm run cc:set my-config ANTHROPIC_BASE_URL https://api.example.com

Prerequisites

• Node.js >= 16.0.0
• npm or yarn

Quick Start

1. Initialize configuration templates

cc q --init

2. Create your first configuration

# Create configuration using quick template
cc q zhhipu your-zhipu-api-key

3. Activate configuration

cc active zhhipu

4. Verify configuration

cc get zhhipu

Command Reference

Basic Commands

| Command | Description | Example | |---------|-------------|---------| | list | List all configurations | cc list | | get <name> | View configuration details | cc get zhhipu | | set <name> <key> <value> | Set configuration item | cc set zhhipu ANTHROPIC_BASE_URL https://api.example.com | | unset <name> [key] | Delete configuration or item | cc unset zhhipu | | active <name> | Activate specified configuration | cc active zhhipu |

Quick Configuration Commands

| Command | Description | Example | |---------|-------------|---------| | q <template> <key> | Create configuration using template | cc q zhhipu sk-xxx | | q --list | List all available templates | cc q --list | | q --init | Initialize default templates | cc q --init |

Export Commands

| Command | Description | Example | |---------|-------------|---------| | export json | Export all configurations to JSON | cc export json |

Proxy Configuration

| Command | Description | Example | |---------|-------------|---------| | proxy <name> <url> | Set proxy for configuration | cc proxy zhhipu http://127.0.0.1:7890 | | env <name> <key> <value> | Set environment variable | cc env zhhipu HTTP_PROXY http://proxy.com |

System Commands

| Command | Description | |---------|-------------| | upgrade | Upgrade tool to latest version | | --version | Show version information | | --help | Show help information |

Available Templates

| Template Name | Service Provider | Base URL | |---------------|------------------|----------| | kimi_coding | Kimi | https://api.kimi.com/coding | | kimi | Moonshot | https://api.moonshot.cn/anthropic | | ali_coding | Alibaba Cloud | https://coding.dashscope.aliyuncs.com/apps/anthropic | | poe | Poe | https://api.poe.com | | zhhipu | Zhipu AI | https://open.bigmodel.cn/api/anthropic |

Configuration File Location

• Windows: %USERPROFILE%\.cccli\config.json
• macOS/Linux: ~/.cccli/config.json

Usage Examples

Scenario 1: Manage multiple AI services

# Configure Kimi
cc q kimi sk-kimi-api-key
cc active kimi

# Switch to Zhipu AI
cc q zhhipu sk-zhipu-api-key
cc active zhhipu

Scenario 2: Export configuration backup

# Export all configurations
cc export json > backup.json

# View exported configuration
cat backup.json

Scenario 3: Use proxy

# Set proxy for specific configuration
cc proxy zhhipu http://127.0.0.1:7890

Shell Auto-completion

Bash

echo 'source <(cc completion bash)' >> ~/.bashrc
source ~/.bashrc

Zsh

echo 'source <(cc completion zsh)' >> ~/.zshrc
source ~/.zshrc

PowerShell

Add-Content $PROFILE "Invoke-Expression (& { (cc completion powershell | Out-String) })"
. $PROFILE

Troubleshooting

Issue: Command not found

# Verify global installation path
npm root -g

# Add to PATH (if needed)
export PATH="$PATH:$(npm root -g)/.bin"

Issue: Configuration file permission error

# Linux/macOS
chmod 600 ~/.cccli/config.json

View detailed error messages

cc --debug <command>

Contributing

Issues and Pull Requests are welcome!

License

MIT License