AI コーディング CLI インストールガイド
最終確認：2026-06-05。CLI のパッケージ名、インストールコマンド、設定ファイルの場所は変わる可能性があります。チーム導入前に各ツールの公式リリース情報を確認してください。
このセクションでは、ETok で扱う AI コーディングツールチェーンのセットアップ手順をまとめています。
インストール前に確認すること
AI コーディング CLI の問題は、多くの場合 Node.js バージョン、npm グローバル権限、環境変数の不足、永続変数を書いたあとにターミナルを開き直していないことに起因します。モデルプロバイダーを疑う前に、まずここを確認してください。
| 要件 | 重要な理由 | 確認方法 |
|---|---|---|
| Node.js 18+ | Claude Code、Codex、Gemini CLI の npm インストールで必要になりやすい | node --version |
npm のグローバル bin が PATH に入っている | インストール後の command not found を防ぐ | npm config get prefix |
| API キーまたは中継キー | CLI は最初の実リクエスト前に認証情報が必要 | 同じターミナルで該当環境変数を echo する |
| Base URL またはプロバイダー設定 | ETok など中継を使う場合に必要 | 設定後に短いプロンプトを実行する |
インストールガイド
| ガイド | 内容 |
|---|---|
| Claude Code インストール & セットアップガイド | macOS、Linux、Windows、Auth Token、BASE URL 設定 |
| Claude Code の Token 節約設定 | Tool Search、自動圧縮、1M コンテキスト制御、settings.json 設定 |
| OpenAI Codex インストールガイド | Codex CLI、API キー、BASE URL、設定ファイル |
| Windows 環境変数設定 | PowerShell、CMD、setx、GUI による環境変数設定 |
| AI CLI 一括アップグレード | Claude Code、OpenAI Codex、Gemini CLI を Bash で更新 |
目的別の読み順
| 目的 | 最初に読む | 次に読む |
|---|---|---|
| リポジトリ内でペアプログラミングする | Claude Code インストール & セットアップガイド | Windows なら Windows 環境変数設定 |
| Claude Code の長いセッションコストを下げる | Claude Code の Token 節約設定 | CC Switch でプロバイダーと設定を管理 |
| OpenAI モデルで Agent 的に開発する | OpenAI Codex インストールガイド | AI 大規模モデルガイド でモデルを選ぶ |
| 複数 CLI を最新に保つ | AI CLI 一括アップグレード | CC Switch でプロバイダーと設定を管理 |
| 環境変数の不具合を直す | Windows 環境変数設定 | 対象 CLI のインストールガイド |
推奨セットアップ順
- AI 大規模モデルガイド からプロバイダーを選ぶ。
- ワークフローに合う CLI をインストールする。
- Token と BASE URL の環境変数を設定する。
- 小さなプロンプトで動作確認してから実プロジェクトで使う。
よくある失敗パターン
command not found：パッケージは入っているが npm のグローバルbinがPATHにない。401または403：キーがない、期限切れ、空白付きでコピーされた、または CLI が読まない場所に保存されている。404 model not found：現在のプロバイダーまたは中継にそのモデル名が存在しない。- 環境変数が反映されない：永続設定を書いたが、現在のターミナルを開き直していない。
- インストールが遅い：一時的に npm レジストリを切り替え、チーム環境では必要に応じて公式レジストリへ戻す。
FAQ
すべての AI コーディング CLI を入れるべきですか？
不要です。まず 1 つの CLI を入れて実プロジェクトで検証してください。別のモデルファミリー、マルチモーダルワークフロー、特定の Agent 機能が必要になったら追加します。
公式エンドポイントと中継のどちらを使うべきですか？
可能なら公式エンドポイントが最も単純です。統一請求、地域ルーティング、プロバイダーのフェイルオーバー、チーム管理ゲートウェイが必要な場合は中継を使います。
いつ CC Switch を使うべきですか？
インストールが成功したあと、繰り返し作業がプロバイダー切り替え、MCP 同期、CLI 設定バックアップ、複数アシスタント管理になった段階で導入すると効果があります。