AI社員をClaude Codeで作る｜サブエージェントと設定の仕組み

この記事の内容は、2026年10月2日に Claude Code の公式ドキュメントで確かめたものです。Claude Code は更新が多く、設定の項目や画面が変わることがあります。使う前に、末尾の出典から最新の内容を確かめてください。

AI社員をClaude Codeで作るとは、仕事のルール、役割、手順、止める操作をファイルに書き、Claude がその範囲で働くように整えることです。プログラムを一から書く必要はありません。多くはMarkdownのファイルと設定ファイルで決めます。

Claude CodeでAI社員を作るとは

Claude Code は、コードベースを読み、ファイルを編集し、コマンドを実行するAIのツールです。ターミナル、IDE、デスクトップアプリ、ブラウザで使えます。多くの使い方では、Claude のサブスクリプションか、Anthropic Console のアカウントが必要です。

AI社員として働かせるときに使う仕組みは、主に4つです。役割が重なって見えますが、読み込まれる時と強さが違います。

CLAUDE.mdで仕事のルールを渡す

CLAUDE.md は、Claude に毎回守ってほしい指示を書く Markdown のファイルです。Claude はセッションの最初にこのファイルを読みます。プロジェクト用は ./CLAUDE.md か ./.claude/CLAUDE.md に置き、バージョン管理でチームと共有できます。

公式ドキュメントは、何度も説明し直していることを書く場所だとしています。同じ間違いが2回起きた時や、新しく入った人にも同じ説明が要る時が、書き足す合図です。/init を実行すると、コードベースを調べた最初の CLAUDE.md を作れます。

書き方のコツ

• 確かめられる具体的な形で書く。たとえば、コミットの前に npm test を実行する、のように書く
• 1つの CLAUDE.md は200行未満を目安にする。長いほど文脈を使い、守られにくくなる
• 見出しと箇条書きでまとめる。矛盾する指示を残さない
• 手順が長いものや、一部のファイルにしか関係しないものは、スキルやパスごとのルールに移す

CLAUDE.md は、強制される設定ではなく、文脈として読まれます。必ず止めたい操作は、後で説明するフックや権限設定で止めます。

サブエージェントで役割を分ける

サブエージェントは、特定の作業を受け持つAIのアシスタントです。それぞれが自分の文脈ウィンドウ、システムプロンプト、使えるツール、権限を持ちます。Claude は、作業がサブエージェントの説明に合うと、その作業を任せます。サブエージェントは作業を終えると、結果の要約だけを返します。

調べ物の結果やログのように、本筋の会話に残す必要のない量の多い作業に向いています。サブエージェントの利用も、本体の会話と同じ利用上限に数えられます。

ファイルの置き場所と書き方

サブエージェントは、YAML の前置き（frontmatter）が付いた Markdown のファイルです。そのプロジェクトだけで使うなら .claude/agents/ に、自分のすべてのプロジェクトで使うなら ~/.claude/agents/ に置きます。ファイルは自分で書くか、Claude に頼んで書いてもらいます。

• name（必須）：サブエージェントの名前
• description（必須）：どんな時にこのサブエージェントに任せるか
• tools：使えるツール。省くと、サブエージェントが使えるツールをすべて受け継ぐ
• model：使うモデル。sonnet、opus、haiku などを指定できる
• permissionMode、skills、hooks：権限の動き、最初から読み込むスキル、このサブエージェントだけのフック

Claude は description を見て任せる相手を決めます。そのため、description は短く、はっきり書きます。細かい指示は、サブエージェントが動く時だけ読まれる本文に書きます。読み取りだけの役割なら、tools を読み取り系のツールに絞ります。

初期設定では、サブエージェントは自分のサブエージェントを、本体の会話から3階層下まで起動できます。起動させたくない役割は、tools から Agent を外します。複数のサブエージェントの組み方はマルチエージェント構成の設計で説明しています。

スキルで手順をまとめる

スキルは、手順やチェックリストを SKILL.md というファイルにまとめたものです。Claude は関係する場面でスキルを使い、人は /スキル名 で直接呼び出せます。CLAUDE.md と違い、本文は使う時だけ読み込まれます。長い参考資料を入れても、使うまで文脈をほとんど使いません。

自分のすべてのプロジェクトで使うスキルは ~/.claude/skills/<名前>/SKILL.md に、そのプロジェクトだけのスキルは .claude/skills/<名前>/SKILL.md に置きます。プロジェクトのスキルをコミットすると、チームでも使えます。以前のカスタムコマンドはスキルに統合されました。Claude に自動で使わせたくないスキルは、disable-model-invocation で人が呼んだ時だけ動くようにできます。

フックと権限設定で勝手な操作を防ぐ

AI社員に仕事を任せるときは、してはいけない操作を、指示ではなく仕組みで止めます。公式ドキュメントは、権限のルールはモデルではなく Claude Code が守らせるものだと説明しています。CLAUDE.md やプロンプトの指示は、Claude がしようとすることを形づくるだけで、許される範囲は変えません。

権限設定

権限のルールには、allow（確認なしで使える）、ask（毎回確認する）、deny（使えない）の3種類があります。ルールは deny、ask、allow の順に確かめられ、最初に当てはまったものが結果になります。広い deny のルールは、より細かい allow のルールがあっても止めます。ルールは /permissions で確かめ、変えられます。

フック

フックは、Claude Code の決まった時点で自動で動くシェルコマンドです。AIが選ぶかどうかに関係なく、必ず実行されます。たとえば PreToolUse のフックは、ツールを使う前に動き、その操作を止められます。終了コード2で終わると、操作は止まります。

PreToolUse のフックが拒否を返すと、権限の確認を省く設定で動かしていても、その操作は止まります。公式ドキュメントは、守らせたいファイルの編集を止める例を載せています。顧客のデータや本番の環境に触れるAI社員では、先にこの仕組みを入れておきます。

作ったAI社員を人に使ってもらうには

作ったAI社員を、ほかの人や会社に使ってもらう方法はいくつかあります。

• プロジェクトに入れて共有する：CLAUDE.md、.claude/agents/、.claude/skills/ をリポジトリにコミットする
• プラグインにまとめる：スキル、サブエージェント、フック、MCP サーバーを1つのまとまりとして入れてもらえる。設定は .claude-plugin/plugin.json に書く
• コマンドから動かす：claude -p で、対話をせずに1回の作業を実行する
• 自分のアプリに組み込む：Claude Agent SDK で、同じツールとエージェントのループを Python や TypeScript から使う

Claude Agent SDK で他社向けの製品を作る場合は、条件を確かめます。公式ドキュメントは、事前の承認がない限り、他社の開発者が claude.ai のログインや利用枠を自分の製品で提供することを認めていません。API キーで認証する形にします。製品の中で Claude Code の名前やそれに似せた見た目を使うことも認めていません。ほかのフレームワークとの比較はAIエージェントのフレームワークで説明しています。

Employee Store は、開発者が作ったAIエージェントを、会社が買い切りや月額で導入できるマーケットプレイスです。形式は問わず、Claude の API を使った自社開発のエージェントも掲載できます。掲載料と初期費用はかかりません。手数料は成約金額の20%で、成約したときだけ発生します。