はじめに

「AWS Kiroをインストールしたけど、何から始めればいいか分からない…」

「VibeとSpecの使い分けが分からない。Hookって何？Steeringって何？」

Kiroは多機能なAgentic IDEですが、機能が多すぎて最初は戸惑いがちです。本記事では、Kiroで何ができるのか・各機能をどう使えばいいかを、初心者でも確実に分かるよう段階的に解説します。

2026年6月時点の情報： KiroはPreviewを経て2025年11月に正式GA（一般提供）を達成。Kiro CLI・チームプラン・GitLabサポートなどが追加されています。2026年5月〜6月には新プラン「Kiro Pro Max」追加・CLI v3プレビュー・自動スケジュール実行機能などが追加されました。

Kiroのインストール・基本セットアップについては以下を参照してください。

• AWS Kiro完全ガイド

AWS Kiro完全ガイド｜Agentic IDEの全貌とは【セットアップ・料金・機能まで】【2026年6月版】

はじめに「Claude CodeやCodex CLIのようなAI開発ツールはターミナル操作が必要で難しい…」「AWSを使った開発をもっとスマートにしたい。IDEでAIに設計から実装まで任せたい…」そんな悩みに応えるのがAWS Kiroです。...

caymezon.com

2026.04.12

この記事で分かること

• VibeモードとSpecモードの詳細な使い分け
• Steering（プロジェクトルール）の設定方法
• Hook（自動化トリガー）の具体的な設定例
• Skills（カスタムコマンド）の作り方
• Powers（MCPの自動化）の活用法
• Kiro CLIの概要
• 個人利用における注意点・コスト管理

機能カテゴリの全体像

Kiroの機能は大きく6つに分類されます。

■ チャット（対話）
├─ Vibeモード  ← 即時実装・質問・解析向け
└─ Specモード  ← 要件→設計→実装の体系的開発向け

■ プロジェクトルール管理
└─ Steering    ← 常時・条件付きのルールを定義

■ 自動化
└─ Hook        ← ファイル操作に反応して自動実行

■ カスタマイズ
└─ Skills      ← 独自スラッシュコマンドを登録

■ 拡張性
└─ Powers      ← MCPを必要なときだけ自動起動

■ ターミナル
└─ Kiro CLI   ← ターミナルからエージェント実行（2025年11月GA追加）

【基本】チャットで使う

まずVibeモードから始めよう

Kiroのチャットパネルを開き、新しいセッションを開始する際にVibeモードを選択します。

Claude CodeやChatGPTと同じ感覚で、日本語で指示するだけです。

使用モデルの選択： VibeモードではClaude Sonnet 4.5（信頼性の高い高度なコーディング・推論向け）、Claude Opus 4.8（1Mコンテキスト・自己検証強化で長期プロジェクト向け）、またはAuto（品質・レイテンシ・コストを最適化する複数モデルの自動選択）を選べます。

よく使う指示例：

# ファイル解析・質問
> このSpring Bootアプリの認証ロジックを説明して

# コード修正
> src/main/java/Service.javaのバグを修正して

# 機能追加
> ユーザー一覧APIにページネーションを追加して

# ドキュメント生成
> このクラスのJavadocコメントを追加して

# インフラ
> EC2インスタンスにS3アクセス権限を付与するIAMロールを作成して

ポイント： 最初にSteeringファイル（後述）で「常に日本語で応答すること」を設定しておくと、毎回指示する必要がなくなります。

【応用】Specモードで仕様駆動開発

Specモードとは

「何を作るか」をAIと一緒に整理してから実装するモードです。以下のようなケースで真価を発揮します。

• 新機能をゼロから作る
• 複数のファイルにまたがる機能開発
• 後から「こんなつもりじゃなかった」を防ぎたい

Specモードの使い方：3ステップ

STEP 1: Specセッションを開始して指示を入力

新しいセッション起動時に「Spec」を選択し、作りたいものを伝えます。

> AWSのEC2上でApacheを動かし、S3に静的コンテンツを配置して
  CloudFrontで配信するWebサイト基盤をCloudFormationで構築したい

2つの開始アプローチ：

• Requirements-First：要件定義から始め、ユーザーストーリーを確認してから設計に進む（デフォルト）
• Design-First：既にアーキテクチャが決まっている場合は設計書から始める
• Quick Plan：承認ゲートなしに要件・設計・タスクの3ファイルを一気に自動生成する高速モード

STEP 2: Requirements（要件）を確認・修正

KiroがEARS記法でユーザーストーリーと受け入れ条件を自動生成します。

# Requirements

## ユーザーストーリー
WHEN ユーザーがWebサイトにアクセスするとき
THEN CloudFront経由でS3の静的コンテンツが配信される

WHEN 管理者がEC2にSSM Session Managerで接続するとき  
THEN パブリックIPなしでセキュアにアクセスできる

## 受け入れ条件
- [ ] CloudFormationテンプレートで全リソースが定義されている
- [ ] SSLが有効化されている
- [ ] EC2へのSSH接続はIGW経由ではなくSSM経由のみ許可

「この受け入れ条件が足りない」「この条件は不要」など、ここで修正します。実装前に方向性を確認できるのがSpecモード最大のメリットです。

STEP 3: Design → Tasks → 実装

要件を確認したら、そのままDesign（設計書）→ Task list（実装タスク）→ 実装まで進みます。

.kiro/specs/web-infra/
├── requirements.md  ← 要件定義
├── design.md        ← アーキテクチャ設計
└── tasks.md         ← 実装チェックリスト

生成されたタスクを一つずつ実行していき、チェックボックスで進捗管理できます。

タスクの並列実行（Wave）： Kiroはタスク間の依存関係を自動分析し、独立したタスクを「Wave（波）」にグループ化して並列実行します。複数ファイルにまたがる実装でも実装時間を大幅に短縮できます。

Specモードの使いどころ

【設定】Steeringでプロジェクトルールを定義

Steeringとは

毎回「日本語で答えて」「コメントは右側に書いて」と指示するのは面倒です。Steeringはこれを一度設定するだけで永続的に効かせる機能です。

基本的なSteeringファイルの作成

.kiro/steering/ 配下にMarkdownファイルを作成します。

日本語・コーディング規約の設定（例）：

---
inclusion: always
---

# プロジェクトルール

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

## コーディング規約
- コメントはコードの右側に記述すること
- AWSリソース名はケバブケース（例: web-server-ec2）で統一すること
- CloudFormationテンプレートはYAML形式で記述すること

このファイルを置くだけで、以降のすべてのセッションで自動的に適用されます。

Steeringの4つのinclusionモード活用例

① always（常時）

---
inclusion: always
---

コーディング規約・言語設定など、常に守ってほしいルールに使います。

② fileMatch（条件付き：ファイルパターン一致時）

---
inclusion: fileMatch
fileMatchPattern: "**/*.tf"
---

# Terraformルール
- リソース名はスネークケースで統一
- AWS providerのバージョンは必ず固定すること

Terraformファイルを操作するときだけ読み込まれます。Spring BootのJavaファイルには適用されません。

③ manual（手動参照）

---
inclusion: manual
---

# トラブルシューティングガイド
（デバッグ手順など長大なガイドを記述）

チャット内で #トラブルシューティングガイド と参照したときだけ読み込まれます。常時ロードしてコンテキストを無駄遣いしません。

④ auto（自動マッチング）

---
inclusion: auto
name: aws-security
description: AWSセキュリティのベストプラクティスとIAM設計ガイド
---

「IAMポリシーを作って」などのセキュリティ関連のプロンプトを検知すると自動でロードされます。nameとdescriptionの両方が必須です。

⑤ グローバルSteeringルール

~/.kiro/steering/ に配置すると、すべてのワークスペースに横断して適用されます。個人の作業スタイルや言語設定など、プロジェクトを問わず守りたいルールに使います。

優先順位： ワークスペース（.kiro/steering/）の設定がグローバル（~/.kiro/steering/）の設定を上書きします。同じルールが競合した場合はプロジェクト固有の設定が優先されます。

標準Steeringファイルの自動生成

KiroはSteeringセクションで「Generate Steering Docs」ボタンをクリックすると、プロジェクトを解析して以下の3ファイルを自動生成します。

.kiro/steering/
├── product.md    ← 製品の目的・ターゲット・主要機能
├── tech.md       ← 技術スタック・フレームワーク・バージョン
└── structure.md  ← ディレクトリ構造・命名規則

既存プロジェクトの解析・ドキュメント化にも活用できます。

【自動化】Hookを設定する

Hookとは

「ファイルを保存するたびにテストが自動で走る」「コードを書いたら自動でドキュメントが更新される」——Hookはこういった繰り返し作業を自動化する仕組みです。

Hookのトリガーイベント一覧

Hookは以下のIDEイベントに反応して起動します。

Hookの設定方法

KiroのHookセクション（Kiro Panel → Agent Hooks）から「New Hook」を選択します。自然言語での説明から自動生成するか、手動で各フィールドを入力します。コマンドパレット（Cmd/Ctrl + Shift + P → 「Kiro: Open Kiro Hook UI」）からも起動可能です。

設定例1: ファイル保存時にテスト自動実行

トリガー: TypeScriptファイルの保存時
実行内容: 変更ファイルに対応するテストを実行し、失敗があれば内容を報告してください

設定例2: 新しいAPIエンドポイント作成時にドキュメント更新

トリガー: src/controllers/ 配下のファイル作成時
実行内容: 作成されたコントローラーのAPIエンドポイントをdocs/api.mdに追記してください

設定例3: セキュリティスキャン

トリガー: .env以外のファイル保存時
実行内容: 変更ファイルにAPIキーやパスワードなどの機密情報がハードコードされていないか確認し、
          発見した場合は警告を出してください

設定はJSONファイルとして .kiro/hooks/ に保存されます。

HookはClaude Codeにない機能

Claude CodeやCodex CLIはすべて手動実行です。Kiroのみがファイル操作に反応して自動でAIエージェントをトリガーできます。品質チェックを「やり忘れる」リスクをゼロにできます。

【カスタマイズ】Skillsで独自コマンドを作る

Skillsとは

同じ作業を繰り返すなら、スラッシュコマンドとして登録しておきましょう。一度定義すれば / + コマンド名 で呼び出せます。

Skillsは**オープンスタンダード（Agent Skills Standard）**に準拠した移植可能なパッケージとして設計されており、コミュニティ間での共有・インポートが可能です。

Skillの作成手順

.kiro/skills/ 配下にフォルダを作成し、SKILL.md を置きます。追加のファイルも配置できます。

.kiro/skills/
└── review-pr/
    ├── SKILL.md        ← 必須
    ├── scripts/        ← オプション：実行スクリプト
    ├── references/     ← オプション：参照ドキュメント
    └── assets/         ← オプション：テンプレートなど

SKILL.md の例（PRレビュー用）：

---
name: review-pr
description: プルリクエストのコードレビューを行う。セキュリティ・パフォーマンス・可読性の観点で指摘する。
---

# PRレビュースキル

## レビュー観点
1. セキュリティ脆弱性（SQLインジェクション・XSS・認証漏れ）
2. パフォーマンス問題（N+1クエリ・不要なAPIコール）
3. コーディング規約の遵守
4. テストカバレッジ
5. エラーハンドリング

## 出力形式
- 重大度: 🔴 Critical / 🟡 Warning / 🟢 Info
- 指摘箇所: ファイル名と行番号
- 改善案: 具体的なコード例を提示

チャット入力欄で /review-pr と入力するだけでこのスキルが起動します。

SKILL.mdのname フィールド： 小文字・数字・ハイフンのみ（最大64文字）、フォルダ名と一致させる必要があります。descriptionは最大1024文字で、スキルを起動すべき状況を明確に記述します。

グローバルスキルの配置

~/.kiro/skills/ に置けば全プロジェクトで使えます。

~/.kiro/skills/
├── review-pr/      ← どのプロジェクトでも /review-pr が使える
└── analyze-arch/   ← どのプロジェクトでも /analyze-arch が使える

【拡張】Powersを活用する

Powersとは

MCP（Model Context Protocol）サーバーを必要なときだけ自動でアクティブ化する仕組みです。使わないMCPをすべてロードするとコンテキストが膨れ上がり、クレジットを無駄消費します。Powersはこれを解決します。

Powerは以下の3要素で構成されます：

1. POWER.md — 利用可能なMCPツールと起動タイミングを定義するファイル
2. MCPサーバー設定 — ツールと接続詳細
3. Steering/Hook（オプション） — IDEイベントやスラッシュコマンドで実行される自動タスク

主なPowersの種類

公式パートナーPowers（2026年6月時点）：

Datadog Powers    → アプリ・インフラの監視・調査時に自動起動
Dynatrace Powers  → オブザーバビリティ関連の調査時に自動起動
Figma Powers      → デザインデータの参照・実装時に自動起動
Neon Powers       → Neon PostgreSQLデータベース操作時に自動起動
Netlify Powers    → Netlifyデプロイ・設定操作時に自動起動
Postman Powers    → API設計・テスト時に自動起動
Supabase Powers   → Supabase（BaaS）操作時に自動起動
Stripe Powers     → 決済・サブスクリプション開発時に自動起動
AWS Aurora Powers → Amazon Auroraデータベース操作時に自動起動
Strands SDK Powers → AWS Strandsエージェント開発時に自動起動

コミュニティPowers：

GitHubのURLからコミュニティ製Powersもインストール可能です。Kiro内またはkiro.devで参照し、「インストール」をクリックするだけで登録できます（JSONファイルやコマンドラインの設定不要）。

AWSのツールではありますが、サードパーティサービス向けのPowersも広く利用可能です。

【ターミナル】Kiro CLIを使う

Kiro CLIとは

2025年11月のGA時に追加された、ターミナルからKiroエージェントを操作する機能です。IDEを使わずにコマンドラインでKiroのすべての機能（Spec・Steering・Hook・Skillsなど）を利用できます。

主な用途：

# 機能実装の自動化
kiro "src/api/users.tsにページネーション機能を追加して"

# バグ解析・修正提案
kiro "エラーログを解析して修正案を提示して"

# ワークフロー自動化（CI/CDパイプライン組み込みなど）
kiro "テストを実行してカバレッジレポートを生成して"

Kiro CLI 2.0（2026年4月）の主な強化点：

• Windows Terminalの正式サポート
• ヘッドレスモード（UIなしでの自動実行）
• サブエージェントによる複雑タスクの並列委譲
• 組み込みPlanエージェント（複雑タスクを段階的な実装計画に分解）
• マルチセッション管理（インタラクティブなセッション選択UI）

Kiro CLI v3（2026年5月〜 プレビュー）：

• 仕様駆動開発（Spec）とタグベースのエージェント設定を導入
• IDE・Webと同じ統合ハーネスで動作し、一貫した開発体験を提供
• GitLabリポジトリ対応（個人アクセストークンで接続）
• 自動スケジュール機能：GitHubやGitLabリポジトリを指定してタスクを記述するだけで、定期的な作業の自動実行とプルリクエスト生成が可能

インストール： curl -fsSL https://cli.kiro.dev/install | bash（macOS・Linux・Windows対応）

超便利な使い方ベスト3

第1位: AWSハンズオンをSpecモードで一から構築

「こんなAWS構成を作りたい」と伝えるだけで、要件定義→CloudFormationテンプレート作成→デプロイ手順書まで自動生成されます。

> VPC内にパブリック・プライベートサブネットを作り、
  EC2（Apacheサーバー）+ RDS MySQL（Multi-AZ）の
  基本的なWebアプリ構成をCloudFormationで構築したい

要件確認ステップで「SSMによる接続も含めてほしい」「NAT Gatewayも追加して」と追加要求して精度を上げ、そのまま実装まで完結できます。

第2位: Hookで品質チェックを完全自動化

ファイル保存のたびに以下が自動で走る環境を構築しておくと、「テスト書き忘れ」「ドキュメントが古い」問題がなくなります。

保存トリガー → 関連テスト実行
作成トリガー → Javadocコメント自動追加
削除トリガー → 依存関係チェック

第3位: Steeringで「いつでも同じクオリティ」を維持

チームのコーディング規約・命名規則・禁止事項をSteeringに書いておけば、誰がKiroを使っても同じ基準でコードが生成されます。

---
inclusion: always
---

# チーム共通ルール
- 日本語でコメント・ドキュメントを記述する
- awsのリソースIDは環境変数から取得すること（ハードコード禁止）
- IAMポリシーは最小権限の原則を守ること

このファイルをGitでコミットしておけば、チーム全員が同じルールでKiroを使えます。

個人利用における注意点

1. クレジット消費を把握する

2026年6月時点のプラン構成：

• 超過分は $0.04/クレジット で追加課金
• 新規登録でソーシャルログインまたはBuilder IDを使用すると、最初の有料プランアップグレード時に$20クレジットが付与される
• クレジットは翌月に繰り越しされない

クレジットを節約するコツ：

✅ Autoモードは品質・レイテンシ・コストを自動最適化
✅ Claude Sonnet 4.5は高精度な推論が必要なタスク向け
✅ Hooksの自動実行が多いと気づかずクレジットを消費する
   → 頻度が高いHookはAutoモードで実行しコストを抑える

2. 機密情報を除外する

.kiroignore ファイルを作成し、Kiroに読み込ませたくないファイルを除外します。

# .kiroignore
.env
.env.*
secrets/
credentials.json
*.pem
*.key

3. プロジェクト外ファイルへのアクセスは制限される

KiroはVSCodeで開いたワークスペース内のファイルしか扱えません。参照したいファイルが別のプロジェクトにある場合は、マルチルートワークスペースでフォルダを追加してください。

VSCode: ファイル → ワークスペースにフォルダを追加

4. Specモードはアウトプットの確認が必要

Specモードで生成されたRequirementsはAIが推測して書いたものです。特に「受け入れ条件」はビジネス要件を正確に反映していない場合があります。必ず確認・修正してから設計・実装フェーズに進んでください。

まとめ

AWS Kiroの主要機能を整理すると：

使い始めのおすすめ順序：

1. まずVibeモードで使ってみる
2. Steeringに日本語設定と規約を書く
3. よく使う作業をSkillsに登録する
4. 自動化したい品質チェックをHookに設定する
5. 大きな機能開発でSpecモードを試す
6. CI/CDへの組み込みや自動化にはKiro CLIを活用する

関連記事：

• AWS Kiro完全ガイド｜Agentic IDEの全貌とは【セットアップ・料金・機能まで】

AWS Kiro完全ガイド｜Agentic IDEの全貌とは【セットアップ・料金・機能まで】【2026年6月版】

はじめに「Claude CodeやCodex CLIのようなAI開発ツールはターミナル操作が必要で難しい…」「AWSを使った開発をもっとスマートにしたい。IDEでAIに設計から実装まで任せたい…」そんな悩みに応えるのがAWS Kiroです。...

caymezon.com

2026.04.12

• AWS Kiro vs Claude Code vs Codex CLI徹底比較

AWS Kiro vs Claude Code vs Codex CLI｜IDE・CLI徹底比較【Kiroだけができること一覧】【2026年6月版】

はじめに「Claude Code、Codex CLI、そしてKiro——どれを選べばいいのか分からない…」AIを使った開発ツールが乱立する2026年、三者の違いを正確に理解している人は意外と少ないです。特に「Kiroだけにできて、Claud...

caymezon.com

2026.04.12

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

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

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

caymezon.com

2026.02.14

タグ: #Kiro #AWSKiro #使い方 #Spec #Vibe #Hook #Steering #Skills #開発効率化 #初心者

The post AWS Kiroの使い方完全解説｜Spec・Vibe・Hook・Steering全機能を初心者向けに徹底解説【何ができる？】 first appeared on CayTech Lab.

はじめに

Claude Skillsという機能、名前は聞いたことがあるけれど「自分には関係ない」と感じていませんか？

実はSkillsは、「Claudeをよく使う人ほど恩恵が大きい機能」 です。

でも「どんな時に使えばいいの？」というのが一番わかりにくい部分でもあります。

■ 検索ボリューム（2026年時点の推定）
- 10～100: "claude skills 例", "claude skills おすすめ"

この記事では、よくある利用シーン7パターン を具体的に解説します。「あ、これ自分のことだ」と感じたものがあれば、それがあなたにとってのSkill化のタイミングです。

「Skill化すべきサイン」チェックリスト

まず、以下の項目に当てはまるものはありますか？

• 同じ指示やプロンプトを1週間に3回以上コピペしている
• 「いつものやり方で」とClaudeに伝えることが多い
• チームで同じClaudeの使い方を揃えたいと思っている
• 間違えて実行されたくない重要な操作がある
• 複数ステップの作業を毎回手動で指示している

1つでも当てはまれば、Skills化が効きます。

パターン1：毎回同じ手順を繰り返している

こんな人に当てはまる

「GitHubにPRを出す前に、コードレビュー → テスト実行 → コミットメッセージ確認という手順を毎回Claudeに説明している」

Skill化するとどうなる

---
name: pre-pr-check
description: PRを出す前の事前チェックを実行する。Use when the user wants to
  prepare a pull request or before submitting code for review.
---

PRを出す前に以下を順番に確認してください：

1. 変更ファイルの一覧を確認（git diff --name-only）
2. テストを実行して全件グリーンか確認
3. コミットメッセージが規約に沿っているか確認
4. レビュアーへのコメント案を作成

/pre-pr-check と打つだけで全手順が流れます。

判断基準: 「また同じことを説明してるな」と感じた瞬間がSkill化のサイン

パターン2：長い説明をCLAUDE.mdに書いてしまっている

こんな人に当てはまる

「CLAUDE.mdにAPI設計の規約、コーディング規約、デプロイ手順、レビュー観点…と書き続けたら300行を超えてしまった」

Skill化するとどうなる

CLAUDE.mdは「常に適用されるルール」だけに絞り、デプロイ手順や詳細なレビュー観点はSKILL.mdに移すと、コンテキストの無駄遣いが減ります。

CLAUDE.md   → 言語設定、基本方針、短いルール（50行以内が理想）
SKILL.md    → デプロイ手順、詳細なコーディングガイド、長い手順書

判断基準: CLAUDE.mdが100行を超えてきたら、手順系はSKILL.mdへ移す検討を

パターン3：チームで作業の品質にバラつきが出ている

こんな人に当てはまる

「コードレビューの観点が人によって違う。Aさんはセキュリティ重視、BさんはパフォーマンスのみでOKを出してしまっている」

Skill化するとどうなる

.claude/skills/code-review/SKILL.md をgitリポジトリに追加するだけで、チーム全員が /code-review を使うと同じ観点・同じ品質でレビューできるようになります。

---
name: code-review
description: コードレビューを実施する。Use when reviewing code changes or
  pull requests.
---

以下の観点でコードをレビューしてください：

## セキュリティ
- 入力値のバリデーションはされているか
- 認証・認可の漏れはないか
- SQLインジェクション、XSSのリスクはないか

## パフォーマンス
- N+1クエリが発生していないか
- 不要なループや重複処理はないか

## 可読性
- 変数名・関数名が意図を伝えているか
- コメントは必要な箇所に書かれているか

判断基準: チームで「このやり方で統一しよう」と決めた作業はプロジェクトSkill化が最適

パターン4：間違えて実行されたくない重要な操作がある

こんな人に当てはまる

「デプロイコマンドを自動実行する設定にしていたら、開発環境向けコマンドが本番に流れてヒヤッとした」

Skill化するとどうなる

---
name: deploy-production
description: 本番環境へデプロイする
disable-model-invocation: true   ← ユーザーが明示的に呼ばない限り絶対に起動しない
allowed-tools: Bash
---

本番環境へのデプロイを実行します：
$ARGUMENTS（staging / production）

1. テストスイートが全件グリーンであることを確認
2. ステージングでの動作確認を確認
3. デプロイコマンドを実行
4. デプロイ後のヘルスチェックを確認

disable-model-invocation: true を設定すると、Claudeが「デプロイの話をしているな」と判断しても絶対に自動起動しません。/deploy-production と自分で打った時だけ動きます。

判断基準: 「うっかり実行されたら困る」操作は必ず disable-model-invocation: true を付ける

パターン5：複数ステップの調査・分析作業を繰り返している

こんな人に当てはまる

「バグ報告が来るたびに『ログ確認 → 関連ファイル検索 → 原因候補の列挙 → 修正案の提示』という手順を毎回Claudeに指示している」

Skill化するとどうなる

---
name: investigate-bug
description: バグを調査して原因と修正案を提示する。Use when a bug is reported
  or something is not working as expected.
argument-hint: [bug-description]
---

以下の手順でバグを調査してください：

## 調査対象
$ARGUMENTS

1. エラーログを確認（logs/ ディレクトリを検索）
2. エラーメッセージに関連するファイルを特定
3. コードを読んで原因候補を3つ列挙
4. 各候補の修正案を提示
5. 最も可能性が高い原因と推奨対応を最後にまとめる

/investigate-bug ログインボタンを押すと500エラーになる と一言で全プロセスが走ります。

判断基準: 「いつもこの手順で調査してるな」という作業はSkill化の候補

パターン6：特定のフォーマットで毎回アウトプットを出している

こんな人に当てはまる

「週次レポートをまとめる時、毎回『この形式で出してください』とフォーマットを貼り付けてからClaudeに依頼している」

Skill化するとどうなる

---
name: weekly-report
description: 週次レポートを作成する。Use when creating a weekly summary,
  progress report, or status update.
argument-hint: [対象期間]
---

以下のフォーマットで週次レポートを作成してください：

---
## 週次レポート：$ARGUMENTS

### 今週の成果
- （箇条書きで3〜5件）

### 来週の予定
- （箇条書きで3〜5件）

### 課題・ブロッカー
- （なければ「なし」と記載）

### 数値実績
| 指標 | 目標 | 実績 | 達成率 |
|------|------|------|--------|
---

/weekly-report 2026年3月第4週 だけで指定フォーマット通りのレポートが完成します。

判断基準: 「毎回このフォーマットで」と言っている場合はSkill化が有効

パターン7：大量のファイルを横断して調査・変換する作業がある

こんな人に当てはまる

「古い書き方のコードを新しい書き方に全部変換したい。でも100ファイルあって手動では無理」

Skill化するとどうなる

組み込みの /batch スキルがこのケースに最適です。

/batch 全ファイルのコールバック関数をasync/awaitに書き換えてください

/batch スキルが自動で：

1. コードベース全体を調査
2. 対象ファイルを特定
3. 作業を独立したユニットに分割（5〜30個）
4. 並列で一括変換
5. 各変更にPRを作成

大規模な一括変換が /batch 一発で完結します。

判断基準: 「同じ変換を大量ファイルに適用したい」は /batch の出番

シーン別・使い分けクイックガイド

まとめ：Skill化のタイミングを見極める3つの問い

Skill化すべきかどうか迷ったら、以下の3つを自問してみてください。

1. 「また同じ説明をしているか？」 → Yes なら Skill 化
2. 「チームで統一したい作業か？」 → Yes なら プロジェクトSkill
3. 「間違えて実行されたら困るか？」 → Yes なら disable-model-invocation: true

Skillsは「作るのが大変そう」に見えて、実はシンプルなテキストファイル1つから始められます。まずは 既存のCLAUDE.mdから1つの手順を切り出してSKILL.mdにする だけでも十分な効果があります。

関連記事

Skillsの仕組み・SKILL.mdの書き方・環境構築手順など、基礎から網羅した完全ガイドはこちら。

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

-->

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

はじめに

「Claudeを使ってみたいけど、Web版・Desktop版・Claude Codeって何が違うの？」

Anthropicが提供するClaude AIには複数の製品があり、初めて触れる方はどれを使えばいいか迷うことが多いです。この記事では、Claude AIの全製品ファミリーを一覧で比較し、あなたに最適な選択肢を明確にする完全入門ガイドです。

Claude AIとは？製品ファミリーの全体像

Claude AIはAnthropicが開発した大規模言語モデルです。2026年4月現在、以下の利用形態があります。

【製品の位置づけ】

Claude Web版
  → 誰でもすぐ使える。ブラウザで完結。

Claude Desktop版
  → MCPで外部ツール連携。ローカルファイル操作が強い。

Claude Code
  → ターミナルから直接コーディング。開発者向け最強ツール。

Claude Cowork（2026-04-09 GA）
  → チームで長時間タスクを並列実行。エンタープライズ向け。

Claude Design（2026-04-17 リサーチプレビュー）
  → プロンプトからプロトタイプ・スライドをビジュアル生成。

Claude API
  → 自分のアプリやスクリプトにClaudeを組み込む。

【比較表】Web版 vs Desktop版 vs Claude Code

基本スペック比較

GitHub連携の違い（詳細）

Web版・Desktop版どちらでGitHubを使うべきか、詳しい比較はこちら：

【2026年版】Claude Web版 vs Desktop版 完全比較 - GitHub連携の設定から使い分けまで徹底解説

はじめに「Claude Web版とDesktop版って何が違うの？」Claudeを使い始めた多くのユーザーが最初に抱く疑問です。特にGitHub連携に関しては、Web版とDesktop版で設定方法も機能も大きく異なります。この記事では、初心...

caymezon.com

2026.02.07

あなたに最適なClaudeはどれ？判断フロー

Claudeを使いたい
  ↓
コードを書く/開発作業が中心？
  ├─ YES → ターミナル操作に慣れている？
  │         ├─ YES → Claude Code ✅（最も効率的）
  │         └─ NO  → Claude Desktop版 or Web版から始める
  │
  └─ NO → 設定の手間を避けたい？
            ├─ YES → Web版 ✅（今すぐ使える）
            └─ NO  → Desktop版 ✅（MCP連携で強力）

Web版が向いている人

✅ AIとの対話を手軽に試したい
✅ ブラウザ環境で完結させたい
✅ 複数デバイスから使いたい
✅ コーディング以外の用途が多い（文章作成、翻訳、分析等）
✅ まず無料で試したい

Desktop版が向いている人

✅ GitHubリポジトリを頻繁に参照・操作したい
✅ ローカルファイルへの直接アクセスが必要
✅ Notion・Slack・DBなど外部ツールとも連携したい（MCP）
✅ 長時間の安定した作業セッションが必要
✅ GUIで操作したい

Claude Codeが向いている人

✅ 本格的なコード開発・修正をAIと一緒に進めたい
✅ ターミナル操作に慣れている
✅ 複数ファイルの同時編集・リファクタリングをしたい
✅ CI/CDやスクリプトにAIを組み込みたい
✅ 開発速度を最大化したい

料金・プランについて

プラン比較

重要：使用量はすべてのClaudeで共有

Web版 + Desktop版 + Claude Code + Cowork + Design
                     ↓
                同じアカウント
                     ↓
         同じ使用量制限（レート制限で管理）

どの製品を使っていても、同じ使用量プールを共有する点に注意が必要です。使用量の上限はレート制限で管理されており、プランによって異なります。

各製品の詳細ガイドへのロードマップ

Claude Desktop版を使いたい方へ

Claude Desktopのインストールから、GitHub MCP連携・ベストプラクティスまで完全解説：

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

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

caymezon.com

2026.03.21

Claude Codeを使いたい方へ（開発者向け）

セットアップからコマンド習得・VSCode連携まで、Claude Codeの全てを体系的に学べます：

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

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

caymezon.com

2026.03.21

モデルの種類と使い分け

Claude AIには複数のモデルがあり、用途に応じて使い分けることでコストを最適化できます。

推奨: 日常的な作業はSonnet 4.6を使うことで、使用量の節約になります。

Claude AIの活用シーン一覧

開発・エンジニアリング

✅ コード生成・修正・リファクタリング
✅ バグの原因特定と修正
✅ コードレビューとセキュリティチェック
✅ テストコードの自動生成
✅ ドキュメント・README作成
✅ Git操作の自動化

コンテンツ制作・ブログ運営

✅ 記事のアイデア出しと構成案作成
✅ 技術記事の執筆支援
✅ SEOキーワードの分析
✅ 画像説明文の生成
✅ 翻訳・校正

データ分析・業務効率化

✅ CSVファイルの分析・集計
✅ レポートの自動生成
✅ スプレッドシートの数式作成
✅ 会議メモの要約
✅ メール文章の作成

よくある質問

Q: 無料プランでも十分使えますか？

A: 簡単な質問や文章作成には無料プランで十分です。ただし、Desktop版やClaude Codeを使うにはProプラン（$20/月）が必要です。

Q: Web版とDesktop版を両方使うことはできますか？

A: はい。多くのユーザーが両方を使い分けています。注意点として、使用量は共有されるため、一方で多く使うと他方の使用量が減ります。

Q: 日本語で使えますか？

A: はい、すべての製品で日本語が使えます。Claude CodeではCLAUDE.mdファイルに「常に日本語で応答すること」と書いておくと、毎回設定する手間が省けます。

Q: GitHubと連携するにはどうすればいいですか？

A: Web版とDesktop版で設定方法が異なります。詳しくは以下の記事を参照してください。
https://caymezon.com/claude-web-vs-desktop-github-integration-guide/

まとめ：Claude AI選び方チートシート

【とにかく今すぐ使いたい】
→ Web版（無料アカウント登録のみ）

【ファイル操作・GitHub連携を強化したい】
→ Claude Desktop版（Proプラン + GitHub MCP設定）

【開発効率を最大化したい】
→ Claude Code（Proプラン + ターミナル操作）

【チームで長時間・並列タスクをこなしたい】
→ Claude Cowork（Proプラン以上、2026-04-09 GA）

【プロトタイプ・スライドをAIで素早く作りたい】
→ Claude Design（Proプラン以上、リサーチプレビュー中）

【自分のアプリにAIを組み込みたい】
→ Claude API（APIキー取得）

各製品の詳細な使い方については、以下のロードマップ記事で体系的に学べます。

Claude Desktop完全攻略ロードマップ：

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

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

caymezon.com

2026.03.21

Claude Code完全攻略ロードマップ：

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

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

caymezon.com

2026.03.21

参考リンク

• Claude公式サイト
• Claude Desktop ダウンロード
• Claude公式ドキュメント
• Anthropic公式サイト

更新履歴

• 2026-03-21: 初版公開

The post 【2026年版】Claude AI完全入門ガイド｜Web版・Desktop版・Claude Codeの違いと選び方を徹底解説 first appeared on CayTech Lab.

⚠️ 【2026年6月18日 追記】Gemini CLI はサービス終了しました

Gemini CLI は 2026年6月18日をもってサービス終了となり、現在はインストール・利用ができません。本記事は歴史的な記録として残しています。代替のAIコーディングエージェントをお探しの方は Claude Code をご検討ください。

はじめに

2026年6月18日、Gemini CLI はサービス終了しました。 現在はインストール・利用ができません。

本記事は、Gemini CLI がサービス継続中だった 2026年4月時点の使い方ガイドとして残しています。操作感・設計思想の参考や、Claude Code など代替ツールへの移行の際にお役立てください。

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ならではの体験でした。

⚠️ 2026年6月18日にサービス終了しました。 現在は利用できません。同様のAIコーディングエージェントをお探しの方は Claude Code をご検討ください。

関連記事：

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

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

⚠️ 【2026年6月18日 追記】Gemini CLI はサービス終了しましたGemini CLI は 2026年6月18日をもってサービス終了となり、現在はインストール・利用ができません。本記事は歴史的な記録として残しています。代替のA...

caymezon.com

2026.02.21

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

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

⚠️ 【2026年6月18日 追記】Gemini CLI はサービス終了しましたGemini CLI は 2026年6月18日をもってサービス終了となり、現在は利用できません。本記事は歴史的な比較記録として残しています。AIコーディングエー...

caymezon.com

2026.02.21

タグ: #GeminiCLI #Gemini #Google #AI #VSCode #使い方 #開発効率化 #ターミナル

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

GitHubを始める前に

必要なもの

必須：

• GitHubアカウント（無料）
• Git（バージョン管理システム）
• テキストエディタ（VSCode推奨）

推奨：

• GitHub CLI（コマンドライン操作用）

アカウント作成

1. https://github.com にアクセス
2. Sign upをクリック
3. メールアドレス、パスワード、ユーザー名を入力
4. メール認証
5. 完了！

ユーザー名選びのポイント：

• 変更可能だが、推奨しない
• プロフィールURLになる：github.com/username
• 本名または認知されやすいID

GitHubの基本概念

リポジトリ（Repository）

プロジェクトを管理する単位です。

my-project/           ← リポジトリ
  ├── README.md       ← プロジェクト説明
  ├── index.html      ← ソースコード
  ├── style.css
  └── .gitignore      ← 管理対象外ファイル指定

コミット（Commit）

変更の記録単位です。

コミット1: 「初回作成」
コミット2: 「ログイン機能追加」
コミット3: 「バグ修正」

各コミットには誰が、いつ、何を変更したか記録されます。

ブランチ（Branch）

並行開発のための分岐です。

main（本番コード）
  ↓
develop（開発中）
  ↓
feature/login（ログイン機能開発中）

ブランチの詳しい使い方は「Git Branch戦略完全ガイド：チーム開発を成功させる実践パターン」をご覧ください。

リモートとローカル

ローカルリポジトリ（あなたのPC）
  ↕️ git push / git pull
リモートリポジトリ（GitHub）

ブラウザでの基本操作

リポジトリ作成

手順：

1. GitHubホーム右上の「+」
2. New repository
3. Repository name: my-first-repo
4. Public（公開）またはPrivate（非公開）
5. Add a README file: ✅チェック
6. Create repository

完了！ リポジトリが作成されました。

ファイル追加

Webインターフェースで：

1. Add file → Create new file
2. Name your file: hello.txt
3. 内容を入力
4. Commit new file

ローカルからプッシュ：

echo "Hello, GitHub!" > hello.txt

# Git管理に追加
git add hello.txt

# コミット
git commit -m "Add hello.txt"

# GitHubにプッシュ
git push origin main

Issue作成

バグ報告や機能要望を管理：

1. Issues タブ
2. New issue
3. タイトル: 「ログイン画面のバグ」
4. コメント: 詳細説明
5. ラベル: bug
6. Submit new issue

Pull Request

変更をマージする流れ：

1. ブランチで開発
2. Pull requests → New pull request
3. base: main ← compare: feature/login
4. Create pull request
5. レビュー待ち
6. Merge pull request

GUIとCLIでのリポジトリ作成の違いは「GitHubリポジトリ作成の2つの方法：GUI vs CLI徹底比較」で解説しています。

VSCodeでのGit操作

VSCodeはGitと深く統合されており、GUI操作で効率的に作業できます。

初期設定

Git設定確認：

git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"

VSCode拡張機能インストール：

• GitLens（推奨）
• GitHub Pull Requests

リポジトリをクローン

方法1：コマンドパレット

Ctrl+Shift+P（Macは Cmd+Shift+P）
→ Git: Clone
→ GitHubリポジトリURL入力
→ 保存先選択

方法2：統合ターミナル

git clone https://github.com/username/repo.git

ファイル変更とコミット

手順：

1. ファイルを編集
2. 左サイドバー「ソース管理」アイコン（またはCtrl+Shift+G）
3. 変更ファイルの「+」をクリック（ステージング）
4. メッセージ入力：「ログイン機能追加」
5. ✓（チェック）ボタンでコミット

複数ファイル一括ステージング：

Changes の「+」アイコンですべてステージング

ブランチ操作

ブランチ作成：

1. 左下のブランチ名クリック
2. 「新しいブランチを作成」
3. ブランチ名入力：feature/new-function

ブランチ切り替え：

1. 左下のブランチ名クリック
2. 切り替え先ブランチを選択

マージ：

1. mainブランチに切り替え
2. コマンドパレット → Git: Merge Branch
3. マージ元ブランチ選択

VSCodeでのGit操作の詳細は「VSCodeでGitを使いこなす：初心者から実務まで完全ガイド」をご覧ください。

プッシュとプル

プッシュ（ローカル → GitHub）：

方法1：ソース管理パネルの「...」→ プッシュ
方法2：Ctrl+Shift+P → Git: Push

プル（GitHub → ローカル）：

方法1：ソース管理パネルの「...」→ プル
方法2：Ctrl+Shift+P → Git: Pull

コンフリクト解決

発生条件：

同じファイルの同じ箇所を
別々に編集してマージしようとした場合

VSCodeでの解決：

1. コンフリクトファイルを開く
2. <<<<<<< HEAD と >>>>>>> feature の間に表示
3. 「Current Change」「Incoming Change」「Both」から選択
4. 保存してコミット

CLIでの効率的な操作

コマンドライン操作に慣れると、作業が格段に速くなります。

基本コマンド

リポジトリ作成とプッシュ：

# ローカルで初期化
mkdir my-project
cd my-project
git init

# ファイル作成
echo "# My Project" > README.md

# コミット
git add .
git commit -m "Initial commit"

# GitHubと接続
git remote add origin https://github.com/username/my-project.git
git push -u origin main

クローン：

git clone https://github.com/username/repo.git
cd repo

状態確認：

# 変更ファイル確認
git status

# コミット履歴
git log --oneline

# ブランチ一覧
git branch -a

ブランチ操作

作成と切り替え：

# ブランチ作成
git branch feature/new-function

# 切り替え
git checkout feature/new-function

# 作成と切り替えを同時に
git checkout -b feature/new-function

マージ：

# mainに切り替え
git checkout main

# マージ
git merge feature/new-function

# プッシュ
git push origin main

削除：

# ローカルブランチ削除
git branch -d feature/new-function

# リモートブランチ削除
git push origin --delete feature/new-function

GitHub CLI活用

インストール：

# Windows
winget install GitHub.cli

# Mac
brew install gh

# 認証
gh auth login

便利なコマンド：

# リポジトリ作成
gh repo create my-project --public --source=. --push

# Issue作成
gh issue create --title "バグ修正" --body "詳細"

# Pull Request作成
gh pr create --title "新機能" --body "説明"

# リポジトリ情報表示
gh repo view

# ブラウザで開く
gh browse

GitHub CLIの使い方は「GitHub CLI完全ガイド：コマンドラインでGitHub操作を効率化」で詳しく解説しています。

個人利用での注意点

1. 公開リポジトリの扱い

Public = 全世界に公開

注意すべきこと：

• パスワード、APIキーを含めない
• 個人情報を含めない
• 企業秘密を含めない
• ライセンスを明記

NGパターン：

# ❌ ハードコード
API_KEY = "sk_live_abc123xyz"
PASSWORD = "mypassword123"

OKパターン：

# ✅ 環境変数
import os
API_KEY = os.getenv("API_KEY")
PASSWORD = os.getenv("PASSWORD")

2. .gitignoreの設定

必ず除外すべきファイル：

# 環境変数
.env
.env.local

# 認証情報
*.pem
*.key
config/secrets.yml

# ビルド成果物
node_modules/
dist/
build/

# IDE設定（個人差）
.vscode/
.idea/

# OS生成ファイル
.DS_Store
Thumbs.db

3. コミットメッセージ

良いコミットメッセージ：

# ✅ 明確で具体的
git commit -m "Add user authentication feature"
git commit -m "Fix login button alignment"
git commit -m "Update README with setup instructions"

悪いコミットメッセージ：

# ❌ 曖昧
git commit -m "update"
git commit -m "fix bug"
git commit -m "test"

4. ブランチ管理

個人開発でも推奨：

main        ← 本番コード（常に動作する状態）
develop     ← 開発中（テスト済み）
feature/xxx ← 機能開発（作業中）

NGパターン：

すべてmainで直接開発 ← 壊れたコードがそのまま本番に

5. セキュリティ設定

Two-Factor Authentication有効化：

Settings → Password and authentication
→ Enable two-factor authentication
→ SMS or Authenticator app

Personal Access Token：

Settings → Developer settings → Personal access tokens
→ Generate new token (classic)
→ 必要な権限のみ選択
→ 有効期限設定（推奨：90日）

6. コントリビューションの可視性

プロフィールに表示：

Settings → Public profile
→ Contribution settings
→ Private contributions を含める（オプション）

アクティビティグラフ：

• 緑色の四角：コミット数を可視化
• 就職活動でアピール材料に

7. ライセンス選択

推奨ライセンス：

• MIT License：最も自由（商用利用OK）
• Apache License 2.0：特許保護付き
• GPL v3：オープンソース強制

設定方法：

リポジトリ作成時
→ Add a README file
→ Choose a license
→ MIT License 選択

トラブルシューティング

問題1：git pushが拒否される

エラー：

! [rejected] main -> main (fetch first)

原因：
リモートに新しいコミットが存在

解決：

# リモートの変更を取得してマージ
git pull origin main

# コンフリクトがあれば解決

# 再度プッシュ
git push origin main

問題2：間違えてコミットした

まだプッシュしていない場合：

# 直前のコミットを取り消し（変更は保持）
git reset --soft HEAD~1

# 変更も取り消す
git reset --hard HEAD~1

プッシュ済みの場合：

# 新しいコミットで打ち消し
git revert HEAD
git push origin main

問題3：ファイルを削除したい（履歴からも）

機密情報を間違えてコミット：

# 特定ファイルを履歴から完全削除
git filter-branch --force --index-filter \
  "git rm --cached --ignore-unmatch secrets.txt" \
  --prune-empty --tag-name-filter cat -- --all

# 強制プッシュ
git push origin --force --all

注意： 履歴を変更するため、他の人が使っているリポジトリでは避ける

問題4：VSCodeでGitが認識されない

エラー：

Git not found. Install it or configure it using the 'git.path' setting.

解決：

1. Gitをインストール（https://git-scm.com/）
2. VSCode再起動
3. それでもダメなら settings.json に追加：
{
  "git.path": "C:\\Program Files\\Git\\bin\\git.exe"
}

学習のロードマップ

第1週：基礎

目標：

• リポジトリ作成
• ファイルをコミット
• GitHubにプッシュ

実践：

mkdir learning-git
cd learning-git
git init
echo "Day 1: Started learning Git" > journal.md
git add journal.md
git commit -m "Day 1: First commit"
gh repo create learning-git --public --source=. --push

第2週：ブランチとマージ

目標：

• ブランチ作成
• 変更をコミット
• マージ体験

実践：

git checkout -b feature/add-intro
echo "## Introduction" >> journal.md
git add journal.md
git commit -m "Add introduction section"
git checkout main
git merge feature/add-intro
git push origin main

第3週：コラボレーション

目標：

• Issue作成
• Pull Request作成
• コードレビュー体験

実践：

# Issue作成
gh issue create --title "Add contact page" --body "Need to add contact information"

# 開発
git checkout -b feature/contact-page
# ファイル編集...
git add .
git commit -m "Add contact page"
git push origin feature/contact-page

# Pull Request
gh pr create --title "Add contact page" --body "Closes #1"

第4週：実践プロジェクト

目標：

• ポートフォリオサイト作成
• GitHub Pagesで公開

実践：

gh repo create my-portfolio --public
cd my-portfolio
echo "
My Portfolio
" > index.html
git add .
git commit -m "Initial portfolio site"
git push origin main

# GitHub Pagesを有効化
# Settings → Pages → Source: main branch

まとめ

GitHubは開発者にとって必須のスキルです。

この記事で学んだこと：

• GitHubの基本概念（リポジトリ、コミット、ブランチ）
• ブラウザ、VSCode、CLIでの操作方法
• 個人利用での注意点（セキュリティ、.gitignore）
• トラブルシューティング

次のステップ：

1. まずは個人プロジェクトで練習
2. GitHub Pagesでポートフォリオ公開
3. オープンソースプロジェクトにコントリビュート
4. GitHub Actionsで自動化

最初は難しく感じるかもしれませんが、実際に手を動かしながら学ぶことで、確実に身につきます。まずは小さなプロジェクトから始めてみましょう！

関連記事

• VSCodeでGitを使いこなす：初心者から実務まで完全ガイド

VSCodeでGitを使いこなす完全ガイド｜GUI操作とCLIコマンドを徹底比較

はじめにVSCodeでアプリケーション開発をしている方の多くが、Gitによるバージョン管理を導入しています。しかし、「CLIコマンドならわかるけど、VSCodeのGUI操作がよくわからない」「どのメニューから操作すればいいのか迷う」といった...

caymezon.com

2026.02.02

• GitHub CLI完全ガイド：コマンドラインでGitHub操作を効率化

GitHub CLI完全ガイド：コマンドラインでGitHub操作を効率化

GitHub CLI（ghコマンド）は、GitHubの操作をコマンドラインで完結できる公式ツールです。ブラウザを開かずに、リポジトリ作成からIssue管理、Pull Request作成まで、すべてターミナルで行えます。この記事では、実際の導...

caymezon.com

2026.01.31

• Git Branch戦略完全ガイド：チーム開発を成功させる実践パターン

【保存版】Git実務ガイド｜ブランチ戦略から失敗時のリカバリまで完全網羅

はじめにGitは強力なバージョン管理ツールですが、使い方を間違えると大変なことになります。この記事では、実務で使えるブランチ戦略から、よくある失敗とそのリカバリ方法まで、完全網羅します。対象読者：Gitの基本は分かるが、実務での使い方に不安...

caymezon.com

2026.01.12

The post GitHub初心者ガイド：基本の使い方からVSCode連携・注意点まで実践解説 first appeared on CayTech Lab.