Claude Codeで「自分の解説書」を作ってみた — 非エンジニア向けガイド【初級編】制作の記録

★ 0
🎧 この記事を音声で聴く(8:37)

きっかけは、よく連絡を取っている24歳の知人からの一言でした。

「Claude Codeについて教えてください」

Pivotの動画を観たらしく、スクリーンショットと一緒にメッセージが来たんですよね。彼はエンジニアではありません。

教えたい気持ちはある。でも、いざ伝えようとすると難しい。Claude Codeの公式ドキュメントは英語で開発者向け。日本語の解説はYouTubeに増えてきたけれど、断片的で全体像が見えにくい。「AIってすごい!」で終わる記事は山ほどあっても、「で、何から始めればいいの?」に答えるものが少ない。

最初は「彼用にちょっと整理すればいいか」くらいに思っていたんですが、Claude Codeと相談しながら設計を進めていくうちに方向性が変わりました。彼専用にする必要はない。広く誰にでも使える汎用ガイドにして、相手に合わせて「ここから読んで」と案内できるものにしよう、と。

そうして出来上がったのが、まずは初級編として、AIの基礎知識からClaude Codeの使い始めまでをカバーするガイドです。


何を作ったか

完成したのは3つの形式です。

1. Webサイト(全6部・25ページ)
Webガイドを見る

MkDocs Materialで構築した、網羅的なガイドサイト。AIの基礎知識からClaude Codeの7つの核心概念、ベストプラクティス、ユースケース集、始め方ロードマップまで。全ページに音声読み上げも付けました。

2. スライド動画(24枚・約9分半)
動画を見る(MP4)

Webサイトの内容をスライドに要約し、ナレーション付きの動画にしたもの。スライド間のトランジション(切り替えアニメーション)とBGM付き。

3. スライドPDF(24ページ)
PDFをダウンロード

動画と同じスライドをPDFにまとめたもの。ダウンロードして手元に置ける形式です。


なぜ「非エンジニア向け」なのか

以前の記事で、Claude Codeで「会社経営」を組んでみたことを書きました。155業界を分析して、43%しか活用できないという結論だった。

ただ、あの分析は「エージェント経営」というアーキテクチャの話であって、Claude Code自体の価値はもっと広いんですよね。

最近のハッカソンで優勝しているのは、心臓専門医や弁護士や道路作業員だったりする。プログラマーではない人たちです。「Vibe Coding」— 自然言語でソフトウェアを作る時代が、もう始まっています。

じゃあ、非エンジニアが「Claude Codeって何?」から「実際に使い始める」までの道のりを、1つのガイドでカバーできないか。それが今回の出発点でした。


構成を設計する — 6部構成にした理由

最初にやったのは、「何を・どの順番で伝えるか」の設計です。

非エンジニアがいきなり「CLAUDE.mdを書きましょう」と言われても意味がわかりません。まず「AIって今どうなってるの?」から入り、Claudeのエコシステムを理解し、その上でClaude Codeの概念を学ぶ。この順序が大事でした。

結果、こうなりました。

テーマ役割
第1部AIの今を知る前提知識の共有
第2部Claudeエコシステム製品群の全体像
第3部Claude Codeの核心概念7つの概念を深掘り
第4部実践Tipsベストプラクティス集
第5部ユースケース集逆引きで活用法を探す
第6部始め方ロードマップ今日からのアクション

「知る→理解する→学ぶ→実践する→始める」という流れです。

この情報設計はAIにはできなかった。「読み手が何を知っていて、何を知らないか」を想像する力は、今のところ人間にしかないと思っています。


「解説書をAIで作る」というメタな体験

面白いのは、この制作プロセス自体がClaude Codeの実力を証明しているところです。

25ページのガイド本文、24枚のスライドナレーション原稿、500行超の音声生成スクリプト、800行超の動画生成スクリプト。これらのコード生成とテキスト生成は、すべてClaude Codeが担当しました。

では僕は何をしたのか。正直に言うと、95%以上はClaude Codeの仕事です。

構成設計、品質判断、BGM選曲、トランジション選定 — 一見すると「人間の判断」に見えますが、実態はこうでした。

構成設計: Claude Codeに複数案を出させて、「これがいい」と選んだ
品質判断: Claude Codeが生成した音声を聴いて、「ここ直して」と戻した
BGM・トランジション: Claude Codeにベストプラクティスをリサーチさせ、候補を並べさせて、好みで選んだ
エラー検出: 画面を見て「これおかしくない?」と指摘した

つまり僕がやったのは、選択肢を選ぶこと違和感を伝えること。リサーチも提案も実装もClaude Code側です。

これって、上司の仕事に近いんですよね。優秀な部下が調べて提案してきたものに「OK」か「やり直し」を出す。コードは1行も書いていないし、テキストもほとんど書いていない。

Anthropicのレポートで「タスクの実行はAI、タスクの定義は人間」と書きましたが、もう少し正確に言うと、タスクの定義すらAIに手伝ってもらえる。人間に残っているのは「最終的なGOサインを出すこと」と「何か違うと感じる直感」だけかもしれません。


作ってみて分かったこと

「量」は圧倒的に速い

25ページの文章を書き、全ページに音声を付け、スライド動画まで作る。手作業なら数週間はかかるプロジェクトを、3日間のセッションで完了できました。

でも「0→1」の部分は人間

そもそもこのプロジェクト自体、知人から「Claude Codeについて教えてください」と連絡が来なければ始まっていません。「じゃあ汎用ガイドにしよう」と方向を広げたのも僕の判断です。

「何かを作ろう」と思い立つこと自体が、まだAIにはできない。 きっかけは日常の人間関係や、「これが足りない」と感じる感覚から生まれるもので、AIに「何か作って」と言っても意味がない。

もちろん、構成設計や取捨選択もClaude Codeに案を出させました。でも「非エンジニアの24歳が読む」という読者像を最初に定義したのは僕だし、それが汎用ガイドに変わったのもClaude Codeとの会話の中での僕の判断です。AIに「非エンジニア向けのClaude Codeガイドを作って」とだけ指示したら、おそらく公式ドキュメントの焼き直しが出てくるでしょう。

人間の「耳」と「目」が品質を決める

音声読み上げは、テキスト上は問題なくても聴いてみると違和感だらけだったりします。「Claude Code」を「クロードコード」と読ませるための辞書を70語以上作りました。トランジションは22種類を実際に見比べて2種類に絞った。BGMは3候補を聴き比べて選んだ。

これらは数値化できない「感覚」の判断です。AIにスコアリングさせることはできるけれど、最終判断は人間の感覚がないと無理でした。


このガイドが伝えたかったこと

Claude Codeは「プログラミングツール」ではなく「AI指揮ツール」です。

必要なのはプログラミングスキルではなく、言語化力(やりたいことを正確に言葉にする力)とマネジメント力(AIに適切に指示・検証する力)。

これは、僕自身がこのガイドを作るプロセスで改めて実感したことでもあります。コードは1行も手で書いていない。でも「何を作るか」「どう構成するか」「この品質でいいか」を判断し続けた。

非エンジニアのみなさんにこそ、この体験をしてもらいたいと思っています。


「初級編」の次

今回のガイドは初級編 — 「Claude Codeって何?」から「実際に使い始める」までをカバーしたものです。

でも、使い始めてからが本番なんですよね。CLAUDE.mdの設計パターン、MCPサーバーの実践的な構築、エージェントチームの運用ノウハウ、Hooksやカスタムスキルの活用。実際に使い込んでいくと、初級編では触れきれないテーマがたくさん出てきます。

今後、中級編・上級編・実践編と段階的に拡充していくつもりです。このジャーナルで書いてきたエージェント経営FXトレーディングシステムの記事も、ある意味では「実践編」の素材ですよね。体験を重ねるごとにガイドも育てていく — Claude Code自体を「育てる」のと同じ考え方です。

完成物リンク

Webガイド(初級編): kaleidofuture.com/claude-guide/(全6部・25ページ・音声付き)
スライド動画: claude-guide-bgm.mp4(24枚・約9分半・BGM付き)
スライドPDF: claude-guide-slides.pdf(24ページ)

「完璧になってから公開する」より「まず出して、フィードバックをもらう」方が、AI時代の作り方だと思っています。

次回は、このガイドを作る中で確立した「Markdownから動画まで」のコンテンツパイプラインについて書きます。技術的に面白いポイントが多かったので、検証ジャーナルとしてまとめる予定です。

この記事が参考になったら

Share