🤖 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 中反馈。