CLIツールの概要
CLI（コマンドラインツール）は特定の単一ソフトウェアではなく、コマンドラインインターフェース全般を指します。Claude Code、Codex CLI、Gemini CLI、OpenClaw、OpenCodeなどがこのカテゴリに該当します。ターミナル上で自然言語を入力することで、プロジェクトの読み取り、コードの解釈、ファイル生成、コマンド実行など、各種開発タスクの遂行を支援してくれます。
公式情報 ダウンロードおよびドキュメントは公式サイトの情報に準拠します。
CLIとは何か・何に使えるのか
CLIツールは通常のチャットツールよりも強力である反面、誤操作によるリスクも生じやすくなります。初心者が初めて設定する際は、まずテスト用プロジェクトでのみ動作させ、「コードの解釈のみ行い、ファイル変更やコマンド実行は行わない」形で試すことを推奨します。
事前に準備するもの
| 準備項目 | 説明 | 重要な理由 |
|---|---|---|
| ターミナル | WindowsではPowerShell、macOS / LinuxではTerminalを使用 | CLIはすべてターミナル上で動作するため |
| ツール本体 | まずClaude Code、Codex CLI、Gemini CLI、OpenClaw、OpenCodeのいずれかをインストール | 設定ファイルはインストール済みのツールに対してのみ有効となるため |
| キー / ログイン方式 | 公式ログイン、API Key、OAuth、またはAIプロバイダーのKeyなど | CLIごとに認証方式が異なるため |
| Base URL | AIプロバイダーや中継プロキシを経由する場合にのみ必要 | プロトコルによってアドレス末尾のパスが異なる場合があるため、ドメイン名だけを変更すればよいとは限りません |
| テスト用プロジェクト | 新規の空フォルダを作成するか、プロジェクトをコピーして用意 | 初回設定時に本番プロジェクトが意図せず破損するのを防ぐため |
AIプロバイダーのドキュメントに記載されているURLは、通常そのサービス固有のサンプルです。実際に設定する際は、ご自身が利用するプロバイダーから提供されたAPIアドレスとKeyに置き換えてください。また、OpenAI、Claude、Geminiのインターフェースが個別に提供されている場合は、これら3つのアドレスを混同して設定しないよう注意してください。
各ツールの設定ガイド
Claude Codeの設定 Claude CodeのKey、Base URL、モデル名、settings.jsonの設定手順。
Codex CLIの設定 Codexターミナルツールのconfig.toml、カスタムプロバイダー、動作確認手順。
Gemini CLIの設定 Gemini CLIにおけるGoogleログイン、API Key、AIプロバイダー利用時の注意点。
OpenClawの設定 OpenClawのbaseUrlとapiフィールドのペア設定について。
OpenCodeの設定 OpenCodeの接続ウィザード、設定ファイルの保存場所、手動設定時のポイント。
どのガイドを見るべきか
| 行いたい操作 | 推奨ガイド | 理由 |
|---|---|---|
| 複数のCLIプロバイダーを一括で切り替えたい | CC-Switch 基本手順 | プロバイダーを一元管理し、Claude、Codex、Geminiなどの各ツールに設定を割り振る用途にはCC-Switchが適しています |
| Claude Codeのみ設定したい | Claude Codeの設定 | Claude Code向けに、Anthropic / Claude関連のKey、Base URL、モデル名、settings.jsonに焦点を当てて解説しています |
| Codex CLIのみ設定したい | Codexの設定 | Codex向けに、config.toml、OpenAI互換プロバイダー、モデル名、環境変数の設定に焦点を当てています |
| Gemini CLIのみ設定したい | Geminiの設定 | Geminiのログイン方式、Key、Vertex / GeminiインターフェースはOpenAI互換インターフェースと仕様が異なるためです |
| OpenClaw / OpenCodeを使用したい | OpenClaw / OpenCode | これら2つのツールはバージョンによってProviderフィールドの仕様が変わることがあるため、専用ガイドや公式ドキュメントを参照してください |
設定前に確認すべきリスク
| リスク項目 | 発生しやすい箇所 | 推奨対策 |
|---|---|---|
| ツールがプロジェクトファイルを読み取れる | Claude Code、Codex、Gemini、OpenClaw、OpenCode | 初回はテスト用ディレクトリで実行し、本番の運用プロジェクトを直接開かないようにしてください |
| モデルがコマンドを実行または提案できる | すべてのコード系CLI | 実行前確認モードを有効にし、削除・移動・インストール・アップロードなどの操作を慎重に確認してください |
| 設定項目同士の上書き・競合 | システム環境変数、プロジェクト設定、ユーザー設定、CC-Switch | 設定が反映されない場合は読み込みの優先順位をまず確認し、複数の箇所を同時に変更しないようにしてください |
| 異なるプロトコルの混用 | OpenAI、Claude、Gemini、Vertex、AIプロバイダー互換インターフェース | プロバイダーの管理画面で提供されているインターフェース形式に合わせて、ツールの設定画面に入力してください |
| 他人のサンプル設定をそのままコピーした | サードパーティのチュートリアル、スクリーンショット、古いドキュメント | サンプルのURL、Key、モデル名は、必ずご自身が利用するプロバイダーの実際の内容に置き換えてください |
初回安全テストの実施方法
設定が完了しても、すぐに本番プロジェクトをCLIに変更させないでください。まずは空のディレクトリを作成し、簡単なテストファイルを1つ配置したうえで、ファイルを変更させずに「読み取りと解釈のみ」を行わせます。
CLIに与える安全テスト用プロンプト
Read only the current directory first. Tell me which files are here. Do not modify any files, run any commands, or install any dependencies.このステップで正常な応答が得られない場合は、該当するトラブルシューティングガイドをご確認ください。設定が正常に動作することを確認する前に、CLIへ本番プロジェクトを自動処理させないようにしてください。