CometAPI で Gemini CLI を使う

このガイドでは、API エンドポイントとして CometAPI を使用して Gemini CLI を実行する方法を説明します。公式リファレンス:

model の利用可否は時間とともに変化します。利用可能な Gemini model については CometAPI Models page を確認してください。

前提条件

要件	詳細
Node.js	22+（LTS 推奨）
OS	macOS、Linux、または Windows
CometAPI key	CometAPI Dashboard から取得（`sk-` で始まります）

Gemini CLI をインストール

npm install -g @google/gemini-cli

または Homebrew（macOS / Linux）経由:

brew install gemini-cli

確認:

gemini --version

環境変数を設定

export GEMINI_API_KEY="sk-your-cometapi-key"
export GOOGLE_GEMINI_BASE_URL="https://api.cometapi.com"

sk-your-cometapi-key を実際の CometAPI key に置き換えてください。

Gemini CLI を起動

cd your-project
gemini

初回起動時には、テーマの選択、安全に関する注意の確認、作業ディレクトリの信頼確認を求められます。

セッションごとに毎回 export しなくて済むように、シェル設定に追加します:

# Add to ~/.zshrc (macOS) or ~/.bashrc (Linux)
export GEMINI_API_KEY="sk-your-cometapi-key"
export GOOGLE_GEMINI_BASE_URL="https://api.cometapi.com"

変更を反映するには、ターミナルを再起動してください。

無効な API キーエラー

GEMINI_API_KEY が正しく設定されていることを確認してください。確認するには echo $GEMINI_API_KEY を実行します。

fetch failed

ネットワーク制限によって接続がブロックされている可能性があります。システム全体のプロキシを試してください。

Node.js のバージョンが正しくない

Gemini CLI には Node.js 22+ が必要です。確認するには node --version を実行します。

Gemini CLI をアンインストールする

npm uninstall -g @google/gemini-cli を実行します。