エージェントの作成と構成

エージェントを作成するのに必要なのは 2 つだけです。名前と AI コーディングツールの選択です。それ以外はすべて任意です — システム指示、モデル、環境変数、CLI 引数、公開範囲、同時実行制限 — デフォルト値でも問題なく動作します。まず動かしてから後で調整しましょう。すべてのフィールドはいつでも変更できます。

エージェントを作成する

前提条件: 使用中のマシンにサポートされている AI コーディングツールが少なくとも 1 つインストールされており（Claude Code、Codex など）、デーモンが実行中であること。まだそこまで準備できていない場合は、Cloud クイックスタートまたはセルフホストクイックスタートから始めてください。

準備が整ったら、ワークスペースの Agents ページに移動して + New をクリックするか、CLI を使用します。

multica agent create

このフォームには必須フィールドが 2 つだけあります。name（ワークスペース内で一意であること）と runtime（= AI コーディングツールの選択）です。それ以外のすべてのフィールドは、以下でセクションごとに扱います。

AI コーディングツールを選ぶ

各ランタイムは特定の AI コーディングツールを基盤としています。Multica はそのうち 12 個をサポートします。最も一般的な選択肢は次のとおりです。

残りの 7 個（Antigravity、Hermes、Kimi、Kiro CLI、OpenCode、Pi、OpenClaw）と、各ツールの完全な機能比較表（セッション再開、MCP、スキル注入パス、モデル選択）は、AI コーディングツール比較で扱います。

システム指示を書く

システム指示（instructions）はすべてのタスクの先頭に追加され、エージェントがどんな役割を担い、どんなルールに従うべきかを伝えます。

You're a frontend code-review agent. When an issue comes in, read the diff first. Focus only on:
- Styling issues (tailwind class names, box model)
- Accessibility (a11y)
Don't change code — leave suggestions in a comment.

空のままにすると（デフォルト）、エージェントは追加の制約なしに、基盤となる AI コーディングツールのネイティブな動作を使用します。

モデルを選ぶ

ほとんどの AI コーディングツールはモデル選択をサポートしています（例えば Claude Code では Sonnet と Opus のどちらかを選べます）。空のままにするとツール自体のデフォルト値が使われ、明示的に 1 つを選ぶとそのモデルが実行されます。各ツールがサポートするモデルは、AI コーディングツール比較にまとめられています。

モデルの変更は新しいタスクにのみ適用されます。すでにディスパッチされたタスクは、ディスパッチ時点で固定されたモデルで実行を続けます。

カスタム環境変数 (custom_env)

カスタム環境変数（custom_env）を使うと、タスク実行時に追加の環境変数を注入できます。代表的な用途は API キーの設定やアップストリームエンドポイントの切り替えです。

ANTHROPIC_API_KEY = sk-...
ANTHROPIC_BASE_URL = https://my-proxy.example.com

システムにとって重要な変数は上書きできません。PATH、HOME、USER、SHELL、TERM、CODEX_HOME、そして MULTICA_* で始まるすべてのキーは、デーモンが静かに無視します（警告ログは残しますが、エラーは発生しません）。

カスタム CLI 引数 (custom_args)

カスタム CLI 引数（custom_args）は、AI コーディングツールのコマンドラインに 1 つずつ順に付け足される文字列配列です。

["--max-turns", "100", "--append-system-prompt", "always respond in Chinese"]

最終的なコマンドは次のように生成されます。

claude --model <model> --max-turns 100 --append-system-prompt "always respond in Chinese" [...]

引数はシェルを介さずそのまま渡されるため（注入リスクなし）、特定のフラグが認識されるかどうかは AI コーディングツール自体に依存します。この部分はツールによって大きな差があります。

公開範囲

• ワークスペース（workspace） — ワークスペースのすべてのメンバーが割り当てできます
• 非公開（private） — ワークスペースの owner、admin、またはエージェントの作成者だけが割り当てできます

新しいエージェントはデフォルトで private です。

非公開だからといって隠されるわけではありません — すべてのメンバーが一覧で非公開エージェントの名前と説明を見ることができ、ただし機微な構成は読み取れません（環境変数の値はエージェントの list/get レスポンスに決して現れず、MCP 構成は owner 以外のユーザーにはマスキングされます）。詳しい意味はエージェント → 誰がエージェントを割り当てられるかを参照してください。

同時実行制限

同時実行制限（max_concurrent_tasks）は、このエージェントが一度に並列で実行できるタスク数を制御します。デフォルト値は 6 です。上限に達した新しいタスクは拒否されず、キューで待機します。

これは 2 段階の制限のうち「エージェント層」にすぎません。デーモン自体がより広い上限（デフォルト値 20）を適用し、2 つのうちより厳しい方が優先されます。詳しくはデーモンとランタイム → 並列で何個のタスクを実行できるかにあります。

この値を変更してもすでに実行中のタスクはキャンセルされず、次に処理されるタスクからのみ適用されます。

ドメインの専門性をつなぐ: スキル

作成したエージェントにはスキルをアタッチできます — タスク実行時に AI コーディングツールへ自動的に届けられるナレッジパック（SKILL.md + 補助ファイル）です。新しいスキルを作成したり、GitHub または ClawHub からインポートしたり、マシン上の既存のスキルディレクトリからスキャンしたりできます。スキルを参照してください。

アーカイブと復元

もう使わないエージェントはアーカイブできます — 日常的な画面からは消えますが、履歴データ（実行したタスク、投稿したコメント）はすべてそのまま保持されます。いつでも復元して再び作業に投入できます。

アーカイブ済みのエージェントには新しいタスクを割り当てられません。

次のステップ

• スキル — エージェントにナレッジパックをアタッチする
• AI コーディングツール比較 — 12 個のツール全体の機能比較表
• エージェントへのイシューの割り当て — 新しく作ったエージェントを作業に投入する