CCMA 一个动态设置Claude Code 配置管理工具

🤖 CCMA - Claude Code Manager#

简体中文 | English

一个强大的 CLI 工具，用于管理多个 Claude Code 配置和 API 端点。轻松在不同的 Claude Code 环境之间切换！

✨ 特性#

🔧 多配置管理 - 存储和管理多个 Claude Code 配置
🚀 快速切换 - 一键切换不同的 API 端点和认证令牌
🌍 跨平台支持 - 支持 Windows、macOS 和 Linux
💡 简单易用 - 直观的命令行界面
🔒 安全存储 - 本地安全存储敏感配置信息
⚡ 即时生效 - 配置更改立即生效，无需重启

📦 安装#

全局安装 (推荐)#

npm install -g ccma

使用 yarn#

yarn global add ccma

验证安装#

ccma --version

🚀 快速开始#

1. 添加第一个配置#

# 添加默认的 Claude Code 配置
ccma add default https://api.anthropic.com your-auth-token-here

# 添加自定义端点配置
ccma add custom https://your-custom-endpoint.com your-custom-token

# 添加配置并指定模型
ccma add production https://api.anthropic.com your-token claude-3-5-sonnet

2. 查看所有配置#

ccma list
# 或者
ccma ls

输出示例：

📋 Claude Code 配置列表:
  * default 🌟 (当前)
    🔗 https://custom.com | 🔑 sk-tqbkTu8...LhKKJ4Ifcs

  custom
    🔗 https://api.anthropic.com | 🔑 sk-1234567...7890abcdef

  production
    🔗 https://api.anthropic.com | 🔑 sk-1234567...7890abcdef | 🤖 claude-3-5-sonnet

3. 切换配置#

# 切换到指定配置
ccma use custom

# 查看当前配置
ccma current

💡 模型参数说明#

CCMA 支持在添加配置时指定可选的模型参数。当配置包含模型信息时，CCMA 会自动设置 ANTHROPIC_MODEL 环境变量。

支持的模型#

claude-3-haiku - 最快速、最经济的模型
claude-3-sonnet - 平衡性能与成本的模型
claude-3-5-sonnet - 最新、最强大的模型
claude-3-opus - 最高质量的模型

使用示例#

# 添加配置时指定模型
ccma add dev https://api.anthropic.com your-token claude-3-haiku

# 切换配置时，ANTHROPIC_MODEL 环境变量会自动设置
ccma use dev
# 环境变量中将包含：ANTHROPIC_MODEL=claude-3-haiku

# 如果配置没有指定模型，ANTHROPIC_MODEL 变量会被移除
ccma add simple https://api.anthropic.com your-token
ccma use simple
# 环境变量中不会包含 ANTHROPIC_MODEL

📖 完整命令参考#

命令	描述	示例
`ccma add <name> <url> <token> [model]`	添加新配置	`ccma add prod https://api.anthropic.com sk-xxx claude-3-5-sonnet`
`ccma del <name>`	删除配置	`ccma del old-config`
`ccma use [name]`	切换配置	`ccma use production`
`ccma list` / `ccma ls`	列出所有配置	`ccma ls`
`ccma current`	显示当前配置	`ccma current`
`ccma clear`	清除所有配置	`ccma clear`
`ccma --version` / `ccma -V`	显示版本	`ccma -V`
`ccma --help` / `ccma -h`	显示帮助	`ccma -h`

🎯 使用场景#

开发团队协作#

# 开发环境
ccma add dev https://dev-api.anthropic.com dev-token-123 claude-3-haiku

# 测试环境
ccma add test https://test-api.anthropic.com test-token-456 claude-3-sonnet

# 生产环境
ccma add prod https://api.anthropic.com prod-token-789 claude-3-5-sonnet

# 快速切换环境
ccma use dev    # 开发时（使用 haiku 节省成本）
ccma use test   # 测试时（使用 sonnet 平衡性能）
ccma use prod   # 部署时（使用 claude-3-5-sonnet 最佳性能）

多项目管理#

# 项目 A 配置（使用标准模型）
ccma add project-a https://api.anthropic.com token-a claude-3-sonnet

# 项目 B 配置（使用高级模型）
ccma add project-b https://custom-endpoint.com token-b claude-3-5-sonnet

# 在项目间切换
cd /path/to/project-a && ccma use project-a
cd /path/to/project-b && ccma use project-b

演示脚本#

#!/bin/bash
# demo.sh - CCMA 演示脚本

echo "🚀 CCMA 演示开始..."

# 添加演示配置
echo "📝 添加演示配置..."
ccma add demo-dev https://dev.anthropic.com demo-dev-token claude-3-haiku
ccma add demo-prod https://api.anthropic.com demo-prod-token claude-3-5-sonnet

# 显示配置列表
echo "📋 当前配置列表:"
ccma list

# 切换到开发环境
echo "🔄 切换到开发环境..."
ccma use demo-dev
echo "✅ 当前配置: $(ccma current)"

# 切换到生产环境
echo "🔄 切换到生产环境..."
ccma use demo-prod
echo "✅ 当前配置: $(ccma current)"

echo "🎉 演示完成!"

⚙️ 配置文件#

CCMA 使用以下优先级来管理配置：

本地配置文件 (最高优先级): .claude/settings.local.json
环境变量: ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN, ANTHROPIC_MODEL
默认配置 (最低优先级)

配置文件位置#

# Windows
%USERPROFILE%\.claude\settings.local.json

# macOS/Linux
~/.claude/settings.local.json

配置文件格式#

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.anthropic.com",
    "ANTHROPIC_AUTH_TOKEN": "your-auth-token-here",
    "ANTHROPIC_MODEL": "claude-3-5-sonnet"
  },
  "permissions": {
    "allow": [
    ],
    "deny": []
  }
}

🛠️ 开发#

克隆项目#

git clone https://github.com/zoeblow/ccma.git
cd ccma
yarn install
yarn link

安装依赖#

npm install

开发命令#

# 开发模式
npm run dev

# 构建项目
npm run build

# 运行测试
npm test

# 代码检查
npm run lint

# 格式化代码
npm run format

# 类型检查
npm run typecheck

本地测试#

# 链接到全局
npm link

# 测试命令
ccma --help

🤝 贡献#

欢迎贡献代码！请先阅读贡献指南。

Fork 项目
创建特性分支 (git checkout -b feature/amazing-feature)
提交更改 (git commit -m 'Add amazing feature')
推送分支 (git push origin feature/amazing-feature)
开启 Pull Request

📄 许可证#

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。

🐛 问题反馈#

如果遇到问题或有建议，请在 GitHub Issues 中反馈。

English Version#

🤖 CCMA - Claude Code Manager#

A powerful CLI tool for managing multiple Claude Code configurations and API endpoints. Easily switch between different Claude Code environments!

✨ Features#

🔧 Multi-Configuration Management - Store and manage multiple Claude Code configurations
🚀 Quick Switching - Switch between different API endpoints and auth tokens with one command
🌍 Cross-Platform - Support for Windows, macOS, and Linux
💡 Easy to Use - Intuitive command-line interface
🔒 Secure Storage - Securely store sensitive configuration information locally
⚡ Instant Effect - Configuration changes take effect immediately

📦 Installation#

Global Installation (Recommended)#

npm install -g ccma

Using yarn#

yarn global add ccma

Verify Installation#

ccma --version

🚀 Quick Start#

1. Add Your First Configuration#

# Add default Claude Code configuration
ccma add default https://api.anthropic.com your-auth-token-here

# Add custom endpoint configuration
ccma add custom https://your-custom-endpoint.com your-custom-token

# Add configuration with model specification
ccma add production https://api.anthropic.com your-token claude-3-5-sonnet

2. View All Configurations#

ccma list
# or
ccma ls

3. Switch Configuration#

# Switch to specified configuration
ccma use custom

# View current configuration
ccma current

💡 Model Parameter#

CCMA supports specifying an optional model parameter when adding configurations. When a configuration includes model information, CCMA automatically sets the ANTHROPIC_MODEL environment variable.

Supported Models#

claude-3-haiku - Fastest and most economical model
claude-3-sonnet - Balanced performance and cost model
claude-3-5-sonnet - Latest and most powerful model
claude-3-opus - Highest quality model

Usage Examples#

# Add configuration with model specification
ccma add dev https://api.anthropic.com your-token claude-3-haiku

# When switching configurations, ANTHROPIC_MODEL environment variable is automatically set
ccma use dev
# Environment variables will include: ANTHROPIC_MODEL=claude-3-haiku

# If configuration doesn't specify a model, ANTHROPIC_MODEL variable will be removed
ccma add simple https://api.anthropic.com your-token
ccma use simple
# Environment variables will not include ANTHROPIC_MODEL

📖 Command Reference#

Command	Description	Example
`ccma add <name> <url> <token> [model]`	Add new configuration	`ccma add prod https://api.anthropic.com sk-xxx claude-3-5-sonnet`
`ccma del <name>`	Delete configuration	`ccma del old-config`
`ccma use [name]`	Switch configuration	`ccma use production`
`ccma list` / `ccma ls`	List all configurations	`ccma ls`
`ccma current`	Show current configuration	`ccma current`
`ccma clear`	Clear all configurations	`ccma clear`
`ccma --version` / `ccma -V`	Show version	`ccma -V`
`ccma --help` / `ccma -h`	Show help	`ccma -h`

🛠️ Development#

Clone the Repository#

git clone https://github.com/zoeblow/ccma.git
cd ccma

Install Dependencies#

npm install

Development Commands#

# Development mode
npm run dev

# Build project
npm run build

# Run tests
npm test

# Lint code
npm run lint

# Format code
npm run format

# Type check
npm run typecheck

📄 License#

This project is licensed under the MIT License - see the LICENSE file for details.

🐛 Issues#

If you encounter any issues or have suggestions, please report them on GitHub Issues.