ccs/README.ja.md

CCS - Claude Code Switch

1コマンド、ダウンタイムなし、複数アカウント

複数のClaudeアカウント、GLM、Kimiを瞬時に切り替え。
レート制限を回避し、継続的に作業。

Languages: English | Tiếng Việt | 日本語

---

🚀 クイックスタート

🔑 前提条件

CCSをインストールする前に、サブスクリプションアカウントでClaude CLIにログインしていることを確認してください：

claude /login

主なインストール方法

オプション1: npmパッケージ（推奨）

macOS / Linux / Windows

npm install -g @kaitranntt/ccs

主要なパッケージマネージャーすべてに対応：

# yarn
yarn global add @kaitranntt/ccs

# pnpm（ディスク使用量70%削減）
pnpm add -g @kaitranntt/ccs

# bun（30倍高速）
bun add -g @kaitranntt/ccs

オプション2: 直接インストール（従来型）

macOS / Linux

curl -fsSL ccs.kaitran.ca/install | bash

Windows PowerShell

irm ccs.kaitran.ca/install | iex

💡 パフォーマンス: 従来型インストールはNode.jsルーティングをバイパスし起動が高速ですが、デプロイ自動化が容易なためnpm更新を優先します。

設定（自動作成）

CCSはインストール時に自動的に設定を作成します（npm postinstallスクリプト経由）。

~/.ccs/config.json:

{
  "profiles": {
    "glm": "~/.ccs/glm.settings.json",
    "kimi": "~/.ccs/kimi.settings.json",
    "default": "~/.claude/settings.json"
  }
}

カスタムClaude CLIパス

Claude CLIが標準以外の場所（Dドライブ、カスタムディレクトリ）にインストールされている場合は、CCS_CLAUDE_PATHを設定してください：

export CCS_CLAUDE_PATH="/path/to/claude"              # Unix
$env:CCS_CLAUDE_PATH = "D:\Tools\Claude\claude.exe"   # Windows

詳細な設定手順については、トラブルシューティングガイドを参照してください。

---

最初の切り替え

⚠️ 重要: GLMまたはKimiプロファイルを使用する前に、対応する設定ファイルでAPIキーを更新する必要があります：

• GLM: ~/.ccs/glm.settings.jsonを編集してGLM APIキーを追加
• Kimi: ~/.ccs/kimi.settings.jsonを編集してKimi APIキーを追加

# Claudeサブスクリプションを使用（デフォルト）で高レベルの計画
ccs "マイクロサービスアーキテクチャの実装計画を立てて"

# GLMに切り替えてコスト最適化されたタスクを実行
ccs glm "シンプルなREST APIを作成して"

# Kimiに切り替えて思考能力を活用
ccs kimi "適切なエラーハンドリングで統合テストを書いて"

---

日常の開発者の課題

開発者は日々多くのサブスクリプションシナリオに直面します：

1. アカウント分離: 会社のClaudeアカウントと個人のClaude → 業務と個人のコンテキストを手動で切り替える必要
2. レート制限: Claudeがプロジェクト途中で停止 → 手動で~/.claude/settings.jsonを編集
3. コスト管理: 2-3つのProサブスクリプション（月$20） vs Claude Maxの5倍コスト（月$100）→ Pro階層が実用的な上限
4. モデル選択: タスクごとに異なるモデルの強みを活用 → 手動切り替え

手動コンテキスト切り替えはワークフローを中断します。CCSがシームレスに管理します。

手動切り替えではなくCCSを使う理由は？

機能	メリット
アカウント分離	業務と個人を分離
コスト最適化	2-3つのProアカウント vs Max 5倍コスト
即座の切り替え	1コマンド、ファイル編集不要
ゼロダウンタイム	ワークフロー中断なし
レート制限管理	制限時にアカウント切り替え
クロスプラットフォーム	macOS、Linux、Windows

ソリューション:

ccs work          # 会社のClaudeアカウントを使用
ccs personal      # 個人Claudeアカウントに切り替え
ccs glm           # コスト効率の良いタスク用にGLMに切り替え
ccs kimi          # 代替オプション用にKimiに切り替え
# レート制限に達した？即座に切り替え：
ccs glm           # GLMで作業を続行
# 別の会社アカウントが必要？
ccs work-2        # 2番目の会社アカウントに切り替え

---

🏗️ アーキテクチャ概要

v3.0 Login-Per-Profileモデル: 各プロファイルは独立したClaudeインスタンスで、ユーザーが直接ログインします。資格情報のコピーやvault暗号化は不要です。

flowchart TD
    subgraph "ユーザー入力"
        USER["ユーザー実行: ccs <profile> [args...]"]
    end

    subgraph "プロファイル検出エンジン"
        DETECT[ProfileDetector]
        PROFILE_CHECK{プロファイル存在?}

        subgraph "プロファイルタイプ"
            SETTINGS["Settings-based<br/>glm, kimi, default"]
            ACCOUNT["Account-based<br/>work, personal, team"]
        end
    end

    subgraph "CCSコア処理"
        CONFIG["config.jsonと<br/>profiles.jsonを読み込み"]

        subgraph "プロファイルハンドラー"
            SETTINGS_MGR["SettingsManager<br/>→ --settings flag"]
            INSTANCE_MGR["InstanceManager<br/>→ CLAUDE_CONFIG_DIR"]
        end
    end

    subgraph "Claude CLI実行"
        CLAUDE_DETECT["Claude CLI検出<br/>CCS_CLAUDE_PATHサポート"]

        subgraph "実行方法"
            SETTINGS_EXEC["claude --settings &lt;path&gt;"]
            INSTANCE_EXEC["CLAUDE_CONFIG_DIR=&lt;instance&gt; claude"]
        end
    end

    subgraph "APIレイヤー"
        API["API Response<br/>Claude Sonnet 4.5<br/>GLM 4.6<br/>Kimi K2 Thinking"]
    end

    %% Flow connections
    USER --> DETECT
    DETECT --> PROFILE_CHECK
    PROFILE_CHECK -->|はい| SETTINGS
    PROFILE_CHECK -->|はい| ACCOUNT

    SETTINGS --> CONFIG
    ACCOUNT --> CONFIG

    CONFIG --> SETTINGS_MGR
    CONFIG --> INSTANCE_MGR

    SETTINGS_MGR --> SETTINGS_EXEC
    INSTANCE_MGR --> INSTANCE_EXEC

    SETTINGS_EXEC --> CLAUDE_DETECT
    INSTANCE_EXEC --> CLAUDE_DETECT

    CLAUDE_DETECT --> API

---

⚡ 機能

• 即座の切り替え - ccs glmでGLMに切り替え、設定編集不要
• 同時セッション - 複数のプロファイルを異なるターミナルで同時実行
• 独立したインスタンス - 各プロファイルが独自の設定を保持 (~/.ccs/instances/<profile>/)
• クロスプラットフォーム - macOS、Linux、Windows - 同一動作
• ダウンタイムなし - 即座に切り替え、ワークフロー中断なし

---

💻 使用例

ccs              # Claudeサブスクリプションを使用（デフォルト）
ccs glm          # GLMフォールバックを使用
ccs kimi         # Kimi for Codingを使用
ccs --version    # CCSバージョンとインストール場所を表示

同時セッション (Multi-Account)

# 複数のClaudeアカウントを作成
ccs auth create work       # 業務用アカウント
ccs auth create personal   # 個人用アカウント
ccs auth create team       # チーム用アカウント

# ターミナル1 - 業務用アカウント
ccs work "implement feature"

# ターミナル2 - 個人用アカウント（同時実行）
ccs personal "review code"

---

🗑️ アンインストール

パッケージマネージャー

# npm
npm uninstall -g @kaitranntt/ccs

# yarn
yarn global remove @kaitranntt/ccs

# pnpm
pnpm remove -g @kaitranntt/ccs

# bun
bun remove -g @kaitranntt/ccs

公式アンインストーラー

macOS / Linux

curl -fsSL ccs.kaitran.ca/uninstall | bash

Windows PowerShell

irm ccs.kaitran.ca/uninstall | iex

---

🎯 哲学

• YAGNI: 「念のため」の機能は追加しない
• KISS: シンプルなbash、複雑さなし
• DRY: 単一の情報源（設定）

---

📖 ドキュメント

docs/の完全なドキュメント:

• インストールガイド
• 設定
• 使用例
• トラブルシューティング
• コントリビューション

---

🤝 コントリビューション

コントリビューションを歓迎します！詳細についてはコントリビューションガイドをご覧ください。

---

📄 ライセンス

CCSはMITライセンスの下でライセンスされています。

---

レート制限に頻繁に遭遇する開発者のために ❤️ を込めて作成

⭐ このリポジトリにスター | 🐛 問題を報告 | 📖 ドキュメントを読む