CCMA 動的設定Claude Code 設定管理ツール

🤖 CCMA - Claude Code Manager#

日本語 | English

複数の Claude Code 設定と API エンドポイントを管理するための強力な CLI ツール。異なる 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

🤝 貢献#

コードの貢献を歓迎します！まず貢献ガイドラインをお読みください。

プロジェクトをフォーク
特徴ブランチを作成 (git checkout -b feature/amazing-feature)
変更をコミット (git commit -m 'Add amazing feature')
ブランチをプッシュ (git push origin feature/amazing-feature)
プルリクエストを作成

📄 ライセンス#

このプロジェクトは MIT ライセンスの下でライセンスされています - 詳細は LICENSE ファイルを参照してください。

🐛 問題フィードバック#

問題が発生した場合や提案がある場合は、GitHub Issues でフィードバックしてください。

我是老王