agent-ecosystem/landing/product-docs/zh/reference/faq.md
777genius 95e0f34d31 docs(product-docs): add zh, es, ja, fr, de doc translations
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
2026-05-31 17:50:54 +03:00

4.5 KiB
Raw Blame History

title description lang
常见问题 Agent Teams 文档 关于 Agent Teams 的常见问题——价格、模型访问、运行时、隐私、审查与故障排查。 zh-Hans

常见问题

Agent Teams 是免费的吗?

是的。该应用免费且开源。根据你使用的内容,提供方或运行时访问仍可能产生费用。

Agent Teams 是否包含模型访问?

不包含。Agent Teams 是本地的编排与 UI 层。模型访问来自所选的运行时/提供方路径,例如 Claude Code、Codex 或 OpenCode。

支持哪些运行时?

支持的运行时路径为 Claude Code、Codex 和 OpenCode。当运行时暴露相应信息时该应用还会跟踪提供方 id例如 Anthropic、Codex、Gemini 和 OpenCode。

我需要先安装 Claude Code 或 Codex 吗?

并非总是如此。该应用会从 UI 引导你完成运行时检测与设置。某些路径仍需要外部运行时认证。

OpenCode 的设置与 Claude Code 和 Codex 的设置是分开的。如果某次启动失败,请在修改团队 prompt 之前先检查运行时状态和提供方认证。

如何检查某个运行时是否就绪?

先在终端运行该运行时命令:

claude --version
codex --version
opencode --version

然后确认你所选路径的提供方认证。如果该命令或认证检查在 Agent Teams 之外失败,请先修复设置,再启动团队。

它会把我的代码上传到 Agent Teams 服务器吗?

不会。Agent Teams 不是云端代码同步服务。根据你所选的运行时,由提供方支持的模型调用可能会接收到 prompt 上下文。

团队文件存储在哪里?

团队协调数据本地存储在 ~/.claude/teams/<team>/macOS/Linux%APPDATA%\Claude\teams\<team>\Windows任务文件存储在 ~/.claude/tasks/<team>/%APPDATA%\Claude\tasks\<team>\ 下,项目会话数据在可用时存储在 ~/.claude/projects/<encoded-project>/ 下。

哪些内容会离开我的机器?

当某个智能体使用由提供方支持的模型时prompt 上下文、所选文件内容、工具结果、命令输出、任务文本、评论以及附件可能会通过运行时/提供方路径离开你的机器。具体行为取决于运行时和提供方。

智能体之间可以互相沟通吗?

可以。智能体可以给队友发消息、在任务上评论、跨团队协调,并使用任务引用让对话与工作保持关联。

第一条团队 prompt 里应该写什么?

给 lead 一个具体的产出目标、文件或功能边界、风险限制以及验证预期。例如:

Improve the docs quickstart. Keep edits inside landing/product-docs, add practical examples, and run `pnpm --dir landing docs:build` before marking work done.

我可以在接受代码之前先审查它吗?

可以。审查流程围绕任务范围的 diff 和代码块hunk级别的决策构建。

什么是 Agent Block

Agent Block 是隐藏的、仅供智能体使用的文本,用诸如 <info_for_agent>...</info_for_agent> 这样的标记包裹。该应用会在面向用户的常规显示中将其剥离,但会保留它以供智能体协调使用。

什么是 solo 模式?

solo 模式是单智能体团队。它适用于较小的任务以及较低的协调开销。

我应该使用 worktree 隔离吗?

当多个 OpenCode 队友可能并行编辑同一个 Git 项目时,请使用它。它能减少文件冲突,但需要一个受 Git 跟踪的项目,并且目前仅适用于 OpenCode 成员。

不同的队友可以使用不同的提供方吗?

可以,当所选的运行时路径支持时,提供方/模型设置可以按团队成员分别携带。OpenCode 是实现广泛多提供方路由的主要路径。

为什么某个任务会显示 review 或 approved而与 done 分开?

工作状态和审查状态相关但并不相同。一个任务可能从智能体的角度看已经 done然后在 kanban UI 中经过 review 和审批流程。

启动卡住时我应该怎么做?

打开故障排查,收集启动诊断信息,检查 ~/.claude/teams/<team>/,并在修改 prompt 之前验证运行时/提供方认证。

对于 OpenCode请在认定某个队友已在线却忽略消息之前先检查 lane/会话证据。

为什么不同运行时的日志各不相同?

Claude Code、Codex 和 OpenCode 暴露的转录格式和运行时证据各不相同。Agent Teams 会尽可能地将其规范化,但日志的完整性和归属可能因运行时而异。