AIツール活用 #Claude Code#Codex#AIエージェント#メディア運営#自動化

Claude CodeとCodexでAIエージェント記事制作を自動化する方法

更新：2026/5/4

AIエージェントと人間が協力して記事を生成するイメージ

この記事は AI エージェント（Writer Agent）が初稿を生成し、Human Owner が確認・修正中のドラフトです。 reviewed_by_human: false の状態では公開されません。

はじめに

私はこのブログ自体を、AIエージェント会社として運営している。

単に「AIに本文を書かせる」のではなく、テーマ決め、構成、本文生成、レビュー待ちの整理までを、Claude Code と Codex を使い分けながら回しているのが特徴だ。実際、この原稿もその運用の中で生成している。

記事制作を自動化したい開発者やメディア運営者にとって重要なのは、1本だけ速く書くことではない。再現できるワークフローとして回ること、そして人間の承認地点が明確であることだと私は考えている。

この記事では、私が実際に採用している Claude Code + Codex の役割分担、Astro + MDX + Cloudflare Pages の構成、そして記事生成フローをどう設計しているかをまとめる。

Claude CodeとCodexを中心にした記事生成フロー図
AIエージェント会社としての記事制作フロー全体像

なぜClaude CodeとCodexを併用するのか

結論から言うと、1つのAIツールに全部やらせるより、役割を分けた方が運用が安定する。

私の感覚では、Claude Code は「リポジトリ全体を見ながら文脈を保って作業する」のが得意で、Codex は「具体的な編集・実装・構造化された作業を進める」のがやりやすい。[要実体験確認]

記事制作に置き換えると、ざっくり次の分担になる。

  • Claude Code：既存記事、運用ルール、ワークフロー、ログの文脈を読む
  • Codex：MDX の生成、frontmatter の整形、必要ファイルの保存を進める
  • Human Owner：公開可否、表現の妥当性、固有体験の追記を判断する

この分担にしておくと、AIが暴走しにくい。特にメディア運営では、本文だけ合っていても不十分で、ログや承認フローまで整っていないと事故につながる。

まずはコンテンツを「ファイル」で持つ

AIエージェント運用と相性がいいのは、WordPress のようなDB中心のCMSより、Markdown / MDX を Git 管理する方式だと感じている。

理由は単純で、AIが直接扱いやすいからだ。

  • 記事本文は apps/site/src/content/articles/*.mdx
  • 制作の裏側は apps/site/src/content/build-logs/*.mdx
  • 生成記録は logs/generation/*.json

この形なら、AIエージェントは「本文だけ」ではなく、「その記事がどう作られたか」まで同じリポジトリで追跡できる。差分も残るし、Human Owner もレビューしやすい。

私はこの点をかなり重要視している。記事制作を自動化するなら、生成物よりも生成プロセスが監査可能であることの方が長期的には効く。

採用している構成

私がこのブログで採用している基本構成は以下の通り。

レイヤー採用技術役割
コンテンツMDX記事本文と build log を管理
サイト生成AstroContent Collections と静的生成
ホスティングCloudflare Pages軽量な配信と運用コスト削減
バージョン管理GitHub差分管理とレビュー
AI作業Claude Code / Codex記事生成、整形、運用補助

Astro を使っている理由は、MDX をそのまま扱いやすく、content schema で frontmatter を一定の形に揃えられるからだ。メディア運営では、記事が増えるほど「フォーマットが揃っていること」の価値が大きくなる。

Cloudflare Pages も相性がいい。WordPress のように動的な管理画面を前提にしなくていいので、公開面をかなりシンプルにできる。

AstroとMDXで構成されたコンテンツディレクトリのイメージ
記事、build log、generation log を分離した構成

実際の記事生成フロー

私の運用では、記事生成はだいたい次の順番で進む。

1. テーマと検索意図を決める

ここは人間または上位エージェントが決める。今回なら claude-code-codex-article-generation というキーワードで、「AIエージェントを使って記事制作を自動化したい人」に向けた MOFU 記事だ。

この時点で曖昧なまま走ると、AIはそれっぽい一般論を書きやすい。だから最初に、

  • 誰向けか
  • 何を持ち帰ってほしいか
  • どの温度感の読者か

を固定する。

2. Writer Agent に記事条件を渡す

次に、テーマ、タグ、frontmatter、本文ルール、画像コメントの形式までまとめて渡す。ここを雑にすると、あとで整形コストが跳ねる。

今回のように、保存先ファイルまで明示しておくと、AIエージェントが迷いにくい。

3. 本文だけでなくログも生成する

ここがこのブログの運用で特徴的な点だ。

私は本文生成だけで終わらせず、同時に generation log と build log を残すようにしている。理由は、あとから「なぜこの表現になったのか」「人間がどこを確認すべきか」を追えるようにするためだ。

生成ログには、少なくとも次を残す。

  • どの記事IDか
  • どのエージェントが作ったか
  • 入力条件の要約
  • 出力内容の要約
  • リスクメモ

4. Human Owner の承認ポイントを明示する

AIだけで公開まで完結させないのも重要だ。私は末尾に「## Human Owner への確認事項」を必ず入れて、実体験の補強、技術的な表現、公開判断を人間に返すようにしている。

この区切りがないと、AI運用は便利でも責任の所在が曖昧になる。

AI生成記事に対するHuman Ownerの確認ポイント一覧
公開前に人間が見るべき承認ポイント

Claude CodeとCodexを使うと何が楽になるか

実運用で便利なのは、単なる文章生成ではなく、周辺作業まで一緒に処理できることだ。

たとえば今回のような記事では、本文だけでなく以下も必要になる。

  • frontmatter の整合性確認
  • 既存 schema との整合性確認
  • 記事ファイルの保存
  • generation log の保存
  • build log の作成

人間が毎回これを手でやると、すぐに面倒になる。Claude Code と Codex を使うと、リポジトリを見ながらこの一連の作業をまとめて処理しやすい。

特に、記事制作を「コンテンツ作業」ではなく「開発フロー」として扱えるようになるのが大きい。レビュー対象が URL ではなくファイル差分になるので、開発者にはかなり馴染みやすい。

自動化でハマりやすい点

もちろん、いいことばかりではない。

私が注意しているのは次の3点だ。

実体験が薄いと記事が軽くなる

AIは整った文章を書くが、固有の温度感は弱い。だから私は、不確かな箇所に [要実体験確認] を付けて、人間があとから厚みを足せるようにしている。

ルールを先に固定しないとブレる

frontmatter、画像コメント、広告表記、アフィリエイトリンクの扱いを先に固定しておかないと、記事ごとにフォーマットが崩れる。運営規模が大きくなるほど、この崩れが効いてくる。

全自動公開は危ない

とくにメディア運営では、事実誤認、表現の強さ、法務リスクがある。だから私は、公開・SNS投稿・案件差し替えのような外向きの操作は Human Owner 承認を前提にしている。

これから始めるならどう導入するか

もし今から始めるなら、私は次の順で小さく作る。

  1. Astro で記事を読むだけの最小サイトを作る
  2. MDX の frontmatter schema を決める
  3. Writer Agent 用の生成プロンプトを固定する
  4. generation log を JSON で残す
  5. Human Owner の確認手順をテンプレ化する

最初から完璧なマルチエージェント運用を作る必要はない。むしろ、1本の記事を安定して再現できるかを先に見るべきだ。

私もこのブログでは、実際に動く流れを先に作り、その後に build log やレビュー導線を増やしている。AIエージェント運用は、設計図より運用ログの方が学びが多い。

まとめ

Claude Code と Codex を使った記事制作自動化の本質は、「AIに文章を書かせること」ではなく、「記事制作を監査可能なワークフローとして実装すること」にある。

私はこのブログをその実験場として運営していて、Astro + MDX + Cloudflare Pages の構成はかなり相性がいいと感じている。開発者やメディア運営者が AI エージェント導入を考えるなら、まずは CMS を自動化するより、ファイルベースの運用に寄せた方が始めやすい。

記事、ログ、承認フローが同じリポジトリに残る。この状態を作れると、AIエージェント運用はかなり現実的になる。

Human Owner への確認事項

  • Claude Code と Codex の使い分けに関する実体験表現が正確か確認してください
  • 実際に詰まりやすかった運用上の課題があれば1〜2個追記してください
  • Astro + MDX + Cloudflare Pages の採用理由に、実際の意思決定背景を足せるか確認してください
  • 本記事を MOFU 向け how-to として公開するなら、次に読むべき関連記事の導線を追加するか判断してください

本記事は Writer Agent が生成した初稿です。 生成ログ：logs/generation/gen_20260504_claude-code-codex-article-generation.json