ドキュメント · ガイド

Kiro Crew を任意のモデルで

Kiro Crew（kirodotdev/KiroCrew）は常駐型のエージェントで、KiroCrew.app デスクトップアプリ、kirocrew CLI、Web ダッシュボードと、それらが共有する Gateway からなります。各セッションはハーネス、つまり Kiro Crew が起動して ACP で話す別のエージェントで動きます。Kiro Crew には magpie に向けられる自前のモデルプロバイダーがなく、モデルはハーネスのものです。そこで magpie はどのハーネスで動かすかを設定します。magpie につないだエージェントなら、その設定がリクエストをゲートウェイに送るので、DeepSeek・GLM・Kimi・Qwen・Claude・ChatGPT サブスクリプションなど magpie のモデルが使えます。

Kiro Crew の設定

  1. magpie でプロバイダーを追加プロバイダー ページで API キーを追加するか、サブスクリプションにサインインします。
  2. エージェント ページで Kiro Crew のプロバイダーを magpie にするKiro Crew が magpie の扱うハーネスに設定されていればそのまま使い、まだ magpie につながっていなければそれも一緒につなぎます。magpie が扱わないハーネス（KAS・kiro-cli・deepseek）のときは、magpie につながった最初のハーネスを、この PC にアダプターがあるものを優先して選びます。
  3. Kiro Crew で新しいセッションを開くGateway はファイルの変更で読み直します。新しいセッションは新しいハーネスを使い、開いているセッションは元のままです。

ハーネスを変えるには、Kiro Crew の行の harness で magpie につながった別のエージェントを選びます。1 つもつながっていなければ、先に Codex・Claude Code・OpenCode・Pi・Goose を magpie につなぎ、それから Kiro Crew をつなぐよう magpie が案内します。

選べるハーネス

magpie が提供するのは自分で接続を管理するハーネスで、Kiro Crew の下でも同じファイルを読みます。

deepseek は含みません。Kiro Crew はこれを dsh --profile acp として動かし、それは Kiro Crew 独自のプロファイルなので magpie の dsh の接続が届かないからです。

config.json

Kiro Crew の設定はホームの config.json です。ホームは $KIROCREW_HOME があればそこ（絶対パスにし、ルート・/usr・/System・/etc は拒否して既定を使います）、なければ ~/.kiro/crew で、デスクトップアプリもここを使います。magpie は 2 つのキーを書きます。

ターミナル
// ~/.kiro/crew/config.json
{
  "agent": {
    "acp_backend": "codex",
    "member_acp_backend": "codex"
  },
  …
}

acp_backend はセッションのハーネスで、空なら既定の kiro-cli です。member_acp_backend はクルーメンバーのハーネスで既定は kas、メンバーを派遣できるハーネス（Codex・Claude Code・OpenCode・Goose）のときだけ書き、Pi では書きません。magpie は 2 つのキーの元の値を覚え、オフにすると戻します。

ACP アダプター

Codex・Claude Code・Pi は、Kiro Crew が同梱しない npm アダプター経由で動きます。magpie は Kiro Crew が探す場所で探します：アダプターの変数（CODEX_ACP_BIN・CLAUDE_AGENT_ACP_BIN・PI_ACP_BIN）が指すパス、PATH、~/.local/bin、npm・mise・Volta・Homebrew のフォルダー、mise・asdf・nvm・fnm が持つすべての Node バージョンです。見つからないときは、エージェントページが npm i -g でパッケージを入れてから新しいセッションを開くよう案内します。magpie 自身は何もインストールしません。

config.local.json はあなたのもの

同じフォルダーの config.local.json はキーごとに config.json に重ねられ、優先されます。ここでハーネス（agent.acp_backend）を設定していると、magpie はキーを 1 つも書かず、そこで magpie につながったハーネスに変えるか、取り除いてからつなぎ直すよう案内します。

元に戻す

magpie で Kiro Crew をオフにすると、magpie は 2 つのキーを元の値に戻します。その後あなたが変えたキーはそのままです。Kiro Crew をつないだことでハーネスのエージェントも magpie につながり、その後あなたが自分で切っていなければ、magpie はそれも切ります。そうでなければつながったままです。

よくある質問

Kiro Crew で DeepSeek や GLM を使えますか？

使えます。Kiro Crew のモデルはハーネスのもので、magpie はハーネスを magpie につないだ Codex・Claude Code・OpenCode・Pi・Goose にします。モデルはそのハーネスで選びます。

開いているセッションが変わらないのはなぜですか？

開いているセッションは元のハーネスのままで、新しいハーネスは新しいセッションから使われます。

codex-acp が見つからないと出たら？

Codex・Claude Code・Pi は npm アダプター経由で動きます。案内されたパッケージを npm i -g で入れ、新しいセッションを開いてください。

magpie がハーネスを変えないのはなぜですか？

config.local.json で agent.acp_backend を設定しており、それが config.json より優先されるので、magpie はあなたの設定に触れません。

同じモデルを他のエージェントでも：Goose を任意のモデルで、Pi を任意のモデルで、JetBrains Copilot を任意のモデルで。エラーが出るときは よくあるエラーの直し方、または Discord で質問してください。