mirror of
https://github.com/farion1231/cc-switch.git
synced 2026-04-18 17:33:08 +08:00
docs: restructure user manual for i18n and add EN/JA translations
Reorganize docs/user-manual/ from flat structure to language subdirectories (zh/, en/, ja/) with shared assets/. Move existing Chinese docs into zh/, fix image paths, add multilingual navigation README, and translate all 23 markdown files (~4500 lines each) to English and Japanese.
This commit is contained in:
Jason
340
docs/user-manual/ja/5-faq/5.1-config-files.md
Normal file
340
docs/user-manual/ja/5-faq/5.1-config-files.md
Normal file
@@ -0,0 +1,340 @@
|
||||
# 5.1 設定ファイルの説明
|
||||
|
||||
## CC Switch のデータストレージ
|
||||
|
||||
### ストレージディレクトリ
|
||||
|
||||
デフォルトの場所：`~/.cc-switch/`
|
||||
|
||||
設定で場所をカスタマイズ可能です（クラウド同期用）。
|
||||
|
||||
### ディレクトリ構造
|
||||
|
||||
```
|
||||
~/.cc-switch/
|
||||
├── cc-switch.db # SQLite データベース
|
||||
├── settings.json # デバイスレベルの設定
|
||||
└── backups/ # 自動バックアップ
|
||||
├── backup-20251230-120000.json
|
||||
├── backup-20251229-180000.json
|
||||
└── ...
|
||||
```
|
||||
|
||||
### データベースの内容
|
||||
|
||||
`cc-switch.db` は SQLite データベースで、以下を保存しています：
|
||||
|
||||
| テーブル | 内容 |
|
||||
|-----|------|
|
||||
| providers | プロバイダー設定 |
|
||||
| provider_endpoints | プロバイダーエンドポイント候補リスト |
|
||||
| mcp_servers | MCP サーバー設定 |
|
||||
| prompts | プロンプトプリセット |
|
||||
| skills | スキルのインストール状態 |
|
||||
| skill_repos | スキルリポジトリ設定 |
|
||||
| proxy_config | プロキシ設定 |
|
||||
| proxy_request_logs | プロキシリクエストログ |
|
||||
| provider_health | プロバイダーヘルスステータス |
|
||||
| model_pricing | モデル料金 |
|
||||
| settings | アプリ設定 |
|
||||
|
||||
### デバイス設定
|
||||
|
||||
`settings.json` はデバイスレベルの設定を保存します：
|
||||
|
||||
```json
|
||||
{
|
||||
"language": "zh",
|
||||
"theme": "system",
|
||||
"windowBehavior": "minimize",
|
||||
"autoStart": false,
|
||||
"claudeConfigDir": null,
|
||||
"codexConfigDir": null,
|
||||
"geminiConfigDir": null,
|
||||
"opencodeConfigDir": null,
|
||||
"openclawConfigDir": null
|
||||
}
|
||||
```
|
||||
|
||||
これらの設定はデバイス間で同期されません。
|
||||
|
||||
### 自動バックアップ
|
||||
|
||||
`backups/` ディレクトリに自動バックアップが保存されます：
|
||||
|
||||
- 設定インポートのたびに自動作成
|
||||
- 最新の 10 件のバックアップを保持
|
||||
- ファイル名にタイムスタンプを含む
|
||||
|
||||
## Claude Code の設定
|
||||
|
||||
### 設定ディレクトリ
|
||||
|
||||
デフォルト：`~/.claude/`
|
||||
|
||||
### 主要ファイル
|
||||
|
||||
```
|
||||
~/.claude/
|
||||
├── settings.json # メイン設定ファイル
|
||||
├── CLAUDE.md # システムプロンプト
|
||||
└── skills/ # スキルディレクトリ
|
||||
└── ...
|
||||
```
|
||||
|
||||
### settings.json
|
||||
|
||||
```json
|
||||
{
|
||||
"env": {
|
||||
"ANTHROPIC_API_KEY": "sk-xxx",
|
||||
"ANTHROPIC_BASE_URL": "https://api.anthropic.com"
|
||||
},
|
||||
"permissions": {
|
||||
"allow_file_access": true
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
| フィールド | 説明 |
|
||||
|------|------|
|
||||
| `env.ANTHROPIC_API_KEY` | API キー |
|
||||
| `env.ANTHROPIC_BASE_URL` | API エンドポイント（任意） |
|
||||
| `env.ANTHROPIC_AUTH_TOKEN` | 代替認証方式 |
|
||||
|
||||
### MCP 設定
|
||||
|
||||
MCP サーバーの設定は `~/.claude.json` にあります：
|
||||
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"mcp-fetch": {
|
||||
"command": "uvx",
|
||||
"args": ["mcp-server-fetch"]
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## Codex の設定
|
||||
|
||||
### 設定ディレクトリ
|
||||
|
||||
デフォルト：`~/.codex/`
|
||||
|
||||
### 主要ファイル
|
||||
|
||||
```
|
||||
~/.codex/
|
||||
├── auth.json # 認証設定
|
||||
├── config.toml # メイン設定 + MCP
|
||||
└── AGENTS.md # システムプロンプト
|
||||
```
|
||||
|
||||
### auth.json
|
||||
|
||||
```json
|
||||
{
|
||||
"OPENAI_API_KEY": "sk-xxx"
|
||||
}
|
||||
```
|
||||
|
||||
### config.toml
|
||||
|
||||
```toml
|
||||
# 基本設定
|
||||
base_url = "https://api.openai.com/v1"
|
||||
model = "gpt-4"
|
||||
|
||||
# MCP サーバー
|
||||
[mcp_servers.mcp-fetch]
|
||||
command = "uvx"
|
||||
args = ["mcp-server-fetch"]
|
||||
```
|
||||
|
||||
## Gemini CLI の設定
|
||||
|
||||
### 設定ディレクトリ
|
||||
|
||||
デフォルト：`~/.gemini/`
|
||||
|
||||
### 主要ファイル
|
||||
|
||||
```
|
||||
~/.gemini/
|
||||
├── .env # 環境変数（API Key）
|
||||
├── settings.json # メイン設定 + MCP
|
||||
└── GEMINI.md # システムプロンプト
|
||||
```
|
||||
|
||||
### .env
|
||||
|
||||
```bash
|
||||
GEMINI_API_KEY=xxx
|
||||
GOOGLE_GEMINI_BASE_URL=https://generativelanguage.googleapis.com
|
||||
GEMINI_MODEL=gemini-pro
|
||||
```
|
||||
|
||||
### settings.json
|
||||
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"mcp-fetch": {
|
||||
"command": "uvx",
|
||||
"args": ["mcp-server-fetch"]
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
| フィールド | 説明 |
|
||||
|------|------|
|
||||
| `mcpServers` | MCP サーバー設定 |
|
||||
|
||||
## OpenCode の設定
|
||||
|
||||
### 設定ディレクトリ
|
||||
|
||||
デフォルト：`~/.opencode/`
|
||||
|
||||
### 主要ファイル
|
||||
|
||||
```
|
||||
~/.opencode/
|
||||
├── config.json # メイン設定ファイル
|
||||
├── AGENTS.md # システムプロンプト
|
||||
└── skills/ # スキルディレクトリ
|
||||
└── ...
|
||||
```
|
||||
|
||||
## OpenClaw の設定
|
||||
|
||||
### 設定ディレクトリ
|
||||
|
||||
デフォルト：`~/.openclaw/`
|
||||
|
||||
### 主要ファイル
|
||||
|
||||
```
|
||||
~/.openclaw/
|
||||
├── openclaw.json # メイン設定ファイル（JSON5 形式）
|
||||
├── AGENTS.md # システムプロンプト
|
||||
└── skills/ # スキルディレクトリ
|
||||
└── ...
|
||||
```
|
||||
|
||||
### openclaw.json
|
||||
|
||||
OpenClaw は JSON5 形式の設定ファイルを使用し、主に以下のセクションを含みます：
|
||||
|
||||
```json5
|
||||
{
|
||||
// モデルプロバイダー設定
|
||||
models: {
|
||||
mode: "merge",
|
||||
providers: {
|
||||
"custom-provider": {
|
||||
baseUrl: "https://api.example.com/v1",
|
||||
apiKey: "your-api-key",
|
||||
api: "openai-completions",
|
||||
models: [{ id: "model-id", name: "Model Name" }]
|
||||
}
|
||||
}
|
||||
},
|
||||
// 環境変数
|
||||
env: {
|
||||
ANTHROPIC_API_KEY: "sk-..."
|
||||
},
|
||||
// Agent デフォルトモデル設定
|
||||
agents: {
|
||||
defaults: {
|
||||
model: {
|
||||
primary: "provider/model"
|
||||
}
|
||||
}
|
||||
},
|
||||
// ツール設定
|
||||
tools: {},
|
||||
// ワークスペースファイル設定
|
||||
workspace: {}
|
||||
}
|
||||
```
|
||||
|
||||
| フィールド | 説明 |
|
||||
|------|------|
|
||||
| `models.providers` | プロバイダー設定（CC Switch の「プロバイダー」にマッピング） |
|
||||
| `env` | 環境変数設定 |
|
||||
| `agents.defaults` | Agent デフォルトモデル設定 |
|
||||
| `tools` | ツール設定 |
|
||||
| `workspace` | ワークスペースファイル管理 |
|
||||
|
||||
## 設定の優先順位
|
||||
|
||||
CC Switch が設定を変更する際の優先順位：
|
||||
|
||||
1. **CC Switch データベース** - 単一事実源 (SSOT)
|
||||
2. **Live 設定ファイル** - プロバイダー切り替え時に書き込み
|
||||
3. **バックフィル機能** - 現在のプロバイダーの編集時に Live ファイルから読み取り
|
||||
|
||||
## 手動での設定編集
|
||||
|
||||
### 手動編集可能なもの
|
||||
|
||||
- CLI ツールの設定ファイル（CC Switch がバックフィルする）
|
||||
- CC Switch の `settings.json`
|
||||
|
||||
### 手動編集を推奨しないもの
|
||||
|
||||
- `cc-switch.db` データベースファイル
|
||||
- バックアップファイル
|
||||
|
||||
### 編集後の同期
|
||||
|
||||
CLI ツールの設定を手動で編集した場合：
|
||||
|
||||
1. CC Switch を開く
|
||||
2. 対応するプロバイダーを編集
|
||||
3. 手動変更の内容がバックフィルされていることを確認
|
||||
4. 保存してデータベースに同期
|
||||
|
||||
## 設定の移行
|
||||
|
||||
### 旧バージョンからの移行
|
||||
|
||||
CC Switch v3.7.0 で JSON ファイルから SQLite に移行しました：
|
||||
|
||||
- 初回起動時に自動的に移行
|
||||
- 移行成功後に通知を表示
|
||||
- 旧設定ファイルはバックアップとして保持
|
||||
|
||||
### デバイス間の移行
|
||||
|
||||
1. 移行元のデバイスで設定をエクスポート
|
||||
2. 移行先のデバイスで設定をインポート
|
||||
3. またはクラウド同期機能を使用
|
||||
|
||||
## 設定のバックアップに関するアドバイス
|
||||
|
||||
### 定期的なバックアップ
|
||||
|
||||
定期的に設定をエクスポートすることを推奨します：
|
||||
|
||||
1. 設定 → 詳細 → データ管理
|
||||
2. 「エクスポート」をクリック
|
||||
3. 安全な場所に保存
|
||||
|
||||
### バックアップに含まれる内容
|
||||
|
||||
エクスポートファイルには以下が含まれます：
|
||||
|
||||
- すべてのプロバイダー設定
|
||||
- MCP サーバー設定
|
||||
- Prompts プリセット
|
||||
- アプリ設定
|
||||
|
||||
### 含まれない内容
|
||||
|
||||
- 使用量ログ（データ量が大きいため）
|
||||
- デバイスレベルの設定（デバイス間の移動に適さないため）
|
||||
Reference in New Issue
Block a user