インストール

Agent Teams は、macOS、Windows、Linux 向けのデスクトップアプリとして配布されています。

最短の手順

1. 以下からお使いのプラットフォーム向けのビルドをダウンロードします
2. アプリを起動します。認証不要の無料モデルから始めるか、UI からプロバイダー認証を接続します
3. クイックスタート を開始して、最初のチームを作成します

デスクトップアプリの起動: Electron アプリは pnpm dev で実行します。通常の利用ではブラウザ/Web の開発モードを起動しないでください。

ビルドのダウンロード

パッケージ済みアプリが必要な場合は、ダウンロードページ または最新の GitHub リリース をご利用ください。

• macOS Apple Silicon: .dmg
• macOS Intel: .dmg
• Windows: .exe
• Linux: .AppImage、.deb、.rpm、または .pacman

Windows SmartScreen

署名されていない、または公開されたばかりのオープンソースアプリは、SmartScreen をトリガーすることがあります。リリース元を信頼できる場合は、More info を選択し、続いて Run anyway を選択してください。

必要要件

パッケージ済みアプリは、セットアップ不要のオンボーディングを目的として設計されています。認証不要の無料モデルから始められます。登録、API キー、クレジットカードは不要です。さらに多くのモデルを利用したい場合は、アプリが UI からランタイム検出とプロバイダー認証をガイドします。

有料またはアカウント連携のモデルを利用するには、少なくとも 1 つのプロバイダーを接続してください。

プロバイダー	アクセス方法
Claude (Anthropic)	Claude Code CLI ログインまたは API キー
Codex (OpenAI)	Codex CLI ログインまたは API キー
Gemini (Google)	Google ADC、Gemini CLI、または API キー
OpenCode	認証不要で同梱されている無料モデル、または対応するバックエンド（例: OpenRouter）向けの API キー

INFO

Gemini は対応プロバイダーの一つとして利用できます。すべてのプロバイダーにわたる認証オプションと現在のステータスについては、プロバイダーとランタイム を参照してください。

ソースからの開発には、さらに以下が必要です。

ツール	バージョン
Node.js	24.16.0 LTS
pnpm	10+

macOS では、公式の Node.js 24 プリビルドバイナリには macOS 13.5+ が必要です。

ソースから実行する

git clone https://github.com/777genius/agent-teams-ai.git
cd agent-teams-ai
pnpm install
pnpm dev

pnpm dev は、ホットリロード付きのデスクトップ Electron アプリを起動します。これがデフォルトの開発ターゲットです。通常の開発ではブラウザ Web 開発サーバーを起動しないでください。ブラウザ経路には、完全なデスクトップ IPC、ターミナル、プロバイダー認証、チームライフサイクルの挙動がありません。

main ブランチには、最新の安定した開発成果が含まれています。特定の未リリースの変更が必要な場合にのみ、フィーチャーブランチに切り替えてください。

セットアップの確認

インストール後、ビルドが健全であることを確認します。

# デスクトップアプリがコンパイルされ、起動することを確認します
pnpm typecheck

# VitePress ドキュメントサイトがビルドされることを確認します
pnpm --dir landing docs:build

pnpm typecheck が型エラーを報告する場合は、依存関係やピン留めされた TypeScript の新しいバージョンを確認してください。pnpm --dir landing docs:build が失敗する場合は、landing/product-docs/ を調べて、markdown や設定の構文エラーを確認してください。

これらのドキュメントを編集している場合は、ビルドを実行して変更を確認してください。

pnpm --dir landing docs:build

自動更新

パッケージ済みアプリは、起動時および実行中に定期的に、更新を自動でチェックします。更新が利用可能になると、アプリがダウンロードとインストールを促します。アプリメニューから手動でチェックすることもできます。

TIP

ソースから実行している場合、自動更新は利用できません。依存関係が変更されたときは、最新の変更をプルして pnpm install を再実行してください。

ソースからの更新

ソースから実行している場合は、main ブランチをプルし、依存関係が変更されたときはインストールを再実行してください。

git pull
pnpm install

更新後、ビルドとドキュメントを確認してください。

pnpm typecheck
pnpm --dir landing docs:build

通常の開発では、ブラウザ開発サーバーではなく、常に pnpm dev（Electron）を使用してください。

次のステップ

• クイックスタート — インストールから最初に稼働するチームまで
• ランタイムの設定 — ランタイムごとのプロバイダー認証とモデル選択
• チームの作成 — 推奨されるチーム構成とブリーフの書き方

コントリビューター向け

• AGENTS.md — リポジトリのナビゲーションとアーキテクチャのポインタ
• CLAUDE.md — 作業上の慣例とプロジェクトのルール
• AGENT_CRITICAL_GUARDRAILS.md — 厳格な実装ガードレール