95e0f34d31
Localize the VitePress docs into Simplified Chinese, Spanish, Japanese, French and German (18 pages each), mirroring the existing en/ru structure. - generate the 5 new locales in config.ts from a single strings table (nav, sidebar, search, footer, docFooter, outline, editLink) with locale-prefixed links - rework DocsCardGrid from the binary isRu check to a per-locale map so the home cards render translated copy and prefixed links for every locale
95 lines
6.8 KiB
Markdown
95 lines
6.8 KiB
Markdown
---
|
||
title: FAQ – Agent Teams ドキュメント
|
||
description: Agent Teams に関するよくある質問 — 料金、モデルアクセス、ランタイム、プライバシー、レビュー、トラブルシューティングについて。
|
||
lang: ja-JP
|
||
---
|
||
|
||
# FAQ
|
||
|
||
## Agent Teams は無料ですか？
|
||
|
||
はい。アプリは無料でオープンソースです。使用する内容によっては、プロバイダーやランタイムのアクセスに費用がかかる場合があります。
|
||
|
||
## Agent Teams にモデルアクセスは含まれていますか？
|
||
|
||
いいえ。Agent Teams はローカルのオーケストレーションおよび UI レイヤーです。モデルアクセスは、選択したランタイム/プロバイダーの経路（Claude Code、Codex、OpenCode など）から提供されます。
|
||
|
||
## どのランタイムがサポートされていますか？
|
||
|
||
サポートされているランタイムの経路は Claude Code、Codex、OpenCode です。また、ランタイムが公開している場合、アプリは Anthropic、Codex、Gemini、OpenCode などのプロバイダー id も追跡します。
|
||
|
||
## 先に Claude Code や Codex をインストールする必要がありますか？
|
||
|
||
必ずしも必要ではありません。アプリは UI からランタイムの検出とセットアップをガイドします。一部の経路では、外部ランタイムの認証が依然として必要です。
|
||
|
||
OpenCode のセットアップは、Claude Code や Codex のセットアップとは別です。起動に失敗した場合は、チームプロンプトを変更する前に、ランタイムのステータスとプロバイダー認証を確認してください。
|
||
|
||
## ランタイムが準備できているかどうかを確認するには？
|
||
|
||
まずターミナルでランタイムのコマンドを実行します:
|
||
|
||
```bash
|
||
claude --version
|
||
codex --version
|
||
opencode --version
|
||
```
|
||
|
||
次に、選択した経路のプロバイダー認証を確認します。コマンドや認証チェックが Agent Teams の外で失敗する場合は、チームを起動する前にセットアップを修正してください。
|
||
|
||
## 私のコードを Agent Teams のサーバーにアップロードしますか？
|
||
|
||
いいえ。Agent Teams はクラウドのコード同期サービスではありません。選択したランタイムによっては、プロバイダーを介したモデル呼び出しがプロンプトのコンテキストを受け取る場合があります。
|
||
|
||
## チームファイルはどこに保存されますか？
|
||
|
||
チームの調整データはローカルの `~/.claude/teams/<team>/`（macOS/Linux）または `%APPDATA%\Claude\teams\<team>\`（Windows）に保存され、タスクファイルは `~/.claude/tasks/<team>/` または `%APPDATA%\Claude\tasks\<team>\` に、プロジェクトのセッションデータは利用可能な場合 `~/.claude/projects/<encoded-project>/` に保存されます。
|
||
|
||
## 私のマシンから何が外部に出ていく可能性がありますか？
|
||
|
||
エージェントがプロバイダーを介したモデルを使用するとき、プロンプトのコンテキスト、選択したファイルの内容、ツールの結果、コマンドの出力、タスクのテキスト、コメント、添付ファイルが、ランタイム/プロバイダーの経路を通じてマシンから外部に出ていく可能性があります。正確な挙動はランタイムとプロバイダーによって異なります。
|
||
|
||
## エージェント同士は会話できますか？
|
||
|
||
はい。エージェントはチームメイトにメッセージを送ったり、タスクにコメントしたり、チームをまたいで調整したり、タスク参照を使って会話を作業に紐づけたままにしたりできます。
|
||
|
||
## 最初のチームプロンプトには何を入れるべきですか？
|
||
|
||
リードに対して、具体的な成果、ファイルや機能の境界、リスクの制限、検証の期待値を与えてください。例えば:
|
||
|
||
```text
|
||
Improve the docs quickstart. Keep edits inside landing/product-docs, add practical examples, and run `pnpm --dir landing docs:build` before marking work done.
|
||
```
|
||
|
||
## 受け入れる前にコードをレビューできますか？
|
||
|
||
はい。レビューフローは、タスク単位の差分とハンク単位の判断を中心に設計されています。
|
||
|
||
## Agent Block とは何ですか？
|
||
|
||
Agent Block は、`<info_for_agent>...</info_for_agent>` などのマーカーで囲まれた、エージェント専用の非表示テキストです。アプリは通常のユーザー向け表示からそれを取り除きますが、エージェントの調整のために利用できる状態を保ちます。
|
||
|
||
## ソロモードとは何ですか？
|
||
|
||
ソロモードは 1 エージェントのチームです。小規模なタスクや、調整のオーバーヘッドを抑えたい場合に役立ちます。
|
||
|
||
## worktree の分離を使うべきですか？
|
||
|
||
複数の OpenCode チームメイトが同じ Git プロジェクトを並行して編集する可能性がある場合に使用してください。ファイルの競合を減らしますが、Git で追跡されているプロジェクトが必要であり、現時点では OpenCode のメンバーに適用されます。
|
||
|
||
## チームメイトごとに異なるプロバイダーを使えますか？
|
||
|
||
はい。選択したランタイムの経路が対応している場合、プロバイダー/モデルの設定をチームメンバーごとに引き継げます。OpenCode は、幅広いマルチプロバイダーのルーティングを行うための主要な経路です。
|
||
|
||
## なぜタスクが done とは別に review や approved を表示するのですか？
|
||
|
||
作業の状態とレビューの状態は関連していますが、同一ではありません。タスクはエージェントの観点では done になっても、その後かんばん UI で review と approval の段階を進んでいくことがあります。
|
||
|
||
## 起動がハングしたときはどうすればよいですか？
|
||
|
||
トラブルシューティングを開き、起動の診断情報を収集し、`~/.claude/teams/<team>/` を確認し、プロンプトを変更する前にランタイム/プロバイダーの認証を確認してください。
|
||
|
||
OpenCode の場合は、チームメイトがオンラインなのにメッセージを無視していると判断する前に、レーン/セッションの証跡を確認してください。
|
||
|
||
## なぜランタイムによってログが異なるのですか？
|
||
|
||
Claude Code、Codex、OpenCode は、それぞれ異なるトランスクリプト形式とランタイムの証跡を公開します。Agent Teams は可能な範囲で正規化しますが、ログの完全性や帰属はランタイムによって異なる場合があります。
|