最新2025年版 Gemini CLIとClaude Code簡単導入（Win・Mac）

#### 導入の全体像と準備物：Node.js・npm・Git・アカウント ここでは「Gemini CLI（Google）」「Claude Code（Anthropic）」をWindows/Macで使い始める前に必要な全体像と準備物を、初心者向けに分かりやすくまとめます。ポイントは「開発ランタイム（Node.js / npm）」「バージョン管理ツール（Git）」「サービス用アカウントとAPIキー」「OSごとの実行環境の差」です。以下は事実（公式ドキュメントや信頼できるチュートリアル）に基づく説明と、それらから得られる実践的な示唆です（出典を明示します）。 #### まず押さえるべき“なぜ”と“何が必要か” - なぜNode.jsが要るのか：Claude CodeはNode.js（とPython）を使うSDK/CLIを提供しており、実際に動かすにはNode.jsが必須です[4](https://docs.anthropic.com/en/docs/claude-code/sdk)。Gemini CLIもNode.js（あるいはHomebrew経由）でインストールできる手段が多く、Nodeの存在はCLIツールの第一条件になります[11](https://www.kdnuggets.com/beginners-guide-to-gemini-cli-install-setup-and-use-it-like-a-pro)[12](https://cloud.google.com/blog/ja/topics/developers-practitioners/introducing-gemini-cli)。 - どのバージョンを選ぶか：Node.js公式は一般利用ではLTS（Long Term Support）版を推奨しており、安定性や長期のセキュリティ対応が期待できます（例：v22.18.0など）[9](https://nodejs.org/en/download)[8](https://nodejs.org/ja/download)。ただし、ツールによっては最低バージョン要件が異なります（Claude CodeはNode.js 18+推奨、一部ツールやGemini CLIはNode.js v20+が推奨例として紹介されています）[4](https://docs.anthropic.com/en/docs/claude-code/sdk)[11](https://www.kdnuggets.com/beginners-guide-to-gemini-cli-install-setup-and-use-it-like-a-pro)。 - アカウントとAPIキー：AnthropicのAPI（Claude）を使うにはAnthropic Consoleでアカウント作成とAPIキー取得が必須です（APIキーを環境変数に設定して使います）[3](https://docs.anthropic.com/en/docs/get-started)[4](https://docs.anthropic.com/en/docs/claude-code/sdk)。Gemini CLIはGoogleアカウントでのログイン（ブラウザ経由の認証）や、APIキーを環境変数に設定する運用もサポートします[12](https://cloud.google.com/blog/ja/topics/developers-practitioners/introducing-gemini-cli)[11](https://www.kdnuggets.com/beginners-guide-to-gemini-cli-install-setup-and-use-it-like-a-pro)。 （言い換えると）安定した体験を得るには「LTS Node.js + nvmでバージョン管理 + Git（あると便利） + 各サービスのアカウント／APIキー」を揃えるのが最短です。これが全体像です。 #### 必要なもの（チェックリスト） 1. Node.js（LTS版を推奨、例: v22.18.0）とnpm（Nodeに同梱）[9](https://nodejs.org/en/download)[8](https://nodejs.org/ja/download) 2. Node バージョン管理ツール（nvm。Windowsは「nvm for Windows」やChocolateyの選択肢） — 複数バージョン切替と障害対応で便利[9](https://nodejs.org/en/download)[8](https://nodejs.org/ja/download) 3. Git（Claude CodeではGit 2.23+があると便利／推奨）[4](https://docs.anthropic.com/en/docs/claude-code/sdk) 4. Anthropic アカウント（Claude／Claude Code 用）と APIキー（環境変数で管理）[3](https://docs.anthropic.com/en/docs/get-started)[4](https://docs.anthropic.com/en/docs/claude-code/sdk) 5. Google アカウント（Gemini CLI のブラウザ認証に使用）または GEMINI_API_KEY を環境変数に設定する方法[12](https://cloud.google.com/blog/ja/topics/developers-practitioners/introducing-gemini-cli)[11](https://www.kdnuggets.com/beginners-guide-to-gemini-cli-install-setup-and-use-it-like-a-pro) 6. インターネット接続（CLIがクラウドのモデルにアクセスするため必須）[4](https://docs.anthropic.com/en/docs/claude-code/sdk)[11](https://www.kdnuggets.com/beginners-guide-to-gemini-cli-install-setup-and-use-it-like-a-pro) #### OS別：準備の「やさしい」手順（概略・初心者向け） - 共通：まず「ターミナル（Mac: Terminal／Windows: PowerShell）」を開く。管理者権限が必要な場合は指示に従う。 出典と実際のコマンド例は以下を参照してください（公式も同様の流れを示しています）[9](https://nodejs.org/en/download)[8](https://nodejs.org/ja/download)[4](https://docs.anthropic.com/en/docs/claude-code/sdk)。 Windows（初心者向け・安全策） 1. nvm for Windowsを検討する（Windows用のバージョンマネージャ）か、Chocolateyでインストールする案が公式ページでも案内されています（Chocolatey経由の例あり）[8](https://nodejs.org/ja/download)[9](https://nodejs.org/en/download)。 2. 直接試す（権限問題回避）：まずnpxでワンショット実行を試す（Gemini CLI等の検証に便利）[11](https://www.kdnuggets.com/beginners-guide-to-gemini-cli-install-setup-and-use-it-like-a-pro)。 3. Node確認コマンド（成功していればバージョンが表示されます）: - node -v / npm -v（公式の確認方法）[9](https://nodejs.org/en/download)。 macOS（初心者向け） 1. Homebrewを使うか、nvmでNodeインストール。公式はnvm経由を推奨する記載があり、nvmのインストールはcurlコマンド一発で可能です（下記参照）[9](https://nodejs.org/en/download)。 2. nvmでLTS導入（例）: - curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash - . "$HOME/.nvm/nvm.sh" - nvm install 22 これらはNode公式ダウンロードページにも掲載されている標準手順です[9](https://nodejs.org/en/download)。 3. Node確認: node -v / npm -v を実行して正しいバージョンが表示されるか確認してください[9](https://nodejs.org/en/download)。 （注）公式ダウンロードページはnvmによる手順を目立たせており、.msi/.pkgの個別リンクがページ上では直接的に強調されていないケースがあるため、nvmを覚えておくと後々便利です[9](https://nodejs.org/en/download)[8](https://nodejs.org/ja/download)。 #### Claude Code／Gemini CLI を動かす前の“アカウントと環境変数”設定 - Claude（Anthropic）の場合： 1. Anthropic コンソールでアカウント作成→Billing（課金）設定→APIキーを作成します（キーは一度きりの表示なので安全に保管）[3](https://docs.anthropic.com/en/docs/get-started)[0](https://tilburg.ai/2025/01/beginners-tutorial-for-the-claude-api-python/)。 2. APIキーは環境変数（例: ANTHROPIC_API_KEY または CLAUDE_API_KEY）として設定するのが推奨です（mac/Windowsでの設定手順が公式ドキュメントに記載されています）[3](https://docs.anthropic.com/en/docs/get-started)[4](https://docs.anthropic.com/en/docs/claude-code/sdk)。 3. PythonやTypeScriptのSDKをインストールしてテスト実行（例: pip install anthropic / npm install @anthropic-ai/claude-code）で動作確認します[3](https://docs.anthropic.com/en/docs/get-started)[4](https://docs.anthropic.com/en/docs/claude-code/sdk)。 - Gemini CLI（Google）の場合： 1. Gemini CLIは初回実行でブラウザ認証を促す仕組み（Googleアカウントでログイン）で動作開始できます。APIキーを用いる運用も可能で、その場合は GEMINI_API_KEY を環境変数に設定する方法が紹介されています[12](https://cloud.google.com/blog/ja/topics/developers-practitioners/introducing-gemini-cli)[11](https://www.kdnuggets.com/beginners-guide-to-gemini-cli-install-setup-and-use-it-like-a-pro)。 2. まずはnpxで「試す」方法が簡便です：npx https://github.com/google-gemini/gemini-cli（グローバルにインストールせずに試せます）[11](https://www.kdnuggets.com/beginners-guide-to-gemini-cli-install-setup-and-use-it-like-a-pro)。 #### 実際のサンプルコマンド（公式に載っている一連の流れ） - nvmのインストール（Linux/macOSでの例）[9](https://nodejs.org/en/download）: curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash . "$HOME/.nvm/nvm.sh" nvm install 22 - Nodeバージョン確認（共通）[9](https://nodejs.org/en/download）: node -v npm -v - Claude Code（npmグローバル）インストール例（Anthropic公式SDKページ）[4](https://docs.anthropic.com/en/docs/claude-code/sdk): npm install -g @anthropic-ai/claude-code （※権限エラーが出る場合はsudoは推奨されない旨の指摘があるため、npm prefixの調整やnpxを検討してください）[6](https://pypi.org/project/claude-api/)[4](https://docs.anthropic.com/en/docs/claude-code/sdk) - Gemini CLI を試す（グローバルインストール不要でまず試せる）[11](https://www.kdnuggets.com/beginners-guide-to-gemini-cli-install-setup-and-use-it-like-a-pro): npx https://github.com/google-gemini/gemini-cli #### 実用的な注意点と専門家の視点（考察・示唆） - バージョン依存に注意：Claude CodeはNode.js 18+を要求し、Gemini CLIのガイドではNode.js v20+の例があるため、複数のプロジェクトで異なるNodeバージョンを扱う可能性があります。だからこそnvm（またはWindows版のnvm）が有用で、「環境切替の手間」を劇的に下げます[4](https://docs.anthropic.com/en/docs/claude-code/sdk)[11](https://www.kdnuggets.com/beginners-guide-to-gemini-cli-install-setup-and-use-it-like-a-pro)。 - 権限とグローバルインストールの落とし穴：npmでグローバルインストールする際の権限問題（sudo不要の推奨など）は多くのドキュメントで触れられており、初心者はまずnpxで試す・ユーザー権限でのnpm設定を行うのが失敗を避けるコツです[4](https://docs.anthropic.com/en/docs/claude-code/sdk)[6](https://pypi.org/project/claude-api/)。 - APIキーの管理は必須のセキュリティ作法：キーをコードに直書きせず、環境変数で管理すること（mac/Windows両方の設定手順は公式に記載）を必ず守ってください[3](https://docs.anthropic.com/en/docs/get-started)[0](https://tilburg.ai/2025/01/beginners-tutorial-for-the-claude-api-python/)。 - まずは小さく試す（npx・ワークベンチ）：Gemini CLIやClaudeのWorkbench/APIを“ブラウザで試す→APIキーを取得→CLIで環境変数を設定して動かす”という段階的な流れは初心者に優しいです[3](https://docs.anthropic.com/en/docs/get-started)[11](https://www.kdnuggets.com/beginners-guide-to-gemini-cli-install-setup-and-use-it-like-a-pro)[12](https://cloud.google.com/blog/ja/topics/developers-practitioners/introducing-gemini-cli)。 #### 全体のフロー図（簡易） ```mermaid flowchart LR A[準備: ターミナル / 管理者権限] --> B[Node.js & nvm インストール] B --> C[npm（同梱）確認 node -v / npm -v] C --> D[Git を導入（必要に応じて）] D --> E[Anthropic アカウント作成 & APIキー取得] D --> F[Google アカウント（Gemini CLI 認証）] E --> G[Claude Code インストール・環境変数設定] F --> H[Gemini CLI を npx で試す or npm install -g] ``` （上流の「Node.js & nvm」が最も重要で、ここを安定させると後の導入がスムーズになります。出典：Node.js公式ダウンロードのnvm推奨説明、Anthropicの導入ガイド）[9](https://nodejs.org/en/download)[4](https://docs.anthropic.com/en/docs/claude-code/sdk)[3](https://docs.anthropic.com/en/docs/get-started)。 #### 参考画像（Gemini CLI のイメージ）  （Gemini CLI の紹介イメージ／出典: Google Cloud ブログ）[14](https://cloud.google.com/blog/ja/topics/developers-practitioners/introducing-gemini-cli) #### 最後に — 初心者への実践アドバイス - まずは「npx で Gemini CLI を試す」か「Anthropic のWorkbench（ブラウザ）でClaudeを試す」ことを推奨します。トラブルの切り分けが簡単です（ブラウザ→CLIの順に進める）[11](https://www.kdnuggets.com/beginners-guide-to-gemini-cli-install-setup-and-use-it-like-a-pro)[3](https://docs.anthropic.com/en/docs/get-started)。 - つまずいたらまず確認するコマンド：node -v / npm -v / git --version / echo $ANTHROPIC_API_KEY（mac）や echo %ANTHROPIC_API_KEY%（Windows）で環境が整っているかをチェックしてください（公式ドキュメントで同様の確認方法が示されています）[9](https://nodejs.org/en/download)[3](https://docs.anthropic.com/en/docs/get-started)。 - 権限やPATHの問題で動かない場合は「ターミナルを再起動」「管理者で再実行」「npxで試す」を順に試すと解決が早いです[8](https://nodejs.org/ja/download)[11](https://www.kdnuggets.com/beginners-guide-to-gemini-cli-install-setup-and-use-it-like-a-pro)。 参考（主要出典） - Node.js ダウンロードと nvm によるインストール例・バージョン確認: Node.js 公式ダウンロードページ[9](https://nodejs.org/en/download)、日本語ページ[8](https://nodejs.org/ja/download)、トップページ[7](https://nodejs.org/ja) - Claude Code / Claude API の導入・APIキー・SDK: Anthropic ドキュメント[4](https://docs.anthropic.com/en/docs/claude-code/sdk)、Get started ガイド[3](https://docs.anthropic.com/en/docs/get-started)、チュートリアルまとめ[0](https://tilburg.ai/2025/01/beginners-tutorial-for-the-claude-api-python/) - Gemini CLI の紹介・インストール手順解説例: Google Cloud ブログ（紹介）[12](https://cloud.google.com/blog/ja/topics/developers-practitioners/introducing-gemini-cli)、KDnuggetsの導入ガイド[11](https://www.kdnuggets.com/beginners-guide-to-gemini-cli-install-setup-and-use-it-like-a-pro) 必要であれば、次は「Windowsでの具体的な一歩ずつインストール手順（スクリーンショット付き）」あるいは「macOSでの端末操作を画像つきで案内」など、よりハンズオンな手順書を作成します。どちらで進めましょうか？