「AIに頼ると逆に時間がかかる」を解決する3つの構造変化 — Claude Code 入門

SHARE

目次

ChatGPTタブを毎朝開く生活、いつまで続ける？

もし、ChatGPT のタブを毎朝開いて1日を始める生活から卒業できたら、とても便利だと思いませんか？

朝、Mac を立ち上げます。慣れた手つきで Chrome の ChatGPT タブを開きます。「今日もよろしくね」と打って、エディタとブラウザの間を1日中往復します。

何を隠そう、私もつい先月までこの生活をしていました。Udemy 講座の教材を作るときも、メールを書くときも、コードを直すときも、毎回 ChatGPT に 同じ前提を貼り直し ていました。プロジェクトの背景、使っている言語、避けたい書き方、過去の失敗。これを毎セッションで再ロードする徒労感を、誰もが知っているはずです。

Cursor に移った人もいるでしょう。私も試しました。確かにエディタの中で対話できるようになって少し楽になります。でも本質は変わりません。「人間が指示する → AI が出力する → 人間が手綱を握り直す」のループが、エディタの中に移っただけでした。

結局、AI に作業を任せるって誰がやってるんだ？

あなたが感じている遅さは、AIの賢さの問題ではない

結論を先に書きます。あなたが感じている遅さは、AI に作業環境がないことが原因です。

3つのアナロジーで説明します。

カフェのテーブルで作業を依頼するのが ChatGPT です。毎回、相手は手ぶらで来ます。プロジェクトの背景もファイル構成も、口頭で説明し直さなければなりません。

IDE に座らせるのが Cursor 系の vibe coding です。ファイルは触れます。でも判断はあなたが握り続けます。コードを書く速さは上がりますが、思考のオーバーヘッドは減りません。

これに対し、道具と環境を渡して仕事仲間にするのが Claude Code、つまり agentic engineering です。AI に道具・ルール・部下まで備えた環境を渡し、仕事を任せます。ChatGPT のように「毎回ゼロから」始める必要がなくなります。

私はこの最初の状態を 「The Copy-Paste Loop（コピペ無限ループ）」 と呼んでいます。倒すべき敵に名前をつけると、対処法が見えやすくなります。

vibe codingからagentic engineeringへ ─ 構造の違い

vibe coding は「対話で書く」、agentic engineering は「環境を整えて任せる」です。これが今日いちばん覚えてほしい1行です。

両者の違いを表にまとめます。

軸vibe codingagentic engineering
主役人間の指示環境（CLAUDE.md / Skills / Subagents / Workflows）
反復のコスト毎回ゼロから環境が育つほど低下
失敗の保管人間の記憶ルール・メモリに蓄積
並列実行不可Agent Teams で可
監査可能性チャット履歴のみHooks・git・ログで残る

なぜこれほど差が出るのか。Cognitive load theory（認知負荷理論） という心理学の概念で説明できます。いわば、人間の脳の RAM には限度があるということです。毎回コンテキストを再ロードするほど、本来の仕事に使える容量が減ります。

「環境にルールを書き込む」 = 自分の脳の RAM を増設する行為です。ChatGPT 時代は人間の脳に頼って RAM を回転させていました。Claude Code 時代は、CLAUDE.md・Skills・Subagents という外部 RAM を増設できます。

mindmap root((AI と仕事の構造)) vibe coding 対話の積み重ね 毎ターン手綱を握る 履歴は揮発する 並列実行は不可 agentic engineering 環境を設計する ルールとメモリで蓄積 Skills と Subagents 並列と監査が可能

ここまでで「思想の違い」を共有しました。次は「では Claude Code は具体的に何ができるのか」を整理します。

あなたが当てはまる4つの罠

このシリーズで答える「読者が当てはまる罠」を、まずは予告として並べます。記事1では4つの全体像を渡し、各論は後続記事で深掘りします。

罠1: Claude.ai と Claude Code は同じだろう

Claude.ai は 会話する AI です。Claude Code は 働く AI です。

Claude Code はファイル操作・コマンド実行・スケジュールタスク・並列実行までできます。あなたのプロジェクトのフォルダに常駐し、エディタの代わりに直接ファイルを編集し、テストを走らせ、git にコミットします。Claude.ai を「もっと使えるようにしたもの」ではなく、別の道具として理解する必要があります。

詳細は #02 会話する AI vs 働く AI で扱います。

罠2: ChatGPT・Cursor・Claude Code はどれも同じ系譜

3つは似ているように見えて、実は構造がまったく違います。

ChatGPT は対話する AI です。Cursor はコード補完を中心にしたエディタです。Claude Code は環境を持つエージェントです。前者2つが「あなたが書く速さを上げる」のに対して、Claude Code は「あなたの代わりに環境ごと仕事を回す」道具です。

詳細は #03 ChatGPT・Cursor・Claude Code 実務で何が変わるか で扱います。

罠3: 機能が多すぎて何から覚えればいいかわからない

Claude Code の核は 4枚の名刺カード です。これを覚えれば全体像はつかめます。

flowchart LR A["Claude Code 4大概念"] A --> B["Subagents<br/>.claude/agents/"] A --> C["Commands<br/>.claude/commands/"] A --> D["Skills<br/>.claude/skills/"] A --> E["Workflows<br/>3つを束ねる"] B --> F["専門分野を持つ部下を雇う"] C --> G["手順を1コマンドに圧縮"] D --> H["反復可能な手順書を渡す"] E --> I["Command→Agent→Skill"]

それぞれを1行で説明します。

  • Subagents（.claude/agents/）: 専門分野を持つ部下を雇う。レビュー専門の部下、デバッグ専門の部下、調査専門の部下、というイメージ。公式が用意した汎用エージェントが5種類あり、自分でも追加できます。
  • Commands（.claude/commands/）: 一連の手順を1コマンドに圧縮する。/review や /security-review のように、何度も使う手順を1つの呼び出しにまとめます。Claude Code 公式コマンドだけで75種類あります。
  • Skills（.claude/skills/）: 反復可能な手順書を渡す。「この種類のタスクが来たら、こう動いて」という指示書です。フロントマターで起動条件を細かく指定できます。
  • Workflows: 上の3つを束ねるオーケストレーション。1つの仕事を、Command が起動し、Agent が実行し、Skill が出力する、という連携を組めます。

「全部いっぺんに使う必要はない、1つずつ育てる」が鉄則です。最初は CLAUDE.md だけでも効果が出ます。

罠4: 個別の機能はわかったが連携できない

3つを束ねる Workflows のイメージが、最後の壁になります。具体例で見せます。

公式リポジトリ（後述）に weather-orchestrator という実装例があります。「気温を取って、SVG カードを作る」だけのシンプルなワークフローですが、Claude Code の連携の仕方がすべて詰まっています。

sequenceDiagram participant U as ユーザー participant C as /weather-orchestrator participant A as weather-agent participant S as weather-svg-creator U->>C: コマンド起動 C->>U: 摂氏か華氏か? U->>C: 摂氏 C->>A: Agent ツールで起動 Note over A: weather-fetcher を preload A->>A: Open-Meteo API A->>C: 26°C を返却 C->>S: Skill ツールで起動 S->>S: SVG を生成 S->>C: weather.svg と output.md C->>U: 結果を表示

読み解き方を1つだけ。/weather-orchestrator は Command です。Command が Agent である weather-agent を呼び出します。Agent は内部に Skill である weather-fetcher を抱えていて、API を叩きます。最後に Command が別の Skill である weather-svg-creator を呼び、SVG を生成します。

Command が指揮者、Agent が演奏者、Skill が楽譜、という関係です。1つの仕事を3層に分けることで、それぞれを独立に育てられます。

今週やる1つの処方箋 ─ CLAUDE.md を50行で書く

ここまでで4つの罠を予告しました。あなたが今週から始められる、たった1つのアクションを処方します。

50行で CLAUDE.md を書く。

これだけです。それだけで「同じ前提を毎回貼る」苦しみが消えます。Boris Cherny（Claude Code の中の人）も「200 行を超えると守られない」と明言しています。最初は短く始めるほうが効果が出ます。

50行 CLAUDE.md の骨格を、私が実際に Udemy 教材リポジトリで使っている版を踏襲して載せます。

# CLAUDE.md
## プロジェクト概要
- このリポジトリは Udemy 講座「AI時代のVBA」の教材リポジトリ
- 受講者向けのサンプルファイルと演習解答を管理
- 公開予定は2026年Q3
## 言語・フレームワーク
- 言語: VBA（Excel 365）+ Python（補助スクリプト）
- ドキュメント: Markdown（Obsidian 互換）
## やってほしくないこと
- グラデーション色の塗りつぶし（NotebookLM パース対策）
- 受講者を煽る表現（「3日でマスター」「誰でも簡単に」）
- ChatGPT を直接呼ぶサンプルコード（ターゲットが初心者なので）
- 区切り線 --- の多用
- 末尾に著者署名
## 最近詰まったポイント
- iCloud 同期と Google ドライブ併用でファイル競合
- VBA の Type ステートメントとクラスモジュールの混同
- Markdown ウィキリンクが Kindle で表示されない問題
## どこにファイルがあるか
- 教材本体: materials/section-XX/- 演習解答: materials/section-XX/answers/- スライド原稿: slides/section-XX.md- 受講者向け配布物: dist/## コミットメッセージのルール
- prefix: feat / fix / docs / refactor
- 1コミット1ファイル原則
## テスト・動作確認
- VBA: Excel 365 で手動実行
- Python: pytest で自動
## 依存関係の追加方針
- 必要最小限。新規追加は理由をコミットメッセージに
## ドキュメント標準
- 日本語の常体は使わない（ですます調で統一）
- カタカナ語は初出時に日本語で言い換える
## その他のクセ
- 私は VBA を10年以上書いている個人事業主です
- ターゲットは日本のビジネスパーソン初心者です
- 顔出しなし、スライド+ナレーション形式です

これを書いてプロジェクトのルートに置くだけで、Claude Code は次回から「同じ前提」を再ロードしません。あなたの脳の RAM が一段と空きます。

書きながら気づくのですが、これは Claude のためではなく自分のため にもなります。プロジェクトの暗黙ルールを言語化する作業そのものが、思考の整理になります。

このシリーズの全体像

このシリーズは全18本構成です。隔週ではなく、毎日1本ずつ公開していきます。

flowchart TD subgraph A["Phase A: 思想と全体像（3本）"] A1["#01 AIに頼ると逆に時間がかかる"] A2["#02 会話するAI vs 働くAI"] A3["#03 ChatGPT・Cursor・Claude Code"] end subgraph B["Phase B: 4大コア概念（4本）"] B1["#04 Skills 入門"] B2["#05 Subagents 入門"] B3["#06 Slash Commands 入門"] B4["#07 Workflows"] end subgraph C["Phase C: 設定とメモリ（3本）"] C1["#08 CLAUDE.md が効かない理由"] C2["#09 .claude/rules/"] C3["#10 設定階層を理解する"] end subgraph D["Phase D: 外との接続（3本）"] D1["#11 MCP"] D2["#12 Hooks"] D3["#13 GitHub Actions レビュー"] end subgraph E["Phase E: 高度な使い方（3本）"] E1["#14 Agent Teams"] E2["#15 Scheduled Tasks と Routines"] E3["#16 /loop と Ralph Wiggum"] end subgraph F["Phase F: 実例とまとめ（2本）"] F1["#17 有名 Workflow 12種を比較"] F2["#18 明日から1つだけ変えるなら"] end A --> B --> C --> D --> E --> F

次回 #02 会話する AI vs 働く AI ─ Claude.ai と Claude Code は別物 では、なぜ Claude.ai を使い慣れた人ほど Claude Code で挫折するのか、その構造を解剖します。

TL;DR

  • 痛みは「AI が遅い」ではなく「AI に環境がない」
  • vibe coding = 対話で書く ／ agentic engineering = 環境を整えて任せる
  • Claude Code の核は4枚の名刺カード（Subagents / Commands / Skills / Workflows）
  • 連携は Command → Agent → Skill のオーケストレーション
  • 今週やる1つは CLAUDE.md を50行で書くこと
  • 次回は Claude.ai vs Claude Code の違い

何を隠そう、私もこのシリーズを書きながら自分の CLAUDE.md を見直しています。最初の Claude Code 体験で震えたのは、ファイルを開いて編集して PR まで作って戻ってきた瞬間でした。同僚ですらない、後輩がついた感覚です。

ひしひしと感じます。この仲間を持っている人と、持っていない人で、来年の生産性は明確に開きます。

来週の自分を1ミリだけ楽にする CLAUDE.md を、今日50行書いてみてください。

前の記事

AIが自動でメンテナンスし続けるナレッジベースをCursorで…