コマンドラインとエージェントツール
利用シーン、プロトコル、権限範囲に応じて、適切なAGTCloud開発ツールを選択します。
AGTCloudは、コマンドラインエージェント、IDE拡張機能、デスクトップクライアント、設定管理ツールから利用できます。ツールを選択するときは、その動作方法とプロトコルを確認し、アクセスできるファイル、コマンド、外部サービスを評価します。
このページでは、各ツールのインストール手順を繰り返さず、目的に合ったチュートリアルをすばやく選べます。各チュートリアルのBase URL、認証、モデル要件に従って接続を完了してください。
エージェントツールはローカル操作を実行する可能性があります
一部のツールは、ファイルの読み取りと変更、シェル コマンドの実行、ネットワークへのアクセスを行うことができます。初めてアクセスする場合は、機密データが含まれていないテストディレクトリを使用し、自動承認を無効にし、読み取り専用タスクから検証を開始してください。
ツール別に選ぶ
| ツール | 利用形態 | AGTCloud 接続プロトコル | 適した用途 |
|---|---|---|---|
| Claude Code | ターミナル型コーディングエージェント | Anthropic Messages | すでに Claude Code ワークフローを使用していて、Messages とContent Blockの構造を保持したい |
| Codex | CLI とデスクトップアプリ | OpenAI Responses | Responses、Input Itemまたは Codex プロジェクト ワークフローを使用する |
| Gemini CLI | ターミナルエージェント | Gemini Generate Content | Geminiのcontents・parts構造を利用したい |
| Cline | IDE拡張機能 | OpenAI Chat Completions | VS Code互換エディタまたはJetBrainsでエージェントの操作をレビューしたい |
| Cherry Studio | デスクトップチャットクライアント | OpenAI Chat Completions | GUIで複数モデルを利用するチャットと基本的な接続検証 |
| OpenClaw | セルフホステッド ゲートウェイ、TUI、およびコントロール UI | OpenAI Chat Completions | ローカル ゲートウェイと拡張可能なパーソナルエージェント実行環境が必要 |
| CC-Switch | ローカル設定管理ツール | Anthropic Messages、OpenAI Responses | Claude Code と Codex の Provider 設定を保存して切り替える必要があります |
| Hermes Agent | ターミナルエージェント | OpenAI Chat Completions | カスタムエンドポイント、ターミナル セッション、ツール呼び出しワークフローが必要 |
プロトコル名はモデルの提供元を表すものではありません。同じモデルが複数のプロトコルエンドポイントを提供する場合がありますが、ツールの呼び出し、マルチモダリティ、推論、およびコンテキスト関連機能は、現在のモデルが実際に対応する範囲に依存します。
タスク別に選ぶ
| ターゲット | 最初に確認することをお勧めします | 選定理由 |
|---|---|---|
| ターミナルでコードを分析・変更する | Claude Code、Codex、Gemini CLI | いずれもターミナル中心のワークフローを提供しますが、使用するプロトコル構造が異なります。 |
| IDEでファイル操作とコマンド実行を段階的に確認する | Cline | 操作計画、ファイル変更、承認フローをエディター内で確認できます。 |
| GUIでモデルとの会話を行う | Cherry Studio | Providerとモデルを設定した後、チャットインターフェイスから接続を確認できます。 |
| ローカルの自己ホスト型エージェントを実行する | OpenClaw、Hermes Agent | GatewayまたはCLIエージェントとして実行できるため、ホスト権限をより厳密に管理する必要があります。 |
| 複数の Claude Code または Codex 構成を管理する | CC-Switch | Provider設定をローカルで保存・切り替える用途に適しています。実際にリクエストを開始したクライアントを置き換えません。 |
| 外部ツールやデータソースに接続する | MCPの接続とセキュリティ | MCP はクライアントとツール サービス間のプロトコルであり、モデル API と同等ではありません。 |
接続前の確認
1. ご利用フォームの確認
ターミナル、IDE、デスクトップ チャット、またはセルフホスト型ゲートウェイのどれが必要かを決定します。名前だけでツールを選択しないでください。まず、チームの承認と権限の管理スタイルに適合していることを確認してください。
2. 同意書の確認
現在利用可能な API Key のモデルIDを モデルマーケットプレイス からコピーし、そのモデルがチュートリアルで必要な Chat Completions、Responses、Anthropic Messages または Gemini の Generate Content プロトコルをサポートしていることを確認します。
3. 専用の認証情報を準備する
まず、API Keys ページで、識別しやすく必要に応じて無効化できるAPI Keyを作成します。実際のキーをリポジトリ、スクリーンショット、ログ、共有設定に書き込まないでください。
4. 権限の説明の読み取り
ツールがアクセスできるディレクトリ、コマンド、ネットワーク、外部サービスを確認してください。自動承認はデフォルトでオフになっており、現在のタスクを完了するために必要な最小限のスコープのみが開きます。
段階的に検証する
| ステージ | 推奨タスク | 合格基準 |
|---|---|---|
| 基本的な接続 | 定型文にのみ返信し、ツールを呼び出さない | 応答内容、Provider、Base URL、モデルが期待どおりである |
| 読み取り専用ファイル | テストディレクトリのREADME.mdを読み、要約する | ファイルが変更されず、未承認のコマンドも実行されない |
| 管理されたツール | 影響範囲を定義して取り消し可能なアクションを実行する | クライアントは操作内容を表示して確認し、結果は期待どおりです。 |
| プロジェクトタスク | バージョン管理の下で実際のプロジェクトに取り組む | 変更をレビュー・ロールバックでき、プロジェクト既存のチェックにも合格する |
「クライアントが正常に起動しました」をアクセス完了とはみなしません。少なくとも、実際のリクエストが予期される Provider、モデル、およびプロトコルを使用していることを確認し、ツールが認可範囲を超えていないことを確認してください。
ツール選択に関するよくある質問
| 質問 | 推奨対応 |
|---|---|
| 会話はできるがツールを呼び出せない | まず、対象のモデルとプロトコルがツール呼び出しをサポートしているかどうかを確認し、次にクライアントのバージョンとツールの権限を確認します。 |
| 同じモデルでもツールによって挙動が異なる | プロトコル、システム プロンプト、ツール スキーマ、コンテキスト、クライアントのデフォルト パラメーターを比較します。 |
| 設定済みなのに別のProviderを要求される | クライアントを完全に再起動し、ユーザーレベルの設定、環境変数、および現在有効なProviderを確認します。 |
Base URLで404が返る | 特定のチュートリアルに従って、API Origin、/v1 Base URLを入力するか、クライアントに自動的にパスを結合させるかを確認します。 |
| 自動承認を有効にしてよいか分からない | 無効にしたままにしておいてください。タスク、ディレクトリ、コマンドの境界が明確な場合にのみ、段階的に有効にしてください。 |
| データベース、ファイル システム、またはビジネス サービスに接続する必要がある | 最初に MCPの接続とセキュリティ を読み取り、サービスのソースと権限を確認します。 |
セキュリティ上の推奨事項
- ツールの公式チャネルからインストール パッケージまたはコマンドをダウンロードし、アップグレードする前にバージョンの説明をお読みください。
- 個別の無効化と監査を容易にするために、ツールごとに個別のAPI Keyを使用します。
- バージョン管理またはバックアップ保護の下でファイルを変更するタスクを実行します。
- パスワード、顧客情報、生産データ、その他の必須ではない機密情報をモデルに送信しないでください。
- ツール ログ、セッション エクスポート、およびクラッシュ レポートにキー、パス、またはビジネス データが含まれているかどうかを確認します。
- ツールの使用を停止した後、ツールに保存されている認証情報を削除し、不要になったアクセス許可を取り消します。
すでにツールを特定している場合は、CC-Switch 統合チュートリアル から始めるか、上の表から対応するツールを直接選択してください。インターフェースフィールドと応答構造については、API Reference を参照してください。