From 014ec48fdd58b594a827e7f3fb312086b499d584 Mon Sep 17 00:00:00 2001 From: Ikko Ashimine Date: Sun, 9 Nov 2025 16:29:43 +0900 Subject: [PATCH] docs: add Japanese README --- README.ja.md | 279 +++++++++++++++++++++++++++++++++++++++++++++++++++ README.md | 4 +- README.vi.md | 2 +- 3 files changed, 282 insertions(+), 3 deletions(-) create mode 100644 README.ja.md diff --git a/README.ja.md b/README.ja.md new file mode 100644 index 00000000..e096ddbf --- /dev/null +++ b/README.ja.md @@ -0,0 +1,279 @@ +# CCS - Claude Code Switch + +
+ +![CCS Logo](docs/assets/ccs-logo-medium.png) + +**1つのコマンドで、ダウンタイムなし、タスクごとに最適なモデルを選択** + +Claude Sonnet 4.5、GLM 4.6、Kimi for Coding を瞬時に切り替え。レート制限を回避し、コストを最適化。 + + +[![License](https://img.shields.io/badge/license-MIT-C15F3C?style=for-the-badge)](LICENSE) +[![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-lightgrey?style=for-the-badge)]() +[![npm](https://img.shields.io/npm/v/@kaitranntt/ccs?style=for-the-badge&logo=npm)](https://www.npmjs.com/package/@kaitranntt/ccs) +[![PoweredBy](https://img.shields.io/badge/PoweredBy-ClaudeKit-C15F3C?style=for-the-badge)](https://claudekit.cc?ref=HMNKXOHN) + +**Languages**: [English](README.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) + +
+ +--- + +## 🚀 クイックスタート + +### 🔑 前提条件 + +**CCSをインストールする前に、サブスクリプションアカウントでClaude CLIにログインしていることを確認してください：** +```bash +claude /login +``` + +### 主なインストール方法 + +#### オプション1: npmパッケージ（推奨） + +**macOS / Linux / Windows** +```bash +npm install -g @kaitranntt/ccs +``` + +npm、yarn、pnpm、bunパッケージマネージャーと互換性があります。 + +#### オプション2: 直接インストール（従来型） + +**macOS / Linux** +```bash +curl -fsSL ccs.kaitran.ca/install | bash +``` + +**Windows PowerShell** +```powershell +irm ccs.kaitran.ca/install | iex +``` + +### 最初の切り替え + +```bash +# Claudeサブスクリプションを使用（デフォルト） +ccs "このアーキテクチャ設計をレビューして" + +# GLMに切り替えてコスト最適化されたタスクを実行 +ccs glm "シンプルなREST APIを作成して" + +# Kimiに切り替えて別のオプションを使用 +ccs kimi "統合テストを書いて" + +# 切り替えが戻されるまで、以降のすべてのコマンドでGLMを使用 +ccs glm +ccs "この問題をデバッグして" +ccs "ユニットテストを書いて" +``` + +#### パッケージマネージャーオプション + +主要なパッケージマネージャーすべてに対応： + +```bash +# npm（デフォルト） +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 +``` + +### 設定（自動作成） + +**CCSはインストール時に自動的に設定を作成します**（npm postinstallスクリプト経由）。 + +**~/.ccs/config.json**: +```json +{ + "profiles": { + "glm": "~/.ccs/glm.settings.json", + "kimi": "~/.ccs/kimi.settings.json", + "default": "~/.claude/settings.json" + } +} +``` + +### カスタムClaude CLIパス + +Claude CLIが標準以外の場所（Dドライブ、カスタムディレクトリ）にインストールされている場合は、`CCS_CLAUDE_PATH`を設定してください： + +```bash +export CCS_CLAUDE_PATH="/path/to/claude" # Unix +$env:CCS_CLAUDE_PATH = "D:\Tools\Claude\claude.exe" # Windows +``` + +**詳細な設定手順については、[トラブルシューティングガイド](./docs/en/troubleshooting.md#claude-cli-in-non-standard-location)を参照してください。** + +--- + +## 日常の開発者の課題 + +Claudeサブスクリプション、GLM Coding Plan、Kimi for Codingを持っている場合、毎日3つのシナリオが発生します： + +1. **レート制限に達する**: Claudeがプロジェクト途中で停止 → 手動で`~/.claude/settings.json`を編集 +2. **コストの無駄**: 単純なタスクに高価なClaudeを使用 → GLMやKimiで十分 +3. **モデル選択**: タスクごとに異なるモデルの強みを活用 → 手動切り替え + +手動切り替えはフローを中断します。**CCSはこれを瞬時に解決します**。 + +## 手動切り替えではなくCCSを使う理由は？ + +
+ +| 機能 | メリット | 感情的価値 | +|---------|---------|-----------------| +| **即座の切り替え** | 1つのコマンド、ファイル編集不要 | 自信、コントロール | +| **ゼロダウンタイム** | ワークフローを中断しない | 信頼性、一貫性 | +| **スマート委譲** | タスクごとに適切なモデルを自動選択 | シンプルさ、容易さ | +| **コスト管理** | 必要な時だけ高価なモデルを使用 | 効率性、節約 | +| **クロスプラットフォーム** | macOS、Linux、Windowsで動作 | 柔軟性、移植性 | +| **信頼性** | 純粋なbash/PowerShell、依存関係なし | 信頼、安心 | + +
+ +**ソリューション**: +```bash +ccs # Claudeサブスクリプションを使用（デフォルト） +ccs glm # GLMフォールバックに切り替え +ccs kimi # Kimi for Codingに切り替え +# レート制限に達した？即座に切り替え： +ccs glm # GLMで作業を続行 +# またはKimiに切り替え： +ccs kimi # Kimiで作業を続行 +``` + +1つのコマンド。ダウンタイムなし。ファイル編集不要。適切なモデル、適切なタスク。 + +--- + +## 🏗️ アーキテクチャ概要 + +```mermaid +graph LR + subgraph "ユーザーコマンド" + CMD[ccs glm] + end + + subgraph "CCS処理" + CONFIG[~/.ccs/config.jsonを読み込み] + LOOKUP[プロファイル → 設定ファイルを検索] + VALIDATE[ファイル存在を検証] + end + + subgraph "Claude CLI" + EXEC[claude --settings file_path] + end + + subgraph "APIレスポンス" + API[Claude Sub または GLM API] + end + + CMD --> CONFIG + CONFIG --> LOOKUP + LOOKUP --> VALIDATE + VALIDATE --> EXEC + EXEC --> API +``` + +--- + +## ⚡ 機能 + +### 即座のプロファイル切り替え +- **1つのコマンド**: `ccs glm`でGLMに切り替え、`ccs`でClaudeサブスクリプションを使用 - 設定ファイルの編集不要 +- **スマート検出**: タスクごとに適切なモデルを自動使用 +- **永続的**: 再度変更されるまで切り替えは有効 + +### ワークフロー中断なし +- **ダウンタイムなし**: コマンド間で即座に切り替え +- **コンテキスト保持**: ワークフローは中断されない +- **シームレスな統合**: ネイティブのClaude CLIと全く同じように動作 + + +--- + +## 💻 使用例 + +```bash +ccs # Claudeサブスクリプションを使用（デフォルト） +ccs glm # GLMフォールバックを使用 +ccs kimi # Kimi for Codingを使用 +ccs --version # CCSバージョンとインストール場所を表示 +``` + +--- + +### 🗑️ 公式アンインストール + +**CCSを完全に削除する推奨方法：** + +**macOS / Linux**: +```bash +curl -fsSL ccs.kaitran.ca/uninstall | bash +``` + +**Windows PowerShell**: +```powershell +irm ccs.kaitran.ca/uninstall | iex +``` + +> 💡 **公式アンインストーラーを使用する理由は？** +> - すべてのCCSファイルと設定を削除 +> - PATH変更をクリーンアップ +> - Claude CLIコマンド/スキルを削除 +> - テスト済みのエッジケースに対応 + +**代替方法**（公式アンインストーラーが失敗した場合）: +- **npm**: `npm uninstall -g @kaitranntt/ccs` +- **手動**: [トラブルシューティングガイド](./docs/en/troubleshooting.md#manual-uninstall)を参照 + +--- + +## 🎯 哲学 + +- **YAGNI**: 「念のため」の機能は追加しない +- **KISS**: シンプルなbash、複雑さなし +- **DRY**: 単一の情報源（設定） + +--- + +## 📖 ドキュメント + +**[docs/](./docs/)の完全なドキュメント**: +- [インストールガイド](./docs/en/installation.md) +- [設定](./docs/en/configuration.md) +- [使用例](./docs/en/usage.md) +- [トラブルシューティング](./docs/en/troubleshooting.md) +- [コントリビューション](./docs/en/contributing.md) + +--- + +## 🤝 コントリビューション + +コントリビューションを歓迎します！詳細については[コントリビューションガイド](./docs/en/contributing.md)をご覧ください。 + +--- + +## 📄 ライセンス + +CCSは[MITライセンス](LICENSE)の下でライセンスされています。 + +--- + +
+ +**レート制限に頻繁に遭遇する開発者のために ❤️ を込めて作成** + +[⭐ このリポジトリにスター](https://github.com/kaitranntt/ccs) | [🐛 問題を報告](https://github.com/kaitranntt/ccs/issues) | [📖 ドキュメントを読む](./docs/en/) + +
diff --git a/README.md b/README.md index 81363c9d..049de4f8 100644 --- a/README.md +++ b/README.md @@ -14,7 +14,7 @@ Switch between Claude Sonnet 4.5, GLM 4.6, and Kimi for Coding instantly. Stop h [![npm](https://img.shields.io/npm/v/@kaitranntt/ccs?style=for-the-badge&logo=npm)](https://www.npmjs.com/package/@kaitranntt/ccs) [![PoweredBy](https://img.shields.io/badge/PoweredBy-ClaudeKit-C15F3C?style=for-the-badge)](https://claudekit.cc?ref=HMNKXOHN) -**Languages**: [English](README.md) | [Tiếng Việt](README.vi.md) +**Languages**: [English](README.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) @@ -276,4 +276,4 @@ CCS is licensed under the [MIT License](LICENSE). [⭐ Star this repo](https://github.com/kaitranntt/ccs) | [🐛 Report issues](https://github.com/kaitranntt/ccs/issues) | [📖 Read docs](./docs/en/) - \ No newline at end of file + diff --git a/README.vi.md b/README.vi.md index cda09f9b..7d04d16d 100644 --- a/README.vi.md +++ b/README.vi.md @@ -13,7 +13,7 @@ Chuyển đổi giữa Claude Sonnet 4.5 và GLM 4.6 ngay lập tức. Ngừng h [![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-lightgrey?style=for-the-badge)]() [![PoweredBy](https://img.shields.io/badge/PoweredBy-ClaudeKit-C15F3C?style=for-the-badge)](https://claudekit.cc?ref=HMNKXOHN) -**Ngôn ngữ**: [English](README.md) | [Tiếng Việt](README.vi.md) +**Ngôn ngữ**: [English](README.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md)