CC Switch CLI
CC Switch の CLI ハーネスです。CC Switch は、AI コーディングツール（Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes）の設定を管理するデスクトップアプリケーションです。Click と CLI-Anything 手法を使用して構築されています。
前提条件
- Python 3.10+
- CC Switch がインストールされており、
~/.cc-switch/cc-switch.dbにアクティブなデータベースがあること
インストール
pip install -e .
インストール後、cli-anything-ccswitch コマンドが使用可能になります。
コマンドグループ
| グループ | 説明 |
|---|---|
status | データベースの概要を表示 |
providers | AI プロバイダ設定の管理（一覧、取得、カレント設定） |
proxy | ローカル HTTP プロキシサーバーの管理（ステータス、設定） |
mcp | MCP（Model Context Protocol）サーバーの管理（一覧、有効化） |
skills | インストール済みスキルの管理（一覧、リポジトリ） |
usage | API 使用量とコスト統計の表示（統計、ログ） |
settings | CC Switch 設定の表示と管理（一覧、取得、設定） |
sessions | AI 会話セッションの参照と検索（一覧） |
グローバルオプション
--json— 機械可読な JSON 形式で出力（エージェント利用推奨）--db PATH— データベースのパスを上書き
エージェント向けガイダンス
JSON 出力
プログラムでの利用には常に --json を使用してください。サブコマンドの前に配置します：
cli-anything-ccswitch --json providers list
cli-anything-ccswitch --json usage stats --days 30
cli-anything-ccswitch --json providers get <id> --app claude
機密情報
API トークン、キー、シークレットはすべての出力でマスクされます。プロバイダ詳細の settings_config フィールドにはマスクされた値（例：sk-bc089...5cbb）が表示されます。
終了コード
0— 成功1— エラー（例：リソースが見つからない、無効なアプリタイプ）
アプリタイプ
有効なアプリタイプ：claude、codex、gemini、opencode、openclaw、hermes。
使用例
全プロバイダを一覧表示
cli-anything-ccswitch providers list
cli-anything-ccswitch --json providers list --app claude
アクティブプロバイダの切り替え
cli-anything-ccswitch providers set-current <provider-id> --app claude
プロキシステータスの確認
cli-anything-ccswitch proxy status --app claude
cli-anything-ccswitch proxy config --app claude --set-port 8080
使用量統計の表示
cli-anything-ccswitch usage stats --days 7
cli-anything-ccswitch --json usage stats --days 30 --app claude
cli-anything-ccswitch usage logs --limit 10
スキルの一覧表示
cli-anything-ccswitch skills list
cli-anything-ccswitch skills repos
MCP サーバー
cli-anything-ccswitch mcp list
cli-anything-ccswitch mcp enable <server-id> --app claude --on
設定
cli-anything-ccswitch settings list
cli-anything-ccswitch settings get <key>
cli-anything-ccswitch settings set <key> <value>
セッション
cli-anything-ccswitch sessions list --app claude --limit 10
ステータス概要
cli-anything-ccswitch status
cli-anything-ccswitch
cli-anything-ccswitch --json
エラーハンドリング
リソースが見つからない場合、CLI はエラーメッセージを stderr に出力し、コード 1 で終了します。エージェントは出力を解析する前に終了コードを確認する必要があります。
データベース
CLI は稼働中の CC Switch SQLite データベースから読み取ります。すべての読み取り操作は安全で、データベースを変更しません。書き込み操作（providers set-current、proxy config、mcp enable、settings set）はデータベースを直接変更します。