logo
0
1
Login

🤖 CCMA - Claude Code Manager

简体中文 | English

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

npm version License: MIT Node.js

✨ 特性

  • 🔧 多配置管理 - 存储和管理多个 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 使用以下优先级来管理配置:

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

配置文件位置

# 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

🤝 贡献

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

  1. Fork 项目
  2. 创建特性分支 (git checkout -b feature/amazing-feature)
  3. 提交更改 (git commit -m 'Add amazing feature')
  4. 推送分支 (git push origin feature/amazing-feature)
  5. 开启 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

CommandDescriptionExample
ccma add <name> <url> <token> [model]Add new configurationccma add prod https://api.anthropic.com sk-xxx claude-3-5-sonnet
ccma del <name>Delete configurationccma del old-config
ccma use [name]Switch configurationccma use production
ccma list / ccma lsList all configurationsccma ls
ccma currentShow current configurationccma current
ccma clearClear all configurationsccma clear
ccma --version / ccma -VShow versionccma -V
ccma --help / ccma -hShow helpccma -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.

About

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

claude-aiccmaclaude-codeclaude
Language
HTML41.8%
TypeScript35.6%
Markdown17.7%
gitignore4.1%
Others0.8%