第1章: なぜ個人開発でCloudflare CLIなのか？

1.1 個人開発におけるCloudflareの圧倒的な強み

個人開発において最も貴重なリソースは「開発者の時間」と「初期運用コスト」です。 Cloudflareは、世界330都市以上に広がるエッジネットワークを活用し、個人開発者に対して以下の破壊的なメリットを提供します。

超高機能な無料枠（Free Tier）:
- Cloudflare Pages: 無制限のリクエスト・帯域幅
- Cloudflare Workers: 1日あたり10万リクエストまで完全無料
- Cloudflare D1（SQLite）: 1日500万行の読み込み、10万行の書き込みが無料
- Cloudflare R2（オブジェクトストレージ）: 下り転送量（Egress）課金ゼロ、月10GBストレージ無料
オリジンサーバーレス: サーバーのパッチ当てやOS管理から完全に解放されます。
世界最速レベルの初期応答: 世界中のユーザーの最寄りのエッジ拠点で処理が実行されます。

1.2 なぜGUI（ダッシュボード）ではなくCLIなのか？

ブラウザのCloudflareダッシュボードは直感的ですが、個人開発がスケールしたり継続開発するにつれて以下の問題に直面します。

再現性の欠如: 「どの画面でどのトグルをONにしたか」が記録に残らない。
誤操作のリスク: 本番とステージングの切り替えミスや、誤ったDNS変更。
CI/CDとの断絶: Gitにコミットしても自動でデプロイされない。
ローカル検証の難しさ: ブラウザ上でコードを修正してテストするのは非効率。

CLIを採用することで得られるDX（開発体験）

# 1コマンドでローカル開発環境がエッジ互換で立ち上がる
npx wrangler dev

# TypeScriptの型定義がエッジストレージに合わせて自動生成される
npx wrangler types

# GitにpushするだけでGitHub Actions経由で安全に本番デプロイされる
git push origin main

1.3 登場する主要CLIツールの全体像

本ガイドブックでは、主に以下の3つの公式CLIツールをマスターします。

ツール名	主な用途	代表的なコマンド例
Wrangler	Workers, Pages, D1, KV, R2, AIの総合管理	`wrangler dev`, `wrangler deploy`, `wrangler d1`
cloudflared	ポート開放不要の外部公開・Zero Trustトンネル	`cloudflared tunnel run`, `cloudflared access`
C3 (`create-cloudflare`)	フルスタック・APIプロジェクトの初期化	`npm create cloudflare@latest`

次章では、さっそく手元のPCに環境をセットアップし、安全なAPIトークン認証を完了させましょう。

💡 用語解説コラム

[!NOTE] エッジコンピューティング (Edge Computing)
ユーザーに物理的に近い世界中の拠点（エッジサーバー）で処理を実行する技術。従来の東京や米国の単一データセンターにアクセスするよりも通信遅延（レイテンシ）を大幅に削減できます。

[!NOTE] オリジンサーバー (Origin Server)
WebサイトやAPIの本来のデータが保管されている大元のサーバー。CloudflareのようなCDN/エッジを前段に挟むことで、オリジンサーバーへの直接のアクセス負荷を激減させられます。

[!NOTE] Egress（下り転送量課金）
クラウドからインターネット（ユーザー）へデータを送信する際にかかるデータ転送量料金。AWS S3等では高額になりやすいですが、Cloudflare R2やPagesではこれが「0円（完全無料）」であることが最大の特徴です。