はじめに

「Claude Desktopを導入したいけど、何からどの順番で学べばいいかわからない」

この記事は、Claude Desktopをゼロから使いこなすまでの全ステップを体系的に整理したロードマップです。セットアップ・GitHub MCP連携・ベストプラクティスまで、関連記事へのナビゲーションも含めて完全解説します。

Claude Desktopとは？30秒でわかる概要

Claude Desktopは、ClaudeをネイティブアプリとしてPC上で動かすデスクトップアプリケーションです。

Web版との最大の違い：MCP（Model Context Protocol）対応

Claude Desktop
    ↓
MCPサーバー接続
    ↓
✅ GitHubリポジトリを直接操作
✅ ローカルファイルの読み書き
✅ Slack・Notionへのアクセス
✅ データベース操作
✅ 12,000種類以上のツール連携（2026年3月時点）

ローカルMCPによる「外部ツールとの連携」が、Desktop版の最大の強みです。なお、2026年よりWeb版（有料プラン）でもリモートMCP（Connectors機能）が利用可能になりました。

Claude Desktop vs Web版の主要差分

Claude Desktop習得ロードマップ

STEP 1: 基本を理解する（30分）
  → Web版との違い・できることを把握

STEP 2: セットアップ（30〜60分）
  → インストール + GitHub MCP設定

STEP 3: ベストプラクティスを身につける
  → トークン節約・効率的な使い方

STEP 4: 応用（オプション）
  → 他のMCPサーバー追加・高度な活用

STEP 1：Claude Desktopの全体像を把握する

まずClaude Desktopがどんなことができるのか、Web版・Claude Codeとどう違うのかを理解しましょう。

Claude Desktop ベストプラクティス完全ガイド

メリット・デメリット・MCP活用・トークン消費の管理まで、Claude Desktop活用の全てを網羅した記事：

【2026年版】Claude Desktop 効果的な活用ガイド - メリット・デメリット・ベストプラクティス完全版

はじめにClaude Desktopは、Claudeをネイティブアプリとして利用できる強力なツールです。本記事では、Web版との違い、効果的な使い方、トークン消費を最小化するテクニック、そして今後の展望まで、実践的な知見を完全網羅します。(...

caymezon.com

2026.01.24

この記事で分かること：

• MCP統合でできること（GitHub・Slack・DBなど）
• ローカルファイルシステムへのアクセス方法
• トークン消費の仕組みと使用量制限
• トークンを節約する6つのテクニック
• デメリット・注意点の整理
• 今後の展望（Tool Search機能など）

STEP 2：セットアップ（GitHub MCP連携）

Claude Desktopの真価はGitHub MCPとの連携にあります。設定は30分程度で完了します。

Claude Desktop + GitHub MCP 完全セットアップガイド

Node.jsのインストールから、GitHub PATの作成・設定ファイル編集・動作確認まで、初心者でも30分で完了できる手順を画像付きで解説：

【2026年版】Claude Desktop + GitHub MCP 完全セットアップガイド - 初心者でも30分で完了

はじめにClaude Desktop + GitHub MCP（Model Context Protocol） を使えば、あなたのGitHubリポジトリ全体をClaudeから直接操作できます。この記事では、完全初心者でも30分でセットアップ...

caymezon.com

2026.01.24

セットアップ完了後にできること：

✅ ファイルサイズ制限なし（プロジェクト機能の4KB制限を回避）
✅ リポジトリ全体にリアルタイムアクセス
✅ ファイルの読み書き・編集
✅ Issue/PR管理
✅ 常に最新版を参照
✅ プライベートリポジトリにもアクセス可能

実際の活用例：

あなた: 「publish.jsの行742-766を確認して」

Claude Desktop:
[GitHub MCPでリポジトリから最新版を取得]
[35KB全文を確認]
「複数スラッグ対応が正しく実装されています...」

Desktop Extensionsによる簡単インストール（2026年新機能）

2026年より、**Desktop Extensions（.mcpbファイル）**による簡単なMCPインストールが利用可能になりました。従来のJSON設定ファイルの手動編集なしに、ブラウザ拡張機能と同じ感覚でMCPサーバーをインストールできます。

インストール方法：
1. 設定 > Extensions から拡張機能を追加
2. または .mcpb ファイルをダブルクリック
→ ターミナル操作・JSON編集不要で即使用可能

GitHub MCPなど主要なサーバーを試す際は、従来のJSON設定に加えてDesktop Extensionsも活用できます。

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

STEP 3：ベストプラクティスでトークンを節約する

Claude Desktopを効率的に使うには、トークン消費の管理が重要です。

重要な前提：トークンはすべて共有

Web版 + Desktop版 + Claude Code
        ↓
   同じ使用量制限（5時間あたり約44,000トークン）

トークン節約の主要テクニック

1. タスクごとに新規会話を開始する

❌ 悪い例: 1つの会話で全作業を継続
  → 会話履歴が膨大化 → 毎回再処理 → トークン消費加速

✅ 良い例: タスクごとに新規会話
  → 会話A: 「記事作成」
  → 会話B: 「コードレビュー」
  → 会話C: 「翻訳作業」

2. 質問をまとめて送る

❌ 3回に分けると: 約25,000トークン消費
✅ 1回にまとめると: 約10,000トークン消費
→ 60%節約

3. 不要なMCPサーバーを無効化する

MCPツール定義のトークン消費:
GitHub MCP単体: 約5,000トークン
4つのMCPサーバー: 約67,000トークン

→ 使わないMCPはコメントアウトして無効化

4. /compact コマンドで会話を圧縮する

/compact 「コード実装部分に焦点を当てて要約」
→ 会話履歴を大幅削減しながら流れを保持

詳しいベストプラクティスはこちら：

【2026年版】Claude Desktop 効果的な活用ガイド - メリット・デメリット・ベストプラクティス完全版

はじめにClaude Desktopは、Claudeをネイティブアプリとして利用できる強力なツールです。本記事では、Web版との違い、効果的な使い方、トークン消費を最小化するテクニック、そして今後の展望まで、実践的な知見を完全網羅します。(...

caymezon.com

2026.01.24

トラブルシューティング：よくある問題と解決法

プロジェクト機能でファイルが文字化けする

Claude Desktopのプロジェクト機能にJavaScriptファイルをアップロードすると、日本語コメントが文字化けする問題があります。

解決策（2通り）：

1. UTF-8 BOM付きで保存する（VSCodeで簡単に対応可能）
2. GitHub MCPを使う（根本的な解決策）

この問題の詳細な原因と解決方法：

【2026年1月】Claudeプロジェクトのファイル文字化け問題と解決法 - UTF-8 BOM付き保存の効果

はじめにClaudeのProプラン以上で利用できる「プロジェクト機能」で、JavaScriptファイルをアップロードすると日本語コメントが文字化けするという問題に遭遇しました。本記事では、この問題の原因究明から解決までの実体験を詳しく解説し...

caymezon.com

2026.01.24

プロジェクトファイルの4KB制限を回避したい

プロジェクト機能のファイル添付には約4KB（約114行）の制限があります。

解決策：GitHub MCP

GitHub MCPを使えばリポジトリ全体にリアルタイムアクセスでき、ファイルサイズ制限を完全に回避できます。

プロジェクトファイル vs GitHub MCP 比較:

| 項目 | プロジェクトファイル | GitHub MCP |
|------|---------------------|------------|
| エンコーディング | BOM必要 | 不要 ✅ |
| ファイルサイズ | 約30KB | 無制限 ✅ |
| 更新 | 手動アップロード | リアルタイム ✅ |
| 複数ファイル | 個別管理 | リポジトリ全体 ✅ |

Claude Desktop vs Web版：どちらを使う？

詳しい使い分けの判断基準はこちら：

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

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

caymezon.com

2026.02.07

簡易判断基準

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

Claude Desktopのエコシステムは急速に拡大しており、2026年3月時点でMCPサーバーは12,000本以上が公開されています。以下のトピックについても随時記事を追加予定です：

📌 追加予定記事
├─ GitHub以外のMCPサーバー活用（Slack・Notion・DB等）
├─ Desktop Extensions（.mcpb）を使ったワンクリックMCP導入
├─ 複数MCPサーバーの組み合わせ活用術
└─ Claude Desktop × 自作MCPサーバー入門

まとめ：Claude Desktop習得の最短ルート

今日やること:
1. Claude Desktopをインストール（5分）
   https://claude.ai/download

2. GitHub MCPをセットアップ（30分）
   → caymezon.com/claude-desktop-github-mcp-setup-guide/

3. ベストプラクティスを読む
   → caymezon.com/claude-desktop-best-practices-guide/

Claude Desktopを使いこなすことで、GitHubリポジトリを起点とした強力なAI開発支援環境が整います。特にMCPによる外部ツール連携は、一度体験すると手放せなくなります。

関連記事

• 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 Code完全攻略ロードマップ

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

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

caymezon.com

2026.03.21

参考リンク

• Claude公式ドキュメント
• Model Context Protocol
• Claude Desktop ダウンロード
• GitHub MCP Server
• MCPサーバー一覧

更新履歴

• 2026-03-21: 初版公開
• 2026-04-20: Web版リモートMCP対応・Desktop Extensions（.mcpb）追加・MCPサーバー数を最新化

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

1️⃣ はじめに：この記事でできるようになること

AWSを使い始めたとき、「まず何から設定すればいいのか」で詰まる人は多いです。

この記事では、AWSコンソールでアクセスキーを作成するところから、VSCodeのAWS ToolkitでAWSリソースを操作できるようになるまでを、初心者でも迷わない粒度で解説します。

この記事で学べること

• IAMユーザーの作成とアクセスキー発行の正しい手順
• AWS CLI のインストールと aws configure の設定
• 接続確認の方法（よく使うコマンド）
• VSCode + AWS Toolkit のインストールと接続設定
• プライベート用・会社用など複数環境の切り替え方
• よくあるエラーと対処法

対象読者

• AWSアカウントを作成したけど次に何をすればいいか迷っている方
• ローカルPCからAWS CLIやVSCodeで操作したい方
• aws toolkit の使い方を知りたい方
• プライベート用と会社用でAWS環境を使い分けたい方

前提条件

• ✅ AWSアカウントを作成済み
• ✅ VSCodeをインストール済み
• ✅ インターネット接続あり

Amazon検索[本 AWS 開発]

2️⃣ 全体の流れ

この記事で設定する手順の全体像です。

STEP 1: IAMユーザー作成
    ↓
STEP 2: アクセスキー発行
    ↓
STEP 3: AWS CLI インストール
    ↓
STEP 4: aws configure で認証情報を設定
    ↓
STEP 5: 接続確認
    ↓
STEP 6: VSCode に AWS Toolkit をインストール・接続
    ↓
完了！VSCodeからAWSリソースを操作できる

なぜこの順番なのかも順を追って説明します。

3️⃣ STEP 1｜IAMユーザーを作成する

なぜルートアカウントを使わないのか？
AWSアカウント作成時の「ルートユーザー」は全権限を持つため、日常利用は危険です。IAMユーザーを作成して権限を適切に管理するのがAWSのベストプラクティスです。

1-1. AWSコンソールにログイン

1. AWSコンソール を開く
2. 「ルートユーザー」を選択し、メールアドレスとパスワードでログイン

1-2. IAMサービスを開く

1. 画面上部の検索バーに IAM と入力してクリック
2. 左メニュー「ユーザー」→「ユーザーの作成」をクリック

1-3. ユーザー情報を入力

ユーザー名: 任意（例: vscode-user-private）
AWSマネジメントコンソールへのアクセスを提供する: チェックしない
（CLIのみ使うなら不要）

「次へ」をクリック。

1-4. 許可ポリシーを設定

「ポリシーを直接アタッチする」を選択
→ 検索欄に「AdministratorAccess」と入力
→ チェックを入れる

学習用なら AdministratorAccess で OK。
本番環境では必要最小限の権限（最小権限の原則）に絞ることを推奨します。

「次へ」→「ユーザーの作成」をクリック。

4️⃣ STEP 2｜アクセスキーを発行する

2-1. 作成したユーザーを開く

1. IAM → ユーザー → 作成したユーザー名をクリック
2. 「セキュリティ認証情報」タブをクリック

2-2. アクセスキーを発行

1. 「アクセスキーを作成」ボタンをクリック
2. ユースケースを選択する画面で以下を選択

「コマンドラインインターフェイス (CLI)」を選択
「上記のレコメンデーションを理解し、アクセスキーを作成します」にチェック

3. 説明タグを入力（任意。例: vscode-private）
4. 「アクセスキーを作成」をクリック

2-3. キー情報を保存する ⚠️ 必ず保存！

アクセスキー ID:     AKIA○○○○○○○○○○○○○○○○
シークレットアクセスキー: ○○○○○○○○○○○○○○○○○○○○○○○○○○○○○○○○

重要: この画面を閉じるとシークレットアクセスキーは二度と表示されません。
「.csvファイルをダウンロード」ボタンで必ずローカルに保存してください。

5️⃣ STEP 3｜AWS CLI をインストールする

AWS CLI は、コマンドラインからAWSを操作するためのツールです。aws configure もこれを使って実行します。

Windowsの場合

1. 以下のURLからインストーラーをダウンロード
   • https://awscli.amazonaws.com/AWSCLIV2.msi
2. ダウンロードした .msi ファイルをダブルクリックして実行（デフォルト設定でOK）
3. インストール完了後、VSCodeのターミナルまたはPowerShellを再起動

インストール確認：

aws --version

出力例：

aws-cli/2.x.x Python/3.x.x Windows/10 ...

Mac の場合

brew install awscli

# バージョン確認
aws --version

Linux の場合

# インストーラーをダウンロード＆実行
curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install

# バージョン確認
aws --version

6️⃣ STEP 4｜aws configure で認証情報を設定する

設定コマンドを実行

VSCodeのターミナル（Git Bash 推奨）を開いて以下を実行：

aws configure

対話形式で4項目を入力します：

AWS Access Key ID [None]: AKIA○○○○○○○○○○○○○○○○     ← STEP2で取得したID
AWS Secret Access Key [None]: ○○○○○○○○○○○○○○○○○○○○    ← STEP2で取得したキー
Default region name [None]: ap-northeast-1             ← 東京リージョン（推奨）
Default output format [None]: json                     ← json推奨（tableも可）

設定内容を確認する

aws configure list

出力例：

      Name                    Value             Type    Location
      ----                    -----             ----    --------
   profile                <not set>             None    None
access_key     ****************XXXX shared-credentials-file
secret_key     ****************XXXX shared-credentials-file
    region             ap-northeast-1      config-file    ~/.aws/config

設定ファイルの保存場所

aws configure を実行すると、以下の2つのファイルに設定が保存されます：

C:\Users\<ユーザー名>\.aws\
├── config       ← リージョン・出力形式が保存される
└── credentials  ← アクセスキー・シークレットキーが保存される（平文）

config ファイルの中身：

[default]
region = ap-northeast-1
output = json

credentials ファイルの中身：

[default]
aws_access_key_id = AKIA○○○○○○○○○○○○○○○○
aws_secret_access_key = ○○○○○○○○○○○○○○○○○○○○

注意: credentials ファイルはGitに絶対コミットしないこと。
.gitignore に .aws/ を追加することを強く推奨します。

7️⃣ STEP 5｜接続確認

設定が正しいか確認するコマンドを実行します。作業前に毎回実行する習慣をつけることを推奨します。

aws sts get-caller-identity

成功した場合の出力例：

{
    "UserId": "AIDA○○○○○○○○○○○○○○",
    "Account": "123456789012",
    "Arn": "arn:aws:iam::123456789012:user/vscode-user-private"
}

• Account が自分のAWSアカウントID
• Arn に user/<作成したユーザー名> が表示されていれば接続成功

試しにS3バケット一覧を確認する場合：

aws s3 ls

（バケットがなければ何も表示されませんが、エラーが出なければOK）

8️⃣ STEP 6｜VSCode に AWS Toolkit をインストール・接続する

AWS Toolkit は、VSCodeからAWSリソースをGUI操作できる公式拡張機能です。Lambda関数の編集・実行、S3バケットの参照、CloudFormationスタックの確認などが手軽にできます。

6-1. 拡張機能のインストール

1. VSCode の左サイドバー「拡張機能」アイコンをクリック（または Ctrl+Shift+X）
2. 検索欄に AWS Toolkit と入力
3. 「AWS Toolkit」（発行者: Amazon Web Services）が表示されたら「インストール」をクリック

6-2. AWS に接続する

1. VSCode 左サイドバーに「AWS」アイコンが追加される
2. クリック → 「Connect to AWS」（またはAWSアイコン横の設定）
3. プロファイルを選択する画面で default を選択
   （aws configure で設定したプロファイルが表示されます）

6-3. リージョンを追加する

1. AWS Toolkit パネル内の「EXPLORER」エリアを右クリック
2. 「Add Region...」をクリック
3. ap-northeast-1（Asia Pacific - Tokyo） を選択

6-4. 接続確認

AWS Toolkit パネルに Lambda・S3・CloudFormation などのサービスツリーが表示されれば接続成功です。

AWS Toolkit でできる主な操作

9️⃣ 複数環境を切り替える（プライベート用・会社用）

プライベート用と会社用など、複数のAWS環境を使い分ける場合は名前付きプロファイルを使います。

会社用プロファイルを追加する

# 会社用プロファイルとして追加
aws configure --profile company

AWS Access Key ID [None]: AKIA○○○○（会社用）
AWS Secret Access Key [None]: ○○○○（会社用）
Default region name [None]: ap-northeast-1
Default output format [None]: json

~/.aws/credentials の中身（複数プロファイルの例）

[default]
aws_access_key_id = AKIA○○○○（プライベート用）
aws_secret_access_key = ○○○○

[company]
aws_access_key_id = AKIA○○○○（会社用）
aws_secret_access_key = ○○○○

プロファイルを指定してコマンドを実行する

# 会社用プロファイルで接続確認
aws sts get-caller-identity --profile company

# 会社用プロファイルでS3一覧を取得
aws s3 ls --profile company

環境変数で一時的に切り替える（Git Bash）

# 会社用環境に切り替え
export AWS_PROFILE=company

# このターミナルセッション中は会社用として実行される
aws sts get-caller-identity

# プライベート用（default）に戻す
unset AWS_PROFILE

重要: 作業前に必ず aws sts get-caller-identity を実行して、どちらの環境で操作しているか確認する習慣をつけましょう。プライベート用と会社用を混同すると、意図しないリソースに変更を加えてしまう危険があります。

VSCode AWS Toolkit でプロファイルを切り替える

1. VSCode の AWS Toolkit パネルで接続中のプロファイル名が表示されている箇所をクリック
2. 「Switch Connections」→ 切り替えたいプロファイルを選択

🔟 よくあるエラーと対処法

エラーの原因を調べる方法

# --debug オプションで詳細ログを出力
aws sts get-caller-identity --debug

# 設定中のプロファイルを確認
aws configure list

# 設定済みプロファイル一覧を確認
aws configure list-profiles

1️⃣1️⃣ セキュリティの注意事項

AWS環境を安全に使うために、以下の点に注意してください。

アクセスキーの管理

• ❌ アクセスキーをコードにハードコードしない
• ❌ .aws/credentials ファイルをGitにコミットしない（.gitignore に追加）
• ❌ Slackやメールなどでキーを共有しない
• ✅ 使わなくなったキーはIAMコンソールから削除または無効化する

.gitignore の設定例

# AWS認証情報
.aws/

# 環境変数ファイル
.env
*.env

権限設定のベストプラクティス

より安全な認証への移行

長期的には、アクセスキーよりも安全な認証方式への移行を検討してください：

• IAM Identity Center（SSO）: 一時的な認証情報を使用するため、より安全
• IAM Roles: EC2やLambdaなどのAWSサービスからアクセスする場合に使用

まとめ

この記事では、AWSをローカルのVSCodeから操作できるようになるまでの全手順を解説しました。

今回設定したこと

• ✅ IAMユーザー作成：ルートアカウントを使わない安全な設定
• ✅ アクセスキー発行：CLIからのアクセスに必要な認証情報
• ✅ AWS CLI インストール：コマンドラインでAWSを操作するためのツール
• ✅ aws configure 設定：認証情報をローカルに設定
• ✅ 接続確認：aws sts get-caller-identity で正しく接続できているか確認
• ✅ VSCode + AWS Toolkit：GUIでAWSリソースを操作できる環境の構築
• ✅ 複数環境の切り替え：プライベート用・会社用を混同しない設定

次のステップ

この環境があれば、以下のような開発をすぐに始められます：

• EC2インスタンスの構築：仮想サーバーを立ち上げて実際のWebサーバーを作る
• Lambda関数の開発：VSCodeから直接Lambda関数を作成・デプロイ
• CloudFormationによるIaC：インフラをコードで管理する
• SAMを使ったサーバーレス開発：API Gateway + Lambdaの構成を手軽に構築

Amazon検索[本 AWS 開発]

参考リンク：

• AWS CLI 公式ドキュメント
• AWS Toolkit for Visual Studio Code 公式
• IAM ベストプラクティス

関連記事：

• 【実践】VSCodeとCloudFormationで学ぶAWS EC2構築｜コードでインフラ管理

【実践】VSCodeとCloudFormationで学ぶAWS EC2構築｜コードでインフラ管理

1️⃣ はじめに：なぜCloudFormationを使うのか？AWSマネジメントコンソールでのEC2構築は直感的ですが、再現性と管理性に課題があります。手動構築の課題❌ 同じ構成を再現するのが難しい❌ 設定ミスが発生しやすい❌ 変更履歴が残...

caymezon.com

2026.01.10

• 【AWS初心者向け】EC2キーペア作成の完全ガイド

【AWS初心者向け】EC2キーペア作成の完全ガイド｜AWSコンソールとCLIの2つの方法

1️⃣ はじめに：EC2キーペアとは？AWS EC2インスタンスにSSH接続するためには、**キーペア（.pemファイル）**が必要です。キーペアの役割認証方式：パスワードではなく公開鍵暗号方式でセキュアに接続用途：EC2インスタンスへのS...

caymezon.com

2026.01.10

最終更新： 2026年2月20日

The post 【初心者向け】AWS環境構築完全ガイド｜アクセスキー作成からVSCode+AWS Toolkitで開発できるまでの全手順 first appeared on CayTech Lab.

はじめに

「Claude CodeってターミナルでCLIを使うものだと思ってた…」
「VSCodeの拡張機能もあるって聞いたけど、何が違うの？」

そんな疑問を持つ開発者は多いはずです。

実は、Claude CodeにはVSCode拡張機能版があり、CLI版と組み合わせることで最強の開発環境を構築できます。

本記事では、2026年4月時点の最新情報をもとに、VSCode拡張機能の詳細、CLI版との違い、そして効果的な使い分け術を徹底解説します。

Amazon検索[本 Claude Code]

この記事で分かること

• Claude Code VSCode拡張機能の概要
• CLI版との機能的な違い
• VSCode拡張機能の主要機能
• 実際の使用シーンと効果的な活用方法
• CLI版との併用による最強の開発環境構築
• インストール方法と基本的な使い方
• メリット・デメリット
• トークン消費の違い
• 履歴管理とエクスポート方法
• 今後の展望と懸念事項

こんな人におすすめ

• Claude CodeのCLI版を使っているが、もっと効率的に使いたい人
• ターミナル操作は苦手だが、AIアシスタントを活用したい人
• VSCode中心の開発スタイルを崩したくない人
• CLI版とVSCode拡張機能のどちらを使うべきか迷っている人
• 視覚的にコード変更を確認しながら作業したい人
• エディタとAIアシスタントをシームレスに連携させたい人

Claude Code VSCode拡張機能とは

概要

Claude Code VSCode拡張機能は、Anthropic公式が提供するVSCode統合プラグインです。

従来のターミナルベースのCLI版とは異なり、VSCodeのGUI環境でClaude Codeの全機能を直感的に操作できます。

提供開始時期

• 初版リリース: 2024年後半
• 2026年4月時点: 安定版として広く利用可能（v2.1.x系）
• 対応モデル: Claude Opus 4.7、Sonnet 4.6、Haiku 4.5

基本コンセプト

■従来のCLI版
└─ ターミナルでコマンドを入力
└─ テキストベースの対話
└─ コード変更をターミナルで確認

■VSCode拡張機能版
└─ エディタ内でGUI操作
└─ チャット形式の対話
└─ インラインdiffで視覚的に確認

CLI版との違い

実行環境の比較

機能的な違い

CLI版の強み：

✓ 複数ファイルの一括生成・修正
✓ テスト実行やビルドコマンドの自動実行
✓ エラー発生時の自律的な修正
✓ スクリプトからの呼び出し
✓ CI/CD環境での自動化

VSCode拡張機能の強み：

✓ 視覚的なdiff表示とワンクリック承認
✓ エディタで選択中のコードを即座に参照
✓ @mention機能でファイル・行を指定
✓ 複数タブでの並列作業
✓ エディタとの完全統合

インストールと依存関係

重要： VSCode拡張機能には内部的にCLI機能が含まれています。

■2026年4月時点の推奨インストール方法

【VSCode拡張機能のみ使う場合】
→ VSCode拡張機能をインストールするだけでOK
→ 拡張機能に必要な機能が全て含まれている

【CLI版も使いたい場合】
→ ネイティブインストール（推奨）
→ Windows: irm https://claude.ai/install.ps1 | iex
→ macOS/Linux: curl -fsSL https://claude.ai/install.sh | bash
→ ⚠️ npm版は廃止予定

VSCode拡張機能の主要機能

1. インラインdiff表示

最大の特徴は視覚的なコード変更確認です。

従来のCLI版：
├─ ターミナルで変更内容を文字で確認
├─ 実際のファイルは別途エディタで開く
└─ 変更前後の比較が困難

VSCode拡張機能：
├─ エディタ内で変更差分を色分け表示
├─ 緑色：追加部分
├─ 赤色：削除部分
├─ ワンクリックで承認・却下
└─ 複数ファイルの変更を一覧表示

2. @mention機能

ファイルや特定の行を簡単に参照できます。

# ファイル全体を参照
@app.tsx このファイルをリファクタリングして

# 特定の行範囲を参照
@utils.js#10-25 この関数を最適化して

# 複数ファイルを参照
@app.tsx @utils.js この2つのファイルの連携を改善して

3. 選択テキストの自動コンテキスト化

エディタで選択中のコードを自動的に会話のコンテキストに含めます。

操作手順：
1. エディタで気になるコードを選択
2. Claude Codeのチャット画面を開く
3. 「この部分を説明して」と入力
→ 選択したコードが自動的に参照される

4. 複数タブでの並列作業

複数の会話を同時進行できます。

タブ1：新機能の実装について相談
タブ2：既存コードのリファクタリング
タブ3：バグ修正の調査

→ 作業内容ごとにコンテキストを分離
→ 効率的なマルチタスク

5. 会話履歴の管理

■履歴の保存場所
├─ ローカル: ~/.claude/projects/
├─ クラウド: Claude.aiアカウントと同期
└─ 形式: JSONL形式のログファイル

■履歴の確認方法
├─ サイドバーの履歴一覧から選択
├─ 過去の会話を再開可能
└─ プロジェクトごとに自動分類

メリット

1. 視覚的で直感的な操作

✓ コード変更を色分けで即座に把握
✓ マウス操作でファイルを簡単に参照
✓ チャット形式で会話の流れが分かりやすい

2. エディタとの完全統合

✓ ファイルを開いたまま作業可能
✓ 選択したコードを即座に質問
✓ 変更をエディタでリアルタイム確認

3. 効率的なワークフロー

■従来の開発フロー（CLI版のみ）
1. ターミナルでclaude起動
2. コード生成を依頼
3. ターミナルで内容確認
4. VSCodeで実際のファイルを開く
5. 手動で確認・修正
→ 画面の切り替えが多い

■VSCode拡張機能の開発フロー
1. VSCode内でClaude起動（Ctrl+Esc）
2. チャットで依頼
3. エディタでdiff確認
4. ワンクリックで承認
5. そのまま微調整
→ すべてVSCode内で完結

4. 初心者にも優しい

✓ ターミナル操作の知識不要
✓ GUI操作で直感的
✓ エラーメッセージも視覚的

5. ファイル参照が簡単

✓ @ファイル名 で即座に参照
✓ ドラッグ&ドロップでファイル追加
✓ エクスプローラーから直接選択

デメリット・注意点

1. 大規模な自動化には不向き

❌ 苦手な作業：
├─ 複数ファイルの一括生成
├─ テスト実行→エラー修正→再実行の自律的ループ
└─ ビルドプロセス全体の自動化

→ このような作業はCLI版の方が得意

2. トークン消費がわずかに多い

理由：
├─ IDE固有のメタ情報を送信
├─ エディタで開いているファイル情報
└─ プロジェクト構造の情報

消費量の違い：
└─ CLI版より 5〜10% 多い程度
└─ プロンプトキャッシュで大幅削減

3. VSCode依存

⚠️ 注意点：
├─ VSCodeを使わない環境では利用不可
├─ サーバーSSH接続時は不便
└─ 軽量エディタ派には不向き

4. 設定の複雑さ

CLI版：
└─ シンプルな設定

VSCode拡張機能：
├─ 拡張機能の設定
├─ ワークスペースの設定
└─ キーバインドのカスタマイズ
→ 設定項目が多い

実際の使用シーン

シーン1：既存コードのリファクタリング

■作業フロー
1. エディタで対象の関数を選択
2. Ctrl+Escでチャット起動
3. 「この関数をもっと読みやすくリファクタリングして」
4. 提案されたdiffをエディタで確認
5. 良ければワンクリックで承認
6. 細かい調整を手動で実施

→ 視覚的に変更を確認しながら進められる

シーン2：新機能の実装相談

■作業フロー
1. 右側のチャットで「ログイン機能を追加したい」
2. 設計について対話的に相談
3. 方針が固まったらコード生成を依頼
4. 複数ファイルの変更をタブで確認
5. 一つずつ承認していく
6. 必要に応じて追加の質問

→ 設計段階からコード生成まで一貫して進められる

シーン3：バグの原因調査

■作業フロー
1. エラーが出ている箇所を選択
2. 「このエラーの原因を教えて」
3. AIが関連ファイルを自動で参照
4. 原因と修正案を提示
5. diffで修正内容を確認
6. 承認して修正完了

→ コンテキストを自動で把握してくれる

CLI版との併用で最強の開発環境に

「エディタ × チャット × CLI」の3方向攻め

VSCodeを使うなら、両方を使い分けるのが最も効率的です。

画面構成：
┌─────────────────────────────────────┐
│  中央：エディタ                      │
│  ├─ コードの確認・手動修正           │
│  └─ diffの視覚的確認                 │
├─────────────────────────────────────┤
│  右側：チャット（拡張機能）          │
│  ├─ 設計の相談                       │
│  ├─ コードの説明を求める             │
│  └─ ピンポイントのリファクタリング   │
├─────────────────────────────────────┤
│  下部：統合ターミナル（CLI版）       │
│  ├─ 複数ファイルの一括修正           │
│  ├─ テスト実行とエラー修正           │
│  └─ ビルドプロセスの自動化           │
└─────────────────────────────────────┘

使い分けの基準

実践的な使い分け例

例1：新機能の追加

■フェーズ1：設計（チャット）
> 「ユーザー認証機能を追加したい。どういう設計が良い？」
→ Sonnetで対話的に設計を固める

■フェーズ2：実装（CLI）
$ claude
> 「さっき決めた設計で、認証機能を実装してテストまで通して」
→ Opusで複数ファイルを自動生成・テスト実行

■フェーズ3：微調整（チャット + 手動）
> 「このログイン画面のUIをもっと改善して」
→ Sonnetでdiffを確認しながら調整

例2：既存コードのリファクタリング

■フェーズ1：問題点の確認（チャット）
> エディタで気になる関数を選択
> 「このコードの問題点を教えて」
→ Sonnetで分析

■フェーズ2：リファクタリング（チャット）
> 「もっと読みやすく書き直して」
→ diffで変更を確認して承認

■フェーズ3：テスト（CLI）
$ npm test
→ 問題があればCLIで修正依頼

インストール方法

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

■手順1：拡張機能マーケットプレイスを開く
Ctrl+Shift+X（Windows/Linux）
Cmd+Shift+X（macOS）

■手順2：「Claude Code」で検索
検索ボックスに入力

■手順3：インストール
「Install」ボタンをクリック

■手順4：認証
初回起動時にブラウザで認証

■手順5：完了
Ctrl+Esc（または Cmd+Esc）で起動

CLI版も併用する場合（推奨）

# Windows（PowerShell）
irm https://claude.ai/install.ps1 | iex

# macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash

# インストール確認
claude --version

⚠️ 注意： npm版（npm install -g @anthropic-ai/claude-code）は廃止予定です。ネイティブインストールを推奨します。

基本的な使い方

起動方法

■キーボードショートカット
Ctrl+Esc（Windows/Linux）
Cmd+Esc（macOS）

⚠️ Windows環境での注意：
Ctrl+Escはスタートメニュー（検索窓）と競合します。
動作しない場合は、右上のClaudeアイコンから起動してください。

■コマンドパレット
Ctrl+Shift+P → "Claude Code" で検索

■アクティビティバー（推奨）
右上のClaudeアイコン「Claude Code: Open」をクリック

チャットでの基本操作

# ファイルを参照
@app.tsx このファイルをレビューして

# 特定の行を参照
@utils.js#15-30 この関数を説明して

# 複数ファイルを参照
@app.tsx @style.css この2つを連携させて

# 選択中のコードを自動参照
エディタでコードを選択 → チャットで質問

便利なショートカット

Ctrl+Esc（Cmd+Esc）
└─ エディタとClaudeのフォーカス切り替え
└─ ※ Windows環境ではシステムと競合する場合あり

Alt+K（Option+K）
└─ ファイル参照の挿入

Ctrl+Shift+Esc（Cmd+Shift+Esc）
└─ 新規タブで会話を開く

Ctrl+N（Cmd+N）
└─ 新規会話開始

プロジェクト設定の連動

ワークスペースの自動認識

VSCode拡張機能は、現在開いているワークスペース（フォルダ）を自動的にプロジェクトとして認識します。

プロジェクト構成：
C:\my-project\
├─ CLAUDE.md          # プロジェクトルール
├─ .claude\
│  └─ settings.json   # Claude Code設定
├─ src\
└─ package.json

→ VSCode拡張機能はこの構造を自動認識
→ CLAUDE.mdのルールも自動適用

CLI版との設定共有

共有される設定：
✓ CLAUDE.md（プロジェクトルール）
✓ .claude/settings.json
✓ .mcp.json（MCPサーバー設定）
✓ モデル選択（手動で同期）

独立した設定：
✗ 会話履歴（セッションは個別）
✗ モデル選択（個別に設定）

CLAUDE.mdの活用

# プロジェクトルール（例）

## 言語設定
- すべてのやり取りは日本語で行ってください

## コーディング規約
- TypeScriptを使用してください
- コメントはコードの右側に記述してください

## 説明スタイル
- 初心者にも分かりやすく説明してください

→ CLI版・拡張機能版の両方でこのルールが適用されます

モデルの選択と切り替え

利用可能なモデル（2026年4月時点）

VSCode拡張機能でのモデル変更

方法1：チャット画面の設定アイコン
└─ 歯車アイコン → モデルを選択

方法2：コマンドパレット
└─ Ctrl+Shift+P → "Claude: Change Model"

方法3：設定ファイル
└─ .claude/settings.json で指定

CLI版でのモデル変更

# セッション中に変更
> /model sonnet
> /model opus
> /model haiku

# 起動時に指定
claude --model claude-sonnet-4-6
claude --model claude-opus-4-7

効率的なモデル使い分け

■設計・相談フェーズ（チャット）
→ Sonnet 4.6
→ 速度とコストのバランスが良い

■複雑な実装フェーズ（CLI）
→ Opus 4.7
→ 高性能で複雑なタスクに対応

■簡単な確認・質問（チャット）
→ Haiku 4.5
→ 高速でコスト削減

トークン消費について

消費量の違い

同じタスクでの比較：

CLI版：
└─ 基本的なコンテキストのみ送信
└─ ファイル内容 + 指示内容

VSCode拡張機能：
├─ ファイル内容 + 指示内容
├─ IDE固有のメタ情報
├─ プロジェクト構造情報
└─ エディタで開いているファイル情報

→ 拡張機能の方が 5〜10% 程度多い

プロンプトキャッシュの効果

■プロンプトキャッシュとは
同じファイルを対象にする場合、
2回目以降のトークンコストが最大90%オフになる仕組み

■CLI版・拡張機能版の両方で適用
→ 併用してもコストが跳ね上がる心配は少ない

■効果的な使い方
同じファイルについて複数回質問
→ 2回目以降は大幅にコスト削減

コスト最適化のコツ

✓ 簡単な質問はHaikuを使う
✓ 複雑なタスクだけOpusを使う
✓ 同じファイルをまとめて処理
✓ /statusで消費状況を定期確認

履歴管理とエクスポート

履歴の保存場所

■ローカル保存
~/.claude/projects/
├─ プロジェクトごとのフォルダ
└─ JSONL形式のログファイル

■クラウド同期
Claude.aiアカウントに自動同期
→ 複数デバイスで履歴を共有

履歴の確認方法

■VSCode拡張機能
サイドバーの履歴一覧から選択
→ 過去の会話を再開可能

■CLI版
/history コマンドで確認
→ セッションIDを指定して再開

■ファイル直接確認
~/.claude/projects/ 内のファイルを開く
→ 詳細なログを確認

エクスポート方法

■方法1：CLIコマンドでエクスポート（CLI版のみ）
ターミナルで claude を起動後、以下のコマンドを実行：

/export                    # クリップボードにコピー
/export session-name       # テキストファイル（.txt）で保存

⚠️ 注意：
- このコマンドはCLI版専用です
- VSCode拡張機能のチャット画面では使用できません（2026年4月現在）
- 出力形式はテキスト形式（.txt）固定
- 拡張子を指定しても無視されます
- 拡張機能で使う場合は、統合ターミナルで claude を起動してください

■方法2：/copy コマンド（CLI版）
最後のアシスタント応答のみをクリップボードにコピー
/copy

■方法3：ファイル直接コピー
~/.claude/projects/ からファイルをコピー
→ JSONL形式のログファイルが保存されている

履歴の削除方法

■VSCode拡張機能
サイドバーの履歴一覧でゴミ箱アイコンをクリック

■CLI版
/clear または /reset でセッションをリセット

■完全削除
~/.claude/projects/ 内のフォルダを削除

⚠️ セキュリティ注意： 履歴にはソースコードや環境変数が含まれることがあります。共有PCでは定期的に削除を推奨します。

2026年4月の主な新機能

v2.1.x系で追加・強化された機能です。

■ アクティビティバーのセッション管理
└─ 過去の会話をサイドバーから一覧・再開可能に

■ マークダウンプランビュー
└─ /plan の出力がマークダウン形式で表示
└─ コメント追記にも対応

■ ネイティブMCPサーバーダイアログ
└─ MCPサーバーをGUIで追加・管理可能に

■ コンパクションカード
└─ /compact 後にサマリーをカード形式で表示

■ フォーカスビュー（Ctrl+O）
└─ プロンプト・ツール要約・最終応答のみ表示するシンプルモード

■ ステータスラインのリフレッシュ機能
└─ refreshInterval設定で定期更新が可能に

今後の展望

期待される機能強化

1. より高度なコード補完
├─ リアルタイムのインライン補完
├─ GitHub Copilot類似の機能
└─ コンテキストを考慮した提案

2. プロジェクト全体の理解向上
├─ 依存関係の自動解析
├─ アーキテクチャの可視化
└─ リファクタリング提案の高度化

3. チーム連携機能
├─ コードレビュー支援
├─ ドキュメント自動生成
└─ ベストプラクティスの共有

4. 他の開発ツールとの統合
├─ GitHub連携の強化
├─ Jira/Notionとの連携
└─ CI/CDパイプライン統合

2026年の技術トレンド

AI駆動開発の普及
├─ ペアプログラミングの相手がAIに
├─ 設計からテストまでAI支援
└─ コードレビューの自動化

Claude 5世代の登場可能性
├─ さらなる性能向上
├─ より複雑なタスクの自動化
└─ マルチモーダル対応の強化

懸念事項と対策

1. 過度な依存のリスク

懸念：
├─ AIに頼りすぎてスキルが低下
├─ コードの理解が浅くなる
└─ トラブル時に対応できない

対策：
✓ AIが生成したコードは必ず読む
✓ なぜそのコードなのか理解する
✓ 定期的に手動でコーディング
✓ 基礎知識の学習を怠らない

2. セキュリティとプライバシー

懸念：
├─ コードがクラウドに送信される
├─ 機密情報の漏洩リスク
└─ ログファイルに機密情報が残る

対策：
✓ 機密情報を含むファイルは除外
✓ .gitignoreで適切に管理
✓ ローカルログを定期削除
✓ 企業ポリシーに準拠

3. コストの予期せぬ増加

懸念：
├─ APIキー使用時の従量課金
├─ 気づかぬうちに高額請求
└─ トークン消費の管理困難

対策：
✓ Pro/Maxプランの範囲内で利用
✓ /statusで定期的に消費確認
✓ モデルを適切に使い分け
✓ 不要な会話は早めに終了

4. 技術的な制約

現在の制約：
├─ 完璧なコードが常に生成されるわけではない
├─ 複雑すぎるタスクは失敗することがある
├─ プロジェクト全体の理解には限界がある
└─ 最新のライブラリ情報は不足することがある

対応方法：
✓ 生成コードのテストを必ず実施
✓ 段階的にタスクを分割
✓ 重要な部分は人間が設計
✓ 公式ドキュメントと併用

JetBrains IDEにも対応

VSCodeだけでなく、JetBrains IDEにも拡張機能が提供されています。

対応IDE：
├─ IntelliJ IDEA
├─ PyCharm
├─ WebStorm
├─ PhpStorm
├─ GoLand
└─ Android Studio

主な機能：
├─ IDE内での直接起動（Ctrl+Esc / Cmd+Esc）
├─ IDE付属のdiffビューアでコード変更を表示
├─ 現在の選択テキスト/タブを自動共有
├─ ファイル参照ショートカット（Ctrl+Alt+K / Cmd+Option+K）
└─ lint エラーなどの診断情報を自動共有

インストール：
JetBrains マーケットプレイスから
「Claude Code」プラグインをインストール

→ VSCode以外のIDEユーザーも同様の恩恵を受けられます

よくある質問（FAQ）

Q1: CLI版とVSCode拡張機能、どちらを使うべき？

A: 用途に応じて使い分けるのが最適です。

日常的なコード編集：VSCode拡張機能
複雑な一括処理：CLI版
最強の組み合わせ：両方を併用

Q2: VSCode拡張機能だけで十分？

A: 多くの場合は十分ですが、CLI版も入れると便利です。

拡張機能だけで可能：
✓ コードの質問・相談
✓ ファイルの編集・リファクタリング
✓ 新規ファイルの作成

CLI版が必要な場面：
✓ 複数ファイルの一括生成
✓ テスト実行とエラー修正の自動化
✓ CIでの自動化

Q3: トークン消費は2倍になる？

A: いいえ、併用しても2倍にはなりません。

理由：
├─ プロンプトキャッシュで大幅削減
├─ 使い分けることで無駄を削減
└─ 同じタスクを重複実行しなければOK

Q4: 会話履歴は共有される？

A: セッションは個別ですが、ファイル変更は共有されます。

共有される：
✓ ファイルの変更内容
✓ プロジェクト設定
✓ CLAUDE.mdのルール

共有されない：
✗ 会話履歴
✗ モデル選択

Q5: オフラインでも使える？

A: いいえ、インターネット接続が必要です。

理由：
├─ Claudeのサーバーと通信
└─ 認証が必要

→ 常時オンライン環境が前提

まとめ

Claude Code VSCode拡張機能について詳しく解説しました。

主要なポイント：

VSCode拡張機能の特徴

✅ 視覚的で直感的

• インラインdiff表示
• チャット形式の対話
• ワンクリックで承認・却下

✅ エディタ完全統合

• @mention機能
• 選択テキストの自動参照
• 複数タブでの並列作業

✅ 初心者にも優しい

• GUI操作で簡単
• ターミナル知識不要
• エラーも視覚的

CLI版との使い分け

VSCode拡張機能が得意：

✓ 既存コードのリファクタリング
✓ 設計の相談
✓ コードの説明を求める
✓ ピンポイントの修正

CLI版が得意：

✓ 複数ファイルの一括生成
✓ テスト実行とバグ修正の自動化
✓ ビルドエラーの一括修正
✓ CIでの自動化

最強の開発環境

エディタ（中央）
├─ コードの確認・手動修正
└─ diffの視覚的確認

チャット（右側）
├─ 設計の相談
├─ コードの説明
└─ ピンポイントのリファクタリング

CLI（下部）
├─ 複数ファイルの一括修正
├─ テスト実行とエラー修正
└─ ビルドプロセスの自動化

→ 3方向から攻めることで無双状態

インストール推奨

基本：VSCode拡張機能
追加：CLI版（ネイティブインストール）
⚠️ npm版は廃止予定

注意事項

✓ 過度な依存に注意
✓ セキュリティ意識を持つ
✓ コスト管理を怠らない
✓ 生成コードは必ず確認

結論：VSCode中心の開発なら拡張機能は必須

CLI版との併用で、最高の開発体験が得られます。まずはVSCode拡張機能をインストールして、その便利さを体感してみてください！

Amazon検索[本 Claude Code]

関連記事：

• 【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環境構築完全ガイド｜初心者でも30分でセットアップできる詳細手順

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

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

caymezon.com

2026.02.14

• Claude Code完全ガイド｜概要とメリット・デメリット

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

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

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完全攻略ロードマップ｜全記事まとめ

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

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

caymezon.com

2026.03.21

タグ: #Claude #ClaudeCode #VSCode #拡張機能 #IDE統合 #開発環境 #AI開発 #使い分け

The post Claude Code VSCode拡張機能完全ガイド｜CLI版との違いと最強の使い分け術 first appeared on CayTech Lab.

はじめに

AWS開発を始めると、「ローカルPC（VSCode）」と「CloudShell」、どちらで作業するのが良いのか迷いませんか？

実は、それぞれに適した使い方があり、理解しないまま使うと思わぬトラブルに遭遇します。

この記事では、両環境の違いを明確にし、実際にハマったポイントを含めて解説します。

CloudShellとは？

AWSが提供するブラウザベースのシェル環境

CloudShellは、AWSマネジメントコンソール右上のアイコンからすぐに起動できるLinuxシェル環境です。

主な特徴:

• ✅ AWS CLIプリインストール - 追加設定不要
• ✅ 認証情報自動設定 - aws configure不要
• ✅ ブラウザだけでOK - どこからでもアクセス可能
• ✅ 無料 - 追加料金なし（一部制限あり）

制約:

• ❌ セッション終了でファイルが消える - ホームディレクトリ以外
• ❌ ネットワークIPが動的 - 毎回変わる可能性
• ❌ エディタ機能が限定的 - VSCodeほど快適ではない

ローカル環境（VSCode）とCloudShellの使い分け

推奨される使い分け

私の使い方

平常時: ローカルVSCodeで開発

• コード編集、Git管理、ビルド、デプロイまで

外出先・緊急時: CloudShell

• 素早くインスタンス停止、ログ確認など

CloudShellで同じEC2を構築してみた

手順は同じ...はずだった

ローカルVSCodeで構築したEC2を、CloudShellでも同じように構築してみました。

# template.yamlをアップロード後
aws cloudformation create-stack --stack-name ec2-test-stack --template-body file://template.yaml --region ap-northeast-1 --capabilities CAPABILITY_IAM

スタック作成は成功。さて、SSH接続してみると...

ssh -i my-ec2-test-key.pem ec2-user@18.183.169.96
# ssh: connect to host 18.183.169.96 port 22: Connection timed out

あれ？接続できない。

ハマったポイント1: CloudShellのIPアドレスは別物

問題の原因

セキュリティグループに設定していたIP123.456.78.901は、ローカルPCのIP（ルーター管理画面で確認）でした。

CloudShellはAWS内部の別のIPアドレスから接続するため、当然ブロックされます。

CloudShellの現在のIPを確認

# CloudShellで実行
curl https://checkip.amazonaws.com
# 結果: 52.68.8.99

このIPアドレスを確認して、セキュリティグループに追加する必要があります。

さらなる問題：CloudShellのIPは頻繁に変わる

CloudShellのIPアドレスはセッションごとに変わる可能性があります。

今日のセッション: 52.68.8.99
明日のセッション: 54.XX.XX.XX （変わっている！）

実用的な対処法:

対処法1: 毎回IPを確認して更新

# 1. CloudShellの現在のIPを確認
curl https://checkip.amazonaws.com

# 2. セキュリティグループに追加
aws ec2 authorize-security-group-ingress --group-id sg-XXX --protocol tcp --port 22 --cidr 新しいIP/32 --region ap-northeast-1

対処法2: CloudShell用に広めの範囲を許可

# AWSのCloudShell IP範囲を許可（推奨はしない）
CidrIp: 52.0.0.0/8

対処法3: Session Managerを使う（推奨）

# SSH不要、IP制限不要
aws ssm start-session --target i-XXX --region ap-northeast-1

ハマったポイント2: SSH接続したままコマンド実行

セキュリティグループを変更しようとしてエラー

CloudShellでEC2にSSH接続後、セキュリティグループを更新しようとしました。

[ec2-user@ip-172-31-34-41 ~]$ aws ec2 revoke-security-group-ingress --group-id sg-XXX ...

An error occurred (UnauthorizedOperation) when calling the RevokeSecurityGroupIngress operation: 
You are not authorized to perform this operation.

なぜ？CloudShellなら権限があるはずでは？

原因：EC2インスタンス内部で実行していた

プロンプトをよく見ると：

[ec2-user@ip-172-31-34-41 ~]$  # EC2内部

CloudShellではなく、EC2インスタンスにSSH接続した状態でした。

EC2インスタンスのIAMロールには、セキュリティグループ変更権限がありません。

正しい手順

# 1. EC2から抜ける
exit

# 2. CloudShellに戻ったことを確認
~ $  # CloudShellのプロンプト

# 3. AWS CLIを実行
aws ec2 revoke-security-group-ingress --group-id sg-XXX --protocol tcp --port 22 --cidr 0.0.0.0/0 --region ap-northeast-1
# 成功！

確実な確認方法

# 現在のアカウント情報を確認
aws sts get-caller-identity

CloudShell（正しい）:

{
    "Arn": "arn:aws:iam::975049949619:user/ユーザー名"
}

EC2内部（NG）:

{
    "Arn": "arn:aws:sts::...:assumed-role/ec2-test-stack-EC2Role/..."
}

ハマったポイント3: SSH接続とWebアクセスのIP設定

セキュリティグループの設定ミス

CloudShellからSSH接続するために、ポート22とポート80の両方にCloudShellのIPを設定しました。

SecurityGroupIngress:
  - IpProtocol: tcp
    FromPort: 22
    ToPort: 22
    CidrIp: 52.68.8.99/32  # CloudShellのIP
  - IpProtocol: tcp
    FromPort: 80
    ToPort: 80
    CidrIp: 52.68.8.99/32  # CloudShellのIP

SSH接続は成功。でも、ローカルPCのブラウザでWebアクセスすると...タイムアウト。

原因：ブラウザはローカルPCから

当たり前ですが、ブラウザはローカルPCから接続します。CloudShellからではありません。

正しい設定

SecurityGroupIngress:
  # SSH: CloudShellから接続
  - IpProtocol: tcp
    FromPort: 22
    ToPort: 22
    CidrIp: 52.68.8.99/32  # CloudShellのIP
    
  # HTTP: ローカルPCのブラウザから接続
  - IpProtocol: tcp
    FromPort: 80
    ToPort: 80
    CidrIp: 123.456.78.901/32  # ローカルPCのIP（ルーター管理画面で確認）

CloudShellでの真のIP確認方法

ローカルVSCodeがない環境で、ローカルPCのブラウザ用の真のIPを確認する方法です。

手順

ステップ1: ポート80を一時的に全開放

# CloudShellで実行
aws ec2 authorize-security-group-ingress --group-id sg-XXX --protocol tcp --port 80 --cidr 0.0.0.0/0 --region ap-northeast-1

ステップ2: ローカルPCのブラウザでアクセス

http://EC2のパブリックIP

ステップ3: CloudShellからEC2に接続してログ確認

# CloudShellからSSH接続
ssh -i my-ec2-test-key.pem ec2-user@18.183.169.96

# Apacheのアクセスログを確認
sudo cat /var/log/httpd/access_log | tail -5

出力例:

123.456.78.901 - - [14/Jan/2025:12:34:56 +0000] "GET / HTTP/1.1" 200 ...

この123.456.78.901がローカルPCのブラウザからの真の送信元IPです。

ステップ4: セキュリティグループを制限

# EC2から抜ける
exit

# CloudShellで実行
# 全開放を削除
aws ec2 revoke-security-group-ingress --group-id sg-XXX --protocol tcp --port 80 --cidr 0.0.0.0/0 --region ap-northeast-1

# 真のIPを許可
aws ec2 authorize-security-group-ingress --group-id sg-XXX --protocol tcp --port 80 --cidr 123.456.78.901/32 --region ap-northeast-1

さらに簡単な方法：ルーター管理画面

実は、ローカルPCのIPはルーター管理画面で確認するのが最も簡単です。

1. ブラウザで http://192.168.0.1 を開く
2. 「インターネットIPアドレス」を確認
3. そのIPをセキュリティグループに設定

詳しくは関連記事をご覧ください。

キーペアの管理

CloudShellにキーペアファイルをアップロード

ローカルPCで作成したキーペア（.pem）は、CloudShellには存在しません。

# CloudShellで確認
ls -la
# my-ec2-test-key.pem がない

アップロード方法:

1. CloudShellの「アクション」→「ファイルをアップロード」
2. ローカルPCのmy-ec2-test-key.pemを選択
3. 権限設定

chmod 400 my-ec2-test-key.pem

CloudShellで新しいキーペアを作成

# CloudShell内で新規作成
aws ec2 create-key-pair --key-name cloudshell-key --query "KeyMaterial" --output text > cloudshell-key.pem
chmod 400 cloudshell-key.pem

# ダウンロード（ローカルPC用）
# CloudShellの「アクション」→「ファイルをダウンロード」

まとめ

CloudShellとローカルVSCodeの違い

重要なポイント

✅ CloudShellのIPアドレスは動的

• セッションごとに変わる可能性

✅ SSH接続とWebアクセスは別のIPを設定

• SSH: CloudShellのIP
• HTTP: ローカルPCのIP（ルーター管理画面で確認）

✅ EC2内部でAWS CLIを実行しない

• 権限エラーになる
• 必ずCloudShellに戻って実行

✅ キーペアファイルは別管理

• CloudShellにアップロードが必要

✅ 真のIP確認はルーター管理画面が最も簡単

• http://192.168.0.1 で確認

推奨ワークフロー

開発フェーズ: ローカルVSCode

コード編集 → Git管理 → ビルド → デプロイ

運用・トラブル対応: CloudShell

素早くログイン → 状態確認 → 必要な操作

IP制限設定:

SecurityGroupIngress:
  # SSH: CloudShell用（動的IPなので都度更新が必要）
  - FromPort: 22
    CidrIp: CloudShellのIP/32  # curl https://checkip.amazonaws.com
    
  # HTTP: ローカルPC用（ルーター管理画面で確認）
  - FromPort: 80
    CidrIp: ローカルPCのIP/32  # http://192.168.0.1

関連記事

• AWSプロジェクトのフォルダ整理で失敗しないために - ローカル環境の整理方法

AWSプロジェクトのフォルダ整理で失敗しないために - Python仮想環境の落とし穴

はじめにAWSでの開発を進めていくと、ec2-test、sam-api-project、my-serverless-appなど、プロジェクトフォルダがユーザーディレクトリ直下に散らばってしまいませんか？「そろそろ整理しないと...」と思って...

caymezon.com

2026.02.01

• EC2セキュリティグループのIP制限で接続できない？ - 真の送信元IP特定方法の詳細（ルーター管理画面での確認）

EC2セキュリティグループのIP制限で接続できない？真の送信元IPを特定する確実な方法

はじめにEC2インスタンスを構築し、セキュリティグループで自分のIPアドレスに制限したのに、なぜかSSH接続もWebアクセスもできない。そんな経験はありませんか？実は、一般的なIP確認方法（curlや確認くん）で表示されるIPアドレスと、実...

caymezon.com

2026.02.01

終わりに

CloudShellは便利なツールですが、ローカル環境とは異なる特性を持っています。

特に、動的IPアドレスとEC2内部での権限エラーは、初見で必ずハマるポイントです。

両環境の違いを理解して、適切に使い分けることで、効率的なAWS開発が可能になります。

この記事が、CloudShellとローカル環境の使い分けで迷っている方の助けになれば嬉しいです！

質問や補足があれば、コメント欄でお気軽にどうぞ！

The post CloudShellとローカル環境でのAWS開発 - 使い分けと注意点 first appeared on CayTech Lab.

GitHub CLIとは？

GitHub CLIは、Gitコマンドとは別の、GitHub専用のコマンドラインツールです。

Gitとの違い

つまり、Gitはローカル作業、GitHub CLIはGitHub上の作業を担当します。

インストール手順

Windows

方法1: wingetコマンド（推奨）

winget install GitHub.cli

実行すると以下のような出力が表示されます：

見つかりました GitHub CLI [GitHub.cli] バージョン 2.85.0
ダウンロード中...
インストールが完了しました

方法2: 公式インストーラー

1. https://cli.github.com/ にアクセス
2. 「Download for Windows」をクリック
3. .msiファイルをダウンロードして実行

インストール後の確認

重要: インストール後はコマンドプロンプトを再起動してください。

再起動後、以下のコマンドで確認：

gh --version

以下のように表示されればOKです：

gh version 2.85.0 (2024-XX-XX)

macOS

brew install gh

Linux

Ubuntuの場合：

sudo apt install gh

その他のディストリビューションは公式ドキュメントを参照してください。

認証設定

GitHub CLIを使うには、GitHubアカウントとの認証が必要です。

基本的な認証フロー

gh auth login

対話形式で以下を選択していきます：

1. アカウント選択

? What account do you want to log into?
> GitHub.com
  GitHub Enterprise Server

GitHub.com を選択します。

2. プロトコル選択

? What is your preferred protocol for Git operations?
> HTTPS
  SSH

HTTPS を選択します（一般的な使い方）。

3. 認証方法選択

? How would you like to authenticate GitHub CLI?
> Login with a web browser
  Paste an authentication token

Login with a web browser を選択します（推奨）。

4. ブラウザで認証

! First copy your one-time code: XXXX-XXXX
Press Enter to open github.com in your browser...

1. 表示されたワンタイムコードをコピー
2. Enterキーを押す
3. ブラウザが開くので、GitHubにログイン
4. コードを入力
5. 「Authorize github」をクリック

重要ポイント：

• ワンタイムコードには有効期限がある（通常15分）
• 素早く入力すること
• 手入力ではなくコピー&ペーストを推奨

認証完了の確認

gh auth status

以下のように表示されれば成功：

github.com
  ✓ Logged in to github.com as YOUR_USERNAME
  ✓ Git operations for github.com configured to use https protocol.
  ✓ Token: ghp_************************************

トラブルシューティング

エラー1: 'gh' は認識されていません

原因: インストール後にコマンドプロンプトを再起動していない

解決方法:

1. コマンドプロンプトを閉じる
2. 新しいコマンドプロンプトを開く
3. 再度 gh --version を実行

それでも解決しない場合は、環境変数のPATHに以下を追加：

C:\Program Files\GitHub CLI

エラー2: Uh oh, we couldn't find anything

原因: ワンタイムコードの入力ミスまたは有効期限切れ

解決方法:

1. gh auth login を再実行
2. 新しいワンタイムコードが表示される
3. すぐにコピーしてブラウザに入力
4. 手入力ではなくコピー&ペーストを使用

エラー3: Personal Access Tokenを使いたい場合

ブラウザ認証がうまくいかない場合：

gh auth login

認証方法選択で Paste an authentication token を選択

トークン作成手順：

1. https://github.com/settings/tokens にアクセス
2. 「Generate new token」→「Generate new token (classic)」
3. Note: github-cli-access
4. Expiration: 任意（推奨: 90 days）
5. Select scopes: repo にチェック
6. 「Generate token」をクリック
7. トークンをコピー（画面を離れると二度と見れない）
8. コマンドプロンプトに貼り付け

基本的な使い方

リポジトリ操作

リポジトリ作成

gh repo create my-project --public

# プライベートリポジトリ
gh repo create my-project --private

# 説明付きで作成
gh repo create my-project \
  --public \
  --description "プロジェクトの説明"

# 現在のフォルダをソースにして作成＆プッシュ
gh repo create my-project \
  --public \
  --source=. \
  --push

リポジトリ作成の詳細な手順は「GitHubリポジトリ作成の2つの方法：GUI vs CLI徹底比較」をご覧ください。

リポジトリ設定変更

# 説明文変更
gh repo edit --description "新しい説明文"

# プライベートに変更
gh repo edit --visibility private --accept-visibility-change-consequences

# 公開に変更
gh repo edit --visibility public --accept-visibility-change-consequences

# ホームページURL設定
gh repo edit --homepage "https://example.com"

# Wiki有効化
gh repo edit --enable-wiki

# Issue無効化
gh repo edit --disable-issues

リポジトリ情報表示

# 情報表示
gh repo view

# ブラウザで開く
gh repo view --web

Issue操作

Issue作成

# 対話形式で作成
gh issue create

# タイトルと本文を指定
gh issue create \
  --title "バグ報告" \
  --body "詳細な説明"

# ラベル付きで作成
gh issue create \
  --title "機能追加" \
  --body "詳細" \
  --label "enhancement"

Issue一覧表示

# オープンなIssue一覧
gh issue list

# すべてのIssue
gh issue list --state all

# 自分がアサインされているIssue
gh issue list --assignee @me

Issue表示

# Issue #123を表示
gh issue view 123

# ブラウザで開く
gh issue view 123 --web

Pull Request操作

PR作成

# 対話形式で作成
gh pr create

# タイトルと本文を指定
gh pr create \
  --title "機能追加: ユーザー認証" \
  --body "詳細な説明"

# ブラウザで開いて作成
gh pr create --web

PR一覧表示

# オープンなPR一覧
gh pr list

# 自分のPR
gh pr list --author @me

PR表示とマージ

# PR #456を表示
gh pr view 456

# PR #456をマージ
gh pr merge 456

その他便利なコマンド

現在のリポジトリを確認

gh repo view

ブラウザで開く

# リポジトリをブラウザで開く
gh browse

# 特定のIssueを開く
gh issue view 123 --web

# 特定のPRを開く
gh pr view 456 --web

GitHub Actionsの確認

# Workflow実行履歴
gh run list

# 最新のWorkflow詳細
gh run view

# 特定のWorkflowを表示
gh run view 12345

実践的な活用例

例1: 新規プロジェクトの開始

# プロジェクトフォルダ作成
mkdir my-new-project
cd my-new-project

# README作成
echo "# My New Project" > README.md

# Git初期化
git init
git add .
git commit -m "Initial commit"

# GitHubにリポジトリ作成＆プッシュ
gh repo create my-new-project --public --source=. --push

例2: Issueを作成してブラウザで確認

# Issue作成
gh issue create --title "バグ修正: ログイン失敗" --body "詳細な説明"

# Issue一覧を確認
gh issue list

# 最新のIssueをブラウザで開く
gh issue view 1 --web

例3: 既存リポジトリのクローンとPR作成

# リポジトリをクローン
gh repo clone username/repository

# ブランチ作成
git checkout -b feature-branch

# 変更をコミット
git add .
git commit -m "Add new feature"

# プッシュ
git push origin feature-branch

# PRを作成
gh pr create --title "新機能追加" --body "詳細"

GUIとの比較

作業速度の比較

GUI（ブラウザ）での新規リポジトリ作成:

1. ブラウザを開く（5秒）
2. GitHubにアクセス（5秒）
3. New repositoryをクリック（3秒）
4. フォームに入力（30秒）
5. Create repositoryをクリック（3秒）
6. ターミナルに戻る（3秒）
7. コマンドをコピペ（20秒）
8. プッシュ（10秒）

合計: 約79秒

CLI（gh コマンド）での新規リポジトリ作成:

1. コマンド1行で完了（5秒）

合計: 約5秒

具体的なコマンド例

実際に私が Claudeチャットエクスポートツール を管理するために使ったコマンド：

# リポジトリ作成（GUIなら1分以上かかる作業が5秒で完了）
gh repo create my-python --public --source=. --push

# 公開範囲変更（GUIなら設定画面を開いて変更が必要）
gh repo edit --visibility private --accept-visibility-change-consequences

# 情報確認（ブラウザを開く必要なし）
gh repo view

GitHub CLIを使うメリット

1. 作業効率の大幅向上

• ブラウザとターミナルを行き来する必要がない
• マウス操作が不要
• ショートカットキーで高速操作

2. 認証が楽

• 一度認証すれば以降はパスワード不要
• Personal Access Tokenの管理が不要
• セキュアな認証情報保存

3. スクリプト化・自動化が可能

# 複数リポジトリを一気に作成
for repo in project1 project2 project3; do
  gh repo create $repo --public
done

4. 一貫した操作感

• すべての操作がコマンドラインで統一
• Gitコマンドとシームレスに連携
• VSCodeなどのターミナルからも実行可能

5. リモート作業に最適

• SSHでリモートサーバーに接続している場合でも使える
• ブラウザが不要なため軽量
• スクリプトに組み込んで自動化可能

デメリットと対策

デメリット1: 学習コスト

対策: よく使うコマンドから徐々に覚える

# まずはこの3つから
gh repo create  --public --source=. --push
gh repo view
gh issue create

デメリット2: GUIほど直感的ではない

対策: --helpオプションを活用

gh repo --help
gh issue --help
gh pr --help

デメリット3: 初期セットアップが必要

対策: 一度セットアップすれば永続的に使える

学習ロードマップ

レベル1: 基本操作（1週間）

gh auth login
gh repo create
gh repo view

レベル2: Issue/PR管理（2週間）

gh issue create
gh issue list
gh pr create
gh pr merge

レベル3: 高度な操作（1ヶ月）

gh run list
gh release create
gh gist create

まとめ

GitHub CLIは、GitHubの操作を大幅に効率化できる強力なツールです。

こんな人におすすめ：

• 開発作業の効率を上げたい
• コマンドライン操作に慣れている
• 複数のリポジトリを管理している
• リモート環境で作業することが多い

初めての人へ：
まずは gh repo create と gh repo view から始めてみてください。慣れてくると、他のGitHub操作もCLIで行いたくなるはずです。

GitHubの操作をコマンドラインで完結させることで、開発フローが劇的に改善します。ぜひ試してみてください！

関連記事

• GitHubリポジトリ作成の2つの方法：GUI vs CLI徹底比較

GitHubリポジトリ作成の2つの方法：GUI vs CLI徹底比較

GitHubでリポジトリを作成する方法は大きく分けて2つあります。ブラウザを使ったGUI操作と、GitHub CLIを使ったコマンドライン操作です。この記事では、実際のPythonプロジェクトを例に、両方の方法を詳しく解説します。前提条件G...

caymezon.com

2026.01.31

• Claudeチャットを資産化！エクスポートデータを整形するPythonツール

Claudeチャットを資産化！エクスポートデータを整形するPythonツール

Claudeとの会話履歴は貴重な知的財産です。しかし、エクスポートしたJSONファイルは読みにくく、そのままでは活用しづらいのが現状です。この記事では、ClaudeのエクスポートデータをMarkdown形式に整形し、チャット毎に分割して保存...

caymezon.com

2026.01.31

The post GitHub CLI完全ガイド：コマンドラインでGitHub操作を効率化 first appeared on CayTech Lab.

前提条件

• GitHubアカウントを持っている
• Gitがインストール済み
• ローカルにプロジェクトフォルダがある

今回は以下のような構成のPythonプロジェクトを例にします：

C:\my-local\my-python\
├── claude_chat_exporter/
│   ├── exporter.py
│   ├── README.md
│   └── output/
├── .gitignore
├── README.md
└── requirements.txt

方法1: GUIでリポジトリ作成（ブラウザ）

ステップ1: GitHubでリポジトリを作成

1. https://github.com/new にアクセス
2. 以下を入力：
   • Repository name: my-python
   • Description: 個人用Pythonツール集
   • Public/Private: 任意で選択
3. 重要: 「Add a README file」のチェックは外す
   • ローカルに既にREADME.mdがある場合、競合を防ぐため
4. 「Create repository」をクリック

ステップ2: ローカルリポジトリを初期化

コマンドプロンプトまたはターミナルで：

cd C:\my-local\my-python

# Gitリポジトリを初期化
git init

# すべてのファイルをステージング
git add .

# 初回コミット
git commit -m "Initial commit: Add claude_chat_exporter"

ステップ3: GitHubにプッシュ

GitHubのリポジトリページに表示されるコマンドを実行：

# ブランチ名をmainに変更
git branch -M main

# リモートリポジトリを追加
git remote add origin https://github.com/YOUR_USERNAME/my-python.git

# プッシュ
git push -u origin main

ステップ4: 認証（初回のみ）

プッシュ時に認証が求められます。

Personal Access Token（推奨）

1. GitHub Settings → Developer settings → Personal access tokens → Tokens (classic)
2. 「Generate new token」をクリック
3. Note: my-python-repo
4. Expiration: 任意（推奨: 90 days）
5. Select scopes: repo にチェック
6. 「Generate token」をクリック
7. トークンをコピー（画面を離れると二度と見れない）
8. プッシュ時のパスワード欄にトークンを貼り付け

メリット・デメリット

メリット：

• ビジュアル的で分かりやすい
• 初心者にも扱いやすい
• 設定項目が一目で確認できる

デメリット：

• ブラウザとコマンドラインを行き来する必要がある
• 認証情報を毎回入力する必要がある（トークンを保存しない場合）
• 複数リポジトリを連続で作成する場合は非効率

方法2: GitHub CLIでリポジトリ作成

GitHub CLI（ghコマンド）を使うと、すべてコマンドラインで完結します。

ステップ1: GitHub CLIをインストール

Windowsの場合：

winget install GitHub.cli

インストール後、コマンドプロンプトを再起動してください。

macOS/Linuxの場合は公式ドキュメントを参照してください。

GitHub CLIの詳細なインストール手順やトラブルシューティングは「GitHub CLI完全ガイド：コマンドラインでGitHub操作を効率化」をご覧ください。

ステップ2: GitHub CLIで認証

gh auth login

対話形式で以下を選択：

1. GitHub.com
2. HTTPS
3. Login with a web browser

ワンタイムコードが表示されるので、ブラウザでGitHubにログインして入力します。

重要: コードには有効期限があるため、表示されたらすぐに入力してください。

ステップ3: 一発でリポジトリ作成＆プッシュ

# プロジェクトフォルダに移動
cd C:\my-local\my-python

# Gitリポジトリ初期化（未初期化の場合）
git init
git add .
git commit -m "Initial commit: Add claude_chat_exporter"

# GitHub上にリポジトリを作成し、同時にプッシュ
gh repo create my-python \
  --public \
  --description "個人用Pythonツール集" \
  --source=. \
  --push

これだけで完了です！

オプション詳細

gh repo create <リポジトリ名> [オプション]

メリット・デメリット

メリット：

• すべてコマンドラインで完結
• 認証情報を保存するため、以降の操作がスムーズ
• 複数リポジトリを短時間で作成できる
• スクリプト化・自動化が可能

デメリット：

• 初回のCLIインストールと認証が必要
• コマンドに慣れるまで時間がかかる
• GUIほど直感的ではない

両方法の比較表

どちらを選ぶべきか？

GUIがおすすめな人

• GitやGitHubを始めたばかり
• たまにしかリポジトリを作成しない
• ビジュアル的な操作が好き
• コマンドラインに慣れていない

CLIがおすすめな人

• 頻繁にリポジトリを作成する
• 開発作業をコマンドラインで行っている
• 効率性を重視する
• GitHubの他の操作（Issue、PR作成など）もCLIで行いたい

実際の使い分け

私の場合、以下のように使い分けています：

• 個人の小規模プロジェクト: GitHub CLI（速い）
• チームでの新規プロジェクト: GUI（設定を確認しながら慎重に）
• 学習目的: GUI（プロセスを理解するため）

次のステップ

リポジトリ作成後の日常的な操作については、以下の記事も参考にしてください：

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

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

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

caymezon.com

2026.01.31

• Claudeチャットを資産化！エクスポートデータを整形するPythonツール

Claudeチャットを資産化！エクスポートデータを整形するPythonツール

Claudeとの会話履歴は貴重な知的財産です。しかし、エクスポートしたJSONファイルは読みにくく、そのままでは活用しづらいのが現状です。この記事では、ClaudeのエクスポートデータをMarkdown形式に整形し、チャット毎に分割して保存...

caymezon.com

2026.01.31

まとめ

GitHubリポジトリの作成方法を2つ紹介しました：

1. GUIでの作成: 直感的で分かりやすい
2. GitHub CLIでの作成: 効率的で自動化可能

どちらもメリット・デメリットがあるため、自分の作業スタイルに合った方法を選択してください。個人的には、GitHub CLIに慣れると作業効率が大幅に向上するので、ぜひ試してみることをおすすめします。

GitHub CLIを使いこなせば、リポジトリ作成だけでなく、Issue管理やPull Request作成などもコマンドラインで効率的に行えるようになります。

The post GitHubリポジトリ作成の2つの方法：GUI vs CLI徹底比較 first appeared on CayTech Lab.

はじめに

VSCodeでカスタムマクロを作成したいけど、どうやって開発環境を構築すればいいか分からない。そんな悩みを持つ方に向けて、TypeScriptでVSCode拡張機能を開発する環境の構築から、実際にマクロを作成して使えるようにするまでの完全手順を解説します。

本記事では、初心者でも迷わずセットアップできるよう、コマンド一つひとつを丁寧に説明します。

この記事で分かること

• TypeScript拡張機能開発環境の構築手順
• プロジェクト構成とファイル配置
• デバッグ実行からインストールまでの流れ
• TypeScript vs JavaScript の比較
• 効果的な開発ワークフロー
• おすすめキーバインド設定
• トラブルシューティング

なぜTypeScriptなのか？

TypeScriptのメリット

1. IntelliSenseが完璧に機能

editor.document.  // ← すべてのメソッドが補完される

2. エラーを実行前に発見

line.text.toUppercase();  // ← 赤波線で即座にエラー検出
// 正しくは toUpperCase()

3. VSCode APIの型定義が充実

// 引数・戻り値の型が明確
function openFile(filePath: string, readOnly: boolean): Promise

4. リファクタリングが安全

• 関数名変更 → すべての呼び出し箇所も自動更新
• タイポによるバグを防止

JavaScriptとの比較

結論：VSCode拡張機能開発ではTypeScript一択

前提条件

必要な環境

• Windows 10/11（Mac/Linuxでも可）
• Node.js v20以上
• VSCode最新版
• Git（バージョン管理用）

推奨スキル

• 基本的なコマンドライン操作
• TypeScript または JavaScriptの基礎知識
• Gitの基本操作

セットアップ手順（完全版）

Step 1: Node.js環境の確認

# バージョン確認
node --version  # v20.x.x以上
npm --version   # 10.x.x以上

# 未インストールの場合
# https://nodejs.org/ からダウンロード

Step 2: 開発ツールのインストール

# グローバルツールをまとめてインストール
npm install -g yo generator-code @vscode/vsce

# yo: Yeoman（プロジェクト生成ツール）
# generator-code: VSCode拡張機能テンプレート
# @vscode/vsce: パッケージ化ツール

Step 3: プロジェクトディレクトリの作成

# 作業ディレクトリを作成
mkdir C:\my-local\my-macros
cd C:\my-local\my-macros

# Gitリポジトリ初期化
git init
git branch -M main

Step 4: 拡張機能プロジェクトの生成

yo code

対話式設定項目：

? What type of extension do you want to create?
  → New Extension (TypeScript)

? What's the name of your extension?
  → my-macros

? What's the identifier of your extension?
  → my-macros

? What's the description of your extension?
  → Custom macros for productivity

? Initialize a git repository?
  → No（既に初期化済み）

? Which package manager to use?
  → npm

Step 5: プロジェクト構造の確認

C:\my-local\my-macros\
├── .vscode\              # VSCodeデバッグ設定
│   ├── launch.json
│   └── tasks.json
├── src\
│   ├── extension.ts      # メインエントリーポイント
│   └── test\             # テストコード
├── node_modules\         # 依存パッケージ
├── .gitignore
├── package.json          # 拡張機能設定
├── tsconfig.json         # TypeScript設定
└── README.md

Step 6: マクロディレクトリの作成

mkdir src\macros

Step 7: 依存関係のインストール

npm install --legacy-peer-deps

エラーが出た場合：

# package.jsonの依存関係を最新版に更新してから
npm install --legacy-peer-deps

Step 8: コンパイル確認

npm run compile

# 成功すれば out/ ディレクトリに .js ファイルが生成される

プロジェクト構成の詳細

package.json（拡張機能の設定）

重要なセクション：

{
  "name": "my-macros",
  "displayName": "My Macros",
  "version": "0.0.1",
  "engines": {
    "vscode": "^1.85.0"
  },
  "contributes": {
    "commands": [
      {
        "command": "myMacros.openPath",
        "title": "Open Path Under Cursor",
        "category": "My Macros"
      }
    ],
    "keybindings": [
      {
        "command": "myMacros.openPath",
        "key": "ctrl+shift+f12",
        "when": "editorTextFocus"
      }
    ]
  }
}

カスタマイズポイント：

• commands: コマンドパレットに表示されるコマンド
• keybindings: デフォルトのキーバインド
• when: キーが有効になる条件

extension.ts（メインファイル）

import * as vscode from 'vscode';

export function activate(context: vscode.ExtensionContext) {
    console.log('my-macros is now active');

    // コマンド登録
    const disposable = vscode.commands.registerCommand(
        'myMacros.openPath',
        () => {
            vscode.window.showInformationMessage('Hello World!');
        }
    );

    context.subscriptions.push(disposable);
}

export function deactivate() {}

マクロファイルの配置

src\macros\
├── openPath.ts           # パスオープン
├── copyToEmptyLine.ts    # 空行までコピー
├── textCalc.ts           # テキスト電卓
└── getFileDate.ts        # ファイル更新日時取得

各マクロは独立したファイルで管理し、extension.tsでインポートします。

開発からインストールまでの流れ

開発フロー全体像

1. コード編集
   ↓
2. コンパイル
   ↓
3. デバッグ実行
   ↓
4. テスト
   ↓
5. 問題なし？
   ↓ Yes
6. Gitコミット
   ↓
7. パッケージ化
   ↓
8. インストール
   ↓
9. 本番環境で使用

デバッグ実行（開発中のテスト）

手順：

1. VSCodeでC:\my-local\my-macrosを開く
2. F5キーを押す
3. 新しいVSCodeウィンドウが開く（Extension Development Host）
4. この新しいウィンドウでマクロをテスト

テスト例：

1. 新しいウィンドウでtest.txtを作成
2. C:\Windows\System32 と入力
3. その行でCtrl+Shift+F12を押す
4. Explorerが開けば成功！

デバッグのメリット：

• パッケージ化不要
• 即座にテスト可能
• console.logでログ確認

ログの確認方法：

新しいウィンドウで：
Ctrl+Shift+U → "Extension Host" を選択

パッケージ化（本番用）

# 元のVSCode（開発用）のターミナルで
vsce package

# my-macros-0.0.1.vsix が生成される

警告が出る場合：

WARNING: repository field is missing
WARNING: LICENSE not found

→ 個人利用なら無視してOK（yで続行）

インストール

code --install-extension my-macros-0.0.1.vsix

VSCode再起動後、全環境で使用可能に！

効果的な開発ワークフロー

watch モードの活用

# ファイル変更を自動検知してコンパイル
npm run watch

別ターミナルで実行しておけば、ファイル保存時に自動コンパイルされます。

バージョン管理

# パッチバージョンアップ（0.0.1 → 0.0.2）
npm version patch

# マイナーバージョンアップ（0.0.2 → 0.1.0）
npm version minor

# メジャーバージョンアップ（0.1.0 → 1.0.0）
npm version major

日常的な更新フロー

# 1. マクロファイル編集
code src/macros/openPath.ts

# 2. 自動コンパイル（watchモード使用時）

# 3. F5でデバッグ実行してテスト

# 4. 問題なければコミット
git add .
git commit -m "Fix: improve openPath functionality"

# 5. バージョンアップ
npm version patch

# 6. 再パッケージ化
vsce package

# 7. 再インストール
code --install-extension my-macros-0.0.2.vsix

# 8. VSCode再起動

キーバインド設計

設定場所の使い分け

package.json（拡張機能内）：

• 変更頻度が低いデフォルト設定
• 他のユーザーと共有する設定

keybindings.json（ユーザー設定）：

• 個人の好みに合わせたカスタマイズ
• いつでも変更可能

おすすめキー設定

競合しにくいキー：

{
  "keybindings": [
    // Ctrl+Alt+[文字]（比較的空いている）
    {
      "command": "myMacros.copyToEmptyLine",
      "key": "ctrl+alt+e"
    },
    
    // 2段階キー（VSCodeスタイル）
    {
      "command": "myMacros.openPath",
      "key": "ctrl+k ctrl+o"
    },
    
    // Ctrl+Shift+Alt+[文字]（ほぼ確実に空いている）
    {
      "command": "myMacros.textCalc",
      "key": "ctrl+shift+alt+c"
    }
  ]
}

when句による条件分岐

{
  "key": "ctrl+t",
  "command": "myMacros.textCalc",
  "when": "editorTextFocus && !terminalFocus"
}

主なwhen条件：

• editorTextFocus: エディタにフォーカス
• terminalFocus: ターミナルにフォーカス
• !condition: 条件の否定
• condition1 && condition2: AND条件

メリット・デメリット

メリット

1. 型安全な開発

• コンパイル時エラー検出
• IntelliSenseによる補完
• リファクタリングが安全

2. VSCode公式推奨

• サンプルコードがすべてTypeScript
• ドキュメントが充実
• コミュニティが活発

3. 保守性の高さ

• コードの可読性向上
• バグの早期発見
• チーム開発に適している

4. Git管理

• バージョン履歴を残せる
• 複数PC間で同期
• チーム共有が容易

デメリット

1. 初期セットアップに時間

• 環境構築が必要
• 学習コストがある（ただしJava経験者なら低い）

2. コンパイルが必要

• npm run compileを実行する必要
• ただしwatchモードで自動化可能

3. パッケージ化の手間

• 更新のたびに再パッケージ化
• ただし開発中はF5デバッグで回避可能

総評

デメリットを上回るメリットがある

特に、エディタの補完機能だけで開発効率が10倍変わります。

トラブルシューティング

コンパイルエラー

エラー: Cannot find module 'vscode'

npm install

型エラー: 'lines' has type 'any[]'

// 修正前
const lines = [];

// 修正後
const lines: string[] = [];

インストールエラー

npm install失敗

# 依存関係の競合を回避
npm install --legacy-peer-deps

# または package-lock.json を削除して再実行
rm package-lock.json
npm install --legacy-peer-deps

拡張機能が認識されない

# 拡張機能一覧を確認
code --list-extensions

# 再インストール
code --uninstall-extension your-name.my-macros
code --install-extension my-macros-0.0.1.vsix

# VSCode完全再起動

デバッグ方法

console.logの確認：

export function openPath() {
    console.log('openPath called');
    // ...
}

F5で新しいウィンドウを開く
↓
Ctrl+Shift+U → "Extension Host"
↓
ログが表示される

効果的な使い方

Keyboard Macro Betaとの併用

使い分け：

• 簡単な操作記録 → Keyboard Macro Beta
• 複雑なロジック → TypeScript実装

共存設定：

// keybindings.json
[
    // Keyboard Macro Beta
    {
        "key": "ctrl+alt+r",
        "command": "kb-macro.startRecording"
    },
    
    // TypeScript実装マクロ
    {
        "key": "ctrl+shift+f12",
        "command": "myMacros.openPath"
    }
]

VSCode標準機能との組み合わせ

例：マルチカーソル + カスタムマクロ

1. Alt+クリックで複数カーソル配置
2. カスタムマクロ実行
3. → すべての位置で一括処理

ワークスペース固有の設定

// .vscode/settings.json（プロジェクトごと）
{
    "myMacros.customPath": "${workspaceFolder}/custom"
}

次のステップ

より高度な機能の実装

• ファイル監視
• 外部APIとの連携
• UIコンポーネントの表示
• 設定画面の追加

チーム展開

# リポジトリ公開
git remote add origin https://github.com/YOUR_USERNAME/my-macros.git
git push -u origin main

# チームメンバーは
git clone https://github.com/YOUR_USERNAME/my-macros.git
cd my-macros
npm install --legacy-peer-deps
vsce package
code --install-extension my-macros-0.0.1.vsix

まとめ

VSCode TypeScriptマクロ開発環境の構築は、初期投資こそ必要ですが、一度セットアップすれば：

得られるメリット：

• 型安全な開発環境
• 完璧なIntelliSense
• Git管理による履歴保持
• 柔軟なカスタマイズ

こんな人におすすめ：

• VSCodeのヘビーユーザー
• 効率化マニア
• TypeScript/JavaScript経験者
• Git管理したい

次は実際に作成したマクロの実装例を紹介します！

関連記事

移行の経緯と環境構築

サクラエディタからVSCodeへマクロ移行！快適開発環境の構築記録

はじめに長年愛用してきたサクラエディタのマクロ機能。便利なJavaScript/VBSマクロを多数作成して日常業務で活用してきましたが、最近のAWS開発やブログ執筆でVSCodeを使う機会が増えてきました。「VSCodeでもサクラエディタの...

caymezon.com

2026.01.25

生産性を上げるキー操作

VSCode標準ショートカットキー完全ガイド【日本語解説・おすすめ付き】

はじめにVSCodeを使いこなすには、ショートカットキーの習得が必須です。しかし、VSCodeの標準ショートカット一覧は英語表記で分かりにくいのが難点。本記事では、VSCodeの標準ショートカットキーをカテゴリ別に日本語化し、特に重要なもの...

caymezon.com

2026.01.25

タグ: #VSCode #TypeScript #拡張機能開発 #マクロ #開発環境 #生産性向上

The post VSCode TypeScriptマクロ開発環境の完全ガイド【セットアップから運用まで】 first appeared on CayTech Lab.

はじめに

Claude Desktopは、Claudeをネイティブアプリとして利用できる強力なツールです。本記事では、Web版との違い、効果的な使い方、トークン消費を最小化するテクニック、そして今後の展望まで、実践的な知見を完全網羅します。

🖥️ Claude Desktop とは？

概要

Claude Desktopは、Anthropic社が提供するClaudeのネイティブデスクトップアプリケーションです。

Web版との違い

🤖 Claude Cowork（2026年1月登場・4月GA）

Claude Desktop には Cowork タブが追加され、エージェント型AIとして自律的にタスクを実行できるようになりました。2026年1月にResearch Previewとして公開され、2026年4月9日に一般提供（GA）開始しました。

Coworkとは？

通常の「チャット」が対話型なのに対し、Coworkは複数ステップのタスクを自律実行するモードです。コーディングスキル不要で、知識労働者向けの自動化ツールとして設計されています。

主な機能

料金

機能差はなく、全プランで同じCowork機能が利用できます。

アクセス方法

Claude Desktop上部の「Cowork」タブをクリックするだけです。Webブラウザ版（claude.ai）では利用できません（Desktop専用）。

注意: 古いバージョンのClaude DesktopにはCoworkタブがない場合があります。最新版をダウンロードして上書きインストールしてください。

Coworkをいつ使うべきか？チャットとの使い分け

具体的な利用シーン

シーン1：毎週やっている週次レポートをまかせたい（会社員・フリーランス向け）

状況:
毎週月曜日に先週の作業ログ（テキストファイル）を元に
週次レポートをWordに書いている。毎回30分かかっていた。

Coworkへの指示:
「Dドライブのwork-logフォルダにある先週分のログファイルを読んで、
 週次レポートのフォーマット（report-template.docx）に沿って
 まとめてreports/2026-03-28.docxとして保存して」

結果:
Coworkがファイルを自動で読み込み → テンプレートに整形 → 保存まで完了
自分は指示を出すだけ

シーン2：大量の画像・スクリーンショットを整理したい（誰でも）

状況:
デスクトップに3ヶ月分のスクリーンショットが300枚散乱している。
日付別・プロジェクト別に整理したいが手作業は面倒。

Coworkへの指示:
「デスクトップのScreenshotsフォルダにある画像ファイルを
 撮影日ごとにサブフォルダ（2026-01、2026-02 等）に分類して整理して」

結果:
Coworkがファイルの作成日時を確認しながら自動でフォルダ分け

シーン3：複数のCSVを集計してレポートを作りたい（事務・経理向け）

状況:
各部署から集まったCSVファイル（10ファイル）を合算して
月次集計表を作るのに毎月2時間かかっていた。

Coworkへの指示:
「monthly-dataフォルダ内のCSVファイルを全て読んで、
 売上合計と部門別の内訳をまとめた集計表をExcelで出力して」

結果:
10ファイルを自動で読み込み → 集計 → Excelに出力

シーン4：Webリサーチ結果をまとめたドキュメントを作りたい（ライター・企画職向け）

状況:
競合他社5社のサービスページを調べて比較表を作る作業がある。
ブラウザを行き来しながらメモするのが手間だった。

Coworkへの指示:
「以下5社のサービスページを調べて、価格・機能・特徴を比較した
 Markdownの比較表を作成してcompare.mdとして保存して」

結果:
Coworkがブラウザで各ページにアクセス → 情報を収集 → 比較表を自動生成

シーン5：外出中にPCで作業を進めておきたい（Dispatch活用）

状況:
移動中にスマホで「この資料を整理しておいてほしい」と思いついた。

操作:
スマホのClaudeアプリから「documents/提案書フォルダを
 プロジェクト名ごとにサブフォルダに整理して」とタスクを送信

結果:
帰宅したらPC上での整理が完了している
（Dispatch機能によりスマホ→PC連携）

🎯 デスクトップ版だからできること

1. MCP（Model Context Protocol）統合

最大の強みは、MCPサーバーとの統合です。

Claude Desktop
    ↓
MCPサーバー接続
    ↓
✅ GitHub（リポジトリ操作）
✅ Google Drive（ファイル管理）
✅ Slack（メッセージ送信）
✅ PostgreSQL（DB操作）
✅ その他100+のツール

実例：GitHub MCP

あなた: 「caytech-blog-repoのpublish.jsを確認して」

Claude Desktop:
[GitHub MCPでリポジトリアクセス]
[35KB全文を取得]
[詳細なコードレビューを実施]

Web版では不可能な、リアルタイムリポジトリアクセスが実現します。

詳しいセットアップ方法：

【2026年版】Claude Desktop + GitHub MCP 完全セットアップガイド - 初心者でも30分で完了

はじめにClaude Desktop + GitHub MCP（Model Context Protocol） を使えば、あなたのGitHubリポジトリ全体をClaudeから直接操作できます。この記事では、完全初心者でも30分でセットアップ...

caymezon.com

2026.01.24

2. ローカルファイルシステムへのアクセス

Desktop Commander MCPなどを使えば：

✅ ローカルファイルの読み書き
✅ ターミナルコマンド実行
✅ ディレクトリ検索
✅ Excel/PDF操作

3. 安定したパフォーマンス

Web版の問題：

• 長時間利用でブラウザが重くなる
• タブを閉じると会話が消える可能性
• JavaScriptヒープのメモリリーク

Desktop版の強み：

• 専用プロセスで安定動作
• 長時間の会話でも快適
• MCPツールとの統合が最適化

4. オフライン対応（一部機能）

• アプリの起動
• ローカル設定の管理
• 過去の会話の閲覧（キャッシュ）

※ AI応答には常にインターネット接続が必要

💰 トークン消費とCurrent Session

重要な事実

claude.ai (Web) + Claude Desktop + Claude Code
        ↓
     同じアカウント
        ↓
   同じusage limit

Desktop版もWeb版も、トークン消費量は同じです。

Usage Limitの詳細

トークン消費の内訳

1回のメッセージ送信で消費されるトークン:
├─ システムプロンプト: 約3,000トークン
├─ MCPツール定義: 約5,000〜80,000トークン
├─ プロジェクトファイル: ファイルサイズ次第
├─ 会話履歴: 累積
└─ あなたのメッセージ + Claude の応答

MCPツールのトークン消費

注意：MCPツールは初期から大量のトークンを消費します

実例：

GitHub MCP単体: 約5,000トークン
4つのMCPサーバー: 約67,000トークン（context windowの33%）

↓

Tool Search機能（2026年1月導入・現在はデフォルト有効）で46.9%削減

推奨：必要最小限のMCPのみ有効化

🚀 トークン消費を抑えるベストプラクティス

1. こまめに新規会話を開始

Claudeは毎回、会話履歴全体を再処理します

❌ 悪い例:
1つの会話で全作業を継続
↓
会話履歴が膨大化（10,000トークン+）
↓
毎回のメッセージで全履歴を再処理
↓
トークン消費が加速

✅ 良い例:
タスクごとに新規会話を開始
- 「publish.js修正」→ 新規会話A
- 「check-posts.js確認」→ 新規会話B
- 「記事状態確認」→ 新規会話C

2. 質問をまとめる

❌ 悪い例（3回のやり取り）:
あなた: 「publish.jsを見せて」
Claude: [全文表示]
あなた: 「行742は？」
Claude: [説明]
あなた: 「行766は？」
Claude: [説明]
→ 合計: 約25,000トークン消費

✅ 良い例（1回のやり取り）:
あなた: 「publish.jsの行742-766を確認して、
複数スラッグ対応が正しく実装されているかレビューしてください」
Claude: [一度に完全な回答]
→ 合計: 約10,000トークン消費

節約効果: 60%削減

3. 不要なMCPツールを無効化

# (Claude Desktopアプリ外から実行)

# 設定ファイルを編集
# Windows: %APPDATA%\Claude\claude_desktop_config.json
# macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

# 使わないMCPサーバーをコメントアウト
{
  "mcpServers": {
    "github": { ... },  // ✅ 常に使用
    // "postgres": { ... },  // ❌ 今は不要
    // "google-drive": { ... }  // ❌ 今は不要
  }
}

4. プロジェクト機能の賢い使い方

プロジェクトの「手順」:
✅ 簡潔な指示（200-300語）
✅ よく使うコマンド
✅ ファイルパス

プロジェクトの「ファイル」:
❌ 大きなコードファイル（4KB制限あり）
✅ 小さなドキュメント（README.md等）
✅ GitHub MCPで代替可能

詳しい問題背景：

【2026年1月】Claudeプロジェクトのファイル文字化け問題と解決法 - UTF-8 BOM付き保存の効果

はじめにClaudeのProプラン以上で利用できる「プロジェクト機能」で、JavaScriptファイルをアップロードすると日本語コメントが文字化けするという問題に遭遇しました。本記事では、この問題の原因究明から解決までの実体験を詳しく解説し...

caymezon.com

2026.01.24

5. 効率的なモデル選択

Sonnet 4.6で十分なタスクにOpus 4.7を使うと、トークン消費が増大します。

6. /compact コマンド活用

長い会話を要約：

/compact 「コード実装とAPIの使い方に焦点を当てて要約」

これで会話履歴を大幅に削減できます。

📊 実践的な運用例

ブログ管理の場合

朝の作業開始

1. Claude Desktop起動
2. 「ブログ管理」プロジェクトを開く
3. 新規会話を開始

あなた: 「caytech-blog-repoの今日のタスクを確認」

Claude: 
[GitHub MCPで最新状態を取得]
[未完成記事（status: draft）を確認]
[投稿準備完了（status: ready）を確認]
「今日は2件のreadyな記事があります...」

作業中（タスクごとに新規会話）

会話A: 「publish.js修正」
会話B: 「check-posts.js確認」
会話C: 「記事状態確認」
会話D: 「新記事のアイデア出し」

夕方（1日のレビュー）

新規会話E:
「今日のcaytech-blog-repoの変更をレビューして、
適切なGitコミットメッセージを提案してください」

アプリ開発の場合

プロジェクト: React アプリ開発
MCPサーバー:
├─ GitHub（コード管理）
├─ PostgreSQL（DB操作）
└─ Slack（通知送信）

朝:
会話1: 「今日のIssue確認」

午前:
会話2: 「ユーザー認証機能の実装」

午後:
会話3: 「API連携のデバッグ」

夕方:
会話4: 「今日の進捗まとめ」

⚠️ デメリットと注意点

デメリット

1. アプリのインストールが必要

   • Web版のように即座に使えない
   • 管理者権限が必要な場合がある

2. 初期設定が複雑

   • MCPサーバーの設定
   • JSON設定ファイルの編集

3. トークン消費は変わらない

   • Web版と同じusage limit
   • MCPツールが追加消費

4. Web版の一部機能が未対応

   • 一部のブラウザ拡張機能
   • Webベースの連携サービス

注意点

1. プライバシー設定

GitHub PATなどの認証情報は：

• ✅ ローカルに保存（暗号化推奨）
• ❌ 公開リポジトリにコミット禁止
• ❌ 他人と共有禁止

2. MCPサーバーの信頼性

⚠️ Use third party MCP servers at your own risk

公式以外のMCPサーバーは、信頼できる開発者のものを選びましょう。

3. トークン消費の予期せぬ増加

MCPツールを大量に有効化すると：

MCPツール定義: 80,000トークン（40%消費）
↓
実際の作業スペース: 120,000トークン（60%）
↓
会話できる内容が制限される

🔮 今後の展望

実現済みの進化（2026年）

✅ Cowork機能の統合（2026年1月〜）

Claude Desktop に Cowork タブが追加。エージェント型AIとして複雑なタスクを自律実行できるようになりました。

✅ コンピュータ操作機能（2026年3月23日〜）

Claude CoworkとClaude Codeがコンピュータを直接操作してタスクを完了できるようになりました。Windows/Mac両対応です。

✅ Coworkマーケットプレイス（2026年2月24日〜）

Google Drive・Gmail・DocuSign・FactSetなど12種類のMCPコネクタが追加。部門別AIエージェントも提供されています。

✅ Cowork 一般提供（GA）開始（2026年4月9日〜）

Research Previewから正式な一般提供へ移行。エンタープライズ向けにロールベースアクセス制御（RBAC）・グループ単位の利用上限・使用状況分析機能も追加されました。

✅ Claude Code デスクトップ版の大幅刷新（2026年4月14日〜）

Claude Code デスクトップアプリが並列エージェント時代に合わせて再設計されました。主な新機能：

※ Claude Code Desktop v1.2581.0以上で利用可能。Pro / Max / Team / Enterprise の全プランが対象。

✅ Opus 4.7 リリース（2026年4月16日〜）

Claude最上位モデルが更新。SWE-bench Pro 64.3%・SWE-bench Verified 87.6%という高いコーディング性能を実現しました。

今後の予想

1. Tool Search機能の拡充

現状: 46.9%のトークン削減
↓
将来: 90%以上の削減を目標
↓
さらに多くのMCPツールを同時利用可能

2. プロジェクトファイルの制限緩和

現状: 約4KB（114行）
↓
期待: 100KB以上
↓
より大きなコードファイルをプロジェクトで管理

3. ローカルLLMとの統合

Claude Desktop
    ↓
ローカルLLM（Ollama等）
    ↓
完全オフライン動作

懸念事項

1. トークン消費の増加トレンド

2025年10月: ユーザー報告「消費量が突然増加」
2025年12月: ホリデー期間に2倍のlimit提供
2026年1月: 通常limitに戻り、ユーザーから不満

↓

将来的にさらなる制限強化の可能性

2. 料金体系の変更

現状: Proプラン $20/月
↓
可能性: 従量課金制度の導入
↓
使いすぎに注意が必要

3. API制限との兼ね合い

GitHub APIなど外部サービスの制限：

GitHub API: 5,000リクエスト/時
↓
Claude Desktopで大量操作
↓
API制限に到達する可能性

🎯 様々な場面での活用法

1. ブログ・コンテンツ制作

✅ 記事構成のアイデア出し
✅ WordPress自動投稿
✅ SEOキーワード分析
✅ 画像説明文の生成
✅ 関連記事の提案

2. Web開発

✅ コードレビュー
✅ バグの特定と修正
✅ リファクタリング提案
✅ API設計
✅ テストコード生成

3. データ分析

✅ CSVファイル分析
✅ グラフ生成
✅ 統計処理
✅ レポート作成
✅ データクリーニング

4. ドキュメント作成

✅ README.md生成
✅ API仕様書作成
✅ マニュアル執筆
✅ コメント自動生成
✅ 翻訳

5. プロジェクト管理

✅ Issue管理
✅ PR作成・レビュー
✅ ブランチ戦略提案
✅ リリースノート生成
✅ タスク優先順位付け

6. 学習・教育

✅ コードの説明
✅ 技術記事の要約
✅ チュートリアル作成
✅ エラーメッセージの解説
✅ ベストプラクティスの提案

📊 メリット・デメリット総まとめ

メリット ✅

デメリット ❌

📚 関連記事

【2026年版】Claude Desktop + GitHub MCP 完全セットアップガイド - 初心者でも30分で完了

はじめにClaude Desktop + GitHub MCP（Model Context Protocol） を使えば、あなたのGitHubリポジトリ全体をClaudeから直接操作できます。この記事では、完全初心者でも30分でセットアップ...

caymezon.com

2026.01.24

【2026年1月】Claudeプロジェクトのファイル文字化け問題と解決法 - UTF-8 BOM付き保存の効果

はじめにClaudeのProプラン以上で利用できる「プロジェクト機能」で、JavaScriptファイルをアップロードすると日本語コメントが文字化けするという問題に遭遇しました。本記事では、この問題の原因究明から解決までの実体験を詳しく解説し...

caymezon.com

2026.01.24

• 【まとめ記事】Claude Desktop完全攻略ロードマップ｜MCP設定・GitHub連携・活用術を体系的に学ぶ

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

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

caymezon.com

2026.03.21

• 【2026年最新】Claude Cowork完全ガイド - PCデスクトップ作業をAIに丸投げする方法

【2026年最新】Claude Coworkとは？完全ガイド - PCデスクトップ作業でAIを使ってできること

はじめに「この繰り返し作業、AIに任せられたらいいのに」と思ったことはありませんか？Claude Coworkは、その願いをそのまま実現する機能です。ファイル整理・レポート作成・ブラウザ操作まで、あなたのPCを自律的に操作してタスクを完了し...

caymezon.com

2026.03.28

• 【実践編】Claude Cowork 活用事例10パターン - プロンプト例と得られる効果まとめ

【実践編】Claude Cowork 活用事例10パターン - プロンプトの使い方と得られる効果まとめ

はじめに「Claude Coworkって面白そうだけど、具体的に何ができるの？」この記事では、Coworkを実際に使ってみて「これは便利だ」と感じた利用シーンを10パターン厳選して紹介します。実際に入力するプロンプト例と得られる効果をセット...

caymezon.com

2026.03.28

📝 まとめ

Claude Desktopを選ぶべき人

✅ 大きなコードベースを扱う開発者
✅ GitHubリポジトリを頻繁に操作する
✅ 長時間の作業セッションが多い
✅ MCPツールを活用したい
✅ より高度な自動化を求める
✅ Coworkで複雑な業務タスクを自動化したい（非エンジニアも対象）

Web版で十分な人

✅ 簡単な質問・相談のみ
✅ ブラウザ環境で完結
✅ セットアップの手間を避けたい
✅ 短時間の利用が中心

最も重要なポイント

1. Desktop版でもトークン消費は同じ
   → 会話管理が重要

2. MCPツールは強力だが、トークンを消費
   → 必要最小限に

3. プロジェクトファイルは4KB制限
   → GitHub MCPで解決

4. タスクごとに新規会話
   → トークン節約の最重要テクニック

今日から始められること

1. Claude Desktopをインストール（5分）※最新版: claude.com/download
2. Coworkタブを開いてプロジェクト（フォルダ）を登録（5分）
3. GitHub MCPをセットアップ（30分）
4. タスクごとに新規会話を開始（今すぐ）
5. 質問をまとめて送信（今すぐ）
6. 不要なMCPを無効化（5分）

参考リンク

• Claude公式ドキュメント
• Model Context Protocol
• Claude Desktop ダウンロード
• GitHub MCP Server
• MCPサーバー一覧

更新履歴

• 2026-01-24: 初版公開
• 2026-03-28: Cowork機能追加・モデル名更新・最新情報反映
• 2026-04-25: Cowork GA・Claude Code Desktop刷新・Opus 4.7・MCP Tool Search仕様反映

Happy Coding with Claude Desktop! 🚀

The post 【2026年版】Claude Desktop 効果的な活用ガイド - メリット・デメリット・ベストプラクティス完全版 first appeared on CayTech Lab.

はじめに

Claude Desktop + GitHub MCP（Model Context Protocol） を使えば、あなたのGitHubリポジトリ全体をClaudeから直接操作できます。

この記事では、完全初心者でも30分でセットアップできるよう、すべての手順を画像付きで詳しく解説します。

🎯 このセットアップで得られるもの

セットアップ完了後、以下のことが可能になります：

✅ ファイルサイズ制限なし（プロジェクト機能の4KB制限を回避）
✅ リポジトリ全体にリアルタイムアクセス
✅ ファイルの読み書き・編集
✅ Issue/PR管理
✅ 常に最新版を参照
✅ プライベートリポジトリにもアクセス可能

具体的な活用例

あなた: 「caytech-blog-repoのscripts/publish.jsの行742-766を確認して」

Claude: 
[GitHub MCPでリポジトリから最新版を取得]
[35KB全文を確認]
「複数スラッグ対応が正しく実装されています...」

プロジェクトファイルの4KB制限から完全に解放されます！

詳しい問題背景はこちら：

【2026年1月】Claudeプロジェクトのファイル文字化け問題と解決法 - UTF-8 BOM付き保存の効果

はじめにClaudeのProプラン以上で利用できる「プロジェクト機能」で、JavaScriptファイルをアップロードすると日本語コメントが文字化けするという問題に遭遇しました。本記事では、この問題の原因究明から解決までの実体験を詳しく解説し...

caymezon.com

2026.01.24

📋 事前準備

必要なもの

所要時間

• 初めての方: 約30分
• 経験者: 約10分

🚀 ステップ1: Node.jsインストール

すでにNode.jsがインストールされている方はステップ2へ。

1-1. Node.jsのダウンロード

1. Node.js公式サイトにアクセス
2. 「LTS（推奨版）」 をクリックしてダウンロード

1-2. インストール

1. ダウンロードした.msiファイルを実行
2. すべてデフォルト設定で「Next」をクリック
3. 「Automatically install the necessary tools」に✅チェック
4. インストール完了まで待機

1-3. 確認

コマンドプロンプトを開いて確認：

node --version

npm --version
# 10.x.x のように表示されればOK

📥 ステップ2: Claude Desktopアプリのインストール

2-1. ダウンロード

1. Claude公式サイトにアクセス
2. Windows版をダウンロード

2-2. インストール

1. ダウンロードした.exeファイルを実行
2. インストーラーの指示に従う
3. Claude.aiアカウントでログイン

🔑 ステップ3: GitHub Personal Access Token (PAT) の作成

3-1. GitHubにアクセス

1. GitHub Settings - Tokensにアクセス
2. 「Generate new token」 をクリック
3. 「Generate new token (classic)」 を選択

3-2. トークンの設定

Select scopes（権限）：

以下の項目に✅チェックを入れます：

✅ repo (Full control of private repositories)
  ├─ repo:status
  ├─ repo_deployment
  ├─ public_repo
  └─ repo:invite

✅ workflow (Update GitHub Action workflows)

✅ admin:org → read:org 
  └─ (Read org and team membership)

✅ user (Update ALL user data)
  └─ user:email

3-3. トークンをコピー

1. 「Generate token」 をクリック
2. 表示されたトークン（ghp_xxxxxxxxxxxx）をコピー
3. 必ず安全な場所に保存（二度と表示されません）

⚠️ 重要： このトークンはパスワード同様に重要です。他人に見せたり、公開リポジトリにコミットしないでください。

⚙️ ステップ4: Claude Desktop設定ファイルの編集

4-1. 設定ファイルを開く

方法A: エクスプローラーから

1. Windowsキー + R を押す
2. %APPDATA%\Claude と入力してEnter
3. claude_desktop_config.json を右クリック
4. 「プログラムから開く」→「メモ帳」または「VSCode」

方法B: コマンドプロンプトから

notepad %APPDATA%\Claude\claude_desktop_config.json

4-2. 設定内容を記述

ファイルが空の場合は、以下をそのままコピー＆ペースト：

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_YOUR_TOKEN_HERE"
      }
    }
  }
}

重要： ghp_YOUR_TOKEN_HERE を、ステップ3でコピーした実際のトークンに置き換えてください。

4-3. 保存

Ctrl + S で保存して、ファイルを閉じます。

🔄 ステップ5: Claude Desktopを再起動

1. Claude Desktopを完全に終了
   • ウィンドウを閉じるだけでなく、タスクトレイのアイコンも右クリック→「終了」
2. Claude Desktopを起動

✅ ステップ6: 動作確認

6-1. 新しいチャットを開始

Claude Desktopで新しいチャットを作成します。

6-2. テスト

以下のように質問してみてください：

私のGitHubリポジトリ一覧を表示してください

または

caytech-blog-repoリポジトリの構造を教えてください

6-3. 成功の確認

Claudeが以下のように応答すれば成功です：

• 🔨 ハンマーアイコンが表示される
• GitHubリポジトリ情報が取得される
• ファイル一覧が表示される

🎉 セットアップ完了！

おめでとうございます！これでClaude DesktopからGitHubリポジトリ全体にアクセスできるようになりました。

💡 実際の使い方

📂 ファイルを読む

caytech-blog-repoの「scripts/publish.js」の内容を全て表示してください

→ 35KB全文が表示されます ✅

📝 複数ファイルを確認

以下のファイルを確認して、全体の構造を教えてください：
- scripts/publish.js
- scripts/check-posts.js  
- readme/USAGE.md

🔍 コードレビュー

publish.jsの行742-766の複数スラッグ対応が
正しく実装されているか確認してください

📊 リポジトリ全体の分析

caytech-blog-repoの全体構造を分析して、
改善点を提案してください

📥 Issueを作成

「publish.js複数スラッグ対応の実装完了」という
Issueを作成してください

🔄 最新の変更を確認

caytech-blog-repoの最近のコミット履歴を表示して、
どんな変更があったか教えてください

🛠️ トラブルシューティング

❌ 「Could not connect to MCP server」エラー

原因1: Node.jsが正しくインストールされていない

node --version
npm --version
# 両方が表示されればOK

表示されない場合は、ステップ1に戻ってNode.jsを再インストールしてください。

原因2: トークンが間違っている

• claude_desktop_config.jsonのトークンを再確認
• GitHubで新しいトークンを作成し直す

原因3: 設定ファイルのJSON形式が間違っている

• カンマ、括弧の位置を確認
• JSONLintで検証

❌ ハンマーアイコンが表示されない

1. Claude Desktopを完全に終了
2. タスクマネージャーで「Claude」プロセスが残っていないか確認
3. Claude Desktopを再起動

❌ ファイルが読めない

スコープ不足の可能性

GitHubでトークンの権限を再確認：

• repoスコープが✅チェックされているか
• トークンが有効期限切れになっていないか

💰 料金について

追加料金は一切かかりません。

📊 トークン消費について

重要な事実

claude.ai (Web) + Claude Desktop + Claude Code
        ↓
     同じアカウント
        ↓
   同じusage limit（5時間ごとに約44,000トークン）

GitHub MCPのトークン消費

GitHubリポジトリ全体のサイズは直接的には影響しません

重要なのは：

1. MCPツールの定義：約5,000トークン（常時）
2. 実際に取得したファイル：内容次第

実例

リポジトリサイズ: 数MB
↓
MCPツール定義: 約5,000トークン
publish.js読み込み: 約8,000トークン（35KB）
↓
合計: 約13,000トークン（Proプランの約30%）

🎯 次のステップ

セットアップが完了したら、Claude Desktopを最大限に活用しましょう：

【2026年版】Claude Desktop 効果的な活用ガイド - メリット・デメリット・ベストプラクティス完全版

はじめにClaude Desktopは、Claudeをネイティブアプリとして利用できる強力なツールです。本記事では、Web版との違い、効果的な使い方、トークン消費を最小化するテクニック、そして今後の展望まで、実践的な知見を完全網羅します。(...

caymezon.com

2026.01.24

📚 関連記事

【2026年1月】Claudeプロジェクトのファイル文字化け問題と解決法 - UTF-8 BOM付き保存の効果

はじめにClaudeのProプラン以上で利用できる「プロジェクト機能」で、JavaScriptファイルをアップロードすると日本語コメントが文字化けするという問題に遭遇しました。本記事では、この問題の原因究明から解決までの実体験を詳しく解説し...

caymezon.com

2026.01.24

📝 まとめ

セットアップの流れ

1. Node.jsインストール（10分）
   ↓
2. Claude Desktopインストール（5分）
   ↓
3. GitHub PATを作成（5分）
   ↓
4. 設定ファイル編集（5分）
   ↓
5. 再起動＆確認（5分）
   ↓
✅ 完了！

得られたメリット

• ✅ ファイルサイズ制限なし
• ✅ リポジトリ全体にアクセス
• ✅ 常に最新版を参照
• ✅ ファイルの読み書き
• ✅ Issue/PR管理
• ✅ プライベートリポジトリ対応

よくある質問

Q: プロジェクトファイルはまだ使えますか？

A: はい。小さなドキュメントファイル（README.mdなど）にはプロジェクトファイルが便利です。大きなコードファイルはGitHub MCPを使いましょう。

Q: 複数のリポジトリにアクセスできますか？

A: はい。同じGitHubアカウントで管理している全てのリポジトリ（プライベート含む）にアクセスできます。

Q: トークンを更新したい場合は？

A: GitHubで新しいトークンを作成し、claude_desktop_config.jsonのトークンを更新して、Claude Desktopを再起動してください。

参考リンク

• Claude公式ドキュメント
• Model Context Protocol
• GitHub MCP Server 公式リポジトリ
• Node.js公式サイト

更新履歴

• 2026-01-24: 初版公開

The post 【2026年版】Claude Desktop + GitHub MCP 完全セットアップガイド - 初心者でも30分で完了 first appeared on CayTech Lab.

はじめに

ClaudeのProプラン以上で利用できる「プロジェクト機能」で、JavaScriptファイルをアップロードすると日本語コメントが文字化けするという問題に遭遇しました。

本記事では、この問題の原因究明から解決までの実体験を詳しく解説します。結論から言うと、UTF-8 BOM（Byte Order Mark）付きで保存することで解決しましたが、さらに便利な方法も見つかりました。

🚨 発生した問題

初期症状

WordPress自動投稿システムの開発中、publish.js（35KB, 860行）をClaudeプロジェクトにアップロードしたところ：

// 正常なコード: // オプション解析
// プロジェクト表示: // オプション解æž

日本語コメントが盛大に文字化けしました。

さらなる調査

ユーザーからの詳細な報告で判明：

• 114行、3901byteまで: 正常表示 ✅
• 3902byte以降: 文字化け ❌

興味深いことに、特定のバイト数境界で問題が発生していました。

🔍 試行錯誤の過程

❌ 最初に試したこと（効果なし）

試行1: 改行コードの変更

dos2unix publish.js

# CRLF → LF に変更
unix2dos publish.js

結果： 文字化けは変わらず ❌

試行2: ファイル名の変更

# .js → .txt に変更
cp publish.js publish.txt

結果： 文字化けは変わらず ❌

試行3: VSCodeで「UTF-8」として保存

VSCodeの右下から「UTF-8」を選択して保存。

結果： 文字化けは変わらず ❌

✅ 解決策の発見

UTF-8 BOM付き保存が効果的！

VSCodeでの操作：

1. ファイルを開く
2. 右下の「UTF-8」をクリック
3. 「UTF-8 with BOM で保存」 を選択
4. 保存して、Claudeプロジェクトに再アップロード

結果：

✅ ファイルサイズ: 28.83 KB（約29KB）
✅ 行数: 864行
✅ 日本語コメント: 完全に正常表示
✅ 文字化けなし

検証結果

🤔 なぜBOMが効果的だったのか？

BOM（Byte Order Mark）とは

BOMは、ファイルの先頭3バイト（EF BB BF）に付加される特殊なマーカーです：

UTF-8 without BOM:
[ファイル内容...]

UTF-8 with BOM:
[EF BB BF][ファイル内容...]
     ↑
   BOMマーカー

Claudeプロジェクトでの効果

推測される理由：

1. エンコーディング自動判定の改善

   • BOMがあることで、Claudeが「UTF-8」であることを確実に認識
   • マルチバイト文字（日本語）の処理が正確に

2. バイト境界の処理改善

   • 3901/3902byte境界での切断問題が解消
   • BOMにより、文字単位での処理が適切に

3. ファイル全体の読み込み

   • BOMによりファイル形式が明確化
   • 切り詰めではなく全文を読み込み

🎯 推奨される保存方法

方法1: VSCodeで保存

Windows

1. ファイルを開く
2. Ctrl + Shift + P でコマンドパレット
3. 「encoding」と入力
4. 「Save with Encoding」 を選択
5. 「UTF-8 with BOM」 を選択

macOS

1. ファイルを開く
2. Cmd + Shift + P でコマンドパレット
3. 「encoding」と入力
4. 「Save with Encoding」 を選択
5. 「UTF-8 with BOM」 を選択

方法2: コマンドラインで一括変換

# Linux/macOS/Git Bash (Windows)
# UTF-8 → UTF-8 with BOM

# 単一ファイル
printf '\xEF\xBB\xBF' | cat - publish.js > publish-utf8bom.js

# 複数ファイルを一括変換
for file in scripts/*.js; do
  printf '\xEF\xBB\xBF' | cat - "$file" > "${file%.js}-utf8bom.js"
done

方法3: Windows PowerShell

# UTF-8 BOM付きで保存
$content = Get-Content -Path "publish.js" -Encoding UTF8
$content | Out-File -FilePath "publish-utf8bom.js" -Encoding UTF8

📊 さらなる解決策：GitHub MCP

UTF-8 BOM付き保存で問題は解決しましたが、もっと便利な方法があります。

Claude Desktop + GitHub MCP

Claude Desktopアプリ に GitHub MCPサーバー を接続すると：

✅ エンコーディング問題を完全回避
✅ ファイルサイズ制限なし
✅ リポジトリ全体にリアルタイムアクセス
✅ ファイル読み書き
✅ BOM付き保存の手間不要
✅ 常に最新版を参照

具体的な利点

実際の使い方

あなた: 「caytech-blog-repoのscripts/publish.jsを確認して」

Claude Desktop (GitHub MCP):
[リポジトリから最新版を取得]
[35KB全文を確認]
[エンコーディング問題なし]
「複数スラッグ対応が正しく実装されています...」

詳しいセットアップ方法：

【2026年版】Claude Desktop + GitHub MCP 完全セットアップガイド - 初心者でも30分で完了

はじめにClaude Desktop + GitHub MCP（Model Context Protocol） を使えば、あなたのGitHubリポジトリ全体をClaudeから直接操作できます。この記事では、完全初心者でも30分でセットアップ...

caymezon.com

2026.01.24

🔬 技術的な詳細

マルチバイト文字の切断問題

UTF-8では、日本語は1文字=3バイト：

// オプション解析
   ↓
[E3 82 AA][E3 83 97][E3 82 B7][E3 83 A7][E3 83 B3]...
   オ      プ      シ      ョ      ン

切断が発生する場合：

3901byte: [E3 82 AA] ← 完全
3902byte: [E3]      ← 不完全（2バイト欠損）
         ↓
      文字化け発生

BOM付きの場合：

[EF BB BF] + ファイル内容
    ↓
エンコーディングが明確
    ↓
文字単位で正しく処理
    ↓
切断されない

📝 プロジェクトファイルの正しい運用

プロジェクトファイルが向いているもの

• ✅ 小〜中規模のコードファイル（UTF-8 BOM付き）
• ✅ ドキュメント（README.md、USAGE.mdなど）
• ✅ 設定ファイル（.env.example、.gitignoreなど）
• ✅ 簡潔な指示（プロジェクトの「手順」セクション）

より便利な選択肢

実用的なプロジェクト構成例

Claudeプロジェクト: ブログ管理

├── 手順（Instructions）
│   ├── 基本情報
│   ├── 重要なファイル位置
│   └── 作業フロー
│
├── ファイル
│   ├── README.md（システム概要） ✅
│   ├── USAGE.md（使い方） ✅
│   └── publish-utf8bom.js（必要に応じて）
│
└── GitHub MCP接続 ⭐
    └── リポジトリ全体にアクセス（推奨）

💡 トークン消費への影響

重要な事実

claude.ai (Web) + Claude Desktop
        ↓
   同じアカウント
        ↓
  同じusage limit（5時間ごとに約44,000トークン）

プロジェクトファイルとGitHub MCP、どちらを使っても基本的なトークン消費は同じです。

それぞれのトークン消費

プロジェクトファイル

publish.js (BOM付き、30KB):
- プロジェクト読み込み: 常時コンテキストに配置
- トークン: 約8,000トークン（常時消費）

GitHub MCP

publish.js (GitHub経由):
- 必要な時だけ取得: 必要時のみコンテキストに配置
- トークン: 約8,000トークン（使用時のみ）
- MCP定義: 約5,000トークン（常時）

GitHub MCPの方が効率的：必要な時だけファイルを取得するため。

🎯 ベストプラクティス

シナリオ別の推奨方法

シナリオ1: 単発の確認作業

✅ 推奨: UTF-8 BOM付きでプロジェクトファイル
理由: 手軽、セットアップ不要

シナリオ2: 継続的な開発作業

✅ 推奨: Claude Desktop + GitHub MCP
理由: 常に最新版、複数ファイル、エンコーディング不要

シナリオ3: チーム開発

✅ 推奨: Claude Desktop + GitHub MCP
理由: 全員が同じリポジトリにアクセス、履歴管理

トークン節約テクニック

1. こまめに新規会話を開始

   • タスクごとに分ける
   • 会話履歴の累積を防ぐ

2. 質問をまとめる

   • 1回で完結させる
   • 往復を減らす

3. 必要なファイルのみ参照

   • 全ファイルを一度に読まない
   • GitHub MCPで必要な部分だけ取得

詳しくは次の記事で：

【2026年版】Claude Desktop + GitHub MCP 完全セットアップガイド - 初心者でも30分で完了

はじめにClaude Desktop + GitHub MCP（Model Context Protocol） を使えば、あなたのGitHubリポジトリ全体をClaudeから直接操作できます。この記事では、完全初心者でも30分でセットアップ...

caymezon.com

2026.01.24

📊 解決方法の比較

完全比較表

推奨度

🥇 1位: Claude Desktop + GitHub MCP
└─ 長期的な開発・チーム作業に最適

🥈 2位: UTF-8 BOM付きプロジェクトファイル
└─ 単発確認・個人作業に便利

🥉 3位: チャット内アップロード
└─ 一時的な確認に使用

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

Q1: BOM付きで保存したのに文字化けする

確認ポイント：

1. 本当にBOMが付いているか確認

   # Linux/macOS/Git Bash
   xxd -l 3 publish.js
   # 出力: 0000000: efbb bf
   # ↑ これがあればBOM付き

2. ファイルサイズを確認

   • 極端に大きいファイル（100MB以上）は制限がある可能性

3. 再アップロード

   • Claudeプロジェクトから一度削除
   • 再度アップロード

Q2: BOMを付けるとエラーが出る

JavaScriptでBOMが原因でエラーが出る場合：

// ❌ Node.jsで実行するとエラー
// SyntaxError: Invalid or unexpected token

// ✅ 解決策
// Claudeプロジェクト用: UTF-8 BOM
// 実行用: UTF-8 without BOM

// 2つのファイルを用意：
publish.js         // 実行用（BOMなし）
publish-bom.js     // Claude用（BOM付き）

または： GitHub MCPを使えばこの問題は発生しません。

Q3: 複数のファイルを一度にBOM付きにしたい

# Linux/macOS/Git Bash
# scriptsフォルダ内の全.jsファイルをBOM付きに

for file in scripts/*.js; do
  # BOMが既にあるかチェック
  if ! head -c 3 "$file" | xxd -p | grep -q "efbbbf"; then
    # BOMを追加
    printf '\xEF\xBB\xBF' | cat - "$file" > "${file}.tmp"
    mv "${file}.tmp" "$file"
    echo "BOM added: $file"
  else
    echo "Already has BOM: $file"
  fi
done

📝 まとめ

問題と解決

重要なポイント

1. UTF-8 BOM付き保存で文字化けは解決 ✅
2. 3901/3902byte境界問題も解消 ✅
3. VSCodeで簡単に変換可能 ✅
4. さらに便利なのはGitHub MCP ⭐

推奨される運用

【パターンA: 単発確認】
UTF-8 BOM付きでプロジェクトファイル
↓
手軽に確認

【パターンB: 継続開発】
Claude Desktop + GitHub MCP
↓
効率的な開発環境

次のステップ

より快適な開発環境を構築しましょう：

【2026年版】Claude Desktop + GitHub MCP 完全セットアップガイド - 初心者でも30分で完了

はじめにClaude Desktop + GitHub MCP（Model Context Protocol） を使えば、あなたのGitHubリポジトリ全体をClaudeから直接操作できます。この記事では、完全初心者でも30分でセットアップ...

caymezon.com

2026.01.24

【2026年版】Claude Desktop 効果的な活用ガイド - メリット・デメリット・ベストプラクティス完全版

はじめにClaude Desktopは、Claudeをネイティブアプリとして利用できる強力なツールです。本記事では、Web版との違い、効果的な使い方、トークン消費を最小化するテクニック、そして今後の展望まで、実践的な知見を完全網羅します。(...

caymezon.com

2026.01.24

参考情報

• Unicode BOM (Byte Order Mark) 仕様
• VSCode Encoding Documentation
• Claude公式ドキュメント
• Model Context Protocol

更新履歴

• 2026-01-24: 初版公開（UTF-8 BOM解決策を確認）

The post 【2026年1月】Claudeプロジェクトのファイル文字化け問題と解決法 - UTF-8 BOM付き保存の効果 first appeared on CayTech Lab.