Claude Codeとは──モデルではなくモデルを動かすハーネスで、入口は5つ、実行環境の区分は3つ
Photo by Ferenc Almasi on Unsplash

Claude Codeとは──モデルではなくモデルを動かすハーネスで、入口は5つ、実行環境の区分は3つ

この記事の日付について。 2026年9月17日に調査・執筆し、公開日の2026年10月4日に、料金プラン・Remote Control の開始方法・権限モードの既定・チェックポイントの制限・費用目安の定義・用語集(英語版)を一次資料で再確認して更新しました。本文中の「2026-09-17確認」は執筆時、「2026-10-04確認」は公開前の再確認の日付です。筆者環境の計測値は、断りがない限り2026年9月17日の記録です。2026年10月11日に第7節・第8節・第9節の「無料で使えるか」・よくある質問3項目を追記しました(「2026-10-11確認」はその日の確認です)。 この記事でわかること Claude Code がモデルそのものではなく、モデルにツール・コンテキスト管理・実行環境を与える「ハーネス」だということ 入口(サーフェス)が5つ、実行環境の公式の区分が3つあり、その2つが別の軸だということ 収集・実行・検証の3フェーズで何が起きているか、ツールの5分類とあわせて 公式が示す費用目安の数字が「誰の・何の」平均なのか、サブスクリプション利用者にとって何を意味しないのか できないこと、戻せないこと、権限モードで止められる範囲 最初の問いに先に答えます。Claude Code とは、Claude というモデルを動かす側の仕組みです。公式用語集は agentic harness を「言語モデルを有能なコーディングエージェントに変える、ツール、コンテキスト管理、実行環境」と定義し、続けて「Claude Code はハーネスです。Claude はその中のモデルです」と書いています(Claude Code 用語集 2026-09-17確認)。 ツールを使わずテキストだけを返す対話との差はここに集約されます。テキストだけの対話なら、提案を適用するのは人間です。Claude Code はファイルを読み、編集し、シェルコマンドを実行し、テストを走らせて結果を確認します。同じ Claude でも、周りに何を持たせるかが違います。 1. Claude Code とは──定義を1文で Claude Code は agentic coding ツールで、コードベースを読み取り、ファイルを編集し、コマンドを実行し、開発ツールと統合します。ターミナル、IDE、デスクトップアプリ、ブラウザで利用できます。 (Claude Code 概要 2026-09-17確認) この定義文には「ターミナル」の語が入っていますが、ターミナル専用とは書かれていません。同じ文にデスクトップアプリとブラウザが並んでいます。ただし公式内部でも書き方は一様ではなく、「Claude Code の仕組み」ページの冒頭定義は「Claude Code はターミナルで実行される agentic アシスタントです」とターミナル起点で書かれています(Claude Code の仕組み 2026-09-17確認)。入口の広さを示しているのは概要ページの定義文のほうで、2ページで粒度が違うと理解しておくのが正確です。 関連して、公式用語集は agentic coding(エージェンティックコーディング)を「AI がファイルを読み取り、コマンドを実行し、自律的に変更を加えることができるワークフロー」と定義しています。英語版の同じ項は、これをテキストだけで応答するチャット型アシスタントと対比しています。そちらでは、返ってきたテキストを人間が自分で適用する必要があります(Claude Code 用語集 英語版 2026-10-04確認)。日本語版の訳文はこの対比の主語が読み取りにくいため、英語版に沿って要約しました。Claude Code が agentic なのは、助言に加えて行動できるツールを持っているから、という説明です。 2. チャット型の AI と何が違うのか 公式ドキュメントの記述から、差が出る観点を4つに整理します。 ...

2026年10月4日 · ひとりユニコーン
Codex と Claude Code の比較──AGENTS.md と CLAUDE.md の読まれ方、利用上限の数え方で決める使い分け
Photo by Emile Perron on Unsplash

Codex と Claude Code の比較──AGENTS.md と CLAUDE.md の読まれ方、利用上限の数え方で決める使い分け

この記事の日付について。 2026-09-30に調査・執筆し、公開日の2026-10-04に Claude Code Docs の「How Claude remembers your project」と「Manage costs effectively」、ChatGPT Learn の「AGENTS.md」と設定リファレンス、openai/codex の agents_md.rs(commit 50d7795)を一次資料で再確認して更新しました。本文中の「2026-09-30確認」は執筆時、「2026-10-04確認」は公開前の再確認の日付です。筆者環境の計測値は、断りがない限り2026-09-30の記録です。 この記事でわかること Codex と Claude Code が、それぞれどの指示ファイルをどの順で読み、どこで読むのをやめるか 手元の CLAUDE.md 30本を Codex の規則に当てたとき、何が読まれなくなるか(実測) AGENTS.md を1本の正本にして、両方のツールで同じ指示を読ませる構成 Codex の料金プランと、5時間枠・週次上限・クレジットの数え方 検証できなかった比較軸と、その理由 結論を先に書きます。2026年10月時点では、指示ファイルの共通化は AGENTS.md を正本にして、CLAUDE.md から @AGENTS.md で取り込む形を筆者は勧めます。公式ドキュメントが示す共有方法に沿っており、設定値や Claude Code のバージョンに左右されにくいためです。Claude Code は v2.1.277 から AGENTS.md を直接読みます。ただし既定では、作業ディレクトリかその上に CLAUDE.md が1本でもあると AGENTS.md を読みません。直接読めない場合もあります。組み込みの agents-md プラグインを無効にした場合や、v2.1.281 より前の一部セッションです(Claude Code Docs「How Claude remembers your project」 2026-10-04確認)。 手元の CLAUDE.md を Codex の探索規則に当てはめると、届かないのは各リポジトリの本文ではありませんでした。Git ルートの外にある祖先ディレクトリの共通ルール97行です。Codex はプロジェクトルート(既定では .git のある階層)から作業ディレクトリまでしか探さないため、この層が丸ごと探索範囲から外れます(ChatGPT Learn「AGENTS.md」 2026-10-04確認)。どちらを選ぶかは「賢さ」より先に、この読まれ方の差と上限の数え方で決まります。 ...

2026年10月4日 · ひとりユニコーン
Codexとは──5つの入口と実行環境の選択で『自分のコードが動く場所』が変わる、手元45リポジトリの棚卸しつき
Photo by Ilya Pavlov on Unsplash

Codexとは──5つの入口と実行環境の選択で『自分のコードが動く場所』が変わる、手元45リポジトリの棚卸しつき

Codexとは、OpenAIが提供するAIコーディングエージェントです。ChatGPTの会話が「答えの文章」を返すのに対し、Codexは実際にファイルを読み、コマンドを実行し、差分(diff)を返します。 最初に一番大事な区別を書きます。公式ドキュメントの「Available on」に並ぶ項目は ChatGPTデスクトップアプリ / Remote / ChatGPT(web) / Codex CLI / Codex IDE拡張 / Codex cloud の6つで、これとは別に「Developers」配下に Codex SDK が掲載されています(learn.chatgpt.com/docs、2026-09-15確認)。本記事ではこのうち CLI・IDE拡張・cloud・ChatGPTアプリ・SDK の5つを入口として扱います。自分のコードが動く場所は、入口と、そこで選ぶ実行環境の組み合わせで決まります。Codex CLIとIDE拡張は通常のローカル利用では自分のマシンの中で動き、Codex cloudはOpenAI側の環境で動きます。ChatGPTデスクトップアプリでは、Local・Worktree・Cloudから実行場所を選べます(learn.chatgpt.com/docs/environments/modes、2026-10-04確認)。この違いは秘密情報の扱いに直結します。 この記事の日付について。 2026年9月15日に調査・執筆し、公開日の2026年10月4日に料金・実行環境・権限設定などを公式ページで再確認して更新しました。本文中の「2026-09-15確認」は執筆時、「2026-10-04確認」は公開前の再確認の日付です。筆者環境の計測値は、断りがない限り2026年9月15日の記録です。2026年10月11日に第6節の「Codexは無料で使えるか」、第9節の「AGENTS.mdの書き方」、第10節・第11節、よくある質問3項目を追記しました(「2026-10-11確認」はその日の確認です)。 この記事でわかること Codexを一文で説明できるようになる(そしてChatGPTとの違いを表で押さえる) CLI / IDE拡張 / cloud / ChatGPTアプリ / SDK の5つの入口で、コードがどこで実行されるかを一次資料付きで確認できる 料金プランと5時間ウィンドウの上限、クレジットの換算式の読み方が分かる サンドボックスの3モードと承認の設定を知り、「勝手に実行されないか」に自分で答えられる AGENTS.mdとは何か、CLAUDE.mdと何が違うかを、手元45リポジトリを数えた結果とあわせて把握できる 別のCodexを探している方へ。 本記事はOpenAIのCodexだけを扱います。食品規格のCodex Alimentarius、WordPressの旧ドキュメント群であるWordPress Codex、冊子本を意味するラテン語のcodex、ゲーム内の図鑑を指すコーデックス、バンドのOLDCODEXは、いずれも別の語です。以降は一切触れません。 1. Codexとは──定義と、ChatGPTと違うところ Codexとは、OpenAIのAIコーディングエージェントです。公式リポジトリはCodex CLIを「a coding agent from OpenAI that runs locally on your computer」(openai/codex GitHub、2026-09-15確認)と説明しています。この「ローカルで動く」はCLIについての説明で、Codex cloudはOpenAI側の環境で動きます。 ChatGPTに「このバグを直して」と貼り付けると、返ってくるのは修正後のコードを含む文章です。貼り直すのは人間の仕事です。Codexに同じことを頼むと、Codexがリポジトリの中を自分で探し、該当ファイルを開き、書き換え、必要ならテストを走らせます。人間がやるのは、その差分と検証結果を確認して、変更を採用するかどうかの判断です。 観点 ChatGPTの通常の会話(ツールを使わない場合) Codex 入力 人間が貼り付けたコード片 リポジトリそのもの 出力 文章とコードブロック ファイルへの差分、コマンドの実行結果 ファイル操作 しない する(サンドボックスと承認設定の範囲で) コマンド実行 しない する(同上) 指示ファイル なし AGENTS.md を作業前に読む 人間の役割 コピー&ペースト コマンド実行の承認と、差分のレビュー 「文章をもらう」か「差分をもらう」かが、実務上いちばん大きい差です。 ...

2026年10月4日 · ひとりユニコーン
Codex料金は1クレジット=0.04ドルでAPI単価とつながる──ChatGPT全プランとAPI従量課金の対応表(2026年10月時点)
Photo by FIN on Unsplash

Codex料金は1クレジット=0.04ドルでAPI単価とつながる──ChatGPT全プランとAPI従量課金の対応表(2026年10月時点)

この記事の日付について。 2026-09-19 に調査・執筆し、公開日の 2026-10-04 にプラン価格、5時間ウィンドウの推定メッセージ数、機能可用性表、クレジット単価表、API 価格表(Standard / Batch / Flex / Fast)、API のレート制限、旧 URL の転送先を一次資料で再確認して更新しました。本文中の「2026-09-19 確認」は執筆時、「2026-10-04 確認」は公開前の再確認の日付です。筆者環境の計測値は、断りがない限り 2026-09-19 の記録です。 この記事でわかること(2026年10月時点の結論) 今回確認した公開料金ページには、Codex だけを単体で購入するサブスクリプション価格は載っていません。 公開されている料金は、ChatGPT のプラン(Free 0 ドル / Go 8 ドル / Plus 20 ドル / Pro 100・200・500 ドル / Business 20 ドル per user / Enterprise・Edu は個別見積)に含まれる利用枠と、API キーによる従量課金の 2 系統です(ChatGPT Learn 公式 Pricing 2026-10-04 確認) 「上限」という一語が、4 つの別の仕組みを指しています。 5時間ウィンドウのメッセージ数、週次上限、クレジット、API のトークン単価です。公式は、API のトークン価格はサブスクリプションの利用枠とは別で、含まれるタスク数の見積もりに使わないよう明記しており、この 4 つを 1 つの換算率で相互に変換することはできません 変換できるのはクレジット単価と API のドル単価の間だけです。2 つの公式表を割り算すると、7 モデル×3 区分の 21 セットすべてが 1 クレジット=0.04 ドルの比で一致しました(本稿の計算。購入価格ではありません) 2026-10-04 確認の公式表では、Pro には現在 5時間上限がありません。 Plus と Standard Business の 5時間あたり推定メッセージ数は同じ値です 私の仮定した 1 ターン(非キャッシュ入力 1 万・キャッシュ入力 5 万・出力 6 千トークン)を gpt-5.3-codex で回すと、月 181 ターンまでは API の請求額が Plus の月額 20 ドルを下回ります。 同じ量を Plus の枠で賄えるかは別の問題で、試算式は第 9 節に置きました この記事は「いくら払えばいいか」だけを扱います。Claude Code や Cursor との比較は別の検索意図なので、第 14 節の内部リンクで既存記事へ送ります。 ...

2026年10月4日 · ひとりユニコーン
Cursorの使い方──Linux arm64版も配布、Cmd+Kは選択範囲・Cmd+Iはサイドペイン、無料Hobbyで枯渇後の挙動まで書かれているのはTabの月次枠
Photo by Arnold Francisca on Unsplash

Cursorの使い方──Linux arm64版も配布、Cmd+Kは選択範囲・Cmd+Iはサイドペイン、無料Hobbyで枯渇後の挙動まで書かれているのはTabの月次枠

Cursorを入れて、自分のコードがAIに書き換わったdiffを初めて見るまでにやることは4つです。配布ページから自分のOSとアーキテクチャに合う版を落とす、起動してサインインする、リポジトリを1つ開く、Cmd+I(Windows・Linuxは Ctrl+I)でサイドペインを開いて変更を1つ依頼する。依頼が通れば差分が出るので、それを確認します。利用枠・通信・権限・指示の中身によっては差分まで進まないこともあります。公式のクイックスタートも、サインイン → Cmd+I でAgentにコードベースを説明させる → 変更を頼む → diffビューで確認、という並びで書かれています(Cursor Docs Quickstart 2026-09-20確認)。 詰まるとしたら手順ではなく、そのあとです。補完が出ない、サインインが弾かれる、Agentが目的のファイルを読まない。この記事は手順を並べたうえで、公式のトラブルシューティングに載っている症状と対処を1枚の表にまとめます。 この記事の日付について。 2026-09-20に調査・執筆し、公開日の2026-10-04に配布ページ・料金ページ・料金ドキュメント(Models and pricing)・Tab / Inline edit / Tab issues のヘルプ・Rules・Run modes・キーボードショートカットの各ページと changelog を一次資料で再確認して更新しました。本文中の「2026-09-20確認」は執筆時、「2026-10-04確認」は公開前の再確認の日付です。筆者環境の計測値は、断りがない限り2026-09-20の記録です。 この記事でわかること ダウンロードからdiffが出るまでの番号付き手順と、各ステップで画面に出る文言 Tab / Cmd+K / Cmd+I の3層がそれぞれ何を担当し、どこで切り替わるか 公式ドキュメントの機能名が、アプリ内のどのメニュー・どのキーに対応するか 補完が出ない・Agentがタイムアウトする・プロキシで通らないときの対処 無料のHobbyでどこまで動き、どの枠が先に尽きるか 1. 検証環境と、この記事で測れなかったこと 先に限界を書きます。今回の執筆環境はGUIを持たないヘッドレス環境で、Cursorのインストーラを実際に起動して操作することができませんでした。したがって企画段階で予定していた2つの実測、すなわち「ダウンロードから最初のdiffまでの完走タイム」と「無料枠が止まった瞬間の画面文言」は、いずれも測定できていません。推定値で埋めることはしません。 この記事に出てくる数値・文言・キー割り当ては、2026-09-20に取得した公式ドキュメントと配布ページの記載で、一部は2026-10-04に再確認しています。出所と確認日はその都度添えます。 項目 内容 OS Linux 6.14.0-1015-nvidia(aarch64) GPU / VRAM 該当なし(Cursorはクラウド側で推論するためローカルGPU要件は論点にならない) Cursorのバージョン 2026-09-20の配布ページの表示で 3.21(2026-10-04確認の最新は 3.22。アプリ内のバージョン情報は未確認) 確認方法 公式ドキュメント・配布ページのWeb取得のみ。アプリの実操作なし 検証日 2026-09-20(JST) ローカル環境で行えた確認は1つだけです。手元の主リポジトリ1本に .cursor/rules ディレクトリは存在しませんでした。~/Documents/gh 配下の全リポジトリを対象にした走査は、ファイル数が多くタイムアウトして完了できていません。「0本」と断定できるのは1本ぶんの範囲です。 2026-10-04 再計測:走査の深さを絞り直したところ、~/Documents/gh 直下のgitリポジトリ46本について、各リポジトリのルートとその1階層下に .cursor ディレクトリは0件でした。それより深い場所は今回も調べていません。 2. 一次資料の対応表 主張 一次資料 種別 確認日 最新版は3.22(2026-09-20時点は3.21)で、Linuxは deb / RPM / AppImage それぞれに ARM64 と x64 がある cursor.com/download 公式配布ページ 2026-10-04 macOS 12以降、Windows 10以降。Linuxはapt / dnf / AppImageの3経路 Cursor Docs Quickstart 公式ドキュメント 2026-09-20 Agentは Cmd+I / Ctrl+I でサイドペインに開く Cursor Docs Agent Overview 公式ドキュメント 2026-09-20 Inline editは Cmd+K / Ctrl+K、質問モードは Opt+Return Cursor Help Inline edit 公式ヘルプ 2026-10-04 ルールは .cursor/rules/ の .mdc。同ディレクトリの素の .md は無視される。AGENTS.md は別方式の指示ファイル Cursor Docs Rules 公式ドキュメント 2026-10-04 無料のHobbyにはTabの月次上限があり、使い切ると次の請求サイクルまで補完が止まる Cursor Help Tab issues 公式ヘルプ 2026-09-20 Hobbyは無料・クレカ不要、Pro が月20ドル、Pro+ が月60ドル、Ultra が月200ドル cursor.com/pricing 公式料金ページ 2026-09-20 Privacy Mode有効時、コードは学習に使われない Cursor Help Privacy 公式ヘルプ 2026-09-20 既定の実行モードはAuto-reviewで、Linuxのサンドボックスは Landlock + seccomp(カーネル6.2以上)、Bubblewrapのフォールバックもある Cursor Docs Run modes 公式ドキュメント 2026-10-04 料金ページは Hobby / Individual / Teams / Enterprise の4列で、個人向けの Individual の中に Pro / Pro+ / Ultra の切替があります(2026-10-04確認)。個人向けの段で数えると Hobby / Pro / Pro+ / Ultra の4段です。このほか公式ヘルプの料金一覧には Hobby(無料)/ Start(インド限定・月額649ルピー、税込)/ Pro(月20ドル)/ Pro+(月60ドル)/ Ultra(月200ドル)が並んでいます(Cursor Help Pricing 2026-09-20確認)。料金の話をするときは、どちらのページを見た値かを添える必要があります。 ...

2026年10月4日 · ひとりユニコーン
Cursor料金は2つの利用枠で決まる──Pro 20ドルを超える条件とモデル別の超過額試算(2026年10月時点)
Photo by Mohammad Rahmani on Unsplash

Cursor料金は2つの利用枠で決まる──Pro 20ドルを超える条件とモデル別の超過額試算(2026年10月時点)

この記事の日付について。 2026年9月24日に調査・執筆し、公開日の2026年10月4日に料金ページ・ヘルプ(Pricing and plans、Usage and limits、Usage-based charges、Spend limits)・docs『Models & Pricing』の全プラン月額、2つの利用枠、モデル別単価、超過時の扱いを一次資料で再確認して更新しました。本文中の「2026年9月24日確認」は執筆時、「2026年10月4日確認」は公開前の再確認の日付です。筆者環境の計測値は、断りがない限り2026年9月24日の記録です。 この記事でわかること 2026年10月4日時点のCursorの全プラン(Hobby無料・Pro 20ドル・Pro+ 60ドル・Ultra 200ドル・Teams 40/120ドル/人)と円換算額 Proの月額を超えて請求が増えるのは、含まれる利用量を使い切り、on-demand(従量課金)を有効にしているときだという仕組み 他社モデル枠を20ドルと仮定した試算では、Claude Opus 5.5で1日30回エージェントを回すと月の超過額は約102ドル(約16,208円)。Sonnet 5.5なら約48ドル(約7,661円) 公式3ページで書き方が揺れている箇所と、本文を確認した範囲では「含まれる量」の金額が見当たらなかったこと 契約前にスペンドリミット(月の上限額)をいくらに設定すればよいかの決め方 結論から書きます。個人で「Tab補完と、ときどきエージェント」ならProの20ドルで収まる可能性が高いです。一方、ClaudeやGPTの上位モデルを毎日エージェントで回すなら、公式docs自身が「月60〜100ドル」を目安に挙げています(Cursor Docs『Models & Pricing』2026-10-04確認)。 含まれる利用量を超え、on-demandを有効にしている場合に、超過分がAPI単価で後払い請求されます。TeamsとEnterpriseでは、他社モデルにCursor Token Rateも加算されます。on-demandを有効にするときは、下の試算で出る自分の超過額に少し余裕を持たせた額をスペンドリミットに入れておくのが安全です。 1. 一次資料の対応表と、3ページで揺れている表示 この記事の数字は、2026年9月24日にCursor公式のページを開いて確認し、2026年10月4日に下表の確認日のとおり開き直したものです。料金は予告なく変わるので、契約前に同じページを開き直してください。 主張 一次資料 種別 確認日 プラン名と月額(Hobby〜Teams Premium、Start ₹649) Help『Pricing and plans』 公式ヘルプ 2026-10-04 2つの利用枠、モデル別単価、Teams Premiumは5倍 Docs『Models & Pricing』 公式docs 2026-10-04 税別表示、on-demandは後払い、Enterpriseはpooled usage cursor.com/pricing 公式料金ページ 2026-10-04 超過分は上乗せなしのAPI単価(Teams・EnterpriseはCursor Token Rateが加算) Help『Usage-based charges』 公式ヘルプ 2026-10-04 利用枠は毎月リセット、繰り越しなし、個人のBYOK Help『Usage and limits』 公式ヘルプ 2026-10-04 スペンドリミットの挙動 Help『Spend limits』 公式ヘルプ 2026-10-04 2025年時点でProは『API価格で20ドル分』 Cursor Blog『Clarifying our pricing』2025-07-04 公式ブログ(過去) 2026-09-24 学生向け特典の有無 cursor.com/ja/students 公式ページ 2026-09-24 為替 1ドル=158.28円(執筆時に固定した試算用のレート) Trading Economics『Japanese Yen』(2026-09-23の値) 市場データ 2026-09-24 料金ページ・ヘルプ・docsの3つは、同じ料金体系を別の切り口で書いています。そのため、読む場所によって見え方が変わります。突き合わせた結果は次のとおりです。 ...

2026年10月4日 · ひとりユニコーン
MCPとは──現行仕様2026-07-28はinitializeを捨て、リクエスト1本ごとにバージョンを宣言する
Photo by Kier in Sight Archives on Unsplash

MCPとは──現行仕様2026-07-28はinitializeを捨て、リクエスト1本ごとにバージョンを宣言する

MCPとは、AIアプリケーションを外部のデータソースやツールへつなぐためのオープンなプロトコルです。標準化されているのは接続の中身ではなく手順です。具体的には、JSON-RPC 2.0のメッセージ形式、ホスト/クライアント/サーバーという3役の分担、サーバーが出せる機能の種類(Resources・Prompts・Tools)、そして各リクエストがどのバージョンで話しているかの宣言方法です(MCP仕様 2026-07-28 2026-09-16閲覧)。 そして「MCPとは」を調べるときに最初に確かめるべきは、読んでいる解説がどのリビジョンの話かです。現行リビジョンは2026-07-28で(Versioning 2026-10-04確認)、この版はinitializeハンドシェイクとMcp-Session-Idを廃止し、プロトコルをステートレスに変えました(同 Key Changes 2026-09-16閲覧)。つまり「まずinitializeでセッションを張り、能力をネゴシエートする」という説明は、2025-11-25以前のリビジョンの説明です。旧リビジョンの説明が誤りになったわけではなく、使うホストやサーバーが旧リビジョンで話していれば、その接続では今もinitializeを使います。仕様はYYYY-MM-DDという識別子を使い、後方非互換な変更が最後に入った日付を示します。 この記事の日付について。 2026年9月16日に調査・執筆し、公開日の2026年10月4日に、仕様の現行リビジョン・HTTPヘッダー・MRTR・ベンチマークの指標などを一次資料で再確認して更新しました。本文と出典表の「2026-09-16」は執筆時、「2026-10-04」は公開前の再確認の日付です。筆者環境の観測値は2026年9月16日の記録です。2026年10月11日に第8節〜第10節(代表的なサーバーの例・料金・Claude Code での接続方法)と、よくある質問4項目を追記しました(「2026-10-11確認」はその日の確認です)。 この記事でわかること MCPを1文で説明するための定義と、何が標準化されていて何は標準化されていないのか ホスト・クライアント・サーバーの3役と、tools/listからtools/callまでに流れるJSON-RPCの中身(_metaの必須フィールドとエラーコード) 自分が読んでいる解説がどの仕様リビジョンの話かをinitializeの有無で判別する方法と、5リビジョンの対応表 2026-07-28でDeprecatedになった機能(Roots・Sampling・Logging)と、最短で削除される時期 導入前に踏むべきリスク確認の項目と、攻撃ベンチマーク論文が報告した「能力の高いモデルほど脆弱」という結果 1. MCPとは──1文の定義と、誰が出しているのか 定義は公式仕様の冒頭が短く書いています。MCPは「LLMアプリケーションと外部のデータソース・ツールとのシームレスな統合を可能にするオープンプロトコル」です(MCP仕様 2026-09-16閲覧、原文は英語)。2024年11月にAnthropicが公開し、2025年12月にLinux Foundation傘下のAgentic AI Foundationへ寄贈された仕様ですが、仕様リポジトリのLICENSEはMITからApache-2.0への移行中の複合ファイルで、前文に続けてApache-2.0とMITは全文、CC-BY-4.0は見出しと外部リンクによる参照という順で並んでいます。新規のコードと仕様の寄与にはApache-2.0が適用され、仕様を除くドキュメントの寄与はCC-BY-4.0です。MITセクションに置かれた著作権表記は「Copyright (c) 2024-2025 Model Context Protocol a Series of LF Projects, LLC.」で、リポジトリのREADMEは今も「This project is licensed under the MIT License」と記載しています(modelcontextprotocol/modelcontextprotocol LICENSE・同リポジトリREADME 2026-09-16閲覧)。単独ベンダーの仕様から、Linux Foundation系のプロジェクトへ器が移っている状態です。 仕様本文は、MCPがLanguage Server Protocol(LSP)から着想を得たと明記しています。LSPが「プログラミング言語への対応をエディタ横断で標準化した」のと同じ形で、MCPは「文脈とツールをAIアプリ横断で標準化する」という位置づけです。ここを押さえると、MCPが何をしないかも見えます。MCPはモデルの重みを変える仕組みではなく、つなぎ先のAPIの中身も決めません。 AI以外のMCPとの切り分け 「MCP」という略語は他分野にもあります。IT資格(Microsoft Certified Professional)、医療の中手指節関節(metacarpophalangeal joint)、日本の除草剤の慣用名(MCPソーダ塩。有効成分名はMCPAナトリウム塩)、電子部品の型番接頭辞(MicrochipのMCP3008など)で同じ3文字が使われます(Microsoft Learn・NCBI Bookshelf(中手指節関節)・石原バイオサイエンス 石原MCPソーダ塩・Microchip MCP3008 2026-09-16閲覧)。本記事が扱うのはAI文脈のModel Context Protocolだけです。別分野のMCPを調べている場合、この記事の内容は当てはまりません。 なぜ2024年11月に出てきたか 初出はAnthropicの2024年11月25日の発表です。同日に公開されたのは、仕様とSDK、Claude Desktopアプリでのローカルサーバー対応、サーバー実装のオープンソースリポジトリ、そしてGoogle Drive・Slack・GitHub・Git・Postgres・Puppeteer向けの既製サーバーでした。発表時点の採用例としてBlockとApolloが挙げられ、開発ツール側ではZed・Replit・Codeium・Sourcegraphの名前が並んでいます(Anthropic『Introducing the Model Context Protocol』 2026-09-16閲覧)。背景は単純です。ツール連携の実装がクライアントごとにばらばらで、同じ連携を各アプリ向けに作り直す必要があったからです。 ...

2026年10月4日 · ひとりユニコーン
MCPサーバーの選び方と候補一覧──登録した本数と実際に載るツール定義を分けて数える
Photo by Fotis Fotopoulos on Unsplash

MCPサーバーの選び方と候補一覧──登録した本数と実際に載るツール定義を分けて数える

MCPサーバーは「良さそうなものを片端から入れる」と壊れます。壊れるのは接続ではなく、セッション開始時のコンテキストと、ツール選択の精度です。 Anthropic公式ドキュメントは数字で明言しています。ツール定義は50本で1万〜2万トークンを消費し、GitHub・Slack・Sentry・Grafana・Splunkを並べた構成では作業前に約55,000トークンが埋まる。そしてツール選択の精度は30〜50本を超えると落ちる(Claude Platform Docs『Tool search tool』 2026-09-14閲覧)。ただしこの数字は、ツール定義がコンテキストに同時に載っている場合の話です。Claude Codeのようにツール探索が既定で有効なクライアントでは、登録した本数と実際に載る定義数は一致しません。だから選び方の順序は「候補を見比べてから選ぶ」ではなく、自分のクライアントでツール探索が効いているかを確かめ、実際に載る定義数を数えてから候補を当てはめるになります。 この記事でわかること MCPサーバーを増やすと何が増えるのか──公式が出している消費トークンの実数と、30〜50本という精度の境界 ツール探索の有無で何が変わるか。自分の環境で「実際に載る定義」を無料で数える手順(トークン数え上げエンドポイントの使い方とJSONの例) 一次資料で提供主体・接続方式・ライセンスを確認できた候補17項目(19サーバー)の一覧表と、公式保守かどうかの見分け方 Claude Code / Codex CLI / Cursor それぞれの設定ファイルの場所と、ツールを絞るための設定項目 結論としての最初の構成の決め方(全定義を載せる構成なら合計30本前後という筆者の運用目安、探索が有効なら登録数より絞り込みの機構を見る) 1. 結論──ツール探索の有無を先に確かめ、上限は合計ツール本数で決める 最初の問いは「MCPサーバーは結局どれを入れればいいのか。全部入れると何が起きるのか」です。答えは順に2つです。 全部入れると何が起きるかは、クライアントがツール探索を使っているかで変わります。ツール探索を切って全定義を載せる構成では、セッションを開くだけでコンテキストが数万トークン埋まり、ツールの選択ミスが増えます。ツール探索が有効な構成では、定義は必要になった時点で読み込まれるため、登録本数がそのまま消費になるわけではありません。どちらの場合も、公式の数字(50本で1万〜2万トークン、30〜50本で精度低下)に自分の構成を当てると、上限は「サーバー本数」ではなく同時に載る合計ツール本数で決まると分かります。1本で40本以上のツールを出すサーバーもあるため、本数の議論はサーバー単位では成立しません。 そのうえで最初の構成は、次の順で決めます。第一に、自分のクライアントでツール探索が有効かを確認します(Claude Codeは既定で有効です。第6節)。第二に、ツール探索を切って全定義を載せる構成なら、合計ツール本数が30本前後に収まる範囲で選びます。この30本前後は公式の30〜50本という境界の下限側に寄せた筆者の運用目安で、公式が示した数値ではありません。役割配分の出発点は、①毎日触るSaaSのベンダー公式サーバー1本、②クライアントの組み込み機能と重複しないリファレンス実装1本、③案件ごとに差し替える空き枠1本です。第三に、ツール探索が有効な構成では、登録本数の上限よりも、ツールセットの絞り込み(--toolsets、enabled_tools)と権限ルールで「モデルに見せる定義」を減らせるかを見ます。本記事の計測ではNotion1本で43本、Gmail1本で29本のツールが出ましたが、このセッションではツール探索が有効だったため、この72本がそのままコンテキストに載っていたわけではありません(第6節)。理由は第4節から第6節で示します。候補の一覧は第5節の表です。 2. 本記事が確認した一次資料と、測っていないこと GPUやVRAMは本記事の判断に関係しないため記載しません。代わりに、本文の主張と一次資料の対応を先に出します。すべて2026-09-14に取得しました。 主張 一次資料 種別 確認日 ツール定義は50本で1万〜2万トークン、精度は30〜50本超で低下 Claude Code Docs『Scale to many tools with tool search』 公式ドキュメント 2026-09-14 5サーバー構成の定義が約55,000トークン、ツール探索で85%超の削減 Claude Platform Docs『Tool search tool』 公式ドキュメント 2026-09-14 仕様の現行リビジョンは2026-07-28版。トランスポートはstdioとStreamable HTTPの2つ MCP仕様 2026-07-28 / 同 transports 公式ドキュメント 2026-09-14 ツールは任意コード実行として扱い、ツール注釈は信頼できない前提とする MCP仕様 2026-07-28 公式ドキュメント 2026-09-14 リファレンス実装は7本、アーカイブ済みは13本。新規貢献はApache-2.0、既存コードはMIT modelcontextprotocol/servers GitHub 2026-09-14 Claude Codeのsseはdeprecated。スコープはlocal / project / user Claude Code Docs『MCP』 公式ドキュメント 2026-09-14 Codex CLIは~/.codex/config.toml、起動タイムアウト既定10秒、enabled_toolsでツールを絞れる OpenAI『MCP』(surface=cli) 公式ドキュメント 2026-09-14 Cursorは.cursor/mcp.jsonと~/.cursor/mcp.json。既定でツール実行前に承認を求める Cursor Docs『MCP』 公式ドキュメント 2026-09-14 GitHub公式サーバーはMIT、リモート版はhttps://api.githubcopilot.com/mcp/ github/github-mcp-server GitHub 2026-09-14 トークン数え上げエンドポイントはtools配列を受け取り、無料で使える Claude Platform Docs『Token counting』 公式ドキュメント 2026-09-14 測っていないことも明示します。本記事は、候補17項目(19サーバー)を3クライアントへ順に接続した接続可否・起動秒数・3回試行での失敗回数を計測していません。計測したのは、執筆環境のClaude Codeセッションに実際につながっていたサーバーのツール本数だけです(第6節)。横断マトリクスの残りは推定値で埋めず、未計測のまま置きます。手順は第6節に書いたので、同じ数え方を自分の構成で再現できます。 ...

2026年9月14日 · ひとりユニコーン
Claude Code の使い方──インストールから CLAUDE.md 1本までの公式手順と、手元31リポジトリの棚卸しで見えた実態
Photo by Radowan Nakif Rehan on Unsplash

Claude Code の使い方──インストールから CLAUDE.md 1本までの公式手順と、手元31リポジトリの棚卸しで見えた実態

この記事でわかること 自分の OS でインストールからログインまで、実際に打つコマンドの並び 最初のセッションで何をどう書くか。公式が例示している最初の3プロンプト CLAUDE.md の置き場所4スコープと、最初の1本に書く項目 手元31リポジトリの CLAUDE.md の実測行数分布と、公式の「200行以下」との差 command not found など、エラーメッセージ別の対処 最初に結論だけ書きます。インストールから CLAUDE.md の初版を整えるまでは、curl -fsSL https://claude.ai/install.sh | bash → claude --version → プロジェクトへ cd → claude → ブラウザでログイン → 質問を1つ投げる → /init で CLAUDE.md を生成 → 手で削る、の8手です。macOS・Linux・WSL はこの1行で入り、Windows は PowerShell なら irm https://claude.ai/install.ps1 | iex に置き換わります(Claude Code Docs「クイックスタート」 2026-09-13確認)。 そのうえで、この記事が上位ページと違うのは後半です。CLAUDE.md は「書け」で終わっている解説がほとんどですが、実際に何本も運用すると何行に落ち着くのかという記録が見当たりません。手元の31本を数えたところ、中央値は41行、平均76.0行で、公式が挙げる200行を超えていたのは2本だけでした。ただし、同時に読み込まれる祖先ディレクトリの CLAUDE.md を足すと、200行を超える組み合わせは6本に増えます(§7)。 1. 一次資料の対応表と検証環境 本文の事実はすべて以下から取りました。ローカルの実測は末尾2行です。 主張 一次資料 種別 確認日 インストールコマンド・対応OS・WSL とネイティブの差 高度なセットアップ 公式ドキュメント 2026-09-13 CLAUDE.md の4スコープ・200行の目安・.claude/rules/ Claude があなたのプロジェクトを記憶する方法 公式ドキュメント 2026-09-13 /usage の内訳・キャッシュミス・コスト平均値 コストを効果的に管理する 公式ドキュメント 2026-09-13 最初の8ステップ・必須コマンド・権限モード クイックスタート 公式ドキュメント 2026-09-13 サーフェス一覧・できること 概要 公式ドキュメント 2026-09-13 CLAUDE.md 31本の行数分布と記載カテゴリ ~/<workspace>/*/CLAUDE.md(作業ディレクトリの実パスは伏せ、本稿では ~/<workspace> と表記) 手元の実測 2026-09-13 権限設定の肥大化 ~/.claude/settings.json 手元の実測 2026-09-13 検証環境は次のとおりです。 ...

2026年9月13日 · ひとりユニコーン
26.0%はS1だけ、48.4%の『成功』には新規脆弱性が混ざる──AI生成パッチ6,080件をS1〜S5の分母から解体する
Photo by Chris Ried on Unsplash

26.0%はS1だけ、48.4%の『成功』には新規脆弱性が混ざる──AI生成パッチ6,080件をS1〜S5の分母から解体する

何が起きたのか パスワード管理の1Passwordが2026年に新設した社内セキュリティ研究チーム Off-by-1 Labs が、2026年8月6日に最初の研究成果『Frontier Models’ Vulnerability Patches are Often F.L.A.W.E.D.』を公開しました(1Password公式ブログ 2026-08-06)。F.L.A.W.E.D. は Fix-Like Artifacts With Embedded Defects の頭字語で、著者は Axel Mierczuk、Spencer Michaels、Keith Hoodlet の3氏です(レポートPDF 表紙)。 実験の骨格はこうです。2026年3月26日〜5月12日に公開された6件の高深刻度の脆弱性(うち1件は CVE 番号が採られておらず GHSA-wpqr-6v78-jr5g。レポート自身は表1でこの6件を「six CVEs」と総称しています)を対象に、OpenAI の ChatGPT 5.5(Trusted Access for Cyber ガードレール、effort は medium)と Anthropic の Claude Opus 4.8(Cyber Verification Program ガードレール、effort は high)へパッチ生成を依頼します。1脆弱性・1モデルあたり540試行。生成されたパッチは5段階(S1〜S5)に分類されました。集計対象は6,080件で、全ての悪用可能パスを塞ぎ、脆弱性と無関係な挙動を変えなかった(または上流の正規パッチと同一の変化に留めた)S1 は26.0%です(PDF 表7)。この26.0%は6,080件の単純な件数比ではありません。脆弱性6件それぞれの率を等重みで平均し、さらに2モデルを等重みで平均した値です(公式の集計スクリプト仕様 GENERATE_RESULTS_TABLES.md)。件数比になっているのは1モデル・1脆弱性のセル内部だけです。 ただしこの26.0%という数字、そして1Password公式ブログが前面に出した53.9%という数字は、いずれも「何を分母にし、何を成功と呼ぶか」で意味が変わります。報道各社の見出しは53.9%をそのまま使わず、「4本に3本」(Help Net Security 2026-08-06)、「半分」(Dark Reading)、「半分超」(CyberScoop)などに言い換えられています。PDF本体には、ブログ記事には載っていない分母の作り方が書かれています。 6,480件生成して、6,080件で数えている 540という数字は $3 \times 9 \times 20$ の積です。パッチャーの動作モードが3種類(oneshot / iterative / exploratory、PDF 2.4節)、プロンプトテンプレートが9種類(PDF 2.5節)あります。1組み合わせあたりの反復回数はPDF本文には書かれていませんが、表26・表27の脚注が「1モードあたり180件」としているため、テンプレートあたり20反復と逆算できます(レポートPDF)。したがって総生成数は6 CVE × 2モデル × 540 = 6,480件になります。 ...

2026年9月6日 · ひとりユニコーン
お問い合わせ: [email protected]