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 中反饋。