タグ: 初期設定

  • 隠しファイル ー 「.claudeフォルダ」が見つからなくて、3日詰まった

    隠しファイル ー 「.claudeフォルダ」が見つからなくて、3日詰まった

    ウォーリーをさがせ、状態だった

    「C:\Users\ユーザー名\.claude\settings.json を編集してください」。チュートリアルにそう書いてあった。私はエクスプローラーを開いた。Users を開いた。自分の名前のフォルダを開いた。.claude フォルダを探した。ない。

    ない。何度見てもない。スクロールしてもない。検索してもない。私はその日、3時間ほど「自分のパソコンには .claude フォルダが存在しないバグ」と本気で戦って、最終的にClaude本体の再インストールまで試した(もちろん解決しなかった)。先に結論を言うと、フォルダは最初からそこにあった。ただ私の目に映っていなかっただけである。ウォーリーは赤と白のシマシマで主張しているが、隠しファイルは主張すらしてくれない。


    結論マップ(ビフォー/アフター)

    場面これまで隠しファイル表示後
    .claude フォルダ「存在しないバグ」と疑う普通にユーザーフォルダ直下にある
    .gitconfig などの設定ファイルチュートリアルが嘘だと思う一覧にちゃんと並んでいる
    表示切り替え知らない(3時間悩む)エクスプローラーの「表示」から1クリック

    3行で済む。ウォーリーは見つかれば赤白シマシマだが、隠しファイルは表示設定をオンにすれば普通の名前で出てくるだけだった。


    そもそも「隠しファイル」とは

    隠しファイル(および隠しフォルダ)は、ファイル管理ツールが標準では一覧に表示しないファイルのこと。Windowsだと、ファイルの「属性」に 隠し(Hidden) という旗が立っているもの、もしくは 名前がドット(.)で始まるもの(後者はもともとUnix系の慣習)が、エクスプローラーの初期設定では非表示になる。

    なぜ隠すのかというと、OSやアプリの動作を支える「触ってほしくない設定ファイル」が、普段の作業の邪魔にならないようにするためだ。.claude・.gitconfig・.env・.ssh など、ドットで始まるフォルダ/ファイルは、各アプリが「自分の設定置き場」として勝手に作っていく場所で、たいていは触らないほうが幸せに暮らせる。Claudeの設定をいじるときだけ、こちらから「ちょっと見せて」とお願いする、くらいの距離感がちょうどいい。

    ちなみに、ドットで始まる名前のことを英語圏では dotfile と呼ぶ。「設定ファイルの集合体」の通称みたいなもの。Macを使っている開発者の方が「dotfilesをGitHubで公開してます」と言っているのは、たいていこのドット系設定の集まりを共有している、ということだ。


    Windowsで表示する:3クリックで終わる

    1. エクスプローラー(Windowsのファイル管理ツール)を開く
    2. ウィンドウ上部の 「表示」 メニューをクリック
    3. 出てきたサブメニューで 「表示」 にマウスを合わせる(同じ名前が二段階続くので、ここで一度迷子になりがち)
    4. 一覧の中にある 「隠しファイル」 にチェックを入れる
    5. 一覧に薄い色の .claude フォルダや AppData などが追加で表示されるようになる

    これで .claude フォルダが姿を現す。薄いアイコンで表示されるのは「これは隠しファイルですよ、本当にいじっていいんですか?」というOSからの優しい警告だと思っている(薄いまま3日くらい眺めていれば、勝手に消えてくれるわけではない)。

    なお、Windows 10 の頃はリボン(タブ式メニュー)の中に「隠しファイル」のチェックボックスがあった。Windows 11 で「表示 → 表示」の二段構えに変わって、これが地味に分かりにくい原因になっている。私もWindows 10時代の手順をうろ覚えで探していて、しばらく途方に暮れていた。


    PowerShellで一発で見る方法

    エクスプローラーの設定をいじりたくない、見るだけ見たい、という場合は、ターミナル(PowerShell)から覗くのが速い。

    # 隠しファイルも含めてユーザーフォルダの中身を一覧
    > Get-ChildItem -Force C:\Users\Ranni
    # 略記版(dirとlsはGet-ChildItemの別名)
    > dir -Force C:\Users\Ranni
    > ls -Force C:\Users\Ranni
    # .claudeフォルダの中身を直接見る
    > Get-ChildItem -Force C:\Users\Ranni\.claude

    💡 ポイント: -Force オプションが「隠しファイルも全部見せて」のスイッチ。これを付けないと、PowerShellでもエクスプローラーと同じように隠しファイルが省略される。コマンドプロンプト派の人は dir /a でも同じことができる(/a が「全部表示」フラグ)。「/なのか-なのかキッチリしてくれ」と言いたくなるが、これはWindowsの歴史の都合なので、両方覚えるしかない。

    エクスプローラーの設定を恒久的にオンにしてしまうと、システムフォルダ(普段は触らないやつ)まで一斉に薄く出てきて視界が騒がしい。「触りに行くときだけPowerShellで覗く」 というやり方は、いつもの机の上を散らかさずに済むので、私は最近こちらを使うことが多い。


    Macで表示する場合(参考)

    私はMacを持っていないので実機では試していないが、公式ドキュメントや一般的なTipsとして広く紹介されている方法をひとつだけ書いておく。Finder(Macのファイル管理ツール)を開いている状態で、キーボードの Cmd + Shift + .(ピリオド) を押すと、隠しファイルの表示が切り替わる、と紹介されている。もう一度同じキーを押すと非表示に戻る、いわゆるトグル式。

    つまり、「隠しファイルを見たいときだけパッと出して、見たら戻す」が1ショートカットで済む、ということになる。Windowsの「表示 → 表示 → チェック」の3段階よりだいぶ楽そうで、これに関してはMacユーザーが少しだけ羨ましい。


    つまずいたところ

    • .claude フォルダを「Claudeアプリの中」で探していた: Program Files やインストール先を必死に探したが、.claude は ユーザーのホームフォルダ直下(C:\Users\ユーザー名\)にできる。アプリ本体ではなく「ユーザーごとの設定置き場」だからだ。これはWindowsだけでなくMacもLinuxも同じ慣習らしい
    • 「隠しファイル」と「保護されたシステムファイル」を混同していた: エクスプローラーには「隠しファイル」と「保護されたOSファイル」の2つの非表示設定があり、後者はさらに別チェック。.claude 程度なら「隠しファイル」をオンにすれば見えるが、AppData のさらに奥などを見たいときは両方オンが必要になることがある。普通は前者だけで足りる
    • 見えるようにしたついでに、要らないものまでいじってしまった: 表示が増えると「これ消していいかな」とつい手が伸びる。基本的に、ドットで始まるファイルは「アプリが自分のために置いた手帳」なので、勝手に消すと当のアプリが「あれ、私の手帳どこ行った?」となる。設定が初期化されたり、起動時にエラーが出たりする。見るだけにとどめるのが安全(私は一度 .gitconfig を実験で消して、Gitの自分の名前が消えた)

    今日のまとめ

    隠しファイルは、OSやアプリの設定ファイルが「日常の視界」を汚さないように、最初から見えなくしてあるだけのもの。バグでもなければ消えているわけでもない。Windowsならエクスプローラーの「表示 → 表示 → 隠しファイル」、PowerShellなら Get-ChildItem -Force。これだけで .claude フォルダは姿を現す。

    ウォーリーをさがせは見つけたら満足だが、隠しファイルは見つけてからが本番だ。設定を覗いて、必要なら少しだけ書き換えて、また閉じる。「触らない人には見せない、触る人にはちゃんと見せる」という、わりと礼儀正しい仕組みだったんだな、と今は思う(3日詰まっていた1週間前の私には、まだ伝わらないだろうけれど)。


    関連リンク

  • MCP ー 「USB-Cみたいなもの」と聞いて、ようやく腑に落ちた

    MCP ー 「USB-Cみたいなもの」と聞いて、ようやく腑に落ちた

    あれ、これだったのか

    「MCPサーバーをインストールしてください」。Claudeの解説記事でそう書かれているのを何度も見た。サーバー、という時点で私は「ああ、私には関係ない話」と画面を閉じてきた。社内の人にちらっと聞いたら「あれは USB-C みたいなものだよ」と言われ、はじめて頭の中の霧が晴れた。USB-C、知ってる。スマホの充電ケーブルと、ノートPCの横にも最近付いてる、あの薄い差し込み口。


    結論マップ(ビフォー/アフター)

    項目MCPを知る前の私MCPを知ったあとの私
    外部サービス連携「Claudeに私のGmailは見えない」と諦めていたMCPサーバーを1つ繋げばGmailもSlackも一気に見える
    導入のイメージ「サーバー」と聞いた瞬間に閉じる「USB-C差すだけ」と思えば抵抗ゼロ
    使えるツールClaudeに付いてる機能だけ世界中の有志が作った数百個のツールから選べる

    要するに何ができるか

    MCP は Model Context Protocol(モデル・コンテキスト・プロトコル) の略で、AnthropicがClaudeのために開いた「外部サービスとAIをつなぐための共通の差し込み口」のことだ。公式ドキュメントの言葉を借りると「AIアプリにとっての USB-C ポート」。USB-C はプリンタでもイヤホンでも外付けSSDでも同じ形の差し込み口で繋がる。MCP も同じで、Gmail でも Slack でも社内のデータベースでも、対応する MCP サーバーさえ用意されていれば Claude から覗きにいける。

    ここで一度、MCP サーバーという言葉だけ整理しておく。サーバーと聞くと専用機械を借りるイメージだが、ここでは「Claude と外部サービスの間に立って通訳してくれる小さなプログラム」くらいの意味だ。Gmail を読みたければ Gmail 用の MCP サーバー、Slack を読みたければ Slack 用の MCP サーバーを差し込む、というイメージで当面は十分だと思う。


    一番シンプルな使い方

    Claude Desktop(私が普段使っているアプリ)にMCPサーバーを追加する流れを書いておく。Coworkモードを開いている前提で、5分かからず終わった。

    1. Claude Desktop の右上「Settings」→「Connectors」を開く
    2. 「Browse Connectors」から欲しい連携先(例:Gmail、Google Calendar)を選ぶ
    3. 「Connect」ボタンを押し、出てきた認証画面で自分のアカウントにログイン
    4. 権限の確認画面で「許可」を押す
    5. チャットに戻り「私のGmailの未読件数を教えて」などと話しかけて動作確認

    公式に用意されたコネクタ(Gmail・Calendar・Drive など)はワンクリックで入る。コネクタ一覧にないサービスは、設定ファイル(claude_desktop_config.json という JSON ファイル)に手書きで追加する形になる。後者はやや上級者向け、と覚えておけば大丈夫だ。


    コピペして使える例

    公式コネクタにないサービスを追加するときは claude_desktop_config.json にこう書く。下は架空の「家計簿サービス(kakeibo-mcp)」を繋ぐ場合の例。実在のキー値は入れていない。

    {
    "mcpServers": {
    "kakeibo": {
    "command": "npx",
    "args": ["-y", "@example/kakeibo-mcp"],
    "env": {
    "KAKEIBO_API_KEY": "ここに自分のAPIキーを貼る"
    }
    }
    }
    }

    💡 ポイント:JSONはカンマと中括弧の位置で全部決まる。最後の項目の後ろにカンマを付けると壊れる、これだけ覚えておけば9割の事故は防げる。

    設定ファイルを保存したら Claude Desktop を一度終了して再起動する(ここを忘れると新しいサーバーは読み込まれない)。再起動後、チャットで「家計簿の今月の合計を出して」と話しかけ、ちゃんと数字が返ってくれば成功だ。


    私が間違えたこと

    最初の数日でやらかしたのは、だいたい次の3つ。

    • 「サーバー」を物理的に借りようとしていた: AWSとかさくらインターネットとか、そっち系の話だと思って身構えていた。実際は自分のPCの中で動く小さなプログラムなので、契約も請求も発生しない。
    • JSONの末尾カンマで Claude が起動しなくなった: 設定ファイルに新しい MCP サーバーを書き足したとき、最後の `}` の前にカンマを残してしまい、Claude が黙って起動しないという地獄を見た。エラーメッセージも出ない。テキストエディタの色が赤くなっていたのに、私は気づかなかった。
    • 権限の許可画面を「とりあえず全部OK」で進めた: あとで「Claudeが私のGmail全部読める状態」になっていて少し怖くなった。MCPサーバーを足すときの権限画面は、毎回中身を読んでから許可した方がいい。USB-Cと違って、繋いだ先のデータが向こうに渡る場合があるので。

    3行でまとめると

    MCPは「Claudeに新しい差し込み口を増やす規格」、と理解しておけば最初は足りる。サーバーという言葉に怯えて閉じていた半年間、本当にもったいなかった。USB-Cと同じで、対応している周辺機器を1つ繋ぐだけで、Claudeで「できること」がぐっと増える。明日、自分が一番よく使うサービスから1つ繋いでみるのを強くおすすめしたい。


    関連リンク

  • /init ー CLAUDE.md、3日かけて手書きしてた私の話

    /init ー CLAUDE.md、3日かけて手書きしてた私の話

    ずっと、白紙から書いてた

    CLAUDE.md(Claude が会話のたびに最初に読むメモ書きのようなファイル)を、私は3日かけて手書きしていた。プロジェクトの構成を眺め、命名規則を書き写し、テストの動かし方を思い出して並べて、最後に誤字を直して、また並べ替えた。エジプトのピラミッドを建てたファラオたちもこんな気持ちだったのかもしれない(まあ彼らの時代に重機などないのだが)。

    そして昨日、/init というスラッシュコマンドの存在を知った。

    「Claude が勝手にプロジェクトを読んで CLAUDE.md の下書きを作ってくれる」と公式ドキュメントには書いてある。3日。私の3日。返してほしい。


    結論マップ(ビフォー/アフター)

    場面/init を知る前/init を打ったあと
    CLAUDE.md の作り方手で1から書く(私は3日溶かした)1コマンドで下書きが出てくる
    プロジェクト把握自分でフォルダを眺めて思い出すClaude がスキャンして要点を抜く
    仕上げ「これ書き忘れてた…」を3日後に発見出てきた下書きを「足す・削る」だけ

    ピラミッドが3秒で建った気分。ただし完成形ではなく下書きである、という1点だけ最後に詳しく書く。


    /init って何をするコマンド

    公式ドキュメントによれば、/init は Claude Code の対話モード(ターミナルで claude と打って起動した状態)の中で打つスラッシュコマンド で、いま開いているプロジェクトを Claude が自分で歩き回って CLAUDE.md の下書きを生成してくれる機能だ。

    具体的には Claude が以下を自分で見に行く:

    • フォルダ構成(どこに何があるか)
    • package.json / pyproject.toml などの設定ファイル(使っているフレームワーク・依存ライブラリ)
    • 既存のドキュメント(README など)
    • ソースコードの命名規則・スタイル

    これらを材料に、「ビルド方法」「テスト方法」「主要ディレクトリの説明」「コーディング規約」などを箇条書きにした CLAUDE.md の下書き を1つ書き出してくれる。

    💡 「Claude が読みやすいように、Claude が自分の取扱説明書を自分で書く」と説明すると近い。私は最初これを聞いて「自分で履歴書書く AI、強い」と思った。


    実際に打つ手順(最小5ステップ)

    1. ターミナルで対象プロジェクトのフォルダに移動する(cd my-project のような移動コマンドを使う)
    2. claude と打って Claude Code を起動する
    3. 起動後のプロンプトに /init と入力して Enter
    4. Claude がプロジェクトを読んで下書きを生成する(数秒〜数十秒)
    5. 生成された CLAUDE.md を自分の目で読み、足りない部分・誤った部分を編集する

    ポイントは 5番。/init はあくまで下書きを置いてくれるだけで、完成版を作ってくれるわけではない。Claude 公式の解説記事にも「think of /init as a starting point, not a finished product(出発点であって完成品ではない)」とはっきり書かれている(公式 Best Practices にも同主旨の記述がある)。


    生成される CLAUDE.md のイメージ

    たとえば、私が書いている架空の家計簿アプリ(仮に kakebo-app という名前のNode.jsプロジェクト)で /init を打つと、こんな雰囲気の下書きが出てくる:

    # kakebo-app
    A personal finance tracker built with Node.js and Express.
    ## Build & Run
    - Install: `npm install`
    - Dev server: `npm run dev`
    - Production build: `npm run build`
    ## Test
    - Unit tests: `npm test`
    - E2E tests: `npm run test:e2e`
    ## Project Structure
    - `src/routes/`  ... API endpoints
    - `src/models/`  ... Database models (using Prisma)
    - `src/views/`   ... EJS templates
    - `tests/`       ... Jest test suites
    ## Conventions
    - Indent: 2 spaces
    - Quotes: single quotes for JS, double for JSON
    - File naming: kebab-case
    

    「あ、これでいい」と思うところと「いや、ここは違う」と思うところが混じった下書きになる。たとえば私の場合、Conventions 欄に「絶対 commit 前に lint を回す」を足したり、「src/views/ は EJS じゃなくて Pug を使ってる」を直したりする。プロの料理人がレシピ本のレシピを試食して「醤油を足したい」と言うのと同じ手つき。

    💡 上の例は架空のプロジェクトのもの。あなたのプロジェクトでは中身がぜんぜん違う形で出てくる。それで正しい。


    新しい /init(対話モード)も来ている

    公式ブログと Best Practices によると、2026年3月から 対話型の新しい /init が試験的に提供されている。CLAUDE_CODE_NEW_INIT=1 という環境変数(プログラムに渡す設定値のこと)を立てて Claude を起動すると、こちらに切り替わる。

    CLAUDE_CODE_NEW_INIT=1 claude
    

    何が違うか。従来版はファイルを勝手に読んで下書きを書く(ボトムアップ:素材から作る)。新版はファイルを読まず、AskUserQuestion(Claude が選択肢付きで質問してくる仕組み・以前の記事で取り上げた)を使って私に質問しながら作っていく(トップダウン:意図から作る)。

    💡 「私の作業のうち、よく繰り返している作業は?」「危ないからフックで止めたい操作は?」のような質問に答えていくと、CLAUDE.md だけでなくスキルや Hooks の雛形まで一緒に整えてくれる、というしくみ。インタビュー上手なフリーランスのコンサルが、私の机を見ずに私の話だけで業務マニュアルを書いてくれる、と思うと近い。

    なお新版はまだフラグ付きの実験的機能なので、通常の /init だけ覚えれば、明日からの作業は十分カバーできる。


    ここで止まりそうなポイント

    • 対話モードで打つ:/init はターミナルから claude --init のような呼び方では打てない。claude を起動して対話画面に入ってから、その中で /init と打つ。私は最初これを「シェルコマンド」と勘違いし、シェルに直接打って怒られた(家のリモコンを冷蔵庫に向けて押していた)
    • 既存の CLAUDE.md は上書きされる可能性:すでに CLAUDE.md がある状態で /init をもう一度回すと、内容が書き換わるか・差分が提示される(Claude のバージョンで挙動が変わる)。実行前に既存ファイルをバックアップすることをおすすめする。私は「これ、賢く merge してくれるはず…」と祈ったが、祈りで Git の履歴は残らない
    • 生成内容を信じすぎない:/init はファイルを「見た」結果で書くので、まだコードに書かれていないルール(たとえば「PR は必ず2人レビューする」のような運用ルール)は当然書かれない。出てきた下書きをスタート地点に、自分の頭で足す工程は必ず必要

    まとめ

    /init は CLAUDE.md の下書きを Claude 自身に書かせるスラッシュコマンド。手で1から書くより圧倒的に早く、しかも基本骨格は埋まった状態で出てくる。

    • まずは claude を起動 →/init を1回打つ
    • 出てきた下書きを読み、削り、足す(ここが本番)
    • 余裕が出てきたら CLAUDE_CODE_NEW_INIT=1 の対話版も試す

    私が次にやりたいのは、すでに育っている既存プロジェクトに /init をぶつけて、私が3日かけて書いた CLAUDE.md と Claude が30秒で書いた CLAUDE.md を並べて比較すること。たぶん私が負ける。負けても勉強になる、という意味で負けても勝ちという不思議な構図。

    なお本記事の挙動・コマンド名は 2026-04-28 時点の公式ドキュメントに基づく。Claude Code は更新が早いので、実行前に必ず一次情報を確認してほしい。


    関連リンク(一次情報)


  • ダウンロードとインストール ー 同じことだと思って混ぜて使ってた

    ダウンロードとインストール ー 同じことだと思って混ぜて使ってた


    結論マップ(ビフォー/アフター)

    項目ダウンロードインストール
    何をするファイルをPCにコピーして保存する保存したファイルを「使える状態」にする
    終わったあとフォルダに置かれているだけデスクトップやスタートメニューから起動できる
    例えるなら段ボールが家に届いた中身を出して棚に並べた

    ざっくり言うと

    ダウンロードは「ネットからPCにファイルを持ってくる」工程。スーパーで商品をカゴに入れて家まで持って帰るイメージだ。

    インストールは「持ってきたファイルを実際に使えるように設置する」工程。家具で言えば、組み立てて部屋に配置する作業に近い。届いたソファを玄関に置いたまま「届いた=座れる」と主張する人はいない。でもダウンロードに関しては、私たちは平気でそれをやる。

    ここで私がつまずいたのは、画像や音楽はダウンロードだけで使えるという事実だ。MP3を保存すればすぐ再生できる。でもソフトウェア(プログラム)は「保存しただけでは動かない」ので、別途インストールという工程が必要になる。段ボールが届いただけでは、中の猫が生きているか動いているかは確定しない——ソフトウェアも、ダウンロードしただけでは「使える」とは限らないのだ。

    ファイルの種類ダウンロードだけで使える?
    写真・音楽・動画使える(インストール不要)
    Word/Excel の文書使える(中身を読むだけなら)
    ソフトウェア(exe・dmg・sh)使えない(インストールが必要)

    一番シンプルな使い方

    ソフトウェアをPCに入れるときの、私が分解できた3ステップ:

    1. ダウンロード:公式サイトのボタンを押す。.exe(Windows)や .dmg(Mac)ファイルが、PC内のダウンロードフォルダに保存される。ここで「ダウンロード完了」と表示が出る。ちなみに私のダウンロードフォルダには、用途を忘れた .exe が3つくらい眠っている。みなさんもそうだと信じている。
    2. インストール開始:そのファイルをダブルクリックして開く。「次へ」「同意する」「インストール先を選ぶ」などの画面が出てくる。これがインストール作業の本体。「次へ」連打で結局何に同意したかは、聞かないでほしい。
    3. インストール完了:最後に「完了」ボタンを押すと、デスクトップやスタートメニューにアイコンが出る。この段階で初めて『使える』状態になる。

    スマホアプリだと、App Store や Google Play が裏で1〜3を一気にやってくれているので、私たちは「インストール」しか意識しなくて済んでいる。スマホは私たちを甘やかしてくれる。PCに来るとその優しさは消えるので、2工程が分かれて見えて混乱しやすい。


    コピペして使える例

    ここまで読んで眠くなった人、起きてください。ここからコードゾーンです。

    例えば、メモ帳の代わりに使える架空のテキストエディタ「NoteFlex」を入れるとする。

    # 1. ダウンロード(ネットから .exe を取得してダウンロードフォルダに保存)
    curl -O https://noteflex.example.com/installer/noteflex-1.0.exe
    # 2. インストール(ダウンロードした .exe を実行)
    .\noteflex-1.0.exe

    💡 ポイント: curl(カール)はネットからファイルを取ってくるコマンド。1行目はファイルを「持ってくる」だけ、2行目の .exe 実行で初めて「使える状態」になる。1行目だけだと NoteFlex は起動できない。

    ちなみに Claude Code を Windows に入れるときの公式コマンドは、この2工程を1行に詰めた書き方になっている。これは PowerShell(Windows標準のコマンド入力画面)に貼り付けて実行するコマンドだ。

    irm https://claude.ai/install.ps1 | iex

    irm、iex。初見の私の感想は「呪文ですか?」だった。落ち着いて分解すると、ちゃんと意味がある。

    💡 ポイント: irm がスクリプトを「ダウンロード」、iex がそれを「実行=インストール」する役割。パイプ | の左右で工程が分かれていると思って読むと、呪文が急に普通の手順書に見えてくる。


    引っかかりやすいポイント

    これ、私だけじゃないと信じたいのですが、こんな経験ありませんか。

    • 「ダウンロードしました」を「使える状態」と勘違いする: ファイルが保存フォルダにあるだけで、実行はまだ。デスクトップにアイコンが出ていなければ、インストールは終わっていない。
    • インストール画面を閉じて『終わったつもり』になる: ウィザード(「次へ」を連打する設定画面)の途中でキャンセルすると、ファイルだけ残って中途半端な状態になることがある。最後の「完了」を押し切るまでが1セット。
    • ZIPを解凍しただけで満足する: ZIP を展開してフォルダができると「終わった感」が出る。あの達成感、わかる。でも中身の setup.exe を実行していなければ、まだダウンロード相当。解凍 ≠ インストール。

    3行でまとめると

    • ダウンロード = 持ってくる:ネット上のファイルをPCにコピーする工程。
    • インストール = 使える状態にする:ダウンロードしたファイルを設置・登録して、起動できる形に整える工程。
    • スマホはこの2工程を裏で1つにまとめてくれている:だからPCに来ると2つに分かれて見えて混乱する。

    過去の自分に教えてあげたい。ダウンロードとインストールは別の駅です、乗り換えてください、と。


    関連リンク

  • CLAUDE.md ー 毎回同じ口頭説明、ついに卒業した

    CLAUDE.md ー 毎回同じ口頭説明、ついに卒業した

    あれ、これだったのか

    「口調はやわらかめで」「コードは書かないで」「日本語で返事して」。
    私はこの3行を、3日連続でClaudeに口頭でお願いしていた。
    3日目に思い出した。「これ、ファイルに書いておけるやつなんじゃ?」

    そのファイルが CLAUDE.md だった。


    結論マップ(ビフォー/アフター)

    改善前(Before)改善後(After)
    毎回チャットの冒頭に「日本語で・優しく・コードは省いて」と打ち込むプロジェクトを開いた瞬間、Claudeが既にそのルールで動いている
    Claudeが急に英語で返事してきて「あれ?」となる口調も言語もブレない。プロジェクト全体で一貫する
    「言ったよね?」と何度もリマインドする手間1回書いて保存。そのあとは存在を忘れていい

    これが本体

    CLAUDE.md(クロード・ドット・エムディー)は、Claudeに毎回読ませたい指示を書いておくテキストファイルだ。
    拡張子の .md は「マークダウン」。名前だけ強そうだが、要は見出しが書けるだけのただのメモ。メモ帳でもVS Codeでも開ける。身構えなくていい。

    公式ドキュメントの言い方を借りるなら、毎セッション開始時に自動で読まれる、Claude宛の置き手紙。
    枕草子なら「春はあけぼの」のあたりに「敬語多め」って書いておくイメージだ(清少納言、ごめん)。
    口頭で毎回お願いしていたことをファイルに書き写すだけで、Claudeはそれを前提にして話し始めてくれる。

    しかも置き場所が用途で使い分けられる。

    • ~/.claude/CLAUDE.md … 全プロジェクト共通の自分ルール(要は私の取扱説明書)。口調・言語・禁止事項などをここに書く
    • プロジェクト直下の CLAUDE.md … そのプロジェクトだけのルール(このフォルダ独自の方言)。チームで共有もできる
    • @path/to/file 構文での import … 別ファイルを CLAUDE.md から読み込む書き方。長くなりがちなルールを別ファイルに分割できる(昔は CLAUDE.local.md というローカル専用ファイルもあったが、現在は import 構文が推奨されている)

    これらは作業フォルダから上の階層に向かって順に読み込まれて、まとめてClaudeに渡される。「全体ルール+プロジェクト固有ルール」をきれいに分けて書ける。


    とりあえずやってみる

    迷いどころを全部スキップした最小手順がこれ。

    1. プロジェクトの一番上のフォルダ(自分が作業しているフォルダ)を開く
    2. その中に CLAUDE.md という名前の空ファイルを作る(メモ帳で「名前を付けて保存」でOK)
    3. 「Claudeに毎回伝えていたこと」を3〜5行書く(ここで完璧主義が顔を出すが無視。ファイル名すら最初に間違えた私が言うんだから間違いない)
    4. 保存して、Claude Codeを開き直す(または新しいセッションを始める)
    5. Claudeに「今回のルールわかってる?」と聞いて、書いた内容を返してくれたら成功

    ポイントは 「毎回伝えてた1行」を1つだけでいい こと。完璧を目指して長文を書こうとすると、たいてい書き終わる前に挫折する。私は最初の1行を書くだけで5分粘った。原稿用紙を前にした夏休み最終日の小学生だった。


    動いた設定をそのまま

    私が試しに作った、架空の「旅レシピ管理」プロジェクト用の CLAUDE.md がこれ。中身は本物のテキストとしてそのまま動く。

    # 旅レシピ管理プロジェクト
    このフォルダは、旅行先で食べた料理を再現するためのレシピメモ集です。
    ## 私の好み
    - 返答は日本語で。専門用語が出たら必ず1行で意味を補足してください
    - 文字数は1メモあたり300字以内におさめる
    - 材料の分量は2人分を基準にする
    ## ファイルの場所
    - 完成したレシピは `recipes/` フォルダに `国名_料理名.md` で保存
    - 試作中のメモは `drafts/` フォルダに置く(公開前なので触らないで)
    ## やらないでほしいこと
    - レシピの手順を勝手に省略しないでください
    - 「お好みで」など曖昧な表現は使わず、数値で書いてください
    

    💡 ポイント: 見出し(##)で「好み」「ファイルの場所」「やらないでほしいこと」を分けると、Claudeが「該当箇所だけ」を意識して動いてくれる。長く書くより、見出しでの分類のほうが効く。


    最初で詰まった4つ

    1. 置き場所を間違えた … デスクトップに置いて「読まれない!」と騒いでいた。CLAUDE.md は 作業しているプロジェクトフォルダの直下 に置かないと反応しない。場所を変えただけで治った。
    2. 長すぎて自分が読めなくなった … 良いことを書こうとして30行を超え、自分でも何を書いたか覚えてなかった。ファイル全体が毎セッションで読まれる仕組みなので、長くなりすぎたら別ファイルに分割するのが安全。公式の Best Practices にも「短く・人間が読める長さに保つ」と書かれている。
    3. 「禁止事項」だけ並べた … 「〜しないで」ばかりだと、Claudeはやってもいいことの判断に迷う。「これはやって・これはやらないで」をペアで書く と動きが安定する。「コードを書かないで」より「コードは書かず、手順だけ箇条書きにしてください」のほうが伝わる。
    4. ファイル名に小文字が混入 … 最初は Claude.md という名前で作ってしまい、「読まれない、なぜ?」と30分溶かした。正しくは すべて大文字の CLAUDE.md(拡張子の .md だけ小文字)。Mac・Linux など大文字小文字を区別する環境では、一文字でもケースが違うと完全に別ファイル扱いで無視される。リネームしただけで動いた。

    使ってみての正直な感想

    CLAUDE.md を作る前と後で、Claudeとの会話の冒頭5分が完全に消えた。
    「いつもの前提を伝える時間」が0になっただけで、いきなり本題に入れる。

    書くのに迷ったら、「直近3回、Claudeに同じ注意をしたこと」をそのまま書き写す のがいちばん早い。
    それは「私が毎回伝えたいルール」の動かぬ証拠だから。

    3回同じことを言ったら、ファイルに書く。3歳児に同じ質問をされ続けた育児ベテランの先輩が言ってたやつだ。
    Claudeも、3歳児だったらしい。


    関連リンク

  • Claude Code CLI ー ターミナル、ずっと怖いと思ってた

    Claude Code CLI ー ターミナル、ずっと怖いと思ってた

    始めるまでが全部

    「Claude Codeって何?」と聞かれたら、ブログ名で使っておきながら「……Cowork で使ってるやつです」とごまかしていた私に、向き合う日が来てしまいました。

    Claude Code には、CLI(コマンドラインインターフェース)版というものがあります。ターミナル(=黒い画面に文字を打ち込むやつ)から使うタイプです。Cowork はそのデスクトップアプリ版、CLI版はターミナルから直接動かすもの。どちらもClaude Code ですが、使い方がまったく違います。

    「ターミナル、怖い」——正直そう思っていました。でも実際やってみたら、インストール自体はコマンドを1行コピペするだけでした。拍子抜けするくらい。怖かったのは始める前の自分だけでした。(始める前の自分に言ってやりたい。本当に)


    結論マップ(ビフォー/アフター)

    改善前(Before)改善後(After)
    Claude Code CLI の存在は知っているが触っていないインストール済み、ターミナルで claude と打つと動く
    「ターミナル = エンジニア専用の世界」だと思っていたコマンド1行コピペでセットアップ完了
    Cowork と CLI の違いが曖昧役割の違いを理解した上で使い分けられる

    これが本体

    Claude Code CLI(クロード・コード・シーエルアイ)は、ターミナルから Claude に話しかけながらコードを書いたり、ファイルを操作したりできるツールです。

    CLI(コマンドラインインターフェース)とは、黒い画面に文字を打ち込んでコンピューターを操作する方法のことです。「コマンドプロンプト」「PowerShell」「ターミナル」が全部これ系。マウスをほとんど使わない世界です。エンジニアが格好よく使っているあれ、です。

    Cowork との違いをざっくり言うと、Cowork はデスクトップアプリ、Claude Code CLI はターミナルツール。Cowork は画面があってボタンもある、CLI はコマンドを打って動かす。どちらも Claude がいて助けてくれるのは同じですが、向いている使い方が違います。

    「じゃあ Cowork があれば CLI いらないじゃないか」と思いますよね。私も思いました。でも CLI版にしかできることもあって、たとえばほかのツールとの連携や、もっとエンジニアっぽいワークフローは CLI が得意です。あと、「使えた」というだけで少し自信がつく——これが意外と馬鹿にできません(重要)。


    実際にやった手順

    ⚠ 注記: ここで紹介するインストール方法は、記事作成時点(2026-04-23)のものです。Claude Code は更新頻度が高いので、将来的に手順やコマンド、対応プランなどが変わっている可能性があります。うまくいかないときは Claude Code セットアップ詳細(公式) の最新版も合わせて確認してください。

    まず確認しておくこと(超重要):
    – Pro / Max / Team / Enterprise プランが必要(Claude.ai の無料プランは Claude Code が使えません)
    – Windows の場合は Git for Windows が必要(後述します)

    1. Git for Windows をインストールする(Windows のみ)

    まず Git for Windows(公式) をダウンロードしてインストールします。「Git って何?」と聞かれると説明が長くなるのですが、Claude Code が内部で使う仕組みが入っているので必要です。コードのバージョン管理ソフト——と覚えておけば今は十分です。

    インストール中に設定画面がいくつか出ますが、基本的にデフォルト(そのまま Next)で進めて問題ありません。「全部読もう」とすると30分かかります。読まなくていい(読みませんでした。ごめんなさい)。

    2. ターミナルを開く

    Windows では「PowerShell」または「コマンドプロンプト(CMD)」を開きます。スタートメニューで「powershell」と検索すると出てきます。

    ここで大事なのが「自分が今どちらを使っているか」の確認です——これが最初の罠です。

    • PowerShell の画面: PS C:\Users\あなたの名前> という感じで PS がつく
    • CMD の画面: C:\Users\あなたの名前> という感じで PS がつかない

    どちらを使うかで次のコマンドが変わります。間違えると「コマンドが見つかりません」エラーが出て、「え何が違うの……」と5分悩む羽目になります(なりました)。

    3. インストールコマンドを実行する

    コマンドをコピーして画面に貼り付けて、Enter を押すだけです。「たったこれだけ?」と思うくらい短いです。

    現在(2026-04-23時点)のインストールコマンドは以下です。 公式の案内は更新されることがあるので、コマンドだけコピペする場合も時期によっては最新版を 公式セットアップページ で確認してください。

    PowerShell の場合:

    irm https://claude.ai/install.ps1 | iex
    

    CMD の場合:

    curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
    

    自動でダウンロードとインストールが始まります。完了するまで少し待ちます。「何も起こっていないのでは」と不安になる時間がありますが、動いています。信じて待つ。

    4. バージョンを確認する

    claude --version
    

    バージョン番号(例:2.1.89 みたいな数字)が出てきたら成功です。やった。画面に claude と入力しただけで Claude が動いた——小さいことですが、なんか感慨深かったです。

    command not found みたいなエラーが出た場合は後述のつまずきポイントを確認してください。

    5. ログインして使い始める

    claude
    

    初回はブラウザが開いてログイン画面が出ます。Claude アカウントでログインすると、ターミナルに戻ってきます。あとは話しかけるだけ——ここから先は Cowork と同じ感覚です。


    動いた設定をそのまま

    プロジェクトのフォルダに移動してから以下を打ってみてください。

    what does this project do?

    💡 ポイント: プロジェクトのフォルダ内でこのコマンドを打つと、Claude がフォルダ内のファイルを読んで「何するプロジェクトか」を説明してくれます。英語で打っても日本語で返ってきます(私の場合は)。「フォルダ内に何もない」場合は適当なテキストファイルを置いてから試してみてください。

    インストール直後に確認しておくと便利なコマンドはこのあたりです:

    claude --version     # バージョン確認
    claude doctor        # インストール状態を診断してくれる
    

    claude doctor は問題があれば「ここがおかしいですよ」と教えてくれる診断コマンドです。お医者さんに行くより気軽に診てもらえる。「なんか動かない気がする」というときに最初に試すといいです。


    ここで止まった


    • 「irm が認識されない」というエラーが出た: PowerShell だと思っていたら CMD を使っていました。プロンプトに PS がついているかどうかで確認できます。PS C:\...> なら PowerShell、C:\...> だけなら CMD です。使っている側のコマンドを選んでください(これで30分悩んだのは内緒です)。



    • 「Git for Windows を入れ忘れた」: インストールは完了したのに claude コマンドを打ったら動かないことがありました。Claude Code は内部で Git Bash を使うので、Git for Windows がないと動きません。Claude Code より先に Git を入れておくのが正しい順番です。



    • 「無料プランで試そうとした」: Claude.ai の無料プランでは Claude Code が使えません。Pro 以上のプランが必要です。「なぜ動かないのか」で30分悩んでから気づいたので、先に確認しておくことを強くおすすめします(30分返してください)。



    • 「インストール後にターミナルを再起動しなかった」: PATH(=コマンドの場所をOSが探すための設定)が更新されないため、古いターミナルのままだと claude が見つからないことがあります。インストール直後に動かなかったら、ターミナルをいったん閉じて開き直してみてください。



    で、結局どうなの

    インストール自体は「難しかった」というより「なんか怖かった」という話でした。コマンドを1行コピペして Enter を押すだけなので、手順自体に難しいところはない。ただターミナルを開くまでの心理的なハードルが異常に高かった——それだけです。

    コロンブスが大西洋を渡ろうとしたとき、「海の果てに奈落がある」と信じていた人が多かったそうですが——開けてみたら普通に大陸がありました。CLI もだいたい同じ構造です。開けてみたら普通でした(怖くなかった、とは言えないけど。あの緊張感はなんだったんだ)。

    Cowork で Claude を使ってきた人は、CLI版を試すと「あ、中身は同じだ」とわかると思います。画面の見た目は全然違うけど、話しかけている Claude は同じです。どちらが向いているかは作業スタイルや目的次第。まず使ってみる、が一番早い結論でした。

    ターミナルやエディタから Claude Code を使うことそのもののメリット——エディタ内で作業が完結する、普段のワークフローに自然に組み込める、複数ファイルを同時に扱える、など——もいろいろあるのですが、ここで書き始めると長くなるので別記事に譲ります。今回はインストールまで。使ってみての利点や Cowork との使い分けは別途解説する予定です。


    関連リンク

  • プラン・料金 ー 最初に全部知っておけばよかった

    プラン・料金 ー 最初に全部知っておけばよかった


    先に言っておく

    「Claudeって無料で使えるの?」

    これ、最初に全人類が思うやつだと思います(たぶん。私調べ)。私も登録ページを開いた瞬間にそう思いました。で、調べてみたら想像より全然ちゃんと設計されていて、「あ、これはちゃんと選んだほうがいいやつだ」とじわじわ気づいた話をします。


    結論マップ(ビフォー/アフター)

    改善前(Before)改善後(After)
    「有料なの?どのプラン?」でフリーズ用途に合わせて3分で選べる
    Proにしたほうがいい?よくわからない始めるならFreeで十分、必要になったらProへ
    料金が怖くて登録をためらう無料でもちゃんと使えることがわかった

    ざっくり言うと

    Claudeには大きく分けて 5つのプラン があります。

    個人向け3種類(Free・Pro・Max)と、仕事向け2種類(Team・Enterprise)。

    「名前がシンプル……」と思ったあなた、そうなんです。内容も、読めば3分で判断できます(その3分間が今ここです)。


    Free(無料)

    • 料金:$0
    • 使えるモデル:全モデル(Opus 4.7・Sonnet 4.6・Haiku 4.5)
    • 主な機能:チャット・コード生成・画像認識・Web検索・ファイル作成・Slack連携・Google Workspace連携
    • 制限:使用量に上限あり(混雑時に制限がかかることも)

    これだけ使えて無料。最初に見たとき「どこかで課金される仕掛けあるよね?」と思って2回読み返しました。本当に $0 です。「ひとまず触ってみたい」という方は、間違いなくFreeから始めてOK。


    Pro(個人有料)

    • 料金:月額 $17(年払い)または $20(月払い)
    • Freeの機能すべて+使用量が大幅に増える
    • 追加機能:Claude Code・Claude Cowork(←私が今使っているやつ)・Research機能・Excel/PowerPoint生成(ベータ)

    「毎日本格的に使いたい」「Claude Code/Coworkを使いたい」という場合はPro一択です。

    ちなみに私もProです(ここで白状しておきます)。


    Max(ヘビーユーザー向け)

    Maxには2種類のプランがあります。

    プラン料金使用量(Proとの比較)
    Max 5x月額 $100Proの5倍
    Max 20x月額 $200Proの20倍

    共通機能:ピーク時も優先接続・早期機能アクセスあり。Claude Code・Coworkも含む。

    「Proの制限に毎日ぶつかる」という方向け。2種類あること、そして価格が倍違うことを最初から知っておくのが大事です。Max 5x($100)からスタートして、それでも足りなければMax 20x($200)へ移行する——が自然な流れです。私は……まだその段階ではないです(正直に申し上げます)。


    Team(チーム向け)

    Teamプランはシート(席)の種類が2つあります。

    シートの種類年払い月払い
    スタンダード$20/席/月$25/席/月
    プレミアム$100/席/月$125/席/月

    5〜150人のチームで使えるプランです。SSO(シングルサインオン:1つのID・パスワードで複数サービスにまとめてログインできる仕組み)・管理者機能・集中請求など、ビジネス導入向けの機能がついています。

    「会社でチーム導入したい」という場合はこちらへ。個人ブログを書いているだけの私には関係なかったですが、将来チームを持ったらまた来ます(壮大な話をしました)。


    Enterprise(大規模・セキュリティ重視向け)

    • 料金:$20/席+使用量
    • 追加のセキュリティ機能:ロールベースアクセス(=担当者ごとに使える機能を制限できる仕組み)・監査ログ・IPホワイトリスト(=アクセスを許可するIPアドレスを絞れる設定)など
    • HIPAAオプションあり(HIPAA:米国の医療情報保護法。医療機関がデータを扱う際に必要な要件)

    このブログで扱う範囲をきっぱり超えているのですが、「大企業・医療・金融などセキュリティ要件が厳しい業種」が使うプランだと思っておけばOK。


    実際にどう選ぶか

    迷ったら2つだけ確認してください。

    1. 個人で使うか、チームで使うか
    2. 毎日ガッツリ使いたいか、ちょっと試したいか

    これで絞れます:

    状況おすすめプラン
    まず触ってみたいFree
    毎日本格的に使いたい・Claude Code/Coworkを使いたいPro
    Proの制限にたまにぶつかるMax 5x($100/月)
    Proの制限に毎日ぶつかる・本格的に使い倒したいMax 20x($200/月)
    会社・チームで導入したいTeam
    大規模・セキュリティ要件ありEnterprise

    「やっぱりわからない」という場合は、Freeで始めてください。本当に。制限に引っかかってから考えれば十分です。


    試してみたプロンプト

    Freeプランで登録直後に打ったプロンプト例です:

    私はプログラミング初心者です。
    Pythonで「Hello, World!」を表示するコードを書いてください。
    コードの各行に日本語でコメントをつけて、初心者でもわかるように説明してください。

    💡 ポイント: 「初心者向け」「日本語で」「各行にコメント」と具体的に書くと、Claudeの回答がグッとわかりやすくなります。試しに条件を何も書かずに同じプロンプトを打ってみてください——差に驚きます。


    私が間違えたこと


    • 「Proにしないと全モデルが使えない」と思っていた:FreeでもOpus 4.7を含む全モデルが使えます。「制限されるのは量であって、機能ではない」というのを最初に知りたかった。30分調べてから気づきました(30分返して)。



    • 「年払いと月払いの差を気にしていなかった」:Proは月払いで $20、年払いだと月 $17 です(年間 $36 の差)。ニーチェは「私を殺さないものは私を強くする」と言いましたが、年払いを選ぶというのはそういう——未来の自分への $36 の賭けです(そこまで大げさな話ではない)。続けるつもりなら最初から年払いのほうがお得。



    • 「Maxは最初から候補に入れなくてよかった」:Proを使い込んで制限にぶつかり始めてから検討する、で十分でした。いきなりMaxを選ぶ必要はなかった。また、MaxにはMax 5x($100/月)とMax 20x($200/月)の2種類があります——最初からMax 20xを選ぶ必要はありません。



    で、結局どうなの

    始めるならFree、本格的に使うならPro。これで9割の人は事足りると思います。

    Claudeは無料でもちゃんと使えます。「有料かどうか怖くて登録できていない」という方がいたら、まずFreeで登録してみてほしい。制限に引っかかってから考えれば十分です。

    「月 $20 が高い」という気持ちはよくわかります。私も使い始める前はそう思っていました。使い始めたら……まあ、元を取ったどころかぐるぐる回っている気がします。でも後悔はしていない(断言)。


    関連リンク

  • ECC(everything-claude-code)ー 3回タブを閉じてからやっと試した、16万スターのプラグイン

    ECC(everything-claude-code)ー 3回タブを閉じてからやっと試した、16万スターのプラグイン


    知らなかった話

    GitHubを見ていたら「これ何?」というリポジトリを見つけた。スター数が16万超。「なんか人気のやつ」という感想しか出てこなかったので、そのままブラウザのタブを閉じた。3回。3回も閉じた。

    今日ちゃんと調べて入れてみた。「え、これ最初から入れておくべきものだったじゃないですか……」という気持ちになった。人の成長とは、大体こういう後悔のくり返しで構成されています(私だけかもしれませんが)。


    結論マップ(ビフォー/アフター)

    現状(Before)改善後(After)
    Claude Codeのデフォルト状態で使っている48エージェント+183スキルが追加される
    毎回同じ指示を一から書いている専門エージェントが役割を引き受けてくれる
    Claude Codeをただのチャットとして使っている本格的なエージェントハーネスとして使えるようになる

    これが本体

    ECC(everything-claude-code)は、Claude Code に「エージェントの軍団」と「専門スキル集」を一括でインストールするプラグインです。48エージェント・183スキル・79コマンドがセットで入る、というやつです。「なんとなく全部入り」という理解で合ってます。もう少しちゃんと理解したい方向けに以下説明しますが、「全部入り」で十分です(そう割り切るのに30分かかりました)。

    「エージェントハーネス」(= 複数のAIエージェントをまとめて管理・運用するフレームワーク、のこと)というとすごく難しそうですが、要するに「仕事の種類ごとに担当者を事前に用意しておく」仕組みです。コードレビュー係、セキュリティ確認係、調査係——全員がスタンバイしていて、呼んだら来てくれます。「それ普通に便利では……?」と思いました。気づくのが遅い(二回目)。

    Windows・Mac・Linux すべてで動作します。Node.js ベースで全フックが実装されているので OS 依存がありません。2026年4月時点で GitHub スター16万超。Claude Code・Cursor・OpenCode など複数の環境に対応済みです。「どの環境でも動く」は地味に大事で、「環境が違うと動かない」の絶望感は一度経験すれば十分です——共感してくれる人、いますよね?


    Coworkユーザーはどうなの?

    ここ、私が一番気にしたところです。ECCの公式READMEに「対応環境」として列挙されているのは Claude Code・Cursor・Codex・OpenCodeで、Coworkの名前はありません。「え、私の環境、対象外?」と5秒固まりました。


    5分でできること

    プラグインマーケットプレイス経由が一番シンプルでした。「一番シンプル」と書いているときはたいていほかの方法で一回詰まっています。今回も例にもれずそうでした。

    1. Node.js がインストールされていることを確認する(まだの場合は nodejs.org から。「ついでにNode.jsの勉強も」は後回しにしていいです)
    2. Claude Code(またはCowork)を起動する
    3. マーケットプレイスにリポジトリを追加するコマンドを実行する
    4. プラグインをインストールするコマンドを実行する
    5. 対話式ウィザードの指示に従って、必要なコンポーネントを選択する(公式は「必要なものだけ選ぶ」ことを推奨しています。私は「どうせなら全部」を選んで現在に至ります)

    Node.js の確認だけは先にしておいてください。これを後回しにすると「なぜか動かない」から始まる探索タイムが発動します。私の場合は40分でした。返してほしい。


    私が使ったコマンド

    # ステップ1: マーケットプレイスにリポジトリを追加する
    /plugin marketplace add affaan-m/everything-claude-code
    # ステップ2: プラグインをインストールする
    /plugin install everything-claude-code
    

    コマンドを打つだけで対話式ウィザードが起動して、必要なコンポーネントを選びながらセットアップを進めていく形式です。ソクラテスが2400年前にやっていた問答法と構造はほぼ同じで、ただしソクラテスと違って答えを間違えても怒られません——そこは安心していいです。

    公式は「必要なものだけ選ぶ」ことを明言しています。「全部」を選ぶと大量のインストールが始まって「本当にこんなに要る……?」と不安になります。不安は正しい。私はそれを知らずに全部選んで今に至ります(知識は必ず事後にやってくる)。

    💡 ポイント: rules/ フォルダは「フォルダごと」コピーするのが正解です。中のファイルだけを取り出すとファイル間の相対パスが壊れます。「なぜかルールが効かない」で30分溶けます——これは経験談です。


    何を選べばいいのか問題

    ウィザードに「何が欲しいですか?」と聞かれるわけですが、「欲しいものを選ぶ」という作業が一番難しいのが初心者です(私のことです)。参考までに仕分けをしておきます。

    必ず入れておくべきもの

    rules/common(言語を問わず全員に効く共通ルール)と、hooks(コード検証などを自動で走らせる仕組み)と、agents(コードレビュー・調査・計画立案などのエージェント群)です。「これがないとECCを入れた意味がない」セットです。

    興味があれば覗いてみるもの

    言語別ルール(rules/golang、rules/typescript、rules/python など)です。自分が使う言語のものだけ入れればOK。

    「ぜんぶ入れとけば何かの役に立つだろう」という私の作戦は、ここに対して特に効果が薄かったです——JavaもRustも書かないので(書けない)。

    初心者はどうすればいい?

    公式は「必要なものだけ選ぶ」ことを推奨しています。選ぶ基準がわからないうちは正しい判断です。ただし、「何が欲しいかわからない」は「何も要らない」とは違います。

    私のように「とりあえず全部」という選択肢も実害はそれほどなく、「余計なものが入っているかもしれない」という軽い罪悪感だけが残ります(現在進行形)。

    後から外す方法

    ecc uninstall コマンドでアンインストールできます。コンポーネントを選び直したい場合は Claude Code 上で /configure-ecc を実行するか、不要なファイルを .agents/ フォルダから手動で削除するのがシンプルです。

    「後から外せる」とわかっていれば、最初の選択でそこまで悩まなくていいですよという話でもあります。


    やらかしたこと


    • hooks の二重登録: ECCは hooks/hooks.json に独自フックを置く構成になっています。なのに settings.json に手動で同じ hooks を追加すると、同じ処理が2回走ります。「自動でやってくれる機能を知らないまま手動でもやる」——これ、コンビニのセルフレジで店員さんのスキャンと自分のスキャンが被るやつと同じ構造だと思います(違う)。



    • rules はフォルダごとコピー: rules/common や rules/golang などは、中のファイルだけ取り出してはいけません。フォルダごと移動が必要です。理由は相対参照(=ファイルの場所を「今いる場所から数えた距離」で指定する方法)。「なんとなくわかった」と思ったら全然わかっていなかった、という現象が起きやすい概念ベスト5に入ります——同じ人いますよね? いますよね??



    • npm パッケージ名が違う: npm でインストールする場合のパッケージ名は ecc-universal です。プラグイン名の everything-claude-code ではありません。「同じものなのに名前が違う」ことに対して人類はずっと慣れられないと思います。私の場合は「npm の everything-claude-code が見つからない」で5分固まりました(経験値は積まれています)。



    使ってみての正直な感想

    ECCを入れてから、Claude Code が「全部ひとりでやってた人」から「チームを持ってる人」になった気がしています。コードレビューのたびに「レビューしてください、以下のコードで……」と毎回書かなくていいのは、思っていた以上に精神的に楽でした。ちりも積もれば山となる——そして山は返ってきません。

    「16万スターのリポジトリを3回タブで閉じた人間」からのアドバイスとしては、とりあえず入れてみてください。Node.js の確認さえ済ませれば、あとはコマンド2本で終わります。同じ3回を繰り返さなくていいのに繰り返したのは私だけで十分です——あなたには今日で終わらせてほしい。


    関連リンク