Studio(首页)
使用手册
Studio 简介
Studio 是一体机的默认 AI 工作区。您可以直接通过对话提出需求,让 Claude Code 或 Codex CLI 协助生成内容、处理文件和推进复杂任务。
Claude Code 与 Codex 开箱即用,无需填写 API Key。模型调用按实际用量计费,预置额度用完后可在线充值。
认识 Studio 页面
进入 Studio 后,您可以新建会话、继续历史会话,也可以在当前项目中提交任务。
Studio 主要包含以下区域:
区域 | 用途 |
左侧导航区 | 使用「新会话」「助手」「定时任务」和「团队」等入口 |
会话列表 | 查看和打开历史会话;没有历史会话时显示为空 |
Agent 选择 | 选择「Claude Code」或「Codex CLI」 |
任务输入区 | 输入任务要求、上传文件、打开文件夹,并选择本次消息使用的模型 |
项目入口 | 通过「在项目中工作」选择当前项目或工作目录 |
任务处理区 | 查看任务的处理过程和返回结果 |
示例任务区 | 参考示例问题开始使用 Studio |
选择 Claude Code 或 Codex
首次进入新版 Studio 时,系统默认选择 Claude Code。开始任务前,您也可以切换为 Codex。
切换 Agent 只影响当前查看或之后新建的会话,不会改变已有会话原来使用的 Agent。打开历史会话时,Studio 会自动显示该会话对应的 Agent。
选择模型与查看参考倍率
Claude Code、Codex 是执行任务的 Agent;模型在输入区单独选择。不同 Agent 可用的模型可能不同,以列表为准。
- 点击输入区的模型名称,打开模型列表。
- 查看模型名称、适用场景和参考倍率。
- 点击需要使用的模型。列表收起后,输入区显示所选模型。
- 发送消息,本条消息使用发送时选中的模型。
同一对话可以切换模型,只影响之后发送的新消息。消息执行期间切换模型,也不会改变正在执行的消息及历史记录。
仅选择模型不产生消费。点击列表外或按 Esc 可关闭列表,保留当前选择。
参考倍率用于比较模型的相对消耗,不直接参与扣费,也不能用于计算单条消息的准确消费。倍率可能调整,以应用展示为准。
倍率获取失败时,有上次结果则继续显示,没有则显示「--」。可查看「参考倍率」旁的异常说明;这不影响选择和使用模型,下次启动或重启应用时会自动重试。
新建会话
- 点击左侧的「新会话」。
- 选择本次任务使用的 Agent,并在输入区确认模型。
- 在输入区域描述需要完成的任务。
- 发送任务,等待 Studio 开始处理。
启动或重新启动客户端后,Studio 默认进入新会话页面。输入框中的发送按钮以向上箭头显示。
在任务中添加图片或文件
需要 Studio 结合已有资料完成任务时,可以在输入区域添加图片或文件:
- 选择「添加文件」,使用一体机 Documents 中
agenthub目录下的已有文件; - 选择「从设备上传」,从当前电脑选择文件。
单个文件最大为 30 MB,可以一次添加多个文件。Claude Code 和 Codex 使用相同的文件规则。
添加资料后,请在任务要求中说明需要 Studio 如何使用这些内容。
打开和继续历史会话
Claude Code 和 Codex 的历史会话按时间排列,并通过不同标识区分。
- 在会话列表中找到需要继续的会话。
- 根据名称、时间和 Agent 标识确认会话。
- 点击会话,查看原有内容。
- 在输入区域继续补充要求。
打开历史会话后,该会话仍使用原来的 Agent。
提交任务并查看处理状态
- 选择 Agent、确认模型,并进入正确的会话。
- 在输入区域清楚描述目标、需要使用的资料和期望结果。
- 发送任务。
- 在任务处理区查看处理过程和返回结果。
处理时间可能因任务内容而有所不同。任务处理期间,请根据页面显示的实际状态判断是否已经完成。
查看和使用任务产物
Studio 可以在执行任务时生成文件。任务完成后,请先根据会话中的任务结果确认是否生成了文件。
如果任务结果中提供了文件入口,可以按照页面提示打开或下载文件。
Studio 会在任务结果中显示生成文件的目录地址。点击文件地址可以直接预览文件,Markdown 文件也可以在 Studio 中直接预览。
Claude Code 和 Codex 生成的文件分别保存在 Documents 的 agenthub 目录中:Claude Code 对应 .claude,Codex 对应 .codex。需要再次查找或管理文件时,可以进入 Documents 搜索对应的文件。
从其他应用返回 Studio
- 点击客户端底部的「Studio」图标。
- 客户端返回离开 Studio 前停留的页面。
客户端内切换应用不会新建会话。只有启动或重新启动客户端时,Studio 默认进入新会话页面。
任务处理期间也可以切换到 Documents 或其他应用。切换后任务会继续执行,返回 Studio 时仍会回到原会话并显示最新状态。
Studio 无法启动时
如果页面提示 Studio 无法启动,请点击底部「修复」,选择 Studio 进行处理。完整操作请查看问题处理【补图】。
在 Documents 中管理 Studio 任务文件
进入 Documents
- 点击客户端底部的「应用」。
- 在「其他应用」中选择「Documents」。
在 Documents 中查看 Studio 任务文件
- 进入 Documents。
- 打开
agenthub目录,再进入 Claude Code 对应的.claude或 Codex 对应的.codex目录。 - 根据文件名称查找任务文件;也可以使用搜索功能定位。
- 打开文件,查看任务结果。
任务文件由 Agent 根据任务内容命名;部分任务也会使用用户指定的名称。
预览和下载 Studio 任务文件
- 在 Documents 中找到任务文件。
- 打开文件或点击对应的预览入口。
- 确认文件内容与 Studio 任务结果一致。
- 如需保存到当前电脑,选择文件并点击下载入口。
- 下载完成后,在电脑的下载位置查看文件。
不同文件类型支持的预览方式可能不同。无法直接预览时,可以先将文件下载到电脑,再使用对应的软件打开。
管理 Studio 任务文件
您可以使用 Documents 提供的重命名、复制、移动或删除功能整理 Studio 生成的任务文件。完整操作请查看本章后续的通用文件管理说明。
删除文件前,Documents 会再次要求确认。Documents 当前没有回收站或恢复功能,请确认文件不再需要后再删除。
从 Documents 返回 Studio
- 点击客户端底部的「Studio」图标。
- 客户端返回离开 Studio 前停留的页面。
在客户端内切换应用不会新建 Studio 会话。