※当サイトにはアフィリエイト広告が含まれます。本記事の本文にアフィリエイトリンクはありませんが、筆者自身の無料noteと、筆者が販売するAI記事キットの案内を1か所ずつ含みます。記事の前後には、サイト共通の広告が表示されます。

AI社員を作った。なのに呼ばれない。呼ばれても、完了しましたと言いながら中身が壊れている。

私のフォルダには、いまAI社員が20体います。ブログ、Threads、Instagram、動画の担当です。コードは書けません。全部Claude Codeに日本語で頼んで作りました。

作るのは簡単でした。難しかったのは、作ったあとに事実と違う報告を止めることです。この記事では、Claude Code AI社員の作り方と、20体を回して踏んだ失敗を数字つきで書きます。

Claude Codeそのものが初めての人は、Claude Codeの始め方を先に読んでください。この記事は、インストールが済んでいる前提で進めます。

Claude CodeのAI社員とは何ですか？中身はファイル1枚のサブエージェント

Claude CodeのAI社員とは、公式にはサブエージェントと呼ばれる機能です。役割と使ってよい道具を書いたMarkdownファイルを1枚置くと、Claude Codeがその係に仕事を任せるようになります。

公式ドキュメントによると、各サブエージェントは独自のコンテキストウィンドウで動きます。コンテキストウィンドウは、AIが一度に覚えていられる作業メモの範囲のことです。係ごとに記憶が分かれるので、長い調べものをさせてもメインの会話が散らかりません。

AI社員とメインのClaude Codeは何が違うのか

メインのClaude Codeは、あなたと話しながら何でもこなす窓口です。AI社員は、その窓口から仕事を振られる専門の係にあたります。

係には専用の指示文と、使ってよい道具の一覧と、権限が付きます。記事を書く係にはファイルの書き込みを許し、検査する係には読むことだけを許す。こういう線引きがファイル1枚でできます。

ファイルを置く場所は2か所だけ

置き場所は、今のプロジェクトだけで使うなら .claude/agents/、全プロジェクトで使うなら ~/.claude/agents/ です。私の20体は、すべてブログのプロジェクト側に置いています。

覚えておくのは、1体につきファイル1枚という点だけで十分です。フォルダを開けば、社員名簿がそのまま並んで見えます。

Claude CodeのAI社員はどう作る？最短の作り方

Claude CodeのAI社員は、先頭に3行の設定を書いたMarkdownファイル1枚で作れます。必須はnameとdescriptionの2つで、toolsは任意です。私はtoolsも最初から書くことを勧めます。

1. nameとdescriptionを書く

nameは係の名前で、英小文字とハイフンで付けます。descriptionは、この係をいつ呼ぶかの説明です。Claudeはこのdescriptionを読んで、仕事を任せるかどうかを決めます。

下は、この記事のために書いた検査係の見本です。私の実物の指示文ではありません。

<code>---
name: fact-checker
description: 記事や投稿文の数字と件数を元データと突き合わせて検査する。文章を書いた直後に使う。Use proactively after writing.
tools: Read, Grep, Glob
---

あなたは検査係です。文章の中の数字を1つずつ元ファイルで探し、
見つからない数字と、上限を超えた文字数を一覧にして返してください。
自分で文章を直してはいけません。</code>

公式ドキュメントは、自動で任せてほしい係のdescriptionに「use proactively」のような言葉を入れるよう勧めています。見本の末尾に英語を足しているのはそのためです。

2. toolsで使ってよい道具を絞る

toolsを書かないと、その係はメインの会話が使える道具をほぼ全部受け継ぎます。検査係に書き込みの道具まで渡すと、検査のついでに本文を書き換えかねません。

見本の検査係は、Read、Grep、Globだけです。読む、探す、ファイル名で一覧を出す。この3つなら、報告はできても勝手な修正はできません。

3. modelは書かなくても動く

modelにはsonnet、opus、haiku、fableのような名前か、inheritを書けます。inheritはメインの会話と同じモデルを使う指定です。

書かなかった場合は、呼び出し時の指定、環境変数、メインの会話のモデルの順で決まります。まず動かしたいだけなら空けておいて構いません。

ファイルを保存すると、Claude Codeは数秒で変更を拾います。再起動は要りません。例外もあります。たとえばセッション開始時に ~/.claude/agents/ フォルダがまだ無かった場合は、再起動が要ると公式に書かれています。

以前の版には、/agents と打つと作成画面が開く機能がありました。公式ドキュメントによると、v2.1.198からは作成画面が開きません。今はClaudeに作ってと頼むか、フォルダに直接ファイルを置きます。

実際に動かしている20体の役割表

私の .claude/agents/ には、2026年9月28日時点で20体のAI社員がいます。数えたのはファイルの数で、指示文の中身はここには出しません。

20体すべてに道具の制限を付けている

20体のファイルを開くと、全員にtoolsの行があります。執筆係は新しいファイルを書けますが、SEO監査係にはWriteを渡していません。

ここで道具を絞っておいた効果は、失敗の話で分かります。先に結論を書くと、道具を絞っても事実と違う報告は防げませんでした。

modelの指定は全20体をopusに揃えた

この記事を書くために数えたら、modelの行はばらばらでした。sonnet指定が12体、行が無いのが8体です。行が無かったのはブログの8体でした。

2026年9月28日に、20体すべてをopus指定へ書き換えました。変えたのは各ファイルの先頭にあるmodelの1行だけです。書き換えたあとに20ファイルを数え直し、opusの行が1体に1行ずつあることを確かめています。

レコプラ以外でも、案件ごとに係を作っている

AI社員はレコプラ専用ではありません。私は案件を始めるたびに、その案件に要る係を作っています。2026年9月28日に数えると、18の案件フォルダに合わせて136体いました。

使い方はオーケストレーションが中心です。1つの指示で、マーケティング担当や心理士役など複数の係を同時に動かし、意見を持ち寄らせます。汎用の係を使い回すより、案件専用に作ったほうが仕上がりの精度は上がると感じています。

AI社員の確認済みの報告は信じていい？304本中23本が落ちた

信じないでください。私の手元では、8体全員が目視で確認済みと報告した304本のうち、23本が機械検査で不合格でした。これは2026年9月17日の作業記録に残っている数字です。

何を作らせて、何が落ちたのか

作らせたのは、Threads投稿の1行目です。304本を8体に分担させました。ルールは2つで、1行20字以内と、台帳に無い数字を足さないこと。

8体とも、全件を目視で確認済みと返してきました。そこで文字数と数字を機械で数え直すと、23本が落ちています。長い行は27字あり、台帳に無い30分や500件という数字も混ざっていました。

確認済みは、作業の説明であって結果の証明ではない

AI社員の確認済みは、確認という作業をしたという報告です。結果が正しいことの証明にはなりません。20字を数える作業は、機械なら一瞬で間違えずに終わります。

私はこの日から、係の自己申告を検証の代わりに使うのをやめました。数と長さは、必ずスクリプトで数え直します。

AIが勝手に数字を足す癖は、ブログ記事でも起きます。私が検証で事実と違う報告を止めた場面は、AI自動化の実例をまとめた記事にも書きました。その記録はバイブコーディングの失敗例と見抜き方に並べました。

担当がいない工程は黙って消える

AI社員の仕組みで一番気づきにくいのは、担当者のいない工程です。誰もエラーを出さないまま、工程ごと飛ばされます。

記事122本に対してリサーチは3本だった

2026年8月18日の時点で、このブログの記事は122本、企画書は14本ありました。それなのに、読者の悩みを集めたリサーチの報告書は3本しかありません。

手順書には、書く前に調べる工程がちゃんと載っていました。ただ、その工程を受け持つ係がいなかった。だから誰も調べず、誰も調べていないと言いませんでした。

係を1体足しただけで、調べる工程が戻ってきた

リサーチ係を足してから、調べる工程は飛ばされなくなりました。2026年9月28日の時点で、リサーチのフォルダには33ファイルありました。この記事も、読者の言葉を4つ集めてから書いています。

手順書に書いた工程の数と、係の数を並べてみてください。担当の欄が空いている工程は、たぶん今も黙って飛ばされています。

検査のつもりのフックが走っていなかった

フックとは、ファイルを書いた直後などに決まったコマンドを自動で走らせる設定です。私はここに、AIっぽい言い回しを探す検査スクリプトをつないでいました。

フォルダが1階層ずれるだけで検査が消える

設定の中身は、.claude/scripts/ にある検査スクリプトを相対パスで呼ぶ1行です。作業中のフォルダがプロジェクトの一番上なら動きます。

ところが作業フォルダが1階層深い .claude に入った日は、.claude/.claude/scripts/ を探しに行きます。そんな場所は無いので、検査は走りません。

緑に見えることと、検査が効いていることは別物

困るのは、走らなくても作業が止まらない点です。書き込みは成功し、画面には何の警告も残りません。私はフックを入れた安心感で、検査が毎回効いていると思い込んでいました。

いまは公開前に、同じスクリプトを手で1回走らせています。フックは保険として残し、合否の判断には使いません。

AI社員が呼ばれない・途中で止まるのはなぜ？

AI社員が呼ばれない原因は、たいていファイルの書き方とdescriptionにあります。途中で止まる原因は、回数の上限か、承認待ちです。どちらも公式ドキュメントに書かれた動きなので、自分で確かめられます。

正直に書くと、私自身はdescriptionの書き方が原因で呼ばれなかった経験はありません。以下の表は、公式ドキュメントの記載から作った確認場所です。

呼ばれないときに見る4か所

確実に呼びたいときは、入力欄で @ を打ってAI社員の名前を選びます。公式ドキュメントでは、これで指定した係が確実に動くと説明されています。

途中で止まるのは、上限か承認待ち

maxTurnsを書いた係は、決めた回数に達すると止まります。このとき結果は途中までの扱いで返り、あとから続きを再開させられます。

もう1つは承認待ちです。裏で動く係が許可の要る操作に当たると、メインの画面に確認が出ます。承認するまで、その係は先へ進みません。画面を離れているあいだに止まって見えるのは、たいていこちらです。

止まったまま気づかない状態が一番こわい

止まるのは直せます。こわいのは、止まったのに完了と読める報告が返ってくる状態です。前の章の304本の話と同じで、報告の文面では区別がつきません。

作業が保存されない、途中で消えるという症状は、Claude Codeで作業が保存されないときの対処で別にまとめています。

非エンジニアの1人事業でもAI社員は実用になる？最初の1体は検査係

実用になります。私はコードを書けないまま、ブログからSNSまで20体を回しています。ただし最初の1体は、書く係ではなく検査係にしてください。

書く係を先に増やすと、確認の手間が人数分ふくらむ

書く係は、置いた日から成果物を出してくれます。うれしいのはそこまでで、出てきた物を確かめる手間は係の数だけ増えます。304本を8体で作ったときも、確かめる側が追いつきませんでした。

検査係が先にいれば、書く係を増やしても確かめる量は増えません。私が20体を作り直すなら、1体目は数字と文字数を数える係にします。

検査係にさせることは3つで足りる

3つ目が大事です。検査係に修正までさせると、直したつもりの報告がまた1つ増えます。

非エンジニアがClaude Codeで何を自動化できるかは、非エンジニアのClaude Code自動化の実例で具体的に書きました。係を組めるようになった力を仕事にしたい人は、Claude Code副業の始め方と単価相場が次の一歩です。

自分で組む前に、できあがった型で試す手もある

ブログ記事を作る係を自分で組む前に、既製品で流れを体験したい人もいると思います。私が作ったAI記事キットは、Claude DesktopとChatGPT Plusで動くブログ記事の生成キットです。

この記事の20体とは別物で、同じ構成は入っていません。記事づくりの流れを1回通してから自分の係を作りたい人向けです。

AI記事キットの中身を見る

Claude CodeのAI社員の作り方によくある質問

Q. AI社員とサブエージェントは同じものですか？

同じものです。AI社員は分かりやすくするための呼び名で、Claude Codeの機能名はサブエージェントです。

Q. AI社員は何体まで作れますか？

公式ドキュメントに体数の上限は書かれていません。ただしdescriptionの合計が15,000トークンを超えると、起動時に警告が出ると記載があります。

Q. プログラミングができなくても作れますか？

作れます。ファイルの中身は日本語の指示文と数行の設定だけです。私もClaudeに作ってと頼んで、20体を作りました。

Q. 作ったAI社員が呼ばれません。

nameとdescriptionの両方があるか、同じnameのファイルが2枚ないかを見てください。確実に呼ぶなら、入力欄で @ から名前を選びます。

Q. AI社員が途中で止まるのはなぜですか？

maxTurnsの上限に達したか、許可の要る操作で承認待ちになっているかのどちらかが多いです。承認待ちなら、メインの画面に確認が出ています。

Q. AI社員の報告はどこまで信じていいですか？

数字と件数は信じないでください。私の手元では、確認済みと報告された304本のうち23本が機械検査で落ちました。数は必ずスクリプトで数え直します。

Q. modelは指定したほうがいいですか？

最初は空けたままで動きます。空けると、呼び出し時の指定やメインの会話のモデルで動きます。私の20体は、2026年9月28日に全員をopus指定へ揃えました。

Q. 最初に作るならどの係がいいですか？

検査係です。書く係を先に増やすと、確かめる手間が係の数だけ増えます。検査係は読む道具だけに絞り、修正はさせないでください。

20体の運用で新しく落ちた場所と直し方は、記事に足したタイミングでレコプラの公式LINEから届けています。

まとめ｜Claude CodeのAI社員は、増やす前に報告を検査する係を置く

Claude Code AI社員の作り方は、.claude/agents/ にMarkdownファイルを1枚置くだけです。nameとdescriptionを書き、toolsで道具を絞れば動きます。

難しいのは作ったあとでした。私の20体で起きた失敗は3つです。

どれも、AI社員の報告だけを見ていたら気づけませんでした。最初の1体は検査係にしてください。数字と文字数を数えて、一覧だけ返す係です。

公開日: 2026年9月29日　最終更新日: 2026年9月29日