はじめに

「ターミナル型AIエージェントが乱立していて、どれを選べばいいか分からない…」

Claude Code（Anthropic）、Gemini CLI（Google）、Codex CLI（OpenAI）——三大AI企業がそれぞれターミナル型エージェントをリリースし、2026年4月現在、どれを使うべきか迷っているエンジニアが急増しています。

どれも「ターミナルから自律的にファイルを編集・コマンドを実行できる」という点は同じです。しかし設計思想・得意分野・コストが大きく異なります。

本記事では3つのツールを同じ観点で徹底的に比較します。「どれを選ぶべきか」の判断材料として、ぜひ参考にしてください。

Amazon検索[本 Claude Code]

Amazon検索[本 Gemini]

基本スペック比較

まずは数値で比べます。

ベンチマークについての補足

SWE-bench Verifiedはコーディングタスク全般の能力評価です。一方、Terminal-Bench 2.0はターミナル操作・シェルスクリプト実行に特化した評価です。Codex CLIはターミナル特化のベンチマークで最高スコアを記録しています。

※OpenAIはSWE-bench Verifiedにトレーニングデータ汚染が発見されたとして報告を停止。Codex CLIの現行モデル比較にはSWE-bench ProとTerminal-Bench 2.0が使われています。

料金の詳細

Claude Code:

Proプラン: $20/月（5時間ごとに約10〜40プロンプト制限）
Max 5x:   $100/月（5倍の使用量）
Max 20x:  $200/月（20倍の使用量）
※ Web版・Desktop版・Claude Codeで使用量を共有

Gemini CLI:

無料枠:   0円（Googleアカウントのみ）
          └→ 60リクエスト/分、1,000リクエスト/日
          └→ デフォルト: Gemini 2.5 Flash
API利用:  従量課金（Google AI Studio経由）
          └→ Gemini 3 Flash: 高コスパ（SWE-bench Verified 78%）

Codex CLI:

無料枠:   なし（APIキー or ChatGPT Plus必須）
Plus:     $20/月（30〜150メッセージ/5時間）
Pro:      $200/月（300〜1,500メッセージ/5時間）
API従量:  gpt-5.4-mini: 入力 $1.25/Mトークン
          → 使いすぎると青天井になる点に注意

Claude Codeの強み——他2ツールにできないこと

1. 高い自律性と粘り強いデバッグ

Claude Codeの最大の強みは**「テストを回す→エラーが出る→自分で修正する→またテストする」** というループの粘り強さです。

Claude Codeのデバッグループ:
1. エラーを検知
2. 原因を深く推論（Thinkingモード）
3. 修正案を実装
4. テストを再実行
5. 成功するまで繰り返す（ほとんど手動介入不要）

実際のベンチマーク比較（あるコーディングタスク）：

Claude Code: 1h17m で完了、コスト $4.80（全自動）
Gemini CLI: より長い時間、コスト $7.06（途中で手動介入が必要なケースも）

Gemini CLI・Codex CLIの課題: どちらも修正を繰り返すと同じ間違いをループしたり、指示を無視して大幅な書き換えをしてしまうことがあります。

2. 洗練されたコードの品質

Claudeは「コーディングの職人気質」が評価されており、生成されるコードが非常に洗練されています。

Claude Code: 簡潔で読みやすいコード
             冗長な記述を避ける傾向
             命名規則やスタイルに一貫性がある

Gemini CLI:  実用的だが、時に冗長なボイラープレートを出力
Codex CLI:   gpt-5.4使用時は高品質だが、モデル選択に依存する
             ※ gpt-5.1 / gpt-5.2-codexは2026年4月14日に廃止。gpt-5.4またはgpt-5.3-codexへの移行が必要

3. 深い思考（Thinkingモード）による自己修正

Claude Codeは、コードを書く前に**「なぜその設計にするのか」を深く自問自答**します。

Claudeの思考プロセス:
1. 要件の本質を理解
2. 複数の実装パターンを検討
3. トレードオフを評価
4. 最適解を選択してから実装

→ 結果: 一発で動くコードを書く確率が高い
   SWE-bench Verified: Sonnet 4.6 で 79.6% / Opus 4.6 で 80.8% / Opus 4.7 で 82.0%（2026年4月時点で最高水準）

4. 音声入力モード（2026年3月〜）

2026年3月のアップデートで、Claude Codeに音声入力モードが追加されました。

/voice コマンドでプッシュトゥトーク方式の音声入力が可能
→ ターミナルでの長い指示も音声で素早く入力できる
→ ハンズフリーでのコーディングが可能に

Gemini CLI・Codex CLIでは現時点でネイティブ音声モードは未搭載です。

5. VS Code + JetBrains 両方に公式IDE統合

Claude Code:  VS Code拡張機能（公式）+ JetBrains拡張機能（公式）
Gemini CLI:   VS Code拡張機能あり
Codex CLI:    ターミナル中心（公式IDE統合なし）

IntelliJ・WebStorm等のJetBrains系IDEを使う開発者には特に優位です。

6. 定額制による費用の予測しやすさ

Claude Code Pro: $20/月で使用量の上限がある
                 → 月の予算が読みやすく、予算オーバーが起きない

Codex CLI:       APIキー従量課金で青天井になる可能性
Gemini CLI:      無料枠を超えると従量課金に

Gemini CLIの強み——他2ツールにできないこと

1. 完全無料から始められる

これがGemini CLIの最大のアドバンテージです。

Gemini CLI:
✅ Googleアカウントだけで今日から無料でスタート
✅ 1,000リクエスト/日で日常的な開発には十分
✅ SWE-bench Verified 78%（Sonnet 4.6の79.6%には僅かに届かないが高水準）という高精度が無料で使える
※ 2026年3月25日以降、無料枠でProモデルが制限され、Gemini 2.5 Flashのみ利用可（低レートリミット）

Claude Code: 別途サブスク（$20/月〜）が必要
Codex CLI:   APIキー or ChatGPT Plus（$20/月〜）が必要

2. 超大規模プロジェクトの「一括」把握

Gemini CLIのコンテキスト: 最大100万トークン
  └→ 数万行のコードベースを丸ごと読み込める
  └→ ファイル間の依存関係や矛盾を一括検出可能

Claude Code: 約20万トークン
  └→ 大規模プロジェクトでは記憶を圧縮（Compaction）
  └→ 圧縮により細部の記憶が抜け落ちることがある

Codex CLI:  gpt-5.3-codexで100万トークン対応
  └→ ただし gpt-5.4（デフォルト）は100万トークン未対応
  └→ モデルを指定変更する必要がある

Gemini CLIはデフォルトのモデルから100万トークンが使える点が優位です。

実際の活用例:

# 数万行のコードベースを丸ごと分析
> このプロジェクト全体を俯瞰して、
> アーキテクチャ上の矛盾点と将来の拡張に向けた改善提案を教えて

3. Google検索とのリアルタイム統合

# 昨日リリースされたライブラリの最新仕様を調べながらコードを書く
> /search React 19 useOptimistic の使い方

# 最新のAWSサービスを使った実装
> 最新のLambda関数URLの仕様を確認して、このコードに組み込んで

Claude Code・Codex CLIはいずれも学習データに基づく推論がメインで、最新情報へのリアルタイムアクセスではGemini CLIが優位です（Codex CLIもWeb検索機能はあるが、Googleほど検索精度が高くない）。

4. Plan Mode（v0.30.0〜デフォルト有効）

Gemini CLI:
✅ 実行前に必ず「実装計画」を提示し、ユーザーが承認してから動く
✅ v0.30.0以降はデフォルト有効
✅ 外部エディタでプランを編集してから実行する機能もあり

Claude Code: 近い機能はあるが、Plan Modeとして独立していない
Codex CLI:   /plan コマンドで呼び出せるが、デフォルトではない

5. スキル（Skills）機能——ワークフローのチーム共有

Gemini CLI独自の拡張機能です。

スキルとは:
- 定型的なワークフローや複雑な手順を「スキル」として定義・共有できる
- タスクに適合するスキルをGemini CLIが自動検出して起動
- チーム全体での開発標準化が容易になる

管理コマンド:
/skills list    → 利用可能なスキルを一覧表示
/skills enable  → スキルを有効化
/skills disable → スキルを無効化

6. マルチモーダル（動画・音声）の優位性

Gemini CLI（Geminiモデル）:
✅ 動画ファイルを渡してバグを修正させることが可能
✅ 画像・音声・PDFなど多様なメディアに対応

Claude Code: スクリーンショット（画像）解析は得意
Codex CLI:  画像入力に対応。動画・音声はGeminiが先行

7. コスト効率（大規模タスク）

Gemini 2.5 Flash（デフォルト）:
- SWE-bench Verified スコア: 78%（3ツール中最高水準）
- 無料枠: 1,000リクエスト/日
- → 品質を保ちながら大量処理できる

Codex CLIの強み——他2ツールにできないこと

1. ターミナル作業能力が業界最高水準

Terminal-Bench 2.0（ターミナル操作・シェルスクリプトの実行能力を評価するベンチマーク）での比較：

Terminal-Bench 2.0:
Codex CLI (gpt-5.3-codex): 77.3%  ← 最高
Claude Code (Opus 4.6):    65.4%
Gemini CLI:                未公開

シェル操作・コマンドライン作業が本職のツールです。

2. OSネイティブのサンドボックス実行

Codex CLIにしかない最も特徴的な機能です。

Codex CLI:
✅ OSネイティブのサンドボックスでコマンド実行を完全隔離
✅ approval-policy=never でも安全な完全自動化が可能
✅ ワークスペース内に操作範囲を限定できる

Claude Code: サンドボックスなし
Gemini CLI:  サンドボックスなし

これにより、他2ツールが「安全のためにfull-autoは危険」なのに対し、Codex CLIはサンドボックスが有効な状態でfull-autoが実現できます。

3. 承認モードの細かい制御（4段階）

Codex CLI の承認モード:
on-request（デフォルト）: ワークスペース外の操作のみ確認
untrusted:               変更・破壊的操作を全て確認（読み取りは自動）
never:                   全ての承認をスキップ（サンドボックスは有効）
dangerously-bypass:      全制限を解除（隔離環境専用）

Claude Code・Gemini CLI: On/Off 程度の制御しかない

4. CI/CDパイプラインへの最適設計

Codex CLI:
✅ never + sandbox の組み合わせで安全な完全自動化
✅ GitHub Actionsに直接組み込める
✅ 夜間バッチ・定期タスクの自動実行に最適

Claude Code・Gemini CLI:
△ CLIとして動作はするが、CI/CD前提の設計ではない

5. Apache-2.0ライセンスで社内カスタマイズが自由

Codex CLI（Apache-2.0）:
✅ ソースコードを完全に改変・再配布可能
✅ 社内セキュリティポリシーに合わせたカスタマイズが可能
✅ 社内MCPサーバーと組み合わせた専用エージェント構築

Gemini CLI（Apache-2.0）: 同様にオープンソース
Claude Code:              クローズドソース

6. マルチエージェントv2による並列タスク実行

Codex CLI マルチエージェントv2:
✅ パスベースアドレスで複数のサブエージェントを管理
✅ 構造化メッセージングで各エージェントが協調
✅ フロントエンド・バックエンドを別エージェントが並列で担当

→ 大規模なリファクタリングや複数モジュールの同時実装に効果的

7. プラグインマーケットプレイス（v0.121.0〜）

v0.121.0から新たにプラグインマーケットプレイスが追加されました。

Codex CLI マーケットプレイス:
✅ codex marketplace add コマンドでプラグインを即座にインストール
✅ コミュニティ製・公式のプラグインを組み合わせて機能拡張が可能
✅ 社内カスタムプラグインも配布可能（Apache-2.0）

8. 音声入力（Realtime Voice V2）対応（v0.119.0〜）

v0.119.0のアップデートでRealtime Voice V2が実装されました。

Codex CLI 音声入力:
✅ スペースバー長押しで録音・文字起こし
✅ リアルタイム会話形式での操作が可能
✅ WebRTCがデフォルトトランスポートとして採用

※ Claude Codeの /voice コマンドに続き、Codex CLIも音声入力に対応。Gemini CLIは未対応。

7. 高速処理（Cerebras統合）

Codex CLI (Cerebras統合): 1,000トークン/秒超
Claude Code:              約200トークン/秒
→ 約5倍の処理速度

大量のファイルを素早く処理する際に特に有効です。

設定ファイルの比較

3つのツールともに、プロジェクトのルールを記述したMarkdownファイルを自動読み込みします。

配置パスの比較

書き方の違いと特徴

CLAUDE.md（Claude Code）：

# プロジェクトルール

## コミュニケーション
- すべてのやり取りは日本語で行うこと

## コーディング規約
- コードの右側にコメントを書くこと
  例: `const x = 1; // 値を初期化`

## プロジェクト固有のルール
- npm scripts 実行時は -- を使って引数を渡すこと

GEMINI.md（Gemini CLI）：

# プロジェクト概要
このプロジェクトは Next.js + TypeScript で構築したブログシステムです。

# コーディングルール
- すべてのやり取りは日本語で行うこと
- コメントはコードの右側に記述すること

# 開発コマンド
- ビルド: npm run build
- テスト: npm test

AGENTS.md（Codex CLI）：

# プロジェクト概要
Next.js + TypeScript のブログシステム

# コーディング規約
- すべてのやり取りは日本語で行うこと
- TypeScript strict モードを厳守

# 開発コマンド
- ビルド: npm run build
- テスト: npm test

# セキュリティポリシー（full-autoモードでの暴走防止）
- .envファイルは絶対に読み取らないこと
- node_modules は絶対に編集しないこと
- 本番環境のDBに接続するコマンドは実行しないこと

書き方のポイント:

• CLAUDE.md: 制約・スタイルガイドの記述が効果的（指示への忠実さが高いため）
• GEMINI.md: 開発コマンドの記述が効果的（CLIコマンドを自律実行するため）
• AGENTS.md: 禁止事項・セキュリティポリシーの明記が特に効果的（full-autoモードの安全性確保のため）

設定の確認コマンド

UI・操作感の違い

Claude Code

• ステップを細かく逐次表示（「ファイルAを読み込みました」「ファイルBを編集しました」など、各アクションを個別に報告）
• ツリー形式でアクションを表示
• 変更内容の差分表示が明確
• 承認プロンプトのUXが洗練されている

Gemini CLI

• 複数のアクションをまとめてボックスで表示（「3つのファイルを確認して修正しました」のようにサマリー形式）
• Plan Modeで作業前に確認ステップを挟める（v0.30.0〜デフォルト有効）
• Verboseモードへの切り替えで、Claude Codeのような逐次ログ表示も可能
• 外部エディタでプランを開いて編集する機能も追加（v0.30.0〜）

Codex CLI

• シンプルなターミナルUI（3ツールの中で最もミニマル）
• 承認プロンプトは機能的だが、視覚的な洗練度は低め
• /plan コマンドでプランモードを呼び出せるが、デフォルトではない
• マルチエージェントv2では複数スレッドを agent コマンドで切り替えて管理

「何をやっているか全部見たい」派            → Claude Code
「結果だけ教えてくれればいい」派            → Gemini CLI
「CIに組み込んで完全自動化したい」派        → Codex CLI

実際の使い分け戦略

ケース別おすすめ

プロの3ツール使い分け

Gemini CLI を使う場面:
✅ ブログ記事100本を一度にスキャンしてSEO課題を見つける
✅ 新しいフレームワークで「まず動くもの」を速攻で作る
✅ コードベース全体の依存関係を把握する
✅ チーム共通のスキル（Skills）を定義してワークフローを標準化する
✅ Plan Modeで実行前に全工程を確認・承認してから安全に作業する
✅ 無料枠の範囲で日常のちょっとした作業を済ませる

Claude Code を使う場面:
✅ 複雑なロジックをバグなしで一発で実装したい
✅ Geminiが書いた「動くけど汚いコード」を清書する
✅ 特定のバグを粘り強くデバッグしたい
✅ 音声入力で手をふさがずにコーディング指示を出したい
✅ VS Code / JetBrains の両方を使った IDE統合で作業したい

Codex CLI を使う場面:
✅ GitHub ActionsなどのCI/CDに組み込んだ安全な自動化
✅ 夜間バッチで大量ファイルの処理を完全自動実行
✅ シェルスクリプト・インフラコードの高度な自動化
✅ Apache-2.0ライセンスで社内ツールに改造・組み込み
✅ マルチエージェントで複数モジュールを並列で開発
✅ プラグインマーケットプレイスで機能を素早く拡張（v0.121.0〜）
✅ 音声入力（Realtime Voice V2）でハンズフリー開発（v0.119.0〜）

最適な分担:

「全体像を把握させる」          → Gemini CLI（デフォルトで100万トークン）
「一か所のバグを徹底的に詰める」 → Claude Code（粘り強い自律デバッグ）
「自動化・CI/CDに組み込む」     → Codex CLI（サンドボックス + full-auto）

機能比較まとめ表

Amazon検索[本 Claude Code]

Amazon検索[本 Gemini]

まとめ

Claude Code・Gemini CLI・Codex CLIの3ツールは、三すくみの補完関係にあります。

3ツールの立ち位置

Claude Code  → 「精密に・確実に・高品質で」
Gemini CLI   → 「広く・大量に・無料で」
Codex CLI    → 「自動化・CI・ターミナル最強で」

あなたに合うのはどれか

Gemini CLIが向いている方:

• まず0円でAIエージェントを試してみたい
• 大規模なコードベース全体をAIに把握させたい
• Google検索と連携した最新情報を使いたい
• チームでワークフローを標準化したい（Skills機能）

Claude Codeが向いている方:

• コードの品質を最優先にしたい
• 複雑なバグを自律的に修正させたい
• 定額制で費用を予測しやすくしたい
• JetBrains系IDEで使いたい
• 音声入力でハンズフリー開発したい

Codex CLIが向いている方:

• CI/CDパイプラインにAIエージェントを安全に組み込みたい
• シェル・ターミナル作業を高度に自動化したい
• Apache-2.0ライセンスで社内ツールに改造・組み込みしたい
• マルチエージェントで大規模タスクを並列処理したい

最もコスパの良い使い方

STEP 1: Gemini CLIの無料枠から試す（0円）
  ↓ 物足りなくなったら
STEP 2: Claude CodeのProプランを追加（$20/月）
  ↓ CI/CD自動化が必要になったら
STEP 3: Codex CLIをCI/CDに組み込む（従量課金・少額）

この3段階のアプローチが、2026年4月現在でコスト面でも最も賢い選択です。

関連記事：

• Claude Code完全ガイド｜ターミナルで動くAIコーディングアシスタントの全貌【2026年3月版】

Claude Code完全ガイド｜ターミナルで動くAIコーディングアシスタントの全貌【2026年4月版】

はじめに「AIにコードを書かせたいけど、ブラウザとエディタを行き来するのが面倒…」そんな悩みを解決するのがClaude Codeです。2026年4月時点で、Anthropicが提供するターミナル型AIエージェントとして、開発者の間で急速に注...

caymezon.com

2026.02.14

• Gemini CLI完全ガイド｜ターミナルで動くGoogleのAIエージェントの全貌【2026年3月最新】

Gemini CLI完全ガイド｜ターミナルで動くGoogleのAIエージェントの全貌【2026年4月最新】

はじめに「Claude CodeみたいなAIコーディングエージェントを試したいけど、費用を抑えたい…」「Googleが出しているターミナル版AIエージェントって何ができるの？」そんな疑問を持つエンジニアに向けて、Gemini CLIの全貌を...

caymezon.com

2026.02.21

• OpenAI Codex CLI完全ガイド｜ターミナルで動くOpenAIのAIエージェントの全貌【2026年3月最新】

OpenAI Codex CLI完全ガイド｜ターミナルで動くOpenAIのAIエージェントの全貌【2026年4月最新】

はじめに「Claude CodeやGemini CLIみたいなAIエージェントを、OpenAIのモデルで使いたい…」「ターミナルで動くAIエージェントの中で、OpenAIが出しているものって何？」そんな疑問を持つエンジニアに向けて、Open...

caymezon.com

2026.03.28

• 【まとめ記事】Claude Code完全攻略ロードマップ｜全記事まとめ

【2026年版】Claude Code完全攻略ロードマップ｜セットアップからVSCode活用・コマンド習得まで全記事まとめ

はじめに「Claude Codeに興味があるけど、何から始めればいいかわからない」「Claude Codeを使い始めたけど、もっと使いこなしたい」この記事は、Claude Codeに関するすべての記事を体系的にまとめたロードマップです。初心...

caymezon.com

2026.03.21

タグ: #CodexCLI #ClaudeCode #GeminiCLI #AI比較 #OpenAI #Google #Anthropic #ターミナル #開発効率化

The post Claude Code vs Gemini CLI vs Codex CLI｜できること・できないことを徹底比較【2026年4月版】 first appeared on CayTech Lab.

はじめに

「Claude CodeやGemini CLIみたいなAIエージェントを、OpenAIのモデルで使いたい…」

「ターミナルで動くAIエージェントの中で、OpenAIが出しているものって何？」

そんな疑問を持つエンジニアに向けて、OpenAI Codex CLIの全貌を徹底解説します。

OpenAIが2025年4月に公開したCodex CLIは、2026年4月時点でバージョンv0.121.0に達し、単なるコード補完ツールから本格的なターミナル型AIエージェントへと進化しました。特にTerminal-Bench 2.0（ターミナル作業能力のベンチマーク）で**77.3%**というスコアは、同カテゴリのツールの中で最高水準です。

本記事では、2026年4月時点の最新情報をもとに、Codex CLIの全体像から実践的な活用方法まで徹底解説します。

この記事で分かること

• Codex CLIとは何か（Claude Code・Gemini CLIとの違い）
• できること・主な機能
• メリット・デメリットの詳細分析
• 承認モード（Approval Policy）とサンドボックスの使い方
• AGENTS.mdによるプロジェクト設定
• 料金体系と使い分け
• インストール手順（Windows/Mac/Linux対応）
• 実践的な活用シーン

こんな人におすすめ

• OpenAIのモデル（GPT-5系）でターミナルAIエージェントを使いたい開発者
• CI/CDパイプラインにAIエージェントを組み込みたいエンジニア
• 完全自動化に安全なサンドボックスを使いたい人
• Claude CodeやGemini CLIとの比較で選択肢を広げたい人
• オープンソースのAIエージェントをカスタマイズして使いたい人

Codex CLIとは

基本概念

Codex CLIは、OpenAIが開発・オープンソース公開しているコマンドライン型のAIエージェントです。

■ターミナルネイティブ
└→ コマンドラインから直接OpenAIモデルとやり取り
└→ エディタとシームレスに統合

■ローカルファイルアクセス
└→ プロジェクトファイルを直接読み書き
└→ ディレクトリ全体を丸ごと解析

■エージェント機能
└→ ファイル編集・シェル実行・Git操作を自律実行
└→ 複数ステップのタスクを自動的に処理

GitHubリポジトリはApache-2.0ライセンスで公開されており、誰でもソースコードを確認・改変・貢献できます。

他のAIエージェントとの違い

2026年4月時点の最新バージョン

Codex CLIでできること

1. ファイル操作（作成・編集・削除）

ローカルファイルを直接操作できます。

# Codex CLIを起動
codex

# 指示例（プロンプトで入力）
> main.py のバグを修正して保存して

> 新しいファイル utils.ts を作成して、日付フォーマット関数を実装して

> src/ フォルダ内の全 .ts ファイルにエラーハンドリングを追加して

2. コードの理解と分析

プロジェクト全体を読み込み、深い分析が可能です。

> このプロジェクト全体のアーキテクチャを分析して、セキュリティ上の問題点を指摘して

> src/components/ フォルダの全コンポーネントを確認して、重複している処理をリストアップして

gpt-5.3-codexモデル使用時は100万トークンのコンテキストに対応しており、大規模なコードベースを丸ごと保持したまま会話できます。

3. シェルコマンドの実行

> テストを実行して、失敗したケースがあれば原因を分析して修正して

> npm run build してエラーがあれば解決して

> git log を確認して、今週のコミット内容をまとめて

4. Git操作の自動化

> 今の変更を feature/fix-bug ブランチにコミットしてプッシュして

> git の差分を確認して、適切なコミットメッセージを作成してコミットまで完了させて

5. Web検索との連携

デフォルトで有効化されており、最新情報をリアルタイムに取得しながらコードを生成できます。

# 最新ライブラリ情報を調べながらコードを書く
> React 19 の新しいフック useOptimistic を使った実装例を見せて

# セキュリティアドバイザリを参照しながら修正
> この依存パッケージに既知の脆弱性がないか確認して

6. 大規模ドキュメント・コードの一括処理

> content/ フォルダ内の全記事をスキャンして、古いAPIの呼び出し箇所を
> 新しいバージョンに一括置換して保存して

主要機能の詳細

承認モード（Approval Policy）【安全のために重要】

Codex CLIの最大の特徴が細かく制御できる承認ポリシーです。--approval-policy フラグまたは config.toml で設定します。

# デフォルト（on-request）: ワークスペース外の操作のみ承認を求める
codex

# 読み取り専用: 状態変更・破壊的操作は全て承認
codex --approval-policy untrusted

# 完全無効: 全ての承認プロンプトをスキップ（サンドボックスは有効）
codex --approval-policy never

# 危険モード: サンドボックス・承認を完全無効化（隔離環境専用）
codex --dangerously-bypass-approvals-and-sandbox

最初は on-request（デフォルト）で使うことを強く推奨します。

サンドボックス実行【Codex CLI独自の安全機能】

Codex CLIはOSネイティブの機能でコマンド実行を隔離します。macOS/Linux/WSL/Windows Nativeで実装が異なります。

■ read-only（読み取り専用）
└→ ファイル閲覧のみ。編集・コマンド実行は承認必要

■ workspace-write（デフォルト）
└→ ワークスペース内のファイル読み書き・通常コマンドは自動許可
└→ ネットワークアクセスやワークスペース外への変更は制限

■ danger-full-access
└→ ファイルシステム・ネットワーク境界を完全解除

Claude CodeやGemini CLIにはないサンドボックス機能により、--approval-policy never と組み合わせても安全な完全自動化が実現できます。

AGENTS.md（プロジェクト設定ファイル）【Claude CodeのCLAUDE.mdに相当】

Codexが起動時に自動読み込みするMarkdown形式の指示ファイルです。

# プロジェクト概要
このプロジェクトはNext.js + TypeScriptで構築したブログシステムです。

# コーディング規約
- すべてのやり取りは日本語で行うこと
- コメントはコードの右側に記述すること
- TypeScript strict モードを厳守すること
- 不要なboilerplateコードは書かないこと

# 開発コマンド
- ビルド: npm run build
- テスト: npm test
- Lint: npm run lint

# セキュリティポリシー
- .envファイルは絶対に読み取らないこと
- node_modules は絶対に編集しないこと
- 本番環境のDBに接続するコマンドは実行しないこと

読み込み順序（優先度が高い順）：

AGENTS.mdのポイント:

• 禁止事項の明記が特に効果的（full-autoモードでの暴走防止）
• 正確なビルド・テストコマンドを記述しておくと精度が上がる
• セキュリティポリシーを明記することで機密情報の漏洩を防止

config.toml（設定ファイル）

AGENTS.mdがプロンプトの指示なら、config.tomlはCLI自体の動作設定です。

# ~/.codex/config.toml（ユーザーレベル）
model = "gpt-5.4"                    # デフォルトモデル
sandbox_mode = "workspace-write"      # サンドボックスモード
approval_policy = "on-request"        # 承認ポリシー

[features]
multi_agent = true                    # マルチエージェントv2を有効化
web_search = true                     # Web検索を有効化

MCP（Model Context Protocol）連携【拡張性が魅力】

MCP対応により、外部ツールとの連携を自由に追加できます。

# ~/.codex/config.toml でMCPサーバーを設定
[mcp_servers.github]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-github"]
enabled = true

[mcp_servers.postgres]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-postgres"]
enabled = true

設定後は /mcp コマンドで接続済みツールを確認できます。GitHubのIssue読み書きやPostgreSQLへの問い合わせを、Codexに自然言語で指示できるようになります。

マルチエージェントv2【v0.117.0〜】

v0.117.0で追加された機能で、複数のサブエージェントを並列実行できます。

> /agent
# パスベースでサブエージェントを管理
# /root/agent_a でフロントエンド担当
# /root/agent_b でバックエンド担当
# → 両エージェントが並列で作業し、構造化メッセージで通信

大規模なリファクタリングや複数モジュールの同時実装に威力を発揮します。

スラッシュコマンド

会話の再開

# ローカル保存されたセッションを復元（長時間タスクに便利）
codex resume

前回の作業状態をそのまま引き継いで続きから始められます。

使用モデル

Terminal-Bench 2.0（ターミナル作業能力）: gpt-5.3-codex で 77.3%

※OpenAIはSWE-bench Verifiedにトレーニングデータ汚染が発見されたとして報告を停止。現在はSWE-bench Pro（56.8%）とTerminal-Bench 2.0が実質的な比較指標となっています。

/model コマンドでセッション中にいつでもモデルを切り替えられます。タスクの複雑さに応じてgpt-5.4とgpt-5.4-miniを使い分けることでコストを最適化できます。

料金体系

前提：APIキーが必須

Codex CLIを使うにはOpenAI APIキーまたはChatGPTのサブスクリプションが必要です。完全無料枠はありません。

ChatGPTサブスクリプション経由

APIキー（従量課金）

⚠️ APIキー従量課金の注意点
└→ 使用量が増えると青天井になる
└→ プロジェクトごとに予算上限を設定することを推奨
└→ gpt-5.4-mini（低コストモデル）を日常タスクに使うことでコスト削減可能

コスト最適化の考え方

gpt-5.4-mini を使う場面:
✅ 単純なファイル編集・コメント追加
✅ ドキュメント生成
✅ 簡単なリファクタリング

gpt-5.4 を使う場面:
✅ 複雑なアーキテクチャ設計
✅ 難易度の高いバグ修正
✅ セキュリティ審査

gpt-5.3-codex を使う場面:
✅ 大規模コードベース（数万行）の全体分析
✅ モノレポの依存関係解析

インストール手順

前提条件

• Node.js 22以上
• OpenAI APIキー または ChatGPT Plus以上のアカウント

Step 1: Node.jsのインストール確認

# バージョン確認
node -v
# v22.x.x 以上が表示されればOK

バージョンが表示されない場合は、Node.js公式サイトからLTS版をインストールしてください。

Step 2: Codex CLIのインストール

npm install -g @openai/codex

Step 3: APIキーの設定

OpenAI APIキーを使う場合（推奨）：

# Mac / Linux
export OPENAI_API_KEY="sk-..."
# または .bashrc / .zshrc に追記して永続化

# Windows (PowerShell)
[System.Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "sk-...", "User")

ChatGPTアカウントを使う場合：

# 起動時にブラウザが開き、ChatGPTアカウントでログイン
codex
# → デバイスコードサインイン（v0.116.0〜）

Step 4: 初回起動と動作確認

# 起動
codex

# 動作確認
> このディレクトリの構造を教えて

これだけで準備完了です。

Windowsネイティブでの使用

v0.121.0以降、Windowsネイティブのサポートが安定しました。WSLなしでも動作するようになっています。

# Windowsネイティブ（PowerShell）
npm install -g @openai/codex
$env:OPENAI_API_KEY = "sk-..."
codex

# WSL経由の場合（より安定）
npm install -g @openai/codex
export OPENAI_API_KEY="sk-..."
codex

メリット

1. ターミナル作業能力が最高水準

Terminal-Bench 2.0（ターミナル操作・シェルスクリプトの実行能力評価）で**77.3%**という業界最高水準のスコアを達成しています。

Terminal-Bench 2.0 比較:
Codex CLI (gpt-5.3-codex): 77.3%  ← 最高
Claude Code (Opus 4.7):    65.4%

シェル操作・コマンドライン作業が得意なのが最大の強みです。

2. サンドボックス実行による安全な完全自動化

Codex CLI:
✅ OSネイティブのサンドボックスでコマンド実行を隔離
✅ approval-policy=never でも安全な自動化が可能
✅ CI/CDパイプラインへの組み込みに最適

Claude Code・Gemini CLI:
❌ サンドボックス機能なし

3. モデルを柔軟に使い分けられる

gpt-5.4-mini: 低コストの日常タスク用
gpt-5.4:      高精度の複雑タスク用
gpt-5.3-codex: 100万トークンの大規模解析用

→ タスクに応じてコストと品質を最適化できる

4. Apache-2.0のオープンソース

✅ ソースコードを完全に確認・改変可能
✅ 社内環境への組み込みが容易
✅ コミュニティによる機能拡張が活発
✅ ベンダーロックインのリスクが低い

5. 高速処理（Cerebras統合）

Cerebras社との統合により、1,000トークン/秒超の高速推論が可能です（Claude Codeの約200トークン/秒と比較して5倍以上）。大量のファイルを素早く処理する際に特に有効です。

6. ChatGPT統合による統一体験

ChatGPT Web UI
    ↓ 同一アカウント
ChatGPT iOSアプリ
    ↓ 同一アカウント
VS Code拡張機能
    ↓ 同一アカウント
Codex CLI
→ どこでも同じ会話履歴にアクセス可能

7. マルチエージェントによる並列タスク実行

v0.117.0から本格化したマルチエージェントv2により、複数のサブエージェントが並列で作業できます。大規模なリファクタリングや複数モジュールの同時実装の効率が大幅に向上します。

デメリット・注意点

1. 完全無料枠がない

Codex CLI:   APIキー or ChatGPT Plus（$20/月〜）が必須
Gemini CLI:  Googleアカウントのみで0円から始められる

→ まず試してみたいだけの場合はGemini CLIの方が手軽

2. ターミナル操作が必須

GUIに慣れている方には学習コストがあります。

基本操作の習得: 1〜2時間
日常的な使いこなし: 1週間程度

3. Windowsネイティブは改善中

v0.121.0でWindowsネイティブのサポートが安定しましたが、一部の機能はWSL環境の方が安定しています。サンドボックス機能をフル活用したい場合はWSL経由の使用を推奨します。

4. コスト管理が必要

APIキー利用の場合、使用量に上限がないため予算管理が必要です。

⚠️ リスクケース:
- gpt-5.4で大規模コードベースを何時間も分析する
- マルチエージェントを多数起動する

✅ 対策:
- OpenAIダッシュボードで予算上限（Usage Limits）を設定
- 日常タスクはgpt-5.4-miniで処理する
- gpt-5.3-codexは大規模解析の時だけ使う

5. ChatGPT・Claude Codeほど日本語コミュニティが充実していない

日本語の情報や事例がまだ少ないため、問題が発生した際に日本語で解決策を探しにくい場面があります。

実践的な活用シーン

シーン1: CI/CDパイプラインへの組み込み

Codex CLIの最も得意な活用法です。

# GitHub Actions での使用例
- name: Codex でコードレビュー
  run: |
    codex --approval-policy never \
      "このPRの変更をレビューして、セキュリティ上の問題を報告して"

サンドボックス付きで完全自動化できるため、CI/CD環境への組み込みが安全です。

シーン2: 大規模コードベースの一括分析

# gpt-5.3-codexモデルで100万トークンを活用
codex
> /model gpt-5.3-codex

> このモノレポ全体を解析して、循環依存のあるモジュールを
> すべてリストアップして、解消の優先順位を提案して

シーン3: ターミナル作業の高度な自動化

> システムのログを解析して、過去24時間のエラーパターンを
> カテゴリ別に集計し、緊急度の高い問題から優先順位をつけてレポートを作成して

> 本番サーバーのデプロイ前チェックリストを実行して、
> 問題があれば詳細を報告して（実際のデプロイはしないこと）

Terminal-Bench 2.0スコア77.3%の実力が発揮される領域です。

シーン4: 夜間バッチ処理の自動化

# 夜間に安全な完全自動モードで実行（サンドボックスは有効）
codex --approval-policy never \
  "todayリリース候補のブランチをテストして、問題があればissueを作成して"

シーン5: 社内ツールへのカスタム組み込み

Apache-2.0ライセンスのため、社内ツールへの改造・組み込みが自由です。

# 独自のワークフローをAGENTS.mdで定義
# 社内のコーディング規約・セキュリティポリシーを強制適用
# 社内MCPサーバーと連携してDBや社内APIにアクセス

Amazon検索[本 Claude Code]

まとめ

Codex CLIは、2026年4月時点でClaude Code・Gemini CLIと並ぶ主要なターミナル型AIエージェントです。

主要なポイント：

✅ メリット

• ターミナル作業能力（Terminal-Bench）が業界最高水準（77.3%）
• サンドボックスによる安全な完全自動化が可能
• CI/CDパイプラインへの組み込みに最適な設計
• Apache-2.0オープンソースで社内カスタマイズが自由
• gpt-5.3-codexの100万トークンで大規模コードベースに対応
• Cerebras統合で1,000トークン/秒超の高速処理

⚠️ デメリット・注意点

• 完全無料枠はなし（APIキー or ChatGPT Plus必須）
• WindowsネイティブはWSL推奨
• 日本語コミュニティがまだ発展途上
• APIキー利用時は予算管理が必要

🎯 こんな方に特におすすめ

• CI/CDパイプラインにAIエージェントを安全に組み込みたい方
• シェル操作・ターミナル作業を高度に自動化したい方
• Apache-2.0ライセンスで社内ツールにカスタム組み込みしたい方
• gpt-5系モデルでターミナルエージェントを使いたい方

次のステップ：

まずは npm install -g @openai/codex でインストールして、簡単なファイル操作からお試しください。APIキーのコスト管理に注意しながら、日常的な開発タスクで効果を体感してみてください。

関連記事：

• Claude Code完全ガイド｜ターミナルで動くAIコーディングアシスタントの全貌

Claude Code完全ガイド｜ターミナルで動くAIコーディングアシスタントの全貌【2026年4月版】

はじめに「AIにコードを書かせたいけど、ブラウザとエディタを行き来するのが面倒…」そんな悩みを解決するのがClaude Codeです。2026年4月時点で、Anthropicが提供するターミナル型AIエージェントとして、開発者の間で急速に注...

caymezon.com

2026.02.14

• Gemini CLI完全ガイド｜ターミナルで動くGoogleのAIエージェントの全貌

Gemini CLI完全ガイド｜ターミナルで動くGoogleのAIエージェントの全貌【2026年4月最新】

はじめに「Claude CodeみたいなAIコーディングエージェントを試したいけど、費用を抑えたい…」「Googleが出しているターミナル版AIエージェントって何ができるの？」そんな疑問を持つエンジニアに向けて、Gemini CLIの全貌を...

caymezon.com

2026.02.21

• Claude Code vs Gemini CLI vs Codex CLI｜できること・できないことを徹底比較【2026年4月版】

Claude Code vs Gemini CLI vs Codex CLI｜できること・できないことを徹底比較【2026年4月版】

はじめに「ターミナル型AIエージェントが乱立していて、どれを選べばいいか分からない…」Claude Code（Anthropic）、Gemini CLI（Google）、Codex CLI（OpenAI）——三大AI企業がそれぞれターミナル...

caymezon.com

2026.03.28

タグ: #CodexCLI #Codex #OpenAI #AI #コーディング #開発効率化 #ターミナル #エージェント

The post OpenAI Codex CLI完全ガイド｜ターミナルで動くOpenAIのAIエージェントの全貌【2026年4月最新】 first appeared on CayTech Lab.

はじめに

「Claude Codeに興味があるけど、何から始めればいいかわからない」
「Claude Codeを使い始めたけど、もっと使いこなしたい」

この記事は、Claude Codeに関するすべての記事を体系的にまとめたロードマップです。初心者から上級者まで、今の自分のレベルに合った記事にすぐたどり着けます。

Amazon検索[本 Claude Code]

Claude Codeとは？3分でわかる概要

Claude Codeは、Anthropicが提供するターミナル（コマンドライン）から動くAIコーディングアシスタントです。

あなた（ターミナル）
    ↓ 自然言語で指示
Claude Code CLI
    ↓ API通信
Claude AI（Sonnet/Opus）
    ↓ コード生成・編集
ローカルファイルに直接反映

Claude Codeの革命的な点：コピペが不要

従来のAI活用（Web版）では、Claudeが生成したコードを自分でコピー＆ペーストする必要がありました。

【従来：Web版での開発フロー（約10ステップ）】
1. ブラウザでClaude.aiを開く
2. コード生成を依頼
3. 生成されたコードをコピー
4. エディタを開く
5. 貼り付ける
6. エラーが出たらブラウザに戻る
7. エラー内容を貼り付けて修正依頼
8. 修正コードをコピー
9. エディタに貼り付ける
10. ※エラーが続く限り繰り返し

【Claude Code（約3ステップ）】
1. ターミナルで指示するだけ
2. Claudeが直接ファイルを編集
3. 動作確認

実測データ：開発時間を53%短縮

同じコーディングタスクで比較した結果：

詳細な比較検証はこちら：

Claude Code vs Web版・Desktop版 開発効率徹底比較｜実際のマクロ開発で検証

はじめに「Claude Codeって本当に効率的なの？」そんな疑問を持つ開発者は多いはずです。実際、Web版やDesktop版と比べて、どれくらいのメリットがあるのかイメージしにくいかもしれません。本記事では、実際に「VSCodeでクリップ...

caymezon.com

2026.02.14

【学習ロードマップ】あなたのレベルはどこ？

レベル0: Claude Codeを知らない・使ったことがない
  → まず「全体像を把握する」へ

レベル1: 興味はあるけどまだセットアップしていない
  → 「環境構築」へ

レベル2: セットアップ済みだが基本操作しか知らない
  → 「コマンド習得」へ

レベル3: ターミナルで使っているがVSCodeも気になる
  → 「VSCode拡張機能」へ

レベル4: 一通り使えるが他ツールとの比較が気になる
  → 「他ツールとの比較」へ

STEP 1：全体像を把握する

Claude Codeとは何か、Web版・Desktop版と何が違うのか、メリット・デメリットを網羅的に解説した記事です。導入前に必ず読んでおきたい一記事。

Claude Code完全ガイド｜ターミナルで動くAIコーディングアシスタントの全貌

この記事で分かること：

✅ Claude CodeとWeb版・Desktop版・APIの違い
✅ 主要機能（ファイル編集・プロジェクト全体理解・複数ファイル同時編集）
✅ 日本語での使い方（CLAUDE.md設定）
✅ 使用量制限の仕組みと回避策
✅ Opus vs Sonnet モデル選択の最適解
✅ 実際の開発シーン別活用例
✅ セキュリティ・プライバシーの注意点

Claude Code完全ガイド｜ターミナルで動くAIコーディングアシスタントの全貌【2026年4月版】

はじめに「AIにコードを書かせたいけど、ブラウザとエディタを行き来するのが面倒…」そんな悩みを解決するのがClaude Codeです。2026年4月時点で、Anthropicが提供するターミナル型AIエージェントとして、開発者の間で急速に注...

caymezon.com

2026.02.14

特に重要なポイント：モデル選択

デフォルト: Sonnet 4.6（バランス型・推奨）
最高性能:  Opus 4.7（2026年4月16日リリース・3倍の視覚解像度・自己検証機能搭載）
軽量版:   Haiku 4.5（高速・低コスト）

→ 日常開発はSonnetで十分。Opusは複雑な設計時のみ使用が節約のコツ。
→ 2026年4月23日以降、Enterprise/API利用者のデフォルトはOpus 4.7に変更予定。

STEP 2：環境構築（セットアップ）

読んだ後は実際に手を動かしましょう。初心者でも30分で完了できます。

Claude Code環境構築完全ガイド｜初心者でも30分でセットアップできる詳細手順

この記事で分かること：

✅ 必要なもの・前提条件の確認
✅ Node.jsインストール手順（Windows/Mac/Linux対応）
✅ npm経由でのClaude Codeインストール
✅ 初回ログイン（OAuth認証）の手順
✅ CLAUDE.mdによる日本語設定
✅ 初回動作確認の方法
✅ よくあるエラーとトラブルシューティング

Claude Code環境構築完全ガイド｜初心者でも30分でセットアップできる詳細手順

はじめに「Claude Codeを使ってみたいけど、環境構築が難しそう…」そんな不安を持つ方も多いはずです。実際、ターミナルベースのツールは初心者にとってハードルが高く感じられます。しかし、この記事の手順通りに進めれば、初心者でも30分でC...

caymezon.com

2026.02.14

セットアップの流れ（概要）：

1. Node.js インストール（10分）
   ↓
2. npm install -g @anthropic-ai/claude-code（2分）
   ↓
3. claude コマンドで起動・ログイン（3分）
   ↓
4. CLAUDE.md で日本語設定（5分）
   ↓
5. 動作確認（5分）
   ↓
✅ セットアップ完了！

STEP 3：コマンドを習得する

セットアップが完了したら、効率を大幅に上げるコマンドを覚えましょう。

【2026年完全版】Claude Codeスラッシュコマンド徹底解説｜ターミナル版とVSCode拡張機能の違いも網羅

Claude Codeには40以上のスラッシュコマンドがあります。さらにカスタムコマンド（.claude/commands/に独自Markdownファイルを配置）も作成可能で、個人・チームで拡張できます。全コマンドを日本語で解説し、おすすめ度を★で評価した唯一の完全ガイド。

この記事で分かること：

✅ 全スラッシュコマンドの日本語解説（おすすめ度★〜★★★付き）
✅ ターミナル版のみのコマンド
✅ VSCode版のみの機能
✅ 両方で使えるコマンド
✅ おすすめコマンドTOP10
✅ 用途別・使い分けガイド
✅ カスタムコマンドの作り方

【2026年4月最新版】Claude Code全67コマンド以上徹底解説｜ターミナル版とVSCode拡張機能の違いも網羅

1️⃣ はじめに：Claude Codeコマンドの需要検索需要から見る関心度Claude Codeのコマンドに関する検索需要を調べたところ、以下のような結果が出ています：🔥 1,000～10,000件: claude code vscode...

caymezon.com

2026.02.15

特に覚えておきたいコマンドTOP5

STEP 4：VSCode拡張機能を活用する

ターミナル版だけでなく、VSCode拡張機能を組み合わせることで、さらに強力な開発環境を構築できます。

Claude Code VSCode拡張機能完全ガイド｜CLI版との違いと最強の使い分け術

この記事で分かること：

✅ VSCode拡張機能でできること・できないこと
✅ ターミナル版との機能差一覧表
✅ VSCode版限定機能（Attach file・Thinking・コスト表示）
✅ エディタ内でのシームレスなClaude Code活用法
✅ ターミナル版とVSCode版の最適な使い分け
✅ インストール・設定方法

Claude Code VSCode拡張機能完全ガイド｜CLI版との違いと最強の使い分け術

はじめに「Claude CodeってターミナルでCLIを使うものだと思ってた…」「VSCodeの拡張機能もあるって聞いたけど、何が違うの？」そんな疑問を持つ開発者は多いはずです。実は、Claude CodeにはVSCode拡張機能版があり、...

caymezon.com

2026.02.14

ターミナル版 vs VSCode版 使い分けガイド

STEP 5：他ツールと比較して理解を深める

Claude Codeを使い続けるか、他のツールと組み合わせるか。客観的なデータで判断しましょう。

Claude Code vs Web版・Desktop版：開発効率徹底比較

実際のマクロ開発で計測した実測データをもとに、3種類のClaude活用方法の効率を比較検証：

Claude Code vs Web版・Desktop版 開発効率徹底比較｜実際のマクロ開発で検証

はじめに「Claude Codeって本当に効率的なの？」そんな疑問を持つ開発者は多いはずです。実際、Web版やDesktop版と比べて、どれくらいのメリットがあるのかイメージしにくいかもしれません。本記事では、実際に「VSCodeでクリップ...

caymezon.com

2026.02.14

結論：Claude Codeは他の2倍速い

Claude Code: 8分（3ステップ）
Web版:      17分（7ステップ）
Desktop版:  14〜17分（5ステップ）

作業切替回数:
Claude Code → 0回（ターミナル内で完結）
Web版      → 4回（ブラウザ⇔エディタ）
Desktop版  → 2回

Claude Code vs Gemini CLI：どっちを使うべき？

GoogleのAIエージェント「Gemini CLI」との徹底比較。それぞれの強み・弱みを正直に比較：

Claude Code vs Gemini CLI｜できること・できないことを徹底比較【2026年4月版】

はじめに「Claude CodeとGemini CLI、どっちを使えばいいの？」どちらもターミナルからAIエージェントを操作して、ローカルファイルの編集・Git操作・テスト実行まで自律的にこなす強力なツールです。しかし設計思想・得意分野・コ...

caymezon.com

2026.02.21

一言比較：

【Gemini CLIが向いている場面】
✅ 大規模プロジェクト全体を一括把握（100万トークン）
✅ 無料で始めたい（1,000リクエスト/日無料）
✅ Google検索と連動した最新情報での実装

【Claude Codeが向いている場面】
✅ 複雑なバグを粘り強く自律デバッグしたい
✅ 洗練された高品質なコードを一発で生成したい
✅ Thinkingモードで深く考えて設計したい

プロの使い分け戦略（2026年版）：

大規模分析・プロトタイプ作成 → Gemini CLI
精密な実装・デバッグ・リファクタリング → Claude Code

CLAUDE.md：プロジェクト設定ファイルを活用しよう

Claude Codeを日本語で使い、プロジェクト固有のルールを守らせるにはCLAUDE.mdファイルが便利です。

## コミュニケーション
- すべてのやり取りは日本語で行うこと

## コーディング規約
- コードの右側にコメントを書くこと
  例: const x = 1; // 初期値を設定

## プロジェクト固有のルール
- npm scripts実行時は -- を使って引数を渡すこと

このファイルをプロジェクトルートに置くだけで、毎回設定する手間がなくなります。さらに~/.claude/CLAUDE.mdに置けばグローバル設定にもなります。

使用量を最大化するコツ

モデル設定（最重要）

# セッション中にSonnetに切り替え（節約推奨）
/model sonnet

# 複雑な設計・難解なバグのときだけOpus（2026年4月現在はOpus 4.7が最新）
/model opus

# 処理強度を変更（Opus利用時のトークン節約に有効）
/effort medium   # デフォルト（Max・TeamプランのOpusは2026年3月より medium がデフォルト）
/effort high     # より深く考えさせたい場合

Sonnet 4.6はOpus 4.xの5分の1のトークン消費で、日常的な開発なら品質の差はほぼありません。

効率的な使い方のルール

1. タスクごとに新しいセッションを開始する
   → 会話履歴の累積によるトークン増加を防ぐ

2. 指示はまとめて1回で送る
   → 往復回数を減らすだけで大幅節約

3. /plan で作業計画を立ててから実装
   → 手戻りを減らして効率UP

4. /compact で長くなった会話を圧縮
   → コンテキスト節約しながら流れを保持

よくある質問

Q: Claude Codeは無料で使えますか？

A: 個人プランの料金は以下のとおりです（2026年4月現在）：

Gemini CLIは無料枠（個人アカウントで1,000リクエスト/日）がありますが、Claude Codeにはありません。代わりに、コードの品質と自律デバッグ能力が評価されています。

Q: Windowsでも使えますか？

A: はい、Windows・Mac・Linux全て対応しています。セットアップ記事はWindows環境を中心に解説しています。

Q: GitHubとの連携はできますか？

A: はい、Gitコマンドのすべての操作をClaude Codeに依頼できます。「変更をコミットして」「PRを作成して」などの自然言語指示で動きます。

Q: VSCode以外のエディタでも使えますか？

A: ターミナル版はエディタに依存しないため、どのエディタでも使えます。VSCode拡張機能版はVSCode専用です。

Q: セキュリティは大丈夫ですか？

A: ソースコードがAPIを通じてAnthropicのサーバーに送信されます。機密情報を含むコードは.claudeignoreで除外設定が可能です。

今後追加予定のコンテンツ

Claude Codeのエコシステムは急速に進化しています。以下のトピックについても随時記事を追加予定です：

📌 追加予定記事
├─ Claude Code × GitHub Actions でCI/CDを自動化
├─ Claude Code エージェントモードの活用法
├─ CLAUDE.mdの書き方・最適化ガイド
├─ Claude Code でテスト駆動開発（TDD）を実践
├─ Claude Code × MCP連携（Desktop版との組み合わせ）
└─ チーム開発でのClaude Code活用ルール

この記事は新しい関連記事が公開されるたびに更新します。ブックマークしておくことをおすすめします。

全記事まとめ：Claude Code学習リスト

まとめ

Claude Codeは、導入すれば開発作業の時間を半分以下に削減できる強力なツールです。

今日から始める最短ルート：

1. 全体像を把握する（15分）
   → caymezon.com/claude-code-overview/

2. セットアップする（30分）
   → caymezon.com/claude-code-setup-guide/

3. よく使うコマンドを3つ覚える
   → caymezon.com/claude-code-commands-guide-2026/

4. VSCode拡張機能も入れてみる
   → caymezon.com/claude-code-vscode-extension-guide/

まずはSTEP1とSTEP2だけ完了させてください。実際に使い始めれば、その効率の差を体感できます。

Amazon検索[本 Claude Code]

関連記事

• Claude AI全製品の入門ガイド（どのClaudeを使うべきか）

【2026年版】Claude AI完全入門ガイド｜Web版・Desktop版・Claude Codeの違いと選び方を徹底解説

はじめに「Claudeを使ってみたいけど、Web版・Desktop版・Claude Codeって何が違うの？」Anthropicが提供するClaude AIには複数の製品があり、初めて触れる方はどれを使えばいいか迷うことが多いです。この記事...

caymezon.com

2026.03.21

• Claude Desktop完全攻略ロードマップ（MCP連携・GitHub活用）

【2026年版】Claude Desktop完全攻略ロードマップ｜MCP設定・GitHub連携・活用術を体系的に学ぶ

はじめに「Claude Desktopを導入したいけど、何からどの順番で学べばいいかわからない」この記事は、Claude Desktopをゼロから使いこなすまでの全ステップを体系的に整理したロードマップです。セットアップ・GitHub MC...

caymezon.com

2026.03.21

参考リンク

• Claude Code公式ドキュメント
• Claude公式サイト
• Anthropic公式GitHub

更新履歴

• 2026-03-21: 初版公開
• 2026-04-20: Opus 4.7リリース対応・料金プラン（Max 5x/20x）追加・コマンド数情報を更新

The post 【2026年版】Claude Code完全攻略ロードマップ｜セットアップからVSCode活用・コマンド習得まで全記事まとめ first appeared on CayTech Lab.

1️⃣ はじめに：Gemini CLIコマンドの真実

検索需要から見る関心度

Gemini CLIのコマンドに関する検索需要を分析したところ、以下のようなトレンドが見て取れます：

• 🔥 1,000～10,000件: gemini cli 使い方, gemini cli vscode
• 🔥 100～1,000件: gemini cli コマンド, gemini cli vs claude code
• 🔥 10～100件: gemini cli memory, gemini cli vscode 拡張 機能

Googleが提供する強力なAIエージェントであるGemini CLIですが、その豊富なコマンドを使いこなせているユーザーはまだ少数です。

意外と知られていない「スラッシュコマンド」

Gemini CLIは「自然言語で指示できる」ことが最大の魅力ですが、実は36個の強力なスラッシュコマンドが用意されています。しかも多くのコマンドにはサブコマンドがあり、単に「会話履歴を管理」とだけ表示されていても、実際には5つの操作が使えるケースもあります。

コマンドを正しく知ることで、「指示が伝わらない」「無駄にトークンを消費する」といったストレスから解放されます。

この記事で解決できること

この記事では、Gemini CLI（ターミナル版）の /help 実出力をもとに、全36コマンドとそのサブコマンドを完全網羅しました。キーボードショートカット12個も併せて収録しています。

• ✅ 全36コマンドを実機ベースでカテゴリ別に徹底解説
• ✅ サブコマンドの使い方・引数まで含めた実用的な解説
• ✅ おすすめ度を★で明示（★～★★★）
• ✅ キーボードショートカット11個もおすすめ度付きで網羅
• ✅ AIが自動で使う「ツール」と、人間が打つ「コマンド」の違いを明確化

Amazon検索[本 Gemini]

2️⃣ まず知っておきたい「Basics」

スラッシュコマンドの前に、Gemini CLIには日常的によく使う2つの特殊入力があります。

@ — ファイル・フォルダをコンテキストに追加

@src/myFile.ts    ← 特定ファイルを指定
@src/             ← フォルダ全体を指定

「このファイルを読んで修正して」と言いたいとき、ファイルパスの前に @ を付けるだけでGeminiがそのファイルを読み込みます。自然言語の質問と組み合わせて使います。

> @src/utils.ts のバグを探して
> @src/ フォルダ全体を分析して、未使用の関数を一覧にして

! — シェルコマンドを直接実行

!npm run start
!git status
!ls -la

!に続けてシェルコマンドを打つと、Geminiに頼まずOS上でそのままコマンドが実行されます。「このコマンドを実行して」と自然言語で頼む方法もありますが、!を使うと直接・即座に実行できます。

3️⃣ Gemini CLI 全34コマンド徹底解説

コマンドを4つのカテゴリに分類して解説します。サブコマンドがある場合は、コマンド行の下に展開して記載しています。

📊 カテゴリ1: セッション・対話管理 (11コマンド)

会話の流れをコントロールし、効率的に作業を進めるためのコマンド群です。

📊 カテゴリ2: プロジェクト・環境設定 (11コマンド)

AIがプロジェクトを正しく理解し、エディタ環境と同期するためのコマンド群です。

📊 カテゴリ3: 高度な拡張・システム連携 (4コマンド)

外部サービスとの連携、GitHub自動化、イベントフック処理などを扱うコマンド群です。

📊 カテゴリ4: システム情報・サポート (8コマンド)

認証、ドキュメント、バグ報告など、ツールの利用自体を支えるコマンド群です。

4️⃣ 「コマンド」と「ツール」の違いに注意！

Gemini CLIを使う上で非常に重要なポイントです。

• スラッシュコマンド (/で入力): 人間がAIの「状態」を操作するもの。（例：/clear で履歴消去、/init で設定作成）
• ツール (AIが自動実行): AIが「目的」を達成するために使う能力。（例：Google検索、ファイル読み書き、シェル実行）

AIに何かをさせたい時は、コマンドを打つのではなく**「〜を検索して」「〜を修正して」と自然言語で指示する**のが正しい使い方です。

5️⃣ おすすめコマンド TOP10

実戦で本当に役立つコマンドを厳選しました。

6️⃣ キーボードショートカット完全一覧

スラッシュコマンドと同様に重要なのがキーボードショートカットです。マウスを使わずに操作でき、作業効率に直結します。

特に知っておきたいショートカット

Ctrl+Y（YOLOモード）

ファイル編集やシェルコマンド実行のたびに「承認しますか？」と聞いてくるのが煩わしいとき、Ctrl+YでYOLOモードをオンにするとすべての操作が自動承認されます。Gitで元に戻せる状態にしてから使うのがお勧めです。

Shift+Tab（自動承認切替）

ファイル編集の承認モードを切り替えます。YOLOモードほど全部ではなく、編集操作だけ自動承認したいときに使います。

Ctrl+Enter（改行）

Gemini CLIではEnterで即送信されるため、複数行のプロンプトを書くにはCtrl+Enterで改行する必要があります。長い指示文を書くときに必須です。

7️⃣ ターミナル版(CLI)とVSCode版の使い分け

Amazon検索[本 Gemini]

8️⃣ まとめ

今回学んだこと

• ✅ Gemini CLIのスラッシュコマンドは全部で36個。多くのコマンドにサブコマンドがあり、実際の機能はさらに豊富。
• ✅ /chat はlist/save/resume/delete/shareの5サブコマンドを持つ強力な会話管理機能。
• ✅ /memory add でその場からルールを追加できるため、GEMINI.mdを逐一編集する手間が省ける。
• ✅ Ctrl+Y（YOLOモード）と Shift+Tab（自動承認切替）を使いこなすと、作業が大幅にスムーズになる。
• ✅ 会話が長くなったら /compress で整理するのがコツ。

まずはターミナルで /help を入力して、今のあなたのGemini CLIで何ができるか眺めてみることから始めてみましょう！

この記事が役に立ったら、ぜひシェアをお願いします！ 🚀

関連記事：

• Gemini CLI完全ガイド｜Googleが放つ最強のAIコーディングエージェントの全貌

Gemini CLI完全ガイド｜ターミナルで動くGoogleのAIエージェントの全貌【2026年4月最新】

はじめに「Claude CodeみたいなAIコーディングエージェントを試したいけど、費用を抑えたい…」「Googleが出しているターミナル版AIエージェントって何ができるの？」そんな疑問を持つエンジニアに向けて、Gemini CLIの全貌を...

caymezon.com

2026.02.21

• Gemini CLI環境構築完全ガイド｜初心者でも10分でセットアップできる手順解説

Gemini CLI完全使いこなしガイド｜基本操作からVSCode連携・ローカル活用術まで【2026年4月版】

はじめに「Gemini CLIをインストールしたけど、どう使えばいいのか分からない…」「ブラウザ版のGeminiとどう使い分ければいいの？」「ローカルで使うからこそできる、CLIならではの活用法って何？」本記事では、Gemini CLIをイ...

caymezon.com

2026.02.21

• Gemini CLI vs Claude Code徹底比較｜2026年最新のAIコーディングツール選び

Claude Code vs Gemini CLI｜できること・できないことを徹底比較【2026年4月版】

はじめに「Claude CodeとGemini CLI、どっちを使えばいいの？」どちらもターミナルからAIエージェントを操作して、ローカルファイルの編集・Git操作・テスト実行まで自律的にこなす強力なツールです。しかし設計思想・得意分野・コ...

caymezon.com

2026.02.21

The post 【2026年4月版】Gemini CLI全36コマンド＋キーボードショートカット完全リファレンス｜サブコマンド・おすすめ度付き first appeared on CayTech Lab.

はじめに

「Claude CodeとGemini CLI、どっちを使えばいいの？」

どちらもターミナルからAIエージェントを操作して、ローカルファイルの編集・Git操作・テスト実行まで自律的にこなす強力なツールです。しかし設計思想・得意分野・コストが大きく異なります。

本記事では2026年4月時点の最新情報をもとに、両者を徹底的に比較します。「どちらを選ぶべきか」の判断材料として、ぜひ参考にしてください。

Amazon検索[本 Claude Code]

Amazon検索[本 Gemini]

基本スペック比較

まずは数値で比べます。

料金の詳細

Claude Code:

Proプラン: $20/月（5時間ごとに約10〜40プロンプト制限）
Max 5x:   $100/月（5倍の使用量）
Max 20x:  $200/月（20倍の使用量）
※ Web版・Desktop版・Claude Codeで使用量を共有

Gemini CLI:

無料枠:   0円（Googleアカウントのみ）
          └→ 60リクエスト/分、1,000リクエスト/日
          └→ デフォルト: Gemini 2.5 Flash
API利用:  従量課金（Google AI Studio経由）
          └→ Gemini 3 Flash: Proの約1/4以下のコスト（プレビュー有効化で利用可）

Claude Codeにできて、Gemini CLIにできないこと

1. 高い自律性と粘り強いデバッグ

Claude Codeの最大の強みは**「テストを回す→エラーが出る→自分で修正する→またテストする」** というループの粘り強さです。

Claude Codeのデバッグループ:
1. エラーを検知
2. 原因を深く推論（Thinkingモード）
3. 修正案を実装
4. テストを再実行
5. 成功するまで繰り返す（ほとんど手動介入不要）

実際のベンチマーク比較（あるコーディングタスク）：

Claude Code: 1h17m で完了、コスト $4.80（全自動）
Gemini CLI: より長い時間、コスト $7.06（途中で手動介入が必要なケースも）

Gemini CLIの課題: 修正を繰り返すと稀に同じ間違いをループしたり、指示を無視して大幅な書き換え（オーバーライト）をしてしまうことがあります。

2. 洗練されたコードの品質

Claudeは「コーディングの職人気質」が評価されており、生成されるコードが非常に洗練されています。

Claude Code: 簡潔で読みやすいコード
             冗長な記述を避ける傾向
             命名規則やスタイルに一貫性がある

Gemini CLI:  実用的だが、時に冗長なボイラープレートを出力
             動くけど少し雑なコードになることも

3. 深い思考（Thinkingモード）による自己修正

Claude Codeは、コードを書く前に**「なぜその設計にするのか」を深く自問自答**します。

Claudeの思考プロセス:
1. 要件の本質を理解
2. 複数の実装パターンを検討
3. トレードオフを評価
4. 最適解を選択してから実装

→ 結果: 一発で動くコードを書く確率が高い

4. ネイティブ音声モード（2026年3月〜）

2026年3月のアップデートで、Claude Codeに音声入力モードが追加されました。

/voice コマンドでプッシュトゥトーク方式の音声入力が可能
→ ターミナルでの長い指示も音声で素早く入力できる
→ ハンズフリーでのコーディングが可能に

Gemini CLIでは現時点でネイティブ音声モードは未搭載です。

5. 使用量の明確な制限（管理しやすさ）

皮肉なことに、制限が厳しいことは「管理しやすい」という側面もあります。「何回使ったか」が明確です。

Gemini CLIにできて、Claude Codeにできないこと

1. 超大規模プロジェクトの「一括」把握

これがGemini CLIの最大のアドバンテージです。

Gemini CLIのコンテキスト: 最大100万トークン
  └→ 数万行のコードベースを丸ごと読み込める
  └→ ファイル間の依存関係や矛盾を一括検出可能

Claude Code: 約20万トークン
  └→ 大規模プロジェクトでは記憶を圧縮（Compaction）
  └→ 圧縮により細部の記憶が抜け落ちることがある

実際の活用例:

# 数万行のコードベースを丸ごと分析
> このプロジェクト全体を俯瞰して、
> アーキテクチャ上の矛盾点と将来の拡張に向けた改善提案を教えて

Claude Codeでは「コンテキストが長くなりすぎた」と言われるタスクでも、Gemini CLIなら余裕で処理できます。

2. Google検索とのリアルタイム統合

# 昨日リリースされたライブラリの最新仕様を調べながらコードを書く
> /search React 19 useOptimistic の使い方

# 最新のAWSサービスを使った実装
> 最新のLambda関数URLの仕様を確認して、このコードに組み込んで

Claude Codeの限界: 学習データに基づいた推論がメインで、知識カットオフ以降の最新情報には対応していません。

3. 完全無料で始められる

Gemini CLI:
✅ Googleアカウントだけで今日から無料でスタート
✅ 1,000リクエスト/日で日常的な開発には十分

Claude Code:
❌ 別途サブスクリプション（最低$20/月）が必要

ちょっと試してみたい、という方には圧倒的にGemini CLIが有利です。

4. マルチモーダル（動画・音声）の優位性

Gemini CLI（Geminiモデル）:
✅ 動画ファイルを渡してバグを修正させることが可能
✅ 画像・音声・PDFなど多様なメディアに対応

Claude Code（Claudeモデル）:
△ スクリーンショット（画像）の解析は得意
❌ 動画ファイルのネイティブ解析はGeminiが先行

5. 「スキル（Skills）」機能の比較

両ツールともスキル機能を持っていますが、設計思想が異なります。

Gemini CLIのスキル:

- 定型的なワークフローや複雑な手順を「スキル」として定義・共有できる
- タスクに適合するスキルをGemini CLIが自動検出して起動
- チーム全体での開発標準化が容易になる

管理コマンド:
/skills list    → 利用可能なスキルを一覧表示
/skills enable  → スキルを有効化
/skills disable → スキルを無効化

スキルの構成:
SKILL.md（必須） + scripts/ + references/ + assets/
→ 組み込みのskill-creatorで新規スキル作成もサポート

Claude Codeのスキル（v2.1.3以降）:

- .claude/skills/{name}/SKILL.md を作成するだけで /name として呼び出せる
- frontmatterで allowed-tools や user-invocable を細かく制御できる
- プロジェクト単位（.claude/skills/）またはグローバル（~/.claude/skills/）で管理
- 旧来の .claude/commands/{name}.md 形式（カスタムスラッシュコマンド）も引き続き利用可能

→ スキル内で $ARGUMENTS を使って引数を受け取ることができる
→ Claudeが認識して適切なタイミングで自動起動することも可能

主な違い:

• Gemini CLIは自動検出・外部共有に強み。チームのスキルリポジトリとの連携が得意
• Claude Codeはシンプルなファイル配置で導入でき、許可ツールの細かい制御が可能

▶ Claude Code Skillsについてもっと詳しく：

• Claude Skills完全ガイド｜とは・使い方・SKILL.mdの作り方まで初心者向けに徹底解説【2026年最新】

Claude Skills完全ガイド｜とは・使い方・SKILL.mdの作り方まで初心者向けに徹底解説【2026年最新】

はじめにClaudeを使っていて、こんな場面に心当たりはありませんか？「毎回同じ長い指示をコピペしている」「いつものやり方をClaudeに覚えさせたい」「チームで同じワークフローを共有したい」そのすべてを解決するのが、Claude Skil...

caymezon.com

2026.03.22

• Claude Skillsはこんな時に使う！活用シーン別ガイド7パターン例【初心者向け・2026年最新】

Claude Skillsはこんな時に使う！活用シーン別ガイド7パターン例【初心者向け・2026年最新】

はじめにClaude Skillsという機能、名前は聞いたことがあるけれど「自分には関係ない」と感じていませんか？実はSkillsは、「Claudeをよく使う人ほど恩恵が大きい機能」 です。でも「どんな時に使えばいいの？」というのが一番わか...

caymezon.com

2026.03.22

6. オープンソースによる拡張性

Gemini CLIはGitHubでソースコードが公開されています。

オープンソースのメリット:
- ソースコードを確認できる（透明性）
- コミュニティによる拡張・改善
- カスタマイズの自由度が高い
- ベンダーロックインのリスクが低い

7. コスト効率（大規模タスク）

Gemini 3 Flash:
- SWE-bench Verified スコア: 78%（Gemini 3 Proを上回る）
- コスト: Gemini 3 Proの1/4以下
- → 品質を保ちながら大量処理できる

Claude Code (Sonnet):
- 高品質だがFlashと比べるとコスト高め

CLAUDE.md vs GEMINI.md：プロジェクト設定ファイルの違い

両ツールともに、プロジェクトのルールを記述したMarkdownファイルを自動読み込みします。

共通点

• プロジェクトルートに配置すると自動で読み込まれる
• 階層的な設定が可能（グローバル・プロジェクト・サブフォルダ）
• Markdown形式で記述
• 起動のたびに自動適用される

配置パスの比較

書き方の違い

CLAUDE.md（Claude Code）の例:

# Claude Code プロジェクトルール

## コミュニケーション
- すべてのやり取りは日本語で行うこと

## コーディング規約
- コードの右側にコメントを書くこと
  例: `const x = 1; // 値を初期化`

## プロジェクト固有のルール
- npm scripts 実行時は --  を使って引数を渡すこと

GEMINI.md（Gemini CLI）の例:

# プロジェクト概要
このプロジェクトは Next.js + TypeScript で構築したブログシステムです。

# コーディングルール
- すべてのやり取りは日本語で行うこと
- コメントはコードの右側に記述すること
- TypeScript の strict モードを厳守すること

# 開発コマンド
- ビルド: npm run build
- テスト: npm test

書き方のポイント:

• 両者ともに自由に記述できますが、Gemini.mdは「開発コマンド」の記述が効果的です（GeminiはCLIコマンドを自律実行するため、正確なコマンドを覚えさせておくと精度が上がります）
• CLAUDE.mdは制約・スタイルガイドの記述が効果的です（Claudeは指示への忠実さが高いため）

設定の確認コマンド

Gemini CLIにしかない設定の階層管理

Gemini CLIは /memory show コマンドで「現在どのGEMINI.mdが読み込まれているか」を表示できるため、設定が意図通り適用されているかを随時確認できます。

UI・操作感の違い

Claude Code

• ステップを細かく逐次表示 する（「ファイルAを読み込みました」「ファイルBを編集しました」など、各アクションを個別に報告）
• ツリー形式でアクションを表示
• 変更内容の差分表示が明確

Gemini CLI

• 複数のアクションをまとめてボックスで表示（「3つのファイルを確認して修正しました」のようにサマリー形式）
• 「Plan Mode」で作業前に確認ステップを挟める（v0.29.0〜、v0.30.0以降はデフォルト有効化）
• Verboseモードへの切り替えで、Claude Codeのような逐次ログ表示も可能に
• v0.30.0以降、Plan Modeに「外部エディタでプランを開く・編集」機能も追加

好みによる選び分け

「何をやっているか全部見たい」派 → Claude Code
「結果だけ教えてくれればいい」派 → Gemini CLI

実際の使い分け戦略

ケース別おすすめ

プロの使い分け（両方使う）

Gemini CLI を使う場面:
✅ ブログ記事100本を一度にスキャンしてSEO課題を見つける
✅ 新しいフレームワークで「まず動くもの」を速攻で作る
✅ コードベース全体の依存関係を把握する
✅ チーム共通のスキル（Skills）を定義・共有してワークフローを標準化する
✅ Plan Modeで実行前に全工程を確認・承認してから安全に作業する

Claude Code を使う場面:
✅ 複雑なロジックをバグなしで一発で実装したい
✅ Geminiが書いた「動くけど汚いコード」を清書する
✅ 特定のバグを粘り強くデバッグしたい
✅ 音声入力で手をふさがずにコーディング指示を出したい
✅ プロジェクト固有のスキル（Skills）で定型ワークフローを自動化したい

「全体像を把握させるのはGemini、一か所のバグを徹底的に詰めさせるのはClaude」 という分担が、2026年現在の賢い戦い方です。

機能比較まとめ表

▶ IDE統合について： Claude CodeのVSCode拡張機能は、CLI版と異なる特徴を持っています。

• Claude Code VSCode拡張機能完全ガイド｜CLI版との違いと最強の使い分け術

Claude Code VSCode拡張機能完全ガイド｜CLI版との違いと最強の使い分け術

はじめに「Claude CodeってターミナルでCLIを使うものだと思ってた…」「VSCodeの拡張機能もあるって聞いたけど、何が違うの？」そんな疑問を持つ開発者は多いはずです。実は、Claude CodeにはVSCode拡張機能版があり、...

caymezon.com

2026.02.14

Amazon検索[本 Claude Code]

Amazon検索[本 Gemini]

まとめ

Claude CodeとGemini CLIは、互いの弱点を補い合える関係にあります。

Gemini CLIが向いている方:

• まず無料でAIエージェントを試したい
• 大規模なコードベース全体をAIに把握させたい
• Google検索と連携した最新情報を使いたい
• コストを抑えながら多量の処理をこなしたい

Claude Codeが向いている方:

• コードの品質を最優先にしたい
• 複雑なバグを自律的に修正させたい
• 高い精度で一発で動くコードを書かせたい

両方使いたい方:

• 大規模分析・プロトタイプ作成 → Gemini CLI
• 精密な実装・リファクタリング → Claude Code

この2ツールを使い分けることで、AIエージェントの恩恵を最大限に享受できます。まずはGemini CLIの無料枠から試してみて、必要に応じてClaude Codeを組み合わせる、というアプローチがコスト面でも最も賢い選択です。

関連記事：

• Gemini CLI完全ガイド｜ターミナルで動くGoogleのAIエージェントの全貌【2026年3月最新】

Gemini CLI完全ガイド｜ターミナルで動くGoogleのAIエージェントの全貌【2026年4月最新】

はじめに「Claude CodeみたいなAIコーディングエージェントを試したいけど、費用を抑えたい…」「Googleが出しているターミナル版AIエージェントって何ができるの？」そんな疑問を持つエンジニアに向けて、Gemini CLIの全貌を...

caymezon.com

2026.02.21

• Gemini CLI完全使いこなしガイド｜基本操作からVSCode連携・ローカル活用術まで【2026年4月版】

Gemini CLI完全使いこなしガイド｜基本操作からVSCode連携・ローカル活用術まで【2026年4月版】

はじめに「Gemini CLIをインストールしたけど、どう使えばいいのか分からない…」「ブラウザ版のGeminiとどう使い分ければいいの？」「ローカルで使うからこそできる、CLIならではの活用法って何？」本記事では、Gemini CLIをイ...

caymezon.com

2026.02.21

• 【2026年4月版】Gemini CLI全36コマンド＋キーボードショートカット完全リファレンス｜サブコマンド・おすすめ度付き

【2026年4月版】Gemini CLI全36コマンド＋キーボードショートカット完全リファレンス｜サブコマンド・おすすめ度付き

1️⃣ はじめに：Gemini CLIコマンドの真実検索需要から見る関心度Gemini CLIのコマンドに関する検索需要を分析したところ、以下のようなトレンドが見て取れます：🔥 1,000～10,000件: gemini cli 使い方, ...

caymezon.com

2026.02.21

• Claude Code完全ガイド｜ターミナルで動くAIコーディングアシスタントの全貌【2026年3月版】

Claude Code完全ガイド｜ターミナルで動くAIコーディングアシスタントの全貌【2026年4月版】

はじめに「AIにコードを書かせたいけど、ブラウザとエディタを行き来するのが面倒…」そんな悩みを解決するのがClaude Codeです。2026年4月時点で、Anthropicが提供するターミナル型AIエージェントとして、開発者の間で急速に注...

caymezon.com

2026.02.14

• Claude Code環境構築完全ガイド｜初心者でも30分でセットアップできる詳細手順

Claude Code環境構築完全ガイド｜初心者でも30分でセットアップできる詳細手順

はじめに「Claude Codeを使ってみたいけど、環境構築が難しそう…」そんな不安を持つ方も多いはずです。実際、ターミナルベースのツールは初心者にとってハードルが高く感じられます。しかし、この記事の手順通りに進めれば、初心者でも30分でC...

caymezon.com

2026.02.14

• 【2026年4月最新版】Claude Code全67コマンド以上徹底解説｜ターミナル版とVSCode拡張機能の違いも網羅

【2026年4月最新版】Claude Code全67コマンド以上徹底解説｜ターミナル版とVSCode拡張機能の違いも網羅

1️⃣ はじめに：Claude Codeコマンドの需要検索需要から見る関心度Claude Codeのコマンドに関する検索需要を調べたところ、以下のような結果が出ています：🔥 1,000～10,000件: claude code vscode...

caymezon.com

2026.02.15

• Claude Code vs Gemini CLI vs Codex CLI｜できること・できないことを徹底比較【2026年3月版】

Claude Code vs Gemini CLI vs Codex CLI｜できること・できないことを徹底比較【2026年4月版】

はじめに「ターミナル型AIエージェントが乱立していて、どれを選べばいいか分からない…」Claude Code（Anthropic）、Gemini CLI（Google）、Codex CLI（OpenAI）——三大AI企業がそれぞれターミナル...

caymezon.com

2026.03.28

• 【まとめ記事】Claude Code完全攻略ロードマップ｜全記事まとめ

【2026年版】Claude Code完全攻略ロードマップ｜セットアップからVSCode活用・コマンド習得まで全記事まとめ

はじめに「Claude Codeに興味があるけど、何から始めればいいかわからない」「Claude Codeを使い始めたけど、もっと使いこなしたい」この記事は、Claude Codeに関するすべての記事を体系的にまとめたロードマップです。初心...

caymezon.com

2026.03.21

タグ: #GeminiCLI #ClaudeCode #AI比較 #Gemini #Claude #ターミナル #開発効率化

The post Claude Code vs Gemini CLI｜できること・できないことを徹底比較【2026年4月版】 first appeared on CayTech Lab.

はじめに

「Claude CodeみたいなAIコーディングエージェントを試したいけど、費用を抑えたい…」

「Googleが出しているターミナル版AIエージェントって何ができるの？」

そんな疑問を持つエンジニアに向けて、Gemini CLIの全貌を徹底解説します。

Googleが2025年後半に正式リリースしたGemini CLIは、2026年4月時点でバージョンv0.39.0に達し、単なる対話ツールからエージェント型ツールへと大きく進化しました。

本記事では、2026年4月時点の最新情報をもとに、Gemini CLIの全体像から実践的な活用方法まで徹底解説します。

Amazon検索[本 Gemini]

この記事で分かること

• Gemini CLIとは何か（ブラウザ版との違い）
• できること・主な機能
• メリット・デメリットの詳細分析
• 特にオススメの機能（Plan Mode、MCP連携など）
• 料金体系と無料枠の活用法
• インストール手順（Windows/Mac/Linux対応）
• GEMINI.mdによるプロジェクト設定

こんな人におすすめ

• AIコーディングエージェントに興味がある開発者
• Claude Codeを試したいが費用を抑えたい人
• ターミナルベースの開発環境を好む人
• 大規模なコードベースをAIに分析させたい人
• Googleのエコシステムを使い倒したい人

Gemini CLIとは

基本概念

Gemini CLIは、Googleが開発・オープンソース公開しているコマンドライン型のAIエージェントです。

■ターミナルネイティブ
└→ コマンドラインから直接Geminiとやり取り
└→ エディタとシームレスに統合

■ローカルファイルアクセス
└→ プロジェクトファイルを直接読み書き
└→ ディレクトリ全体を丸ごと解析

■エージェント機能
└→ ファイル編集・シェル実行・Git操作を自律実行
└→ 複数ステップのタスクを自動的に処理

GitHubリポジトリも公開されており、誰でもソースコードを確認・貢献できます：https://github.com/google-gemini/gemini-cli

ブラウザ版（Gemini Apps）との違い

ブラウザ版は「サンドボックス（砂場）」と呼ばれる隔離された環境にいますが、CLI版はあなたの許可を得て**「PCの住人」**として振る舞えます。

2026年4月時点の最新バージョン

Gemini CLIでできること

1. ファイル操作（作成・編集・削除）

ローカルファイルを直接操作できます。

# Gemini CLIを起動
gemini

# 指示例（プロンプトで入力）
> main.py のバグを修正して保存して

> 新しいファイル utils.js を作成して、日付フォーマット関数を実装して

> src/ フォルダ内の全 .ts ファイルに TypeScript strict モードを追加して

2. コードの理解と分析

プロジェクト全体を一括で読み込み、深い分析が可能です。

> このプロジェクト全体のアーキテクチャを分析して、セキュリティ上の問題点を指摘して

> @src/components/ フォルダの全コンポーネントを確認して、重複している処理をリストアップして

100万トークンのコンテキストウィンドウにより、数万行のコードベースを丸ごと保持したまま会話できます。

3. シェルコマンドの実行

> テストを実行して、失敗したケースがあれば原因を分析して修正して

> npm run build してエラーがあれば解決して

> git log を確認して、今週のコミット内容をまとめて

4. Git操作の自動化

> 今の変更を feature/fix-bug ブランチにコミットしてプッシュして

> git の差分を確認して、適切なコミットメッセージを作成してコミットまで完了させて

5. Google検索との連携

# /search コマンドで最新情報を検索しながらコードを生成
> /search React 19の新機能を調べて、このコンポーネントをアップグレードして

ブラウザ版Geminiと同様に、最新のライブラリ仕様や技術情報をリアルタイムに検索しながら回答してくれます。

6. ブログ記事・ドキュメントの作成と更新

> vba-color.md という新規ファイルを作って、「VBA 色 一覧」をテーマに記事を書いて

> content/ フォルダ内の全記事をスキャンして、SEO上の問題点をリストアップして

> この記事の冒頭に「この記事のポイント」を3点追記して上書き保存して

主要機能の詳細

Plan Mode（プランモード）【v0.30.0〜デフォルト有効 特にオススメ】

v0.30.0からデフォルトで有効になり、実装前に必ず設計フェーズを経るようになりました。

> /plan

# Geminiが実装前に以下を確認してくれる
# ✓ 変更の影響範囲を整理
# ✓ 実装ステップを列挙
# ✓ リスクや注意点を提示
# ユーザーが承認してから実際の作業を開始

いきなりファイルを書き換えるのではなく、「何をするか」を先に確認してから実行できるため、安心して使えます。v0.30.0以降は「外部エディタでプランを開いて編集」機能も追加されました。

承認モード（Approval Mode）【安全のために重要】

# デフォルト（手動承認）: ファイル書き換えやコマンド実行のたびに確認を求める
gemini  # 通常起動（手動承認）

# 全自動モード: すべてGeminiに任せる（Git管理下で使うこと）
gemini --approval=yolo

# ファイル編集は自動、シェルコマンドは確認
gemini --approval=auto_edit

最初は手動承認モード（デフォルト）で使うことを強く推奨します。

GEMINI.md（プロジェクト設定ファイル）【Claude CodeのCLAUDE.mdに相当】

Claude Codeの CLAUDE.md と同様に、プロジェクトごとのルールを記述したファイルを自動読み込みします。

# プロジェクト概要
このプロジェクトはWordPressブログ（例: mysite.com）の記事管理システムです。

# コーディング・執筆ルール
- すべてのやり取りは日本語で行うこと
- IT系の回答時はコメントをコードの右側に記述すること
- 記事はMarkdown形式で posts/ フォルダ内に保存すること

# 開発コマンド
- ビルド: npm run build
- 記事の公開: git push origin main

MCP（Model Context Protocol）連携【拡張性が魅力】

MCP対応により、外部ツールとの連携を自由に追加できます。

// .gemini/settings.json でMCPサーバーを設定
{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"]
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"]
    }
  }
}

設定すると、GitHubのIssueを読み書きしたり、PostgreSQLデータベースの中身を見に行かせたりと、外部ツールとの連携を自在に増やせます。

カスタムスラッシュコマンド

よく使うプロンプトを定義しておくことができます。

# .gemini/commands/blog-create.toml
name = "blog-create"
description = "ブログ記事の新規作成"
prompt = """
Markdownファイルを新規作成して、SEOを意識した構成で記事を書いてください。
"""

# 使用時
> /blog-create

Agent Skills（エージェントスキル）

v0.23.0から実装された機能で、独自のエージェントスキルを定義し、複雑なタスクを自動化できます。

トークン消費量の把握

ブラウザ版では「Googleのさじ加減」でわかりにくかったトークン消費量が、CLIではAPIレスポンスの usage フィールドから数値で確認できます。

使用モデル

コンテキストウィンドウ: 最大100万トークン（Claude Codeの約5倍）

インテリジェント自動ルーティング機能により、複雑なタスクは自動的にProモデル、単純なタスクはFlashモデルに振り分けてくれます。

料金体系

無料枠（個人Googleアカウント）

Claude CodeやChatGPTと異なり、個人Googleアカウントで無料から始められるのが最大の強みです。

注意点：無料枠でのデータ利用

⚠️ 無料枠の場合
└→ 入力データがモデル改善に使用される可能性あり
└→ 機密情報・個人情報の入力は避けること

✅ 有料（API課金）の場合
└→ データは学習に使われない
└→ Google AI Studio でトークン消費量をリアルタイム確認可能

Google AI Studioでの利用（APIキー方式）

より詳細な管理が必要な場合や、業務利用にはGoogle AI Studio経由でのAPIキー取得を推奨します。使用量のグラフをリアルタイムで確認でき、予算管理も可能です。

インストール手順

前提条件

• Node.js 18以上（LTS版推奨）
• Googleアカウント

Step 1: Node.jsのインストール確認

# バージョン確認
node -v
# v20.x.x 以上が表示されればOK

バージョンが表示されない場合は、Node.js公式サイトからLTS版をインストールしてください。

Step 2: Gemini CLIのインストール

npm install -g @google/gemini-cli

Step 3: 初回起動と認証

# 起動
gemini

初回起動時は：

1. テーマ選択（デフォルトでOK）
2. ブラウザが自動で開く
3. Googleアカウントでログイン
4. プロンプト画面が表示される

Step 4: 動作確認

> このディレクトリの構造を教えて

これだけで準備完了です。

APIキーを使った起動（上級者向け）

無料枠ではなくAPIキーを使う場合：

# Google AI Studio でAPIキーを取得後
# Windows (PowerShell)
[System.Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "あなたのAPIキー", "User")

# Mac / Linux
echo 'export GEMINI_API_KEY="あなたのAPIキー"' >> ~/.zshrc
source ~/.zshrc

メリット

1. 完全無料から始められる

Googleアカウントがあれば、今日から0円でスタートできます。Claude Codeには別途サブスクリプション（$20/月〜）が必要なのと対照的です。

2. 圧倒的なコンテキストウィンドウ（100万トークン）

数万行のコードベース全体を丸ごと読み込んだまま、プロジェクト横断的な分析や修正が可能です。ブラウザ版Geminiの最大200万トークン（AI Ultraプラン）には及びませんが、競合ツールと比べれば依然として最大級です。

3. Google検索との統合

昨日リリースされたライブラリの仕様や最新のエラー解決策を、リアルタイムで検索しながらコードを書けます。

4. オープンソース

GitHubでソースコードが公開されており、カスタマイズや拡張が容易です。

5. マルチモーダル対応

画像・動画・音声ファイルも入力として扱えるため、「アプリの動作画面の動画を見てバグを修正して」といった指示も可能です（現時点ではCLI経由での動画解析には制限あり）。

デメリット・注意点

1. ターミナル操作が必須

GUIに慣れている方には学習コストがあります。

基本操作の習得: 1〜2時間
日常的な使いこなし: 1週間程度

2. 自律性がやや低い（Claude Code比較）

実際のベンチマーク比較では、Claude Codeが全自動で完了したタスクに対して、Gemini CLIは途中で手動介入が必要なケースもあります。

あるタスクの比較例:
- Claude Code: 1h17m完了、コスト$4.80（全自動）
- Gemini CLI: より長い時間、コスト$7.06（手動介入込み）

3. コードの質が若干荒い

冗長なボイラープレート（定型コード）を多く出力する傾向があります。Claude Codeの方が「洗練されたコード」という評価が多いです。

4. ブラウザ版のチャット履歴は参照不可

Gemini CLI（CLI/API経由）は、ブラウザ版Geminiのチャット履歴とデータが分離されているため、過去のブラウザ版のやり取りをそのまま引き継ぐことはできません。

5. 無料枠での機密情報の扱い

無料枠では入力データがモデル改善に使用される可能性があるため、業務での機密コードを扱う場合は有料プランか、オンプレミスでの利用を検討してください。

実践的な活用シーン

シーン1: 大規模コードベースの分析

# プロジェクトルートで起動
gemini

> このプロジェクト全体を分析して、セキュリティ上の問題点と改善提案を教えて

100万トークンの恩恵で、他のツールでは「ファイルが大きすぎて読めない」となるケースでも、プロジェクト全体を把握したまま回答してくれます。

シーン2: ログ解析の自動化

# 他のコマンドの結果をGeminiに流し込む（パイプ）
grep "ERROR" system.log | gemini "このエラーの原因と対策を教えて"

数ギガバイトのログファイルから特定のキーワードを抽出し、その結果をGeminiに解析させる、といったパイプライン処理が可能です。

シーン3: ブログ記事の一括処理

> content/ フォルダ内の全記事をスキャンして、
> 古いリンク先を新しいURL（newsite.com/...）に一括置換して保存して

数十〜数百のファイルを高速でスキャンし、一気に書き換えます。ブラウザ版では絶対に不可能な作業です。

シーン4: 開発環境の自動構築

> このプロジェクトを動かすために必要なパッケージをチェックして、
> 入っていなければインストールコマンドを実行して

Amazon検索[本 Gemini]

まとめ

Gemini CLIは、2026年4月時点で最も注目すべきAIコーディングエージェントの一つです。

主要なポイント：

✅ メリット

• 完全無料から始められる（個人Googleアカウントのみ）
• 100万トークンという圧倒的なコンテキストウィンドウ
• Google検索とのリアルタイム統合
• オープンソースで拡張性が高い
• Plan Mode（v0.30.0〜デフォルト有効）、MCP連携など機能が充実
• Gemini 2.5 Flash が SWE-bench Verified で78%という高精度（無料枠で利用可）

⚠️ デメリット・注意点

• ターミナル操作が必須
• Claude Code比で自律性がやや低い
• 無料枠では機密データに注意
• ブラウザ版とのチャット履歴は分離

🎯 こんな方に特におすすめ

• まずコスト0でAIエージェントを試してみたい方
• 大規模なプロジェクト全体をAIに把握させたい方
• Google検索と連携した最新情報を活かしたい方

次のステップ：

まずは npm install -g @google/gemini-cli でインストールして、簡単なファイル操作からお試しください。無料枠の1,000リクエスト/日があれば、日常的な開発作業には十分です。

より詳しい使い方は、以下の記事で解説しています：

• Gemini CLI完全使いこなしガイド｜基本操作からVSCode連携・ローカル活用術まで

Gemini CLI完全使いこなしガイド｜基本操作からVSCode連携・ローカル活用術まで【2026年4月版】

はじめに「Gemini CLIをインストールしたけど、どう使えばいいのか分からない…」「ブラウザ版のGeminiとどう使い分ければいいの？」「ローカルで使うからこそできる、CLIならではの活用法って何？」本記事では、Gemini CLIをイ...

caymezon.com

2026.02.21

• Claude Code vs Gemini CLI｜できること・できないことを徹底比較【2026年4月版】

Claude Code vs Gemini CLI｜できること・できないことを徹底比較【2026年4月版】

はじめに「Claude CodeとGemini CLI、どっちを使えばいいの？」どちらもターミナルからAIエージェントを操作して、ローカルファイルの編集・Git操作・テスト実行まで自律的にこなす強力なツールです。しかし設計思想・得意分野・コ...

caymezon.com

2026.02.21

タグ: #GeminiCLI #Gemini #Google #AI #コーディング #開発効率化 #ターミナル

The post Gemini CLI完全ガイド｜ターミナルで動くGoogleのAIエージェントの全貌【2026年4月最新】 first appeared on CayTech Lab.

はじめに

「Gemini CLIをインストールしたけど、どう使えばいいのか分からない…」

「ブラウザ版のGeminiとどう使い分ければいいの？」

「ローカルで使うからこそできる、CLIならではの活用法って何？」

本記事では、Gemini CLIをインストール後に迷わず使いこなせるよう、基本操作から応用テクニック、VSCode連携、ローカル環境だからこそできること、個人利用での注意点まで、体系的に解説します。

Amazon検索[本 Gemini]

基本的な使い方

起動とインタラクティブモード

インストール後、以下のコマンドで起動します。

gemini

起動すると対話型のプロンプトが表示されます。ここに自然言語（日本語でOK）で指示を入力します。

> こんにちは。このディレクトリに何がありますか？

> src/main.py を読んで、どんな処理をしているか教えて

ワンショットモード（単発コマンド）

対話モードに入らず、コマンドラインから直接質問する方法です。

# 引数として質問を渡す
gemini "このディレクトリの構造を分析して"

# 他のコマンドの結果をパイプで渡す
cat error.log | gemini "このエラーの原因を教えて"

# ファイルを指定して質問
gemini "このコードを日本語でコメントして @src/utils.js"

主要なスラッシュコマンド一覧

ファイル参照の方法（@記号）

# 特定のファイルを読み込んで質問
> @src/main.py を読んでバグを探して

# 複数ファイルを参照
> @package.json と @src/App.tsx を確認して、使っていないパッケージを教えて

Plan Modeの活用（初心者にも安全）

Plan Modeは、実際に作業を始める前に「何をするか」を確認できる機能です。初心者が誤ってファイルを書き換えてしまうのを防げます。

# Plan Modeを開始
> /plan

# 以降の指示は計画段階として扱われる
> src/ フォルダ全体のTypeScriptファイルに型注釈を追加して

# Geminiが計画を提示する
# ✓ 影響するファイルのリスト
# ✓ 変更の概要
# ✓ 想定リスク
# ユーザーが承認 → 実際の作業開始

Plan Modeのメリット：

• 「思ったのと違う動き」をする前に確認できる
• 影響範囲を事前に把握できる
• 大規模な変更でも安心して任せられる

VS Codeとの連携

方法1: VS Code内のターミナルでGemini CLIを使う（おすすめ）

VS Codeの統合ターミナル（Ctrl + @）でGemini CLIを起動すると、Claude Codeとほぼ同じ感覚で操作できます。

# VS Codeのターミナルで
gemini

# CLIで「ファイルを修正して」と指示すると
# → VS Codeのエディタがリアルタイムで書き換わる

ポイント：

• CLIがファイルを編集すると、VS Code上でリアルタイムに変更が反映される
• VS Code上で開いているファイルの内容をCLI側が自動認識してくれる

方法2: VS Code拡張機能「Gemini Code Assist」

VS Codeのマーケットプレイスで「Gemini Code Assist」を検索してインストールできます。

■チャットインターフェース
└→ サイドパネルでコードに関する質問や修正依頼が可能

■インライン補完
└→ コード入力中にGeminiが次の一行や関数をグレーで提案（Ghost Text）

■エージェントモード
└→ 「このプロジェクトのテストコードを全部書いて」→複数ファイルを自動生成

IDE連携コマンド

# CLIとVS Codeをリンクして、エディタのコンテキストを共有
> /ide enable

# 今エディタで開いているファイルの選択範囲をGeminiに渡せるようになる

使い分けの指針

外部ツール・サービスとの連携

MCP（Model Context Protocol）でツールを追加

MCP対応により、外部ツールとの連携を簡単に追加できます。

// .gemini/settings.json に記述
{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"]
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"]
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/project"]
    }
  }
}

設定後は自動的に外部ツールが使えるようになります：

# GitHubのIssueを確認して対応する
> GitHubの open なIssueを一覧表示して、優先度の高いものから修正計画を立てて

# データベースの構造からコードを生成
> ローカルのPostgreSQLのusersテーブルを確認して、対応するTypeScriptの型定義を作って

カスタムスラッシュコマンドの活用

よく使うプロンプトをコマンドとして登録できます。

# ~/.gemini/commands/code-review.toml（ユーザースコープ）
name = "code-review"
description = "コードレビューを実施"
prompt = """
以下の観点でコードをレビューしてください：
- セキュリティの問題
- パフォーマンスの改善点
- 可読性の向上
- ベストプラクティスへの準拠
"""

# .gemini/commands/blog-article.toml（プロジェクトスコープ）
name = "blog-article"
description = "ブログ記事を新規作成"
prompt = """
SEOを意識したブログ記事をMarkdown形式で作成してください。
見出し構成：H2に3〜5個、H3を適宜配置。
文体：親しみやすく、専門用語は必ず解説。
"""

# 使用例
> /code-review
> /blog-article

Google検索との連携

# /search で最新情報を取得しながらコーディング
> /search Next.js 15 App Router の最新仕様

> React 19の新機能を調べて、このコンポーネントを最新の書き方に更新して

Webではできない！ローカルだからこそできること

これがGemini CLIの真骨頂です。ブラウザ版ではできない、ローカル環境ならではの活用法を紹介します。

1. プロジェクト全体の一括処理

# プロジェクト内の全ファイルをスキャン
> このプロジェクト全体で使われているlog4jのバージョンをリストアップして、脆弱性があるものを教えて

# 全ファイルの一括リファクタリング（動作確認付き）
> 変数名 oldParam を newParam に全ファイルで変更して。
> テストコード内のアサーションも合わせて書き換えて、変更後に npm test でエラーがないことを確認して

ブラウザ版では数個のファイルをアップロードするのが限界ですが、CLIはPC内のパスを自由にスキャンできます。

2. パイプラインによる前処理→AI解析の自動化

# ログから特定のエラーだけ抽出してGeminiに解析させる
grep "ERROR" /var/log/app.log | gemini "このエラーパターンの原因と対策を教えて"

# gitの差分からコミットメッセージを自動生成
git diff HEAD~1 | gemini "この変更内容に適したコミットメッセージを提案して"

# ビルド結果を解析
npm run build 2>&1 | gemini "このビルドエラーを解析して修正方法を教えて"

3. ローカルサーバー・DBとの直接対話（MCP経由）

# ローカルDBのスキーマを確認してコードを生成
> ローカルのPostgreSQLに接続して、usersテーブルの構造を確認し、
> それに対応するJavaのEntityクラスを作成して

# サーバーログのリアルタイム監視
> system.log を監視して、NullPointerExceptionが出たら即座に原因を分析してチャットに表示して

4. OS操作を伴う自動化（RPA的な動き）

# 環境構築の自動化
> このプロジェクトに必要なパッケージ（Python 3.11, Docker, AWS CLIなど）がインストールされているか確認して、
> 不足しているものがあれば必要なインストールコマンドを提案して

# ファイルの自動整理
> Downloadsフォルダの過去1ヶ月のスクリーンショットを、
> 内容に基づいて適切なフォルダに分類して移動して

5. ブログ・ドキュメントの完全自動化

# 記事作成から保存まで一気に
> new-article.md を作成して、「React Hooksの使い方」をテーマに
> SEOを意識した記事を書いて保存して。
> 書き終わったらgit commitまでして

# 全記事の一括リライト
> posts/フォルダ内の全記事をスキャンして、
> 古いURLをすべて新しいドメイン（newsite.com）に一括置換して保存して

6. セキュリティフィルタリング（独自の前処理）

# 機密情報を除外してからGeminiに送る仕組みを構築
# 例: パスワードや個人情報を伏せ字にするスクリプトを挟んでから送信

APIを経由するCLIでは、送信前に自分でスクリプトを噛ませて「個人情報が含まれていたら自動で伏せ字にしてからGeminiに送る」といった独自の制御が可能です。

GEMINI.mdによるプロジェクト設定

GEMINI.mdは、Claude CodeのCLAUDE.mdに相当するファイルです。プロジェクトルートに作成しておくだけで、毎回同じ前提を説明する必要がなくなります。

基本的な書き方

# プロジェクト概要
このプロジェクトは Next.js + TypeScript で構築したブログシステムです。

# コーディングルール
- すべてのやり取りは日本語で行うこと
- コメントはコードの右側に記述すること（例: `const x = 1; // 説明`）
- TypeScript の strict モードを厳守すること
- 関数には必ず JSDoc コメントを付けること

# 技術スタック
- フレームワーク: Next.js 15 (App Router)
- 言語: TypeScript
- スタイリング: Tailwind CSS
- DB: PostgreSQL（Prisma経由）

# 開発コマンド
- 開発サーバー起動: npm run dev
- ビルド: npm run build
- テスト: npm test
- デプロイ: git push origin main

# 記事の保存ルール
- 記事は Markdown 形式で posts/ フォルダに保存
- ファイル名は kebab-case（例: my-first-post.md）

グローバル設定（全プロジェクト共通）

# ~/.gemini/GEMINI.md

# 共通ルール
- 回答は常に日本語で行うこと
- コードの説明は簡潔に、ステップ数を最小限にすること
- セキュリティ上の問題点を発見した場合は必ず指摘すること

設定確認コマンド

# 現在読み込まれているルールを確認
> /memory show

# GEMINI.mdを更新後に再読み込み（再起動不要）
> /memory refresh

個人利用における注意点

1. 無料枠でのデータプライバシー

⚠️ 重要な注意点

無料枠（個人Googleアカウント）の場合：
- 入力したデータがGeminiモデルの改善に使用される可能性があります
- パスワード、APIキー、個人情報、業務上の機密情報は入力しないでください

対策：
① 機密情報は伏せ字にしてから入力する
② 業務利用には課金設定（有料API）を使う
③ .geminiignore でアクセス禁止ファイルを設定する

2. 常にGit管理下で作業する

Geminiはファイルを直接書き換えます。万が一の誤編集に備えて：

# 作業前にコミットしておく
git add .
git commit -m "作業前のバックアップ"

# 問題が起きたら元に戻せる
git restore .

これは鉄則です。 Git管理外のファイルをGeminiに触らせると、元に戻せなくなります。

3. 最初は承認モードを手動にする

# デフォルト（手動承認）で始める
gemini

# ファイルの書き換えや rm コマンドを実行しようとするたびに確認を求めてくれる
# [y/N] → y で承認、N でスキップ

慣れてきたら --approval-mode=auto_edit（ファイル編集は自動、シェルは確認）に移行するのがおすすめです。

また、以下のショートカットも覚えておくと便利です：

Ctrl+Y         → YOLO mode（全操作を自動承認）のオン/オフをトグル
Shift+Tab      → 承認モードを Default → Auto-Edit → Plan の順に切り替え

⚠️ YOLO modeは全操作を確認なしで実行するため、信頼できる環境でのみ使用してください。

4. コスト管理（APIキー利用時）

無料枠を超えてAPIキーで利用する場合：

# Google AI Studio でダッシュボードを確認
# https://aistudio.google.com/
# → 使用量グラフをリアルタイムで確認可能
# → プロジェクトごとの予算上限も設定可能

5. 生成されたコードは必ず確認する

AIが生成したコードをそのまま使うのはリスクがあります：

✅ 推奨ワークフロー：
1. Geminiが提案した変更を確認（Plan Modeの活用）
2. git diff でファイルの変更内容を確認
3. テストを実行して動作確認
4. 問題なければコミット

6. インターネット接続が必要

Gemini CLIはクラウドAPIを利用しているため、常時インターネット接続が必要です。オフライン環境では使用できません。

7. 会話コンテキストの管理

一つの会話セッションが長くなりすぎると、過去のすべてのやり取りがトークンとして消費されます。

# テーマが変わったら新しいセッションを開始
> /clear  # 会話履歴をクリア

# または起動し直す
exit
gemini

これが最も効果的なコスト節約術です。

実践的なワークフロー例

ワークフロー1: 朝のコードレビュー

# VS Codeのターミナルで
gemini

> 昨日のコミット以降の変更ファイルを確認して、
> セキュリティ上の問題点と改善提案をリストアップして

ワークフロー2: バグ修正の自動化

> このエラーメッセージを読んで原因を特定して修正して：
> TypeError: Cannot read properties of undefined (reading 'map')
> スタックトレース: @src/components/ProductList.tsx:45

# Geminiが原因を特定 → 修正 → ファイルに保存 → テスト実行まで自動で処理

ワークフロー3: ドキュメント生成

> src/ フォルダ内の全コンポーネントを読み込んで、
> 各コンポーネントの使い方をまとめたREADME.mdを作成して

ワークフロー4: ブログ記事の一括SEO改善

> posts/ フォルダ内の全記事をスキャンして：
> 1. titleタグが50文字以上の記事をリストアップ
> 2. meta descriptionが設定されていない記事を特定
> 3. 指摘した問題を各記事に直接修正して保存して

Amazon検索[本 Gemini]

まとめ

Gemini CLIは、使い方を理解すれば非常に強力なツールです。

おさらい：

■基本操作
└→ gemini で起動、日本語で指示するだけでOK
└→ @ファイル名 でファイルを参照

■安全な使い方
└→ /plan で事前確認
└→ 手動承認モードで始める
└→ 常にGit管理下で作業

■VSCode連携
└→ 統合ターミナルでCLI起動が最も使いやすい
└→ 「Gemini Code Assist」拡張機能も選択肢

■ローカルならではの活用
└→ ファイルの一括処理・一括置換
└→ パイプで他のコマンドと連携
└→ MCP経由でDB・GitHubと直接連携

■個人利用の注意点
└→ 機密情報は無料枠に送らない
└→ 常にGit管理下で作業
└→ 生成コードは必ず確認

特に「プロジェクト全体をGeminiに把握させて、横断的な分析や一括処理をさせる」という使い方は、他のどのツールでも難しい、Gemini CLIならではの体験です。まずは小さなファイル操作から試してみてください。

関連記事：

• Gemini CLI完全ガイド｜ターミナルで動くGoogleのAIエージェントの全貌【2026年4月最新】

Gemini CLI完全ガイド｜ターミナルで動くGoogleのAIエージェントの全貌【2026年4月最新】

はじめに「Claude CodeみたいなAIコーディングエージェントを試したいけど、費用を抑えたい…」「Googleが出しているターミナル版AIエージェントって何ができるの？」そんな疑問を持つエンジニアに向けて、Gemini CLIの全貌を...

caymezon.com

2026.02.21

• Claude Code vs Gemini CLI｜できること・できないことを徹底比較【2026年4月版】

Claude Code vs Gemini CLI｜できること・できないことを徹底比較【2026年4月版】

はじめに「Claude CodeとGemini CLI、どっちを使えばいいの？」どちらもターミナルからAIエージェントを操作して、ローカルファイルの編集・Git操作・テスト実行まで自律的にこなす強力なツールです。しかし設計思想・得意分野・コ...

caymezon.com

2026.02.21

タグ: #GeminiCLI #Gemini #Google #AI #VSCode #使い方 #開発効率化 #ターミナル

The post Gemini CLI完全使いこなしガイド｜基本操作からVSCode連携・ローカル活用術まで【2026年4月版】 first appeared on CayTech Lab.

1️⃣ はじめに：Claude Codeコマンドの需要

検索需要から見る関心度

Claude Codeのコマンドに関する検索需要を調べたところ、以下のような結果が出ています：

• 🔥 1,000～10,000件: claude code vscode
• 🔥 100～1,000件: claude code コマンド
• 🔥 10～100件: claude code スラッシュ, claude code vscode 拡張機能

この検索数からも分かる通り、Claude Codeの使い方やコマンド一覧を求めている人は意外と多いのが実情です。

この記事で解決できること

Claude Codeには67個以上のスラッシュコマンドが存在し、ターミナル版とVSCode拡張機能では使えるコマンドが異なります。

この記事では：

• ✅ 全67コマンド以上を日本語で解説（2026年4月時点）
• ✅ おすすめ度を★で明示（★～★★★）
• ✅ ターミナル版とVSCode版の違いを相互表で整理
• ✅ 使いどころを具体的に説明

これにより、あなたは必要なコマンドを素早く見つけて、Claude Codeを最大限活用できるようになります。

対象読者

• Claude Codeを使い始めたばかりの方
• VSCode拡張機能とターミナル版の違いを知りたい方
• よく使うコマンドを効率的に覚えたい方
• スラッシュコマンドの全貌を把握したい方

Amazon検索[本 Claude Code]

2️⃣ Claude Codeとは？

AI駆動の開発アシスタント

Claude Codeは、Anthropic社が提供するClaude AIをベースにした開発者向けツールです。

• ターミナル版（CLI）: コマンドラインから直接Claudeと対話
• VSCode拡張機能: エディタ内でシームレスに利用

主な特徴

• 🤖 自然言語でコード生成・編集
• 📝 コードレビューやリファクタリング支援
• 🔍 プロジェクト全体の理解と分析
• ⚡ スラッシュコマンドで高速操作

3️⃣ 全67コマンド以上一覧（おすすめ度付き）

📊 カテゴリ1: 両方に存在するコマンド

📊 カテゴリ2: UI要素として共通（表記が異なる）

📊 カテゴリ3: ターミナルのみに存在するコマンド

💡 セッション管理系

💡 プロジェクト・作業管理系

💡 データ管理・出力系

💡 GitHub/Git連携系

💡 システム設定・診断系

💡 IDE・プラットフォーム連携系

💡 アカウント・プラン管理系

💡 ヘルプ・サポート系

💡 その他

📊 カテゴリ4: VSCode拡張機能のみに存在する機能

4️⃣ おすすめコマンド TOP10

実際の開発現場でよく使われるコマンドを、おすすめ度★★★から厳選しました。

5️⃣ ターミナル版とVSCode版の使い分け

ターミナル版が優れている点

• ✅ セッション管理が豊富: /resume, /fork, /rewind などで柔軟に会話を管理
• ✅ システム統合が充実: /desktop, /chrome, /mobile などプラットフォーム間の移動が容易
• ✅ 詳細な統計・診断: /stats, /doctor, /status で深い分析が可能
• ✅ スクリプト連携: シェルスクリプトやCI/CDに組み込みやすい

VSCode版が優れている点

• ✅ ファイル操作がUI化: Attach file, Mention file でドラッグ&ドロップ感覚
• ✅ 視覚的な設定: メニュー形式で直感的に操作
• ✅ コスト確認: /cost で使用料金を即座に確認
• ✅ 思考プロセス可視化: Thinking トグルでAIの推論を追える
• ✅ エディタ統合: コードとClaude Codeをシームレスに行き来

推奨する使い分け

Amazon検索[本 Claude Code]

6️⃣ まとめ

この記事で学んだこと

• ✅ Claude Codeには全67個以上のスラッシュコマンドが存在（2026年4月時点）
• ✅ ターミナル版とVSCode版では使えるコマンドが大きく異なる
• ✅ おすすめ度★★★のコマンドを優先的に覚えると効率UP
• ✅ 用途に応じてターミナル版とVSCode版を使い分けるのがベスト

次のステップ

1. まずは★★★のコマンドから試してみる
2. 自分のワークフローに合ったコマンドを見つける
3. /memory でClaude Codeに自分の好みを覚えさせる
4. /plan で複雑なタスクを効率的に進める

さらに学ぶために

• 📖 Claude Code公式ドキュメント
• 🎓 VSCode拡張機能マーケットプレイス
• 💬 Claude Codeコミュニティ

この記事が役に立ったら、ぜひシェアしてください！ 🚀

Claude Codeを使いこなして、開発生産性を劇的に向上させましょう！

関連記事：

• Claude Code完全ガイド｜ターミナルで動くAIコーディングアシスタントの全貌

Claude Code完全ガイド｜ターミナルで動くAIコーディングアシスタントの全貌【2026年4月版】

はじめに「AIにコードを書かせたいけど、ブラウザとエディタを行き来するのが面倒…」そんな悩みを解決するのがClaude Codeです。2026年4月時点で、Anthropicが提供するターミナル型AIエージェントとして、開発者の間で急速に注...

caymezon.com

2026.02.14

• Claude Code環境構築完全ガイド｜初心者でも30分でセットアップできる詳細手順

Claude Code環境構築完全ガイド｜初心者でも30分でセットアップできる詳細手順

はじめに「Claude Codeを使ってみたいけど、環境構築が難しそう…」そんな不安を持つ方も多いはずです。実際、ターミナルベースのツールは初心者にとってハードルが高く感じられます。しかし、この記事の手順通りに進めれば、初心者でも30分でC...

caymezon.com

2026.02.14

• Claude Code vs Web版・Desktop版 開発効率徹底比較｜実際のマクロ開発で検証

Claude Code vs Web版・Desktop版 開発効率徹底比較｜実際のマクロ開発で検証

はじめに「Claude Codeって本当に効率的なの？」そんな疑問を持つ開発者は多いはずです。実際、Web版やDesktop版と比べて、どれくらいのメリットがあるのかイメージしにくいかもしれません。本記事では、実際に「VSCodeでクリップ...

caymezon.com

2026.02.14

• Claude Code VSCode拡張機能完全ガイド｜CLI版との違いと最強の使い分け術

Claude Code VSCode拡張機能完全ガイド｜CLI版との違いと最強の使い分け術

はじめに「Claude CodeってターミナルでCLIを使うものだと思ってた…」「VSCodeの拡張機能もあるって聞いたけど、何が違うの？」そんな疑問を持つ開発者は多いはずです。実は、Claude CodeにはVSCode拡張機能版があり、...

caymezon.com

2026.02.14

• 【まとめ記事】Claude Code完全攻略ロードマップ｜全記事まとめ

【2026年版】Claude Code完全攻略ロードマップ｜セットアップからVSCode活用・コマンド習得まで全記事まとめ

はじめに「Claude Codeに興味があるけど、何から始めればいいかわからない」「Claude Codeを使い始めたけど、もっと使いこなしたい」この記事は、Claude Codeに関するすべての記事を体系的にまとめたロードマップです。初心...

caymezon.com

2026.03.21

The post 【2026年4月最新版】Claude Code全67コマンド以上徹底解説｜ターミナル版とVSCode拡張機能の違いも網羅 first appeared on CayTech Lab.

はじめに

「AIにコードを書かせたいけど、ブラウザとエディタを行き来するのが面倒…」

そんな悩みを解決するのがClaude Codeです。2026年4月時点で、Anthropicが提供するターミナル型AIエージェントとして、開発者の間で急速に注目を集めています。

実際、AI開発ツールの検索トレンドを見ると：

■検索ワード（月間推定）
- 1万～10万: "Claude AI"
- 1000～1万: "Claude API", "Claude コーディング"
- 100～1000: "Claude Code", "AI コーディングアシスタント"

Claude Codeは、ターミナルから直接Claudeとやり取りできる革新的なツールです。

本記事では、Claude Codeの全体像から実践的な活用方法まで、2026年4月時点の最新情報をもとに徹底解説します。

Amazon検索[本 Claude Code]

この記事で分かること

• Claude Codeとは何か（Web版・Desktop版との違い）
• デスクトップアプリとしての特徴と機能
• メリット・デメリットの詳細分析
• 日本語での使い方（CLAUDE.md設定）
• 使用量制限と回避策
• モデル選択（Opus vs Sonnet）
• 実際の開発ワークフローでの活用法
• 今後の展望と懸念事項

こんな人におすすめ

• AIを使ったコーディングに興味がある開発者
• ブラウザとエディタの行き来に疲れている人
• ターミナルベースの開発環境を好む人
• Claude APIを効率的に活用したい人
• 最新のAI開発ツールを試したい人

Claude Codeとは

基本概念

Claude Codeは、Anthropic社が提供するコマンドライン型のAIコーディングアシスタントです。

主な特徴：

■ターミナルネイティブ
└→ コマンドラインから直接Claudeとやり取り
└→ エディタとシームレスに統合

■ローカルファイルアクセス
└→ プロジェクトファイルを直接読み書き
└→ ファイルツリーの自動認識

■複数モデル対応
└→ デフォルトはSonnet 4.6（バランス型、SWE-bench Verified 79.6%）
└→ Opus 4.7も選択可能（最高性能、SWE-bench Verified 87.6%、2026年4月リリース）
└→ Opus 4.6も利用可能（高性能、SWE-bench Verified 80.8%）
└→ Haiku 4.5も利用可能（高速・低コスト、SWE-bench Verified 73.3%）

Claude製品ファミリーとの関係

アーキテクチャ

[開発者]
    ↓ コマンド入力（日本語/英語）
[Claude Code CLI]
    ↓ API通信
[Claude API (Sonnet/Opus)]
    ↓ 応答
[ローカルファイルシステム]
    ↓ 読み書き
[プロジェクトファイル]

動作フロー：

1. ターミナルでClaude Code起動
2. 自然言語で指示（日本語OK）
3. Claudeがコード生成・編集
4. ファイルに直接反映
5. 確認・修正のループ

日本語での使い方

セッション開始時の設定（一時的）

Claude Codeは英語表示がデフォルトですが、日本語で使うことができます。

方法1: 起動直後に指示

# Claude Code起動後、最初に入力
> 以後、すべてのやり取りは日本語で行ってください。

これだけで、そのセッション中は日本語で解説やコードの説明をしてくれるようになります。

CLAUDE.mdによる永続的な設定（推奨）

毎回指示するのは面倒なので、プロジェクトごとに設定ファイルを作成することをお勧めします。

手順：

# プロジェクトのルートディレクトリで
> CLAUDE.mdファイルを作成してください。内容は「常に日本語で応答すること」「コードの右側にコメントを書くこと」としてください。

または手動で作成：

# プロジェクトルール

- 常に日本語で応答してください
- コード生成時はコメントをコードの右側に記述してください
- ステップ数を抑えた簡潔な実装を心がけてください

保存場所：

C:\my-project\CLAUDE.md  ← プロジェクトルートに配置
C:\my-project\src\
C:\my-project\package.json

Claude Codeはこのファイルを自動的に読み取り、プロジェクト専用のルールとして適用します。

メリット：

• 一度設定すれば毎回指示不要
• プロジェクトごとに異なるルール設定可能
• チーム共有も可能（Gitで管理）

Claude Codeの主要機能

1. ファイル編集機能

# 日本語での指示例
> src/components/Button.tsxにホバーエフェクトを追加して

# 英語でも可能
> edit src/components/Button.tsx to add hover effect

実行例：

// Before
export const Button = ({ children }) => (
  <button>{children}</button>
);

// After（Claude Codeが自動生成）
export const Button = ({ children }) => (
  <button
    className="transition-all hover:bg-blue-600"  // ホバー時の色変更
  >
    {children}
  </button>
);

2. プロジェクト全体の理解

# 日本語での指示例
> このプロジェクトの構造を分析して

# 英語でも可能
> analyze this project structure

Claude Codeが理解すること：

• ディレクトリ構造
• 使用技術スタック
• 依存関係
• コーディング規約
• アーキテクチャパターン

3. 複数ファイル同時編集

# 日本語での指示例
> 全ファイルの認証ロジックをリファクタリングして

# 英語でも可能
> refactor the authentication logic across all files

自動で処理：

1. 関連ファイルの検出
2. 依存関係の分析
3. 一貫性のある編集
4. インポート文の自動更新

4. コードレビュー機能

# 日本語での指示例
> src/utils/api.tsのセキュリティ問題をレビューして

# 英語でも可能
> review src/utils/api.ts for security issues

レビュー項目：

• セキュリティ脆弱性
• パフォーマンス問題
• ベストプラクティス違反
• 潜在的なバグ
• コード品質

5. テストコード生成

# 日本語での指示例
> src/components/Form.tsxのテストを生成して

# 英語でも可能
> generate tests for src/components/Form.tsx

生成内容：

// Form.test.tsx
import { render, screen, fireEvent } from '@testing-library/react';
import { Form } from './Form';

describe('Form', () => {
  it('有効なデータでフォームを送信できる', () => {
    // Claude Codeが自動生成
  });
  
  it('バリデーションエラーを表示する', () => {
    // ...
  });
});

メリット

1. 圧倒的な開発速度

Web版との比較：

■Web版でのワークフロー
1. ブラウザでClaude.aiを開く
2. コード生成を依頼
3. 生成されたコードをコピー
4. エディタに貼り付け
5. 動作確認
6. 修正が必要なら1に戻る
→ 約10ステップ

■Claude Codeでのワークフロー
1. ターミナルで指示（日本語OK）
2. 自動でファイルに反映
3. 動作確認
→ 約3ステップ

実測データ：

• コード生成時間: 70%短縮
• コピペ作業: 100%削減
• エディタ切替: 不要

2. コンテキストの完全保持

[プロジェクト全体]
    ↓ 自動認識
[Claude Code]
    ↓ 理解
[一貫性のあるコード生成]

保持される情報：

• ファイル構造
• コーディング規約
• 命名規則
• アーキテクチャパターン
• 依存関係

3. ターミナルとの完全統合

# Git操作も依頼可能（日本語で）
> これらの変更を分かりやすいメッセージでコミットして
> commit these changes with a descriptive message

# ビルドエラーの解析
> このビルドエラーを解析して修正して
> analyze this build error and fix it

# パッケージ管理
> tailwindcssを追加して設定して
> add tailwindcss and configure it

4. リアルタイムフィードバック

> src/api/client.tsにリトライロジックを追加して

[処理中...]
✓ src/api/client.ts を編集しました
✓ 3箇所の関数にリトライロジックを追加
✓ exponential backoffを実装
✓ 最大3回のリトライを設定

デメリット・制約事項

1. ターミナル操作が必須

対象外の人：

• GUIツールに慣れている初心者
• ターミナル経験が浅い開発者
• マウス操作を好む人

学習コスト：

基本操作: 1-2時間
実践習得: 1週間
完全習熟: 1ヶ月

2. インターネット接続必須

[Claude Code]
    ↓ 常時通信
[Claude API]

制約：

• オフライン作業不可
• ネットワーク遅延の影響
• 通信量の消費

3. 使用量制限（重要）

Claude Codeの最大の問題点

Claude.ai（Web版）、Claude Desktop、Claude Code（CLI版）はすべて同じ使用量制限を共有します。

[Claude.ai での使用]
        ↓
[共有された使用量プール]
        ↑
[Claude Code での使用]

Proプラン（$20/月）の制限：

■5時間ごとにリセット
├─ プロンプト数: 約10-40回/5時間
└─ 大規模タスクで上限に達しやすい

■週次制限も存在
└─ ヘビーユーザーは週次上限にも注意

2026年4月の価格変更に関する注意：

2026年4月22日、AnthropicはProプランの新規ユーザーを対象にClaude Codeへのアクセスを一時的に削除するA/Bテストを実施しました。既存のProおよびMaxユーザーには影響なく、数日後に元に戻されました。今後の価格体系の変更に注意が必要です。

問題が起きやすいケース：

• Web版で調べ物をした後にClaude Codeを使う
• 大規模リファクタリング
• 複数ファイルの同時編集
• 長時間のペアプログラミング

回避策：

1. モデルをSonnetに変更（推奨）

# セッション開始時
/model sonnet

# またはデフォルト設定
claude --model claude-sonnet-4-6

SonnetはOpusよりトークン消費が約1/5で、5時間制限内で100+プロンプト可能です。

2. Web版とClaude Codeを使い分ける

調べ物・質問 → Web版
実際のコーディング → Claude Code

3. Max プランへのアップグレード

Max 5x: $100/月（約88,000トークン/5時間ウィンドウ）
Max 20x: $200/月（約220,000トークン/5時間ウィンドウ）

なお、Routines機能（後述）の利用上限もプランにより異なります：

Proプラン:          5ルーティン/日
Max 5x/20xプラン: 15ルーティン/日
Team/Enterpriseプラン: 25ルーティン/日

4. モデル選択の注意点

デフォルトモデルの懸念

Claude CodeはOpus 4.6がデフォルトになることがあります。

起動時: Opus 4.6（高性能）
  ↓
使用量を大量消費
  ↓
上限到達が早い

Opus 4.7（2026年4月16日リリース）について：

2026年4月16日にリリースされたClaude Opus 4.7はSWE-bench Verified 87.6%を達成し、Anthropicの最新フラッグシップモデルです。ただし、トークン消費量も最大であるため、使用量制限に十分注意が必要です。

Opusモデルの特徴：

✅ メリット
├─ 最高レベルの推論能力
├─ 複雑なアーキテクチャ設計
└─ 難易度の高いバグ修正

⚠️ デメリット
├─ トークン消費が多い
├─ Proプランでは追加料金が必要な場合あり
└─ 5時間制限に達しやすい

Sonnet 4.6で十分なケース（ほとんどの日常開発）：

✅ 通常の機能開発
✅ コードレビュー
✅ テストコード生成
✅ リファクタリング
✅ ドキュメント作成

モデル比較：

推奨設定：

# デフォルトをSonnetに設定
echo 'export ANTHROPIC_MODEL="claude-sonnet-4-6"' >> ~/.bashrc

# セッション中に変更
/model sonnet  # Sonnetに切り替え
/model opus    # 複雑なタスクのみOpus使用

5. プライバシー・セキュリティ

注意点：

■送信されるデータ
├─ ソースコード
├─ ファイルパス
├─ プロジェクト構造
└─ 会話履歴

■対策
├─ .gitignore相当の設定
├─ 機密情報の除外
└─ エンタープライズ契約

6. ファイル変更の確認が必要

# Claudeは直接ファイルを書き換える
# Git diffで確認必須
git diff

推奨ワークフロー：

1. Claude Codeで編集
2. git diffで差分確認
3. 問題なければcommit
4. 問題あれば修正依頼

7. モデルの限界

苦手な領域：

• 超大規模プロジェクト（1000+ファイル）
• レガシーコード（独自フレームワーク）
• 低レベルプログラミング（アセンブラ等）
• 極めて複雑なアルゴリズム

実践的な活用シーン

シーン1: 新規機能開発

# 日本語での指示例
> JWTでユーザー認証機能を追加して

# 英語でも可能
> add user authentication with JWT

Claude Codeの動作：

1. 認証ロジック実装
2. APIエンドポイント追加
3. フロントエンド連携
4. テストコード生成
5. ドキュメント更新

シーン2: バグ修正

# 日本語での指示例
> このエラーを修正して: TypeError: Cannot read property 'map' of undefined

# 英語でも可能
> fix this error: TypeError: Cannot read property 'map' of undefined

分析・修正フロー：

1. エラーの原因特定
2. 該当箇所の修正
3. null/undefinedチェック追加
4. テストケース追加

シーン3: リファクタリング

# 日本語での指示例
> このコードを可読性とパフォーマンス向上のためにリファクタリングして

# 英語でも可能
> refactor this code to improve readability and performance

改善内容：

• 可読性向上
• パフォーマンス最適化
• 重複コードの削減
• ベストプラクティス適用

シーン4: ドキュメント生成

# 日本語での指示例
> このプロジェクトの包括的なREADME.mdを作成して

# 英語でも可能
> create a comprehensive README.md for this project

生成内容：

• プロジェクト概要
• インストール手順
• 使い方
• API仕様
• 開発環境構築

Web版・Desktop版との比較

詳細比較表

使い分けの指針

Web版が向いている：

• AI対話を試したい初心者
• コード断片の生成
• 軽い質問・相談
• ブラウザ環境しかない場合

Desktop版が向いている：

• GUIベースの開発
• ファイル操作を視覚的に確認
• マウス操作を好む人
• ターミナルに不慣れな人

Claude Codeが向いている：

• 本格的な開発作業
• ターミナル中心の開発環境
• 複数ファイルの一括編集
• CI/CD統合
• 高速な開発サイクル

2026年4月時点の最新アップデート

実現済みの機能（2026年4月まで）

1. IDE統合（実現済み）

VS Code拡張機能（公式）
    ↓
Claude Code統合
    ↓
エディタ内でシームレス操作

JetBrains拡張機能（公式）
    ↓
IntelliJ / WebStorm等でも利用可能

2. 音声入力モード（2026年3月3日〜）

# /voice コマンドでプッシュトゥトーク方式の音声入力
/voice
→ スペースキーを押しながら話し、離すと送信
→ ハンズフリー開発が実現
→ 20言語対応、追加料金なしで全有料プランで利用可能

3. MCP（Model Context Protocol）対応

MCPサーバーとの連携により外部ツールへのアクセスが可能
→ GitHub Issues、Slack、データベース等と直接連携
→ Spotify、Booking.com、Instacart、Uber等200以上のパートナーとの統合も追加

4. デスクトップアプリ完全刷新（2026年4月14日〜）

マルチセッションサイドバー
    ↓
複数セッションの並列管理
    ↓
ドラッグ＆ドロップのペインレイアウト
    ↓
統合ターミナル・インアプリファイルエディタ
    ↓
Git worktreesによるセッション間の分離

各セッションはGitリポジトリ内でworktrees（ワークツリー）を使って分離され、コミットまで変更が他セッションに影響しません。

5. Routines（ルーティン）機能（2026年4月14日〜 研究プレビュー）

Routinesとは保存済みのClaude Code自動化タスク
    ↓
Anthropicのクラウド基盤上で実行（ローカルPC不要）
    ↓
トリガー種別: スケジュール / APIエンドポイント / GitHubイベント

スケジュールは「毎時・毎日・毎週」等から選択可能。GitHubイベント（PR作成・プッシュ・Issue等）に連動したCI/CD自動化も実現します。

今後に期待される機能

1. オフラインモード

ローカルモデル
    ↓
セキュアな環境
    ↓
機密プロジェクト対応

2. チーム機能の強化

共有プロジェクト
    ↓
コードレビュー自動化
    ↓
チーム全体の効率化

市場への影響

開発ツール市場の変化：

従来:
[開発者] → [IDE] → [手動コーディング]

未来:
[開発者] → [AI Assistant] → [自動コーディング]

GitHub Copilotとの競合：

懸念事項

1. スキル低下のリスク

AI依存度 ↑
    ↓
基礎スキル ↓
    ↓
問題解決能力 ↓

対策：

• 生成コードを必ず読む
• 仕組みを理解する
• 定期的に手動コーディング

2. セキュリティ・コンプライアンス

企業での課題：

• コード流出リスク
• ライセンス違反
• 機密情報の漏洩
• コンプライアンス違反

対策：

• エンタープライズ契約
• プライベートクラウド
• 監査ログ整備
• ポリシー策定

3. 技術的負債の蓄積

AI生成コード
    ↓
理解不十分のまま使用
    ↓
メンテナンス困難化

対策：

• コードレビュー必須化
• ドキュメント充実
• テストカバレッジ維持

4. コスト管理

想定外のコスト増：

大規模プロジェクト
    ↓
頻繁なAPI呼び出し
    ↓
月額コスト増大

対策：

• 利用状況モニタリング
• 予算上限設定
• 効率的な使用
• Sonnetモデルの活用

環境構築の準備

Claude Codeを実際に使い始めるには、適切な環境構築が必要です。

詳細な手順については、以下の記事で解説しています：

Claude Code環境構築完全ガイド｜初心者でも30分でセットアップできる詳細手順

はじめに「Claude Codeを使ってみたいけど、環境構築が難しそう…」そんな不安を持つ方も多いはずです。実際、ターミナルベースのツールは初心者にとってハードルが高く感じられます。しかし、この記事の手順通りに進めれば、初心者でも30分でC...

caymezon.com

2026.02.14

セットアップの概要：

1. Node.js環境の準備
2. Claude Code CLI のインストール
3. 初回ログイン（OAuth認証）
4. プロジェクトの初期化
5. 初回動作確認

実際の開発での効率比較

Claude Codeを使った開発と従来手法での効率の違いについて、実例を交えて詳しく解説しています：

Claude Code vs Web版・Desktop版 開発効率徹底比較｜実際のマクロ開発で検証

はじめに「Claude Codeって本当に効率的なの？」そんな疑問を持つ開発者は多いはずです。実際、Web版やDesktop版と比べて、どれくらいのメリットがあるのかイメージしにくいかもしれません。本記事では、実際に「VSCodeでクリップ...

caymezon.com

2026.02.14

比較内容：

• Web版との開発時間比較
• Desktop版との使い勝手比較
• 実際のマクロ開発での実測データ
• ワークフローの最適化手法

Amazon検索[本 Claude Code]

まとめ

Claude Codeは、ターミナルで動作するAIコーディングアシスタントとして、2026年4月時点で最も先進的なツールの一つです。

主要なポイント：

✅ メリット

• ターミナルからの直接操作
• ファイルへの自動反映
• プロジェクト全体の理解（Sonnet 4.6: SWE-bench Verified 79.6%）
• 開発速度の大幅向上
• 日本語での利用が可能
• VS Code・JetBrains拡張機能による IDE統合（実現済み）
• 音声入力モード /voice が利用可能（2026/03〜、20言語対応）
• デスクトップアプリのマルチセッション並列管理（2026/04〜）
• Routinesによるクラウド自動実行（2026/04〜 研究プレビュー）

⚠️ デメリット・注意点

• ターミナル操作が必須
• インターネット接続必要
• 使用量制限が全製品で共有（重要）
• Opusモデルは消費が激しい
• プライバシー考慮必要

🎯 推奨設定

• モデルはSonnet 4.6を使用（日常開発に最適）
• CLAUDE.mdで日本語設定
• Web版とClaude Codeを使い分け

⚠️ 懸念事項

• スキル低下リスク
• セキュリティ課題
• 技術的負債
• コスト管理

次のステップ：

実際にClaude Codeを導入して、開発効率を体感してみましょう。

環境構築の詳細は以下の記事を参照してください：

Claude Code環境構築完全ガイド｜初心者でも30分でセットアップできる詳細手順

はじめに「Claude Codeを使ってみたいけど、環境構築が難しそう…」そんな不安を持つ方も多いはずです。実際、ターミナルベースのツールは初心者にとってハードルが高く感じられます。しかし、この記事の手順通りに進めれば、初心者でも30分でC...

caymezon.com

2026.02.14

関連記事：

• 【2026年2月完全版】Claude Code全56コマンド徹底解説｜ターミナル版とVSCode拡張機能の違いも網羅

【2026年4月最新版】Claude Code全67コマンド以上徹底解説｜ターミナル版とVSCode拡張機能の違いも網羅

1️⃣ はじめに：Claude Codeコマンドの需要検索需要から見る関心度Claude Codeのコマンドに関する検索需要を調べたところ、以下のような結果が出ています：🔥 1,000～10,000件: claude code vscode...

caymezon.com

2026.02.15

• Claude Code環境構築完全ガイド

Claude Code環境構築完全ガイド｜初心者でも30分でセットアップできる詳細手順

はじめに「Claude Codeを使ってみたいけど、環境構築が難しそう…」そんな不安を持つ方も多いはずです。実際、ターミナルベースのツールは初心者にとってハードルが高く感じられます。しかし、この記事の手順通りに進めれば、初心者でも30分でC...

caymezon.com

2026.02.14

• Claude Code vs Web版・Desktop版 開発効率徹底比較

Claude Code vs Web版・Desktop版 開発効率徹底比較｜実際のマクロ開発で検証

はじめに「Claude Codeって本当に効率的なの？」そんな疑問を持つ開発者は多いはずです。実際、Web版やDesktop版と比べて、どれくらいのメリットがあるのかイメージしにくいかもしれません。本記事では、実際に「VSCodeでクリップ...

caymezon.com

2026.02.14

• Claude Code VSCode拡張機能完全ガイド｜CLI版との違いと最強の使い分け術

Claude Code VSCode拡張機能完全ガイド｜CLI版との違いと最強の使い分け術

はじめに「Claude CodeってターミナルでCLIを使うものだと思ってた…」「VSCodeの拡張機能もあるって聞いたけど、何が違うの？」そんな疑問を持つ開発者は多いはずです。実は、Claude CodeにはVSCode拡張機能版があり、...

caymezon.com

2026.02.14

• VSCodeマクロ開発で実感！Claude Codeの威力

VSCodeで画像挿入が一瞬！クリップボード画像をMarkdown化するTypeScriptマクロ

はじめに「Markdownで記事を書くとき、画像挿入がいちいち面倒…」ブログ執筆やドキュメント作成で、こんな経験をしたことがある人は多いはずです。従来の作業フロー：1. スクリーンショットを撮る2. 画像編集ソフトで開く3. ファイル名をつ...

caymezon.com

2026.02.14

• 【まとめ記事】Claude Code完全攻略ロードマップ｜全記事まとめ

【2026年版】Claude Code完全攻略ロードマップ｜セットアップからVSCode活用・コマンド習得まで全記事まとめ

はじめに「Claude Codeに興味があるけど、何から始めればいいかわからない」「Claude Codeを使い始めたけど、もっと使いこなしたい」この記事は、Claude Codeに関するすべての記事を体系的にまとめたロードマップです。初心...

caymezon.com

2026.03.21

• 【入門ガイド】Claude AI完全入門ガイド｜Web版・Desktop版・Claude Codeの違いと選び方

【2026年版】Claude AI完全入門ガイド｜Web版・Desktop版・Claude Codeの違いと選び方を徹底解説

はじめに「Claudeを使ってみたいけど、Web版・Desktop版・Claude Codeって何が違うの？」Anthropicが提供するClaude AIには複数の製品があり、初めて触れる方はどれを使えばいいか迷うことが多いです。この記事...

caymezon.com

2026.03.21

タグ: #Claude #ClaudeCode #AI #コーディング #開発効率化 #ターミナル #Anthropic

The post Claude Code完全ガイド｜ターミナルで動くAIコーディングアシスタントの全貌【2026年4月版】 first appeared on CayTech Lab.

はじめに

「VSCodeでいちいちコマンドをコピペしてターミナルで実行するのめんどくさい…」

そんな悩みを持つ開発者は多いはずです。実際、検索数から見ても：

■検索ワード（月間検索数）
- 1000～1万: "vscode ターミナル"
- 100～1000: "vscode コマンド プロンプト", "vscode powershell", "vscode gitbash"
- 10～100: "vscode ターミナル 実行", "vscode cmd"

ターミナル実行の効率化は、多くの開発者が求めている機能です。

本記事では、カーソル行または選択テキストをショートカットキー一発でターミナル実行できるTypeScriptマクロの実装方法を完全解説します。

Amazon検索[本 TypeScript]

この記事で分かること

• ターミナル実行マクロの実装方法
• cmd/PowerShell/Git Bashの使い分け
• 単一行・複数行コマンドの実行方法
• キーバインド設定のベストプラクティス
• 実践的な使用例とワークフロー
• トラブルシューティング

こんな人におすすめ

• コマンドをメモ帳に保存している人
• コマンド実行のたびにコピペしている人
• よく使うコマンドをすぐ実行したい人
• 複数のターミナル（cmd/PS/GitBash）を使い分けたい人

解決できる課題

従来の問題点

1. コピペの手間

1. コマンドを選択
2. Ctrl+Cでコピー
3. ターミナルをクリック
4. Ctrl+Vで貼り付け
5. Enter押下

2. コマンド管理の煩雑さ

• よく使うコマンドをどこに保存？
• 過去のコマンド履歴を探すのが大変
• プロジェクトごとのコマンド集が散在

3. ターミナル切り替えの手間

• cmd、PowerShell、Git Bashを使い分け
• それぞれでコマンド入力が必要

この機能で実現できること

ショートカットキー一発で実行！

Before:
選択 → コピー → ターミナル切替 → 貼り付け → Enter（5ステップ）

After:
Ctrl+Shift+1（1ステップ）

複数コマンドも順次実行

# 3行を選択してCtrl+Shift+1
cd /d C:\projects
npm install
npm run dev
# → 自動で順次実行！

機能仕様

基本機能

ショートカットキー

動作フロー

1. テキスト未選択の場合（1行コマンド）
   ↓
   カーソル行の文字列全体を取得
   ↓
   ターミナルで実行
   ↓
   エディタにフォーカスを戻す
   ↓
   カーソルを次の行の先頭に移動

2. テキスト選択の場合（複数行コマンド）
   ↓
   選択範囲を行ごとに分割
   ↓
   空行を除外
   ↓
   各行を順次実行（100ms待機）
   ↓
   エディタにフォーカスを戻す
   ↓
   [カーソルが行頭(char=0)の場合] 選択解除のみ（カーソル移動なし）
   [カーソルが行中の場合] 選択範囲の次の行の先頭に移動

TypeScript実装コード

ファイル構成

src/
├── extension.ts              # コマンド登録
└── macros/
    └── runInTerminal.ts      # ターミナル実行機能

runInTerminal.ts（完全版）

import * as vscode from 'vscode';

/**
 * ターミナルのタイプ
 */
export enum TerminalType {
    CMD = 'cmd',
    PowerShell = 'powershell',
    GitBash = 'gitbash'
}

/**
 * コマンドプロンプトで実行
 */
export async function runInCmd() {
    await runInTerminal(TerminalType.CMD);
}

/**
 * PowerShellで実行
 */
export async function runInPowerShell() {
    await runInTerminal(TerminalType.PowerShell);
}

/**
 * Git Bashで実行
 */
export async function runInGitBash() {
    await runInTerminal(TerminalType.GitBash);
}

/**
 * 指定されたターミナルでコマンド実行
 */
async function runInTerminal(terminalType: TerminalType) {
    const editor = vscode.window.activeTextEditor;
    if (!editor) {
        vscode.window.showWarningMessage('アクティブなエディタがありません');
        return;
    }

    // コマンド取得
    const commands = getCommandsToExecute(editor);
    if (commands.length === 0) {
        vscode.window.showWarningMessage('実行するコマンドがありません');
        return;
    }

    // 現在の行位置・選択範囲を記憶
    const currentLine = editor.selection.active.line;
    const currentChar = editor.selection.active.character;
    const selectionEndLine = editor.selection.end.line;
    const isSingleCommand = commands.length === 1;

    // ターミナル取得または作成
    const terminal = getOrCreateTerminal(terminalType);
    terminal.show();

    // コマンド実行（複数行の場合は順次実行）
    for (const command of commands) {
        const trimmedCommand = command.trim();
        if (trimmedCommand) {
            terminal.sendText(trimmedCommand, true);
            // 複数コマンド実行時は少し待機
            if (commands.length > 1) {
                await sleep(100);
            }
        }
    }

    // エディタをアクティブにする
    await vscode.commands.executeCommand('workbench.action.focusActiveEditorGroup');

    if (isSingleCommand) {
        // １行コマンド: 次の行の先頭にカーソルを移動
        const nextLine = currentLine + 1;
        if (nextLine < editor.document.lineCount) {
            const newPosition = new vscode.Position(nextLine, 0);
            editor.selection = new vscode.Selection(newPosition, newPosition);
            editor.revealRange(new vscode.Range(newPosition, newPosition));
        }
    } else {
        // 複数行コマンド: カーソルが行の先頭（char 0）でなければ選択範囲の次の行に移動
        if (currentChar > 0) {
            const nextLine = selectionEndLine + 1;
            if (nextLine < editor.document.lineCount) {
                const newPosition = new vscode.Position(nextLine, 0);
                editor.selection = new vscode.Selection(newPosition, newPosition);
                editor.revealRange(new vscode.Range(newPosition, newPosition));
            }
        } else {
            // カーソルが行頭にある場合は移動せず、選択状態のみ解除
            const currentPosition = new vscode.Position(currentLine, currentChar);
            editor.selection = new vscode.Selection(currentPosition, currentPosition);
        }
    }

    // 実行完了メッセージ
    const terminalName = getTerminalDisplayName(terminalType);
    const message = commands.length === 1
        ? `${terminalName}でコマンドを実行しました`
        : `${terminalName}で${commands.length}個のコマンドを実行しました`;
    vscode.window.showInformationMessage(message);
}

/**
 * 実行するコマンドを取得
 */
function getCommandsToExecute(editor: vscode.TextEditor): string[] {
    const selection = editor.selection;
    const document = editor.document;

    // テキストが選択されている場合
    if (!selection.isEmpty) {
        const selectedText = document.getText(selection);
        
        // 複数行の場合は行ごとに分割
        const lines = selectedText.split(/\r?\n/);
        
        // 空行を除外してコマンドリストを作成
        return lines
            .map(line => line.trim())
            .filter(line => line.length > 0);
    }

    // テキスト未選択の場合は現在行を取得
    const currentLine = document.lineAt(selection.active.line);
    const lineText = currentLine.text.trim();
    
    return lineText.length > 0 ? [lineText] : [];
}

/**
 * ターミナルを取得または作成
 */
function getOrCreateTerminal(terminalType: TerminalType): vscode.Terminal {
    const terminalName = getTerminalName(terminalType);
    
    // 既存のターミナルを探す
    const existingTerminal = vscode.window.terminals.find(
        t => t.name === terminalName
    );

    if (existingTerminal) {
        return existingTerminal;
    }

    // 新規ターミナルを作成
    return createTerminal(terminalType);
}

/**
 * Git Bash のパスを解決する
 * 優先順位: VSCode設定 → 既定パス1 → 既定パス2
 */
function resolveGitBashPath(): string {
    const fs = require('fs');

    // 1. VSCode設定から取得
    const configPath = vscode.workspace.getConfiguration('myMacros').get<string>('gitBashPath', '');
    if (configPath && fs.existsSync(configPath)) {
        return configPath;
    }

    // 2. 既定パス（Program Files）
    const defaultPath = 'C:\\Program Files\\Git\\bin\\bash.exe';
    if (fs.existsSync(defaultPath)) {
        return defaultPath;
    }

    // 3. 代替パス（Program Files (x86)）
    const altPath = 'C:\\Program Files (x86)\\Git\\bin\\bash.exe';
    if (fs.existsSync(altPath)) {
        return altPath;
    }

    // 見つからない場合は設定値または既定パスを返す（ターミナル作成時にエラーになる）
    return configPath || defaultPath;
}

/**
 * 新しいターミナルを作成
 */
function createTerminal(terminalType: TerminalType): vscode.Terminal {
    const name = getTerminalName(terminalType);

    let shellPath: string | undefined;
    let shellArgs: string[] | undefined;

    switch (terminalType) {
        case TerminalType.CMD:
            shellPath = 'cmd.exe';
            break;
        case TerminalType.PowerShell:
            shellPath = 'powershell.exe';
            break;
        case TerminalType.GitBash:
            shellPath = resolveGitBashPath(); // VSCode設定 → Program Files の順で解決
            shellArgs = ['--login', '-i'];
            break;
    }

    return vscode.window.createTerminal({
        name: name,
        shellPath: shellPath,
        shellArgs: shellArgs
    });
}

/**
 * ターミナル名を取得
 */
function getTerminalName(terminalType: TerminalType): string {
    switch (terminalType) {
        case TerminalType.CMD:
            return 'My Macros - CMD';
        case TerminalType.PowerShell:
            return 'My Macros - PowerShell';
        case TerminalType.GitBash:
            return 'My Macros - Git Bash';
    }
}

/**
 * ターミナル表示名を取得
 */
function getTerminalDisplayName(terminalType: TerminalType): string {
    switch (terminalType) {
        case TerminalType.CMD:
            return 'コマンドプロンプト';
        case TerminalType.PowerShell:
            return 'PowerShell';
        case TerminalType.GitBash:
            return 'Git Bash';
    }
}

/**
 * 待機用ヘルパー関数
 */
function sleep(ms: number): Promise<void> {
    return new Promise(resolve => setTimeout(resolve, ms));
}

extension.ts（コマンド登録）

import * as vscode from 'vscode';
import { runInCmd, runInPowerShell, runInGitBash } from './macros/runInTerminal';

export function activate(context: vscode.ExtensionContext) {
    console.log('my-macros extension is now active');

    // コマンド登録
    const commands = [
        // ターミナル実行
        vscode.commands.registerCommand('myMacros.runInCmd', runInCmd),
        vscode.commands.registerCommand('myMacros.runInPowerShell', runInPowerShell),
        vscode.commands.registerCommand('myMacros.runInGitBash', runInGitBash),
    ];

    commands.forEach(command => context.subscriptions.push(command));
}

export function deactivate() {}

package.json（設定ファイル）

{
  "name": "my-macros",
  "displayName": "My Macros",
  "version": "0.0.2",
  "contributes": {
    "commands": [
      {
        "command": "myMacros.runInCmd",
        "title": "Run in Command Prompt",
        "category": "My Macros"
      },
      {
        "command": "myMacros.runInPowerShell",
        "title": "Run in PowerShell",
        "category": "My Macros"
      },
      {
        "command": "myMacros.runInGitBash",
        "title": "Run in Git Bash",
        "category": "My Macros"
      }
    ],
    "keybindings": [
      {
        "command": "myMacros.runInCmd",
        "key": "ctrl+shift+1",
        "when": "editorTextFocus"
      },
      {
        "command": "myMacros.runInPowerShell",
        "key": "ctrl+shift+2",
        "when": "editorTextFocus"
      },
      {
        "command": "myMacros.runInGitBash",
        "key": "ctrl+shift+3",
        "when": "editorTextFocus"
      }
    ]
  }
}

コードの詳細解説

1. Enum定義

export enum TerminalType {
    CMD = 'cmd',
    PowerShell = 'powershell',
    GitBash = 'gitbash'
}

ポイント：

• 型安全にターミナルタイプを管理
• 文字列のタイポを防止
• IntelliSenseが効く

2. コマンド取得ロジック

function getCommandsToExecute(editor: vscode.TextEditor): string[] {
    const selection = editor.selection;
    
    // 選択されている場合
    if (!selection.isEmpty) {
        const selectedText = document.getText(selection);
        const lines = selectedText.split(/\r?\n/);
        
        return lines
            .map(line => line.trim())
            .filter(line => line.length > 0);
    }
    
    // 未選択の場合は現在行
    const currentLine = document.lineAt(selection.active.line);
    return currentLine.text.trim().length > 0 ? [currentLine.text.trim()] : [];
}

機能：

• 選択範囲の検知
• 行単位で分割
• 空行の自動除外
• trim()でホワイトスペース除去

3. ターミナル管理

function getOrCreateTerminal(terminalType: TerminalType): vscode.Terminal {
    const terminalName = getTerminalName(terminalType);
    
    // 既存ターミナルを検索
    const existingTerminal = vscode.window.terminals.find(
        t => t.name === terminalName
    );

    if (existingTerminal) {
        return existingTerminal;
    }

    // 新規作成
    return createTerminal(terminalType);
}

メリット：

• ターミナルの再利用
• メモリ効率の向上
• ターミナルの乱立防止

4. 複数コマンドの順次実行

for (const command of commands) {
    terminal.sendText(command, true);
    if (commands.length > 1) {
        await sleep(100);  // 100ms待機
    }
}

100ms待機の理由：

• コマンドの確実な実行
• 先行コマンドの完了待ち
• ターミナルの処理負荷軽減

5. エディタ自動復帰とカーソル制御

// エディタをアクティブにする（単一行・複数行ともに）
await vscode.commands.executeCommand('workbench.action.focusActiveEditorGroup');

if (isSingleCommand) {
    // １行コマンド: 次の行の先頭にカーソルを移動
    const nextLine = currentLine + 1;
    if (nextLine < editor.document.lineCount) {
        const newPosition = new vscode.Position(nextLine, 0);
        editor.selection = new vscode.Selection(newPosition, newPosition);
        editor.revealRange(new vscode.Range(newPosition, newPosition));
    }
} else {
    // 複数行コマンド: 行頭（char 0）かどうかでカーソル制御を分岐
    if (currentChar > 0) {
        // 行中の場合は選択範囲の次の行へ移動
        const nextLine = selectionEndLine + 1;
        if (nextLine < editor.document.lineCount) {
            const newPosition = new vscode.Position(nextLine, 0);
            editor.selection = new vscode.Selection(newPosition, newPosition);
            editor.revealRange(new vscode.Range(newPosition, newPosition));
        }
    } else {
        // 行頭の場合は選択解除のみ（カーソル移動なし）
        const currentPosition = new vscode.Position(currentLine, currentChar);
        editor.selection = new vscode.Selection(currentPosition, currentPosition);
    }
}

機能のポイント：

• 単一行・複数行ともに実行後エディタに自動復帰
• 単一行: 次の行の先頭にカーソルが移動（連続実行に最適）
• 複数行（行頭から選択開始の場合）: 選択解除のみ（カーソル移動なし）
• 複数行（行中から選択開始の場合）: 選択範囲の次の行へ移動

メリット：

• コマンドを順番に実行する際、エディタとターミナルの切り替えが不要
• カーソルが自動で次の行に移動するため、テンポよく連続実行できる
• 複数行実行後も即座に次の操作に移れる

使い方

基本的な使い方

1. 単一コマンドの実行

# test_commands.txt
npm run dev

1. カーソルを行に配置
2. Ctrl+Shift+2（PowerShellで実行）
3. → PowerShellが開いて自動実行！
4. → 自動的にエディタにフォーカスが戻り、カーソルが次の行へ移動

新機能のメリット：

• コマンドを連続実行する際、エディタとターミナルの切り替え不要
• カーソルが自動で次の行に移動するため、テンポよく実行できる
• １行ずつ確認しながら実行するワークフローに最適

2. 複数コマンドの実行

# deploy.txt
cd /d C:\projects\my-app
git pull origin main
npm install
npm run build
npm run deploy

1. 全行を選択（Ctrl+A）
2. Ctrl+Shift+1（CMDで実行）
3. → 5つのコマンドが順次実行！
4. → 実行後、エディタにフォーカスが自動復帰

動作の違い：

• １行コマンド: 実行後、エディタに自動復帰してカーソルが次の行へ
• 複数行（行頭から選択）: 実行後、エディタに自動復帰して選択解除のみ（カーソル移動なし）
• 複数行（行中から選択）: 実行後、エディタに自動復帰して選択範囲の次の行へ移動

実践的な活用例

開発環境セットアップ

# setup_dev.txt
cd /d C:\projects
git clone https://github.com/user/repo.git
cd repo
npm install
code .

選択 → Ctrl+Shift+1で一括セットアップ！

定型作業の自動化

# daily_tasks.txt
cd /d C:\projects\app
git fetch origin
git status
npm run test

毎朝Ctrl+Shift+1で健全性チェック！

Docker操作

# docker_commands.txt
docker-compose down
docker-compose build
docker-compose up -d
docker-compose logs -f

Ctrl+Shift+2で一括操作！

キーバインドのカスタマイズ

keybindings.json での変更

// ショートカットキーを変更
[
    {
        "key": "ctrl+alt+1",
        "command": "myMacros.runInCmd",
        "when": "editorTextFocus"
    },
    {
        "key": "ctrl+alt+2",
        "command": "myMacros.runInPowerShell",
        "when": "editorTextFocus"
    },
    {
        "key": "ctrl+alt+3",
        "command": "myMacros.runInGitBash",
        "when": "editorTextFocus"
    }
]

コンテキストによる制限

// Markdownファイルでのみ有効
{
    "key": "ctrl+shift+1",
    "command": "myMacros.runInCmd",
    "when": "editorTextFocus && resourceExtname == '.md'"
}

// 特定のワークスペースでのみ有効
{
    "key": "ctrl+shift+1",
    "command": "myMacros.runInCmd",
    "when": "editorTextFocus && workspaceFolderCount > 0"
}

メリット・デメリット

メリット

1. 圧倒的な時短効果

• コピペ操作の削減: 5ステップ → 1ステップ
• よく使うコマンドを即実行
• 複数コマンドも一括処理
• １行コマンド実行後の自動エディタ復帰で連続実行がスムーズ

2. コマンド集の一元管理

• .txt または .md で管理
• プロジェクトごとにファイル作成
• Gitで履歴管理

3. ターミナルの使い分けが簡単

• cmd/PS/Bashを自在に切替
• ターミナル固有のコマンドも対応
• ターミナルの再利用で効率化

4. 学習コストが低い

• 直感的な操作
• 既存のメモをそのまま活用
• エディタ感覚で編集可能

デメリット

1. 初期セットアップが必要

• TypeScript環境の構築
• 拡張機能のインストール

2. 対話的なコマンドは非対応

• npm init などの入力待ちコマンド
• ssh でのパスワード入力

3. エラーハンドリングが弱い

• コマンド失敗時も次へ進む
• 自動リトライ機能なし

総評

デメリットを大きく上回る効率化が可能

特に、頻繁にコマンド実行する開発者には必須の機能です。

応用テクニック

1. プロジェクト別コマンド集

project-commands/
├── backend/
│   ├── dev.txt
│   ├── test.txt
│   └── deploy.txt
└── frontend/
    ├── dev.txt
    ├── build.txt
    └── deploy.txt

使い方：

1. dev.txtを開く
2. Ctrl+A → Ctrl+Shift+2
3. → 開発環境が起動！

2. エイリアス定義ファイル

# aliases.txt（Git Bash用）
alias ll='ls -la'
alias gs='git status'
alias gp='git pull'
alias gb='git branch'

起動時にCtrl+Shift+3で一括登録！

3. 環境変数設定

# env_setup.ps1（PowerShell用）
$env:NODE_ENV="development"
$env:API_KEY="your-api-key"
$env:DEBUG="true"

Ctrl+Shift+2で環境変数を一括設定！

4. ドキュメント化

# コマンド集

## 開発環境起動
cd /d C:\projects
npm run dev

## ビルド
npm run build

## デプロイ
npm run deploy

Markdownで管理 + 実行可能！

トラブルシューティング

Git Bashが起動しない

エラー：

Failed to launch terminal

解決策：VSCode設定でパスを指定する

Git Bashが C:\Program Files\Git 以外の場所（AppData\Local 等）にインストールされている場合は、VSCode設定でパスを指定してください。

Ctrl+, → 検索欄に「myMacros.gitBash」と入力
→ Git Bash Path 欄に bash.exe のフルパスを入力

設定例：

C:\Users\ユーザー名\AppData\Local\Programs\Git\bin\bash.exe

パスの探索順序：

1. myMacros.gitBashPath 設定値（指定がある場合のみ）
2. C:\Program Files\Git\bin\bash.exe
3. C:\Program Files (x86)\Git\bin\bash.exe

コマンドが実行されない

原因1: 空行が含まれる
→ trim() と filter() で除外済み

原因2: ターミナルが閉じている
→ 自動で再作成されるはずだが、手動で閉じた場合は再実行

原因3: パスに空白が含まれる

# NG
cd C:\Program Files\app

# OK
cd "C:\Program Files\app"

複数コマンドが途中で止まる

原因: コマンド実行時間が長い

解決策: 待機時間を調整

// 100ms → 500msに変更
if (commands.length > 1) {
    await sleep(500);
}

キーバインドが効かない

確認ポイント：

1. when条件の確認

"when": "editorTextFocus"
// エディタにフォーカスがあるか？

2. 競合の確認

Ctrl+Shift+P → "Preferences: Open Keyboard Shortcuts"
→ Ctrl+Shift+1で検索

3. 拡張機能の有効化確認

Ctrl+Shift+P → "Extensions: Show Installed Extensions"
→ My Macros が有効か確認

パフォーマンス最適化

ターミナルの再利用

// ターミナル名で識別して再利用
function getOrCreateTerminal(terminalType: TerminalType): vscode.Terminal {
    const terminalName = getTerminalName(terminalType);
    
    const existingTerminal = vscode.window.terminals.find(
        t => t.name === terminalName
    );

    return existingTerminal || createTerminal(terminalType);
}

メリット：

• 新規作成のオーバーヘッド削減
• 環境変数の保持
• 作業ディレクトリの維持

非同期処理の最適化

// 並列実行は避ける（コマンドの依存関係のため）
for (const command of commands) {
    await terminal.sendText(command, true);
    // 順次実行を保証
}

まとめ

VSCodeでショートカット一発でターミナル実行できるTypeScriptマクロを実装しました。

得られる効果：

• コマンド実行が5ステップ → 1ステップに
• よく使うコマンドを即座に実行
• 複数コマンドの一括実行
• cmd/PowerShell/Git Bashの使い分けが簡単

こんな人に最適：

• 頻繁にコマンド実行する開発者
• コマンドをメモ帳管理している人
• 作業を効率化したい人
• 複数のターミナルを使い分ける人

次のステップ：

1. 環境構築（TypeScript + VSCode拡張）
2. コード実装（この記事のコードをコピー）
3. パッケージ化してインストール
4. よく使うコマンド集を作成
5. ショートカットで爆速実行！

ぜひ実装して、開発効率を劇的に向上させてください！

Amazon検索[本 TypeScript]

関連記事

TypeScript拡張機能の開発環境構築

VSCode TypeScriptマクロ開発環境の完全ガイド【セットアップから運用まで】

はじめにVSCodeでカスタムマクロを作成したいけど、どうやって開発環境を構築すればいいか分からない。そんな悩みを持つ方に向けて、TypeScriptでVSCode拡張機能を開発する環境の構築から、実際にマクロを作成して使えるようにするまで...

caymezon.com

2026.01.25

サクラエディタからVSCodeへのマクロ移行

サクラエディタからVSCodeへマクロ移行！快適開発環境の構築記録

はじめに長年愛用してきたサクラエディタのマクロ機能。便利なJavaScript/VBSマクロを多数作成して日常業務で活用してきましたが、最近のAWS開発やブログ執筆でVSCodeを使う機会が増えてきました。「VSCodeでもサクラエディタの...

caymezon.com

2026.01.25

タグ: #VSCode #TypeScript #マクロ #ターミナル #コマンド実行 #生産性向上 #自動化

The post VSCodeでショートカット一発でターミナル実行！TypeScriptマクロ実装完全ガイド first appeared on CayTech Lab.