---
title: "接続を管理する"
description: "接続のライフサイクルとアプリ固有の動作を理解します。"
version: "ja"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.ochub.org/ja/llms.txt
> Use this file to discover all available pages before exploring further.

# 接続を管理する

OcHub はアプリごとに接続を分けて保存します。Claude Code の接続が
Codex に自動で現れることはありませんが、**アプリへコピー**で対象形式の新しい設定を
生成できます。

## 既存設定を検出する

アプリページを開くと、OcHub はツールの現在の実設定を読み取ります。

- 認識できる接続は「直接接続」に表示されます。
- ツールに存在するが現在ではない項目は「追加済み」と表示されます。
- 使用中の接続は「現在」と表示されます。
- フォームで完全に表現できないカスタム項目は、保存前に書き込みプレビューを確認します。

## 日常の操作

| 操作 | 用途 |
| --- | --- |
| 編集 | アドレス、キー、モデル、メモ、高度な項目を変更 |
| ドラッグで並べ替え | リストとシステムメニューの表示順を変更 |
| アプリへコピー | 対象アプリ形式で新しい接続として保存 |
| ツールに追加 | 現在の接続を変えずに事前登録 |
| 切り替え | 直ちに現在の接続に設定 |
| ツールから削除 | OcHub データを残し、実設定だけから削除 |
| 削除 | OcHub から完全に削除 |

現在使用中の接続を削除する前に、別の接続へ切り替えます。

## 公式ログイン

**公式ログインを使用**はサードパーティーの Base URL や API キーを書き込まず、
ツール自身のログイン状態を利用します。

- Claude Code または Codex ですでに公式アカウントへログイン済み。
- サードパーティー API から一時的に公式サービスへ戻す。
- ツール固有のアカウントやサブスクリプション機能を維持する。

Codex では `auth.json` と `config.toml` の両方が現在の接続バージョンに含まれます。
OcHub 外で変更した内容を残す場合は、別の接続へ切り替える前に差分を確認して新しい
バージョンとして保存します。

## アプリ固有設定

アプリページ右上の**アプリ設定**を開きます。

| アプリ | 主な設定 |
| --- | --- |
| Claude Code | MCP オンボーディングのスキップ、Claude プラグイン連携、カスタム設定ディレクトリ |
| Codex | 履歴統合、既存セッション移行、カスタム設定ディレクトリ |
| OpenCode | カスタム設定ディレクトリ |
| OpenClaw | カスタム設定ディレクトリ |
| Hermes | カスタム設定ディレクトリ |
| Grok Build | カスタム設定ディレクトリ |

カスタムディレクトリは、設定、MCP、セッション履歴の読み取り先を変更します。保存後に
OcHub と対象ツールを再起動してください。

## エディター内のチェック

- **URL をテスト**：HTTP 応答のレイテンシーを測定。
- **モデルを取得**：現在のアドレスとキーでモデル一覧を取得。
- **残高を確認**：互換する残高 API がある上流サービスのみ。
- **書き込むファイル**：生成内容と保存先を表示。
- **共通設定**：アプリ単位の共有スニペットを有効な接続へマージ。

テスト成功はモデル呼び出しの成功を保証しません。最終確認は対象 CLI の実リクエストです。

## 外部で設定が変更された場合

OcHub は現在の接続を、保存済みの設定バージョンとして扱います。切り替え前に、その
バージョンとディスク上の現在のファイルを比較します。

1. 左右のファイル差分を確認します。赤は保存済みバージョン、緑は現在のファイルです。
2. **新しいバージョンとして保存**を選ぶと、現在のファイルを現在の接続へ保存してから
   切り替えます。後で戻ると、この新しいバージョンが復元されます。
3. **保存済みに戻す**を選ぶと、ディスク上の変更を破棄し、保存済みバージョンを復元して
   から切り替えます。
4. **キャンセル**では OcHub のデータも現在のファイルも変更しません。

この処理は、Claude Code、Codex、Grok Build、Kimi Code、切り替え型プラグインなど、
OcHub が実設定を読み取れるすべての切り替え型アプリに適用されます。Codex では
`auth.json` と `config.toml` を別々に表示し、不正な JSON の `auth.json` も原文のまま
差分、保存、復元の対象になります。

OcHub、cc-switch、手動エディターで同じファイルを同時に編集しないでください。

## 新しい接続を確認する

任意のアプリで接続を保存または切り替えた後：

1. 生成ファイルとパスを確認。
2. 保存後に「追加済み」または「現在」を確認。
3. 対象ツールを完全に再起動。
4. 新しいプロバイダーとモデルを選択。
5. 短いリクエストを送信。
6. ツールエラー、OcHub 使用量、上流ログを確認。

| 問題 | よくある原因 |
| --- | --- |
| 接続がない | 保存だけで追加していない、またはディレクトリ違い |
| 別項目を上書き | 共存アプリで Provider ID が重複 |
| 401 | キー、環境変数、起動環境の不一致 |
| 404 / ボディエラー | バックエンド、プロトコル、API モードの誤り |
| モデルは見えるが失敗 | ID、コンテキスト、権限の不一致 |
| 高度な保存に失敗 | JSON/YAML ノード型の誤り |

## アプリ別フィールドガイド

| アプリ | 続きを読む |
| --- | --- |
| Claude Code / Claude Desktop | [認証、役割モデル、MCP、プラグイン](/ja/claude/configure) |
| Codex | [OAuth、Responses、推論、セッション履歴](/ja/codex/configure) |
| Grok Build | [プロファイル、API バックエンド、環境変数](/ja/grok-build/configure) |
| OpenCode | [AI SDK パッケージ、Provider ID、OMO](/ja/opencode/configure) |
| OpenClaw | [プロトコル、デフォルトモデル、ツール権限](/ja/openclaw/configure) |
| Hermes | [API モード、モデル、メモリ](/ja/hermes/configure) |

旧管理ツールから接続を移す場合は、手作業でコピーせず
[cc-switch から移行](/ja/guides/migration)を利用してください。

Source: https://docs.ochub.org/ja/guides/providers/index.mdx