Gemini CLI

概要

種類: コーディングツール主要パス: Gemini-nativeサポートレベル: best-effort

Google Gemini CLI は、Gemini モデルとやり取りするためのコマンドラインツールです。TokenLab は互換性のあるエンドポイントを提供しており、Gemini CLI を使用して 300 以上のモデルにアクセスできます。

これは実験的な互換構成です。Gemini CLI は現在、TokenLab のようなカスタム Base URL ワークフローを安定した形で公式には文書化していません。サポートされた TokenLab のターミナル運用が必要なら、Codex CLI、Claude Code、OpenCode を優先してください。

システム要件

Node.js: バージョン 20.0 以上
OS: Windows 10/11、macOS 10.15 以上、Ubuntu 20.04 以上、または Debian 10 以上

インストール

npm install -g @google/gemini-cli

インストールの確認:

gemini --version

設定

ステップ 1: API キーの取得

TokenLab ダッシュボードにログインします
API キーに移動します
API キーを作成してコピーします（形式: sk-...）

ステップ 2: 環境変数の設定

一時的（現在のセッション）:

export GEMINI_API_KEY="sk-your-tokenlab-key"
export GOOGLE_GEMINI_BASE_URL="https://api.tokenlab.sh"

永続的な設定: シェル設定ファイルに追加します:

Bash
Zsh
Fish

echo 'export GEMINI_API_KEY="sk-your-tokenlab-key"' >> ~/.bashrc
echo 'export GOOGLE_GEMINI_BASE_URL="https://api.tokenlab.sh"' >> ~/.bashrc
source ~/.bashrc

echo 'export GEMINI_API_KEY="sk-your-tokenlab-key"' >> ~/.zshrc
echo 'export GOOGLE_GEMINI_BASE_URL="https://api.tokenlab.sh"' >> ~/.zshrc
source ~/.zshrc

set -Ux GEMINI_API_KEY "sk-your-tokenlab-key"
set -Ux GOOGLE_GEMINI_BASE_URL "https://api.tokenlab.sh"

設定を反映させるために、設定後にターミナルを再起動してください。

既知の制限事項: キャッシュされた Google セッションがある場合、Gemini CLI が GOOGLE_GEMINI_BASE_URL を無視することがあります。接続の問題が発生した場合は、CLI キャッシュをクリアするか、新しいターミナルセッションを開始してください。

基本的な使い方

プロジェクトディレクトリから Gemini CLI を起動します:

cd your-project
gemini

初回実行時には、以下の操作を行います:

テーマの選択
安全に関する通知の確認
作業ディレクトリの信頼設定

利用可能なモデル

モデル	説明
`gemini-2.5-pro`	最も高性能な Gemini モデル
`gemini-3.5-flash`	高速で、ほとんどのタスクに効率的
`gemini-3.1-flash-lite`	現行の軽量 Gemini モデル

よく使うコマンド

質問する:

> What is the best way to structure a React app?

コードを分析する:

> Explain the code in src/main.ts

コードを生成する:

> Create a Python function to parse JSON files

変更をレビューする:

> Review the recent git changes and suggest improvements

設定の確認

# 環境変数の確認
echo $GEMINI_API_KEY
echo $GOOGLE_GEMINI_BASE_URL

# 接続テスト
gemini

トラブルシューティング

接続エラー

GOOGLE_GEMINI_BASE_URL が https://api.tokenlab.sh に設定されていることを確認してください
注意: Gemini エンドポイントには /v1 サフィックスは不要です
ネットワーク接続を確認してください

認証失敗

GEMINI_API_KEY 環境変数が設定されていることを確認してください
キーが sk- で始まっていることを確認してください
TokenLab ダッシュボードでキーが有効であることを確認してください

モデルが利用不可

tokenlab.sh/en/models で Gemini モデルの利用可能性を確認してください
別の Gemini モデルバリアントを試してください

ベストプラクティス

プロジェクトディレクトリで使用する

コンテキストをより正確に理解させるため、常にプロジェクトのルートから Gemini CLI を実行してください。

ディレクトリの信頼設定は慎重に行う

自身が所有するディレクトリのみを信頼してください。Gemini CLI はファイルを読み取り、変更する可能性があります。

生成されたコードをレビューする

プロジェクトにコミットする前に、AI が生成したコードを必ずレビューしてください。

互換性マトリクス

コーディングツール

ネイティブ SDK

フレームワークとプラットフォーム

チャットアプリ

概要

システム要件

インストール

設定

ステップ 1: API キーの取得

ステップ 2: 環境変数の設定

基本的な使い方

利用可能なモデル

よく使うコマンド

設定の確認

トラブルシューティング

ベストプラクティス

​概要

​システム要件

​インストール

​設定

​ステップ 1: API キーの取得

​ステップ 2: 環境変数の設定

​基本的な使い方

​利用可能なモデル

​よく使うコマンド

​設定の確認

​トラブルシューティング

​ベストプラクティス

概要

システム要件

インストール

設定

ステップ 1: API キーの取得

ステップ 2: 環境変数の設定

基本的な使い方

利用可能なモデル

よく使うコマンド

設定の確認

トラブルシューティング

ベストプラクティス