选模型之前，先问任务需要什么：理解图片、修改文件、运行工具，还是整理文字。模型负责理解和生成，Agent 负责把这些能力接到工具与工作环境。 Codex、Claude Code 是 Agent 执行入口；模型需要在界面里另行选择。进一步的概念解释见模型与 Agent。
- Agent.Space 模型使用可用套餐或 Flex
- 自有模型 API把服务商绑定到 Workspace
- Developer API在外部客户端使用 Model API Key
图中把两条 Key 的方向分开：自有模型把外部服务接入 Workspace；Model API Key 把 Agent.Space 的模型服务提供给外部客户端。相似的名字不代表相同凭据或相同账单。
选择可用的 Agent 与模型组合
在新对话里选择 Agent，再看模型菜单提供哪些可用选项。能在目录看到一个模型，不代表它能配合所有 Agent、接受所有附件。图片输入需要模型、Agent 和运行入口共同支持；不支持时界面会要求移除图片或更换组合。
先用小任务检查再投入长任务，例如：
请阅读当前网页文件，列出三个最影响手机阅读的问题。只分析，不修改；如果需要额外工具或材料，请先说明。
检查回复是否确实读到了文件、是否说明缺少的材料。要验证图片能力，就附一张相关截图，要求指出截图中一个可核对的细节。仅收到流畅文字，不足以证明材料已被读取。
已有 Session 的 Agent 类型不能随意切换；需要换 Agent 时新建对话，并说明目标、文件路径与已确认的决定。高级选项由当前 Agent 实际提供，不同 Agent 菜单不一样是正常的。具体迭代方法见把作品改好。
套餐额度、Flex 和实际付款人
打开“订阅市场”查看当前套餐、适用模型、剩余额度和重置时间。多个时间窗口可以同时约束一个套餐；某个窗口还有余量，不代表所有窗口都可用。额度也不是固定的消息条数，任务上下文、输出和模型不同会改变消耗。
模型在适用套餐内且额度可用时，优先使用套餐；套餐外或额度不足时，符合条件的调用可以使用 Flex 积分按量计费。Flex 页面显示余额、来源和有效期；赠送积分与购买积分不一定具有相同用途，不能把余额数字理解成永久有效或包含所有服务。
标准 Workspace 模型调用由 Workspace 所有者的可用权益承担，成员发起任务前应理解这个归属。本机 Agent 使用该电脑上的登录与订阅；接入自有模型则由外部服务商计费。独享 Mac、对外 API 和模型调用也有各自的适用条件，不能由一个套餐名称推断全包。
价格、模型范围和供应情况会变化，以当前目录与结算确认页为准。比较方案时记录这四项就够了：我需要的模型、常用任务大小、可接受的重置等待、是否允许按量继续。购买或变更前检查生效日期和续费说明；停止续费与立即退款不是同一个动作。
把自己的模型接入 Workspace（BYOK）
这条路径适合已经持有外部模型服务商 API 地址与 Key 的所有者。打开“工作区设置”里的“自有模型”，点“接入模型 API”。填写服务名称、接口地址和对应 Key，继续选择模型并保存。
保存前系统会逐个试跑，检查模型能否调用工具，并在收到工具结果后继续；接口或能力不匹配会显示原因。只有检测通过、适合当前 Agent 的模型才进入可选列表，按服务商分组显示在前面。云端电脑运行期间新增或修改后，按页面提示重启才能使用新配置。
成功检查分两步：先确认模型检测结果，再在新对话选中该服务商的模型完成一个小任务。成员可以使用这些模型，但不能读取 Key；Key 加密保存，不交给成员或 Agent。调用发给你填写的服务商，由服务商向所有者收费，不消耗 Agent.Space 套餐额度或积分。
地址和 Key 必须属于同一服务。不要把登录密码或本机订阅账号当 API Key；也不要把 Key 粘贴进聊天消息、公开网页或项目文件。模型没出现时，先看兼容性检测和重启提示，重复保存并不能修复一个不支持工具调用的接口。
用 Model API Key 连接外部客户端
侧边栏“更多”中的“Model API Key”打开 Developer API 页面。这是从外部客户端调用 Agent.Space 的入口，不是上面的 BYOK 表单，也不是用于读写 Workspace 文件的万能密钥。
页面会检查使用资格：当期有效套餐或积分订阅、或者未过期的已购积分可以满足资格；只有赠送积分不能解锁 API。取得 API 资格与某次请求有足够余额、可用模型，是两项检查。 普通 Workspace 对话仍可按条件使用赠送积分。
按“接入指南”选择客户端与可用模型，创建命名清楚的 Key，再复制页面给出的完整配置到对应客户端。比如名称用 personal-laptop，另一个工具用单独的 Key，之后容易识别用量和撤销。地址、协议和模型标识以指南为准，不要从其他服务复制相似字段混用。
Key 可设置花费上限及重置周期、允许模型和过期日期；限制作用于新请求。未选择模型限制代表允许全部模型，日期留空代表不过期。查看或重新生成等敏感操作可能要求重新验证身份。密钥泄露时立即撤销或重新生成，并更新客户端配置。
完成一次小请求后，回到 API 页面查看对应 Key 的请求记录和用量。看见客户端有回复、且这里出现匹配记录，才说明它用了预期服务；客户端也可能仍在使用原来配置。
用量异常时按路径排查
模型不可选，查 Agent 兼容性、权益和模型状态；任务因额度停止，查每个额度窗口与 Flex 有效余额；API 被拒，另查 API 资格、Key 是否过期、模型限制与花费上限。BYOK 失败要查外部服务商的 Key、接口和账单，本机任务失败则查本机登录和订阅。
求助时记录发生时间、模型、Agent、所用路径和错误文字。不要附完整密钥。把“在哪里运行、调用谁、由谁付款”说清楚，通常比反复更换模型更快找到原因。