设置第一个 Agent

设置向导会连接 Model、创建 Agent，并选择执行权限。未配置默认 Agent，或所选 Agent 没有 Model 时，设置向导会自动运行。要重新运行，先退出 TUI，然后执行：

a13n-harness-ui setup

TUI 中没有 /setup 命令。显式运行设置会在保存后返回 shell；首次设置完成后会打开 TUI 输入框。

1. 连接 Model复制章节链接

选择 ChatGPT、Codex、Grok 或 GitHub Copilot 订阅，或 API 密钥连接。

复用已检测到的登录，使用向导提供的方法登录，或先配置连接，稍后运行 a13n-harness-ui login <provider> 登录。如果账户存储需要修复，按显示的提示操作。登录在 TUI 之外进行。

使用 API 密钥时，向导提供不回显的密钥输入框，也可填写 env:OPENAI_API_KEY 或 key:key-primary。不要将密钥粘贴到 TUI 输入框。新输入的密钥会立即保存到独立的本地密钥存储，不会写入 Model YAML。

登录方式、已存密钥和账户位置见模型与身份验证。

2. 选择模型和设置复制章节链接

选择推荐模型，或输入区分大小写的 API 模型 ID。推荐来自已安装的目录；向 provider 确认可用性。复用 Model 时保留原设置。

创建 Codex 连接时，向导还会提供 Fast 或 Standard 服务选项。Fast 请求优先处理，可能消耗更多配额，也不保证更快。用 /fast 临时切换，或修改 Model 以永久设置。

API 密钥设置多一个可跳过的 Shell review model 步骤。选择推荐项或输入模型 ID 才启用审查。同系列的轻量模型排在前面，但不会自动选中。跳过则不启用 shell 审查。审查模型复用相同端点和密钥引用，保存为独立 Model，不复制主 Model 的设置。每次审查都会产生额外模型请求；推荐列表不代表已验证访问权限或审查质量。

设置向导为所选路由保存已知的媒体输入能力。使用自定义端点时，先验证图像、音频和视频输入支持，再修改这些声明。

见模型设置、上下文预算和 Fast 模式。

3. 选择执行权限复制章节链接

• Full Control： 命令使用宿主机账户的文件系统和网络权限运行，不需要 Envd 运行时。
• Sandbox： 保存前，向导会检查本地隔离的前置条件。失败不会降级到 Full Control。Windows 内置执行仅支持 Full Control。

选择后即保存配置，不会额外确认。选择前请阅读执行权限。

TUI 使用启动目录作为工作目录；首次提示时，会为该目录选择或创建单根 Project。设置不要求 Project 文件，也不会创建默认的 project-local 资源。

高级设置复制章节链接

a13n-harness-ui setup --advanced

高级设置提供可选的上下文、推理、shell 审查、subagent 和指令选项。常规设置会填入默认配置，之后仍可编辑 YAML；这些设置并非隐藏的应用状态。

常规设置包含三种内置 Subagent 角色。选择启用 shell 审查时，会初始化尚未配置的 security.shell_review：用 Model 审查 shell 启动，在风险达到 extra_high 时请求审批。API 密钥设置未选择审查模型时，快捷配置初始化为关闭。Codex 设置选择独立的审查 Model，并开启 Guardian 额度关联。现有审查设置保持不变。审查与隔离是两回事；见 shell 审查配置。

内置 subagent 继承父级 Model。高级设置提供全部启用或全部关闭选项；要选择单独角色，请编辑 subagents.include。导入外部 Codex/Claude Code subagent 是独立的 /import 工作流，不属于设置流程。

添加其他连接或 Agent复制章节链接

a13n-harness-ui add model
a13n-harness-ui add agent

add model 创建可复用的 Model，并提供独立的 Agent 创建流程。add agent 可让你复用 Model 或创建新 Model，再为 Agent 命名。复用只引用已有 Model，不会复制或修改它。重复名称会分配不同身份；现有默认值和对话保持不变。

使用 /agent 切换整个 Agent。使用 /model 为当前 Project 选择已配置的 Model，同时保留当前 Agent 的指令和工具；/model default 清除该选择。

取消或恢复设置复制章节链接

使用上/下方向键和 Enter，或输入选项编号。Esc 返回上一步；Ctrl+C 或 Ctrl+D 取消。取消首次设置会返回 shell，不会打开 TUI 输入框。

取消设置会保留已完成的登录和已保存的密钥。保存多个文件失败时，先检查错误列出的路径再重试。旧版 .a13n-harness-ui-setup-recovery-* 目录保持不变。

查看保存的内容复制章节链接

生成的根配置会显式开启 WebUI Sidekick：

webui:
  sidekick: {}

要关闭 Sidekick，设置 sidekick: null，或选择 Settings → General → Sidekick → Disabled。设置向导保留已有 Sidekick 选择；该偏好本身不会开始工作。

a13n-harness-ui config path
a13n-harness-ui config show --format json
a13n-harness-ui config validate

接下来可阅读配置用法或入门根配置。