Gemini CLI

Gemini CLI は Google が公式にリリースしたコマンドラインツールで、環境変数によるカスタムゲートウェイの設定を通じて Codex Proxy サービスに接続でき、ターミナル内で Gemini モデルと対話できます。

準備アンカーリンクをコピー

Gemini CLI は npm でグローバルインストールするため、先に Node.js 18+ と npm 環境を用意する必要があります。

Node.js のインストールアンカーリンクをコピー

• Node.js 公式サイトのダウンロードページにアクセスします：https://nodejs.org/en/download
• macOS/Windows：LTS バージョンをダウンロードしてインストール
• Linux：そのページに記載のディストリビューションごとの方法でインストール
• macOS（Homebrew ユーザー）：brew install node を実行

インストールの確認アンカーリンクをコピー

node -v
npm -v

Gemini CLI のインストールアンカーリンクをコピー

npm でグローバルインストールします：

npm install -g @google/gemini-cli

インストールの確認：

gemini --version

環境変数の設定アンカーリンクをコピー

Gemini CLI は以下の 3 つの環境変数でカスタムゲートウェイに接続できます：

設定例アンカーリンクをコピー

export GOOGLE_GEMINI_BASE_URL="https://aicentos.com"
export GEMINI_API_KEY="your_api_key_here"
export GEMINI_MODEL="gemini-2.0-flash"

注意事項アンカーリンクをコピー

• GOOGLE_GEMINI_BASE_URL にはサービスのルートアドレスを入力し、具体的な API パスは不要です
• 一時的なテスト：現在の shell セッションで上記の export コマンドを直接実行します
• 永続化：export 文を ~/.zshrc または ~/.bashrc に追記し、source ~/.zshrc を実行して反映させます

Gemini CLI の起動アンカーリンクをコピー

設定が完了したら、次のコマンドでそのまま起動します：

gemini

起動後、ターミナル内で Gemini モデルと対話できるようになります。

接続の確認アンカーリンクをコピー

Gemini CLI 内で会話を 1 回開始し、正常に返信が受け取れれば接続成功です。

よくある問題のトラブルシューティングアンカーリンクをコピー

• 認証エラーが発生した場合は、GEMINI_API_KEY が正しいか確認してください
• GOOGLE_GEMINI_BASE_URL が正しいサービスアドレスを向いているか確認してください

注意事項アンカーリンクをコピー

• 現在のサービスは Gemini 互換インターフェースに対応しており、Gemini CLI にそのまま使えます
• 環境変数の設定は、永続化のために shell 設定ファイルに追記することをおすすめします
• Gemini CLI は API パスを自動で連結するため、BASE_URL に具体的な API パスを追加する必要はありません

関連リンクアンカーリンクをコピー

• 公式ドキュメント：https://docs.aicentos.com/clients/gemini-cli.html