lastAI Box 完整使用指南

更新于 2026 年 9 月 8 日 · 可使用浏览器查找定位问题，或打印保存为 PDF。

1. Box 负责什么，Codex 负责什么

lastAI Box 是一款独立产品，用来管理自己的 Codex 工作环境：产品激活、Cloud 登录、模型选择、私有配置、技能、用量、诊断和更新在 Box 中处理；实际任务在由 Box 打开的 Codex 窗口中进行。

本指南以官网当前提供的 Box 1.0.27 Windows x64 正式版为核对基线。Box 与 Desktop 分别安装、分别更新，也分别管理产品授权。你不需要先安装 Desktop 才能使用 Box。

• Box：准备与维护环境，选择模型和技能，处理账号、用量与修复。
• Box 打开的 Codex：创建任务、选择项目、提供材料、与 AI 对话并查看实际结果。
• 电脑上原有的 Codex：与 Box 管理的私有环境分别使用，不应把两个窗口的登录、模型和配置状态混为一谈。

日常开始工作时，建议从 Box 的“打开 Codex”入口进入，确保打开的是当前由 Box 管理的环境。

2. 安装前的准备清单

1. 打开下载中心的 Box 区域，选择实际提供的系统安装包。目前官网提供 Windows x64；未列出的系统不要套用其他产品的安装包。
2. 准备 Box 激活码，或准备拥有 Box 产品权益的 Cloud 账号。
3. 确认电脑时间与时区正确，网络能够访问 Cloud 和下载服务。
4. 预留下载及解压空间。Box 安装器与后续下载的 Codex 是不同内容，首次设置还需要下载较大的应用文件。
5. 保存原有 Codex 窗口中的工作，准备一个不含敏感信息的练习项目。

安装包只安装 Box 本身；安装结束并不代表 Codex、模型和私有配置都已准备完成。下一步还需要完成 Box 首页引导。

3. 安装 Box 并确认当前版本

1. 完整下载 Box Windows x64 安装包，核对下载来源与文件名。
2. 运行安装器并完成安装。升级时先保存工作，不要同时运行多个安装过程。
3. 启动 Box。首次使用会进入激活和账号连接流程。
4. 进入应用后，可在“Codex 管理”的“软件更新”区域查看当前 Box 版本。

Box 的版本号、官方 Codex 客户端版本和内置 CLI 版本是三个不同信息。反馈问题时至少提供 Box 当前版本；不要用 Codex 窗口显示的版本替代 Box 版本。

4. 激活产品、登录账号与恢复购买

有激活码时

1. 在“激活 lastAI Box”中输入 Box 激活码。
2. 点击“立即激活”，等待设备与产品许可校验。
3. 根据后续页面连接 lastAI Cloud，登录已有账号或按界面创建账号。
4. 进入首页后核对产品激活、账号连接和模型可用状态。

已经购买并绑定账号时

1. 在激活页面选择“恢复已购产品”或“登录并自动恢复”。
2. 使用当时购买或绑定权益的账号登录。
3. 等待 Box 恢复本产品授权；如果没有找到权益，先确认是否登录了另一个邮箱。
4. 设备名额或权益状态有问题时，根据具体提示处理，不要反复删除数据重装。

Cloud 账号可以跨产品使用，但 Desktop 与 Box 的产品授权分别管理。拥有账号、钱包余额或 Desktop 授权，不等于已经拥有 Box 产品使用权；实际可用状态以账号和产品页面为准。

登录失败时先核对邮箱、网络、电脑时间与密码。不要把模型 API Key 填进登录密码框，也不要把 Box 激活码当成模型服务密钥。

5. 认识 Box 的五个主要页面

• 首页：查看 Codex 状态、当前模型、已启用技能、私有目录和下一步主操作。
• 模型：选择 Cloud 模型，或配置本地／自定义模型供应商。
• 技能：查看已安装与启用的技能，浏览精选内容和 SkillHub。
• 用量与账户：查看账号用量、调用明细、消耗和登录状态。
• Codex 管理：检查安装与配置、运行诊断、处理语言、反馈和软件更新。

首页的主按钮会根据当前缺少的步骤变化。看到“安装”“配置”“同步配置”或“打开”，代表不同阶段，不需要寻找一个永远名称相同的按钮。

6. 一键安装、配置并打开 Codex

1. 在“模型”页选择一个当前账号可用的模型。如果首页提示“先选择模型”，先完成这一步。
2. 回到首页，点击当前主按钮，例如“一键安装、配置并打开 Codex”。
3. 等待下载、校验、安装、创建私有环境和配置过程完成。进度显示正在下载或校验时，不要反复点击安装。
4. 如果电脑已经安装原版 Codex，Box 仍可能提示需要私有副本，这是为了独立管理自己的配置。
5. 配置成功后，Box 会打开对应 Codex。先确认窗口已正常打开，再开始第一个任务。
6. 下次使用通常只需要点击“打开 Codex”；切换模型或其他配置后，可能显示“同步配置并打开 Codex”。

新手引导会依次说明 Codex 状态、当前模型、技能和主操作。可以通过页面的“新手引导”入口重新打开；跳过说明不会自动完成尚未执行的安装或配置。

首次设置失败时

先记录失败停在下载、校验、安装、模型选择还是配置阶段。使用页面给出的重试或修复入口处理当前步骤。发生错误并不意味着必须从头卸载所有组件；如果持续失败，获取反馈信息后再联系支持。

7. 选择与切换 Cloud 模型

1. 打开“模型”，查看当前账号实际可用的 Cloud 模型。
2. 阅读模型能力与状态：是否推荐、是否支持图片、上下文范围、是否存在兼容或权限提示。
3. 选择适合任务的模型。普通文本任务可以先用稳定模型；截图任务需要图片输入能力。
4. 若显示“已选择，待同步”，说明模型选择已保存，但运行中的 Codex 还没有应用新配置。
5. 先保存 Codex 中正在进行的工作，再回到 Box 完成“同步配置并打开 Codex”。
6. 如提示需要重启，使用“由 Box 安全重启 Codex”，按提示处理待保存内容。
7. 打开后新建一个短任务，核对模型显示和实际响应，再继续正式工作。

模型目录会受当前账号权益和兼容状态影响。某个模型不在列表中，不能仅靠手动输入名称就获得使用权限。模型资格变更时，选择仍可用的模型并重新同步。

切换模型后，历史任务中已经完成的内容不会因此重新生成。需要验证新模型时使用新任务，避免混淆旧回复与新配置。

8. 接入本地或自己的模型服务

Box 支持添加本地／自定义供应商，但需要服务支持 Codex 所用的 Responses 协议，以及流式输出和工具调用。只有 Chat Completions 接口的服务，不能仅凭“兼容 OpenAI”字样判断能用于 Box。

先从服务方确认这些信息

• API 基础地址及正确路径。
• 模型 ID，而不仅是营销名称。
• 是否支持 Responses 流式输出和函数／工具调用。
• 上下文 Token 和最大输出 Token 的实际上限。
• 是否支持图片输入、推理参数，以及是否需要 API Key。

添加步骤

1. 在“模型”页找到“本地供应商与模型”，选择添加供应商。
2. 填写供应商 ID 和显示名称。使用自己的短名称，不使用系统保留名称；页面校验不通过时按提示修改。
3. 填写基础地址。本机回环服务可以使用界面允许的 HTTP 地址，其他主机地址应使用 HTTPS。
4. 服务要求密钥时启用“此服务需要 API Key”并填写密钥；确实无需认证的本机服务，按实际情况配置。
5. 添加模型，填写精确模型 ID、显示名称、上下文和最大输出。
6. 只勾选服务实际支持的能力。没有图片支持就不要声明图片输入，不能为了保存而随意勾选兼容选项。
7. 点击“安全保存”，然后选用该模型。
8. 保存 Codex 中的工作，返回 Box 同步配置并重新打开。

怎样验证配置真的可用

1. 先发送一个简短的纯文本问题，确认基础请求可返回。
2. 再让它读取练习目录中的一个文本文件，确认工具调用链路。
3. 声明支持图片时，再附上一张简单截图，让它描述图中可见文字。
4. 任何一步失败都记录具体错误，分别检查协议、模型 ID、服务能力与认证。

“用户声明、未验证”表示 Box 已保存你填写的能力，不代表服务已经通过真实任务验证。自定义服务的用量和费用应到服务方核对；本机模型也可能需要本机持续运行相应服务。

修改密钥与删除供应商

编辑供应商时，界面提示留空保留已有密钥，就按该提示操作。密钥变更后需要让下一次启动的 Codex 使用新凭据。删除供应商前先切换到另一个可用模型，避免当前环境仍依赖被删除的连接。

9. 在 Codex 中完成第一个任务

1. 通过 Box 打开 Codex，选择一个练习项目或明确提供资料位置。
2. 先做只读任务，确认模型能够读取你提供的材料。
3. 要求先展示处理结果或计划，再进行文件修改。
4. 出现权限或系统配置提示时，按具体任务和界面说明处理，不要把扩大权限当成默认解决办法。
5. 完成后打开实际文件或结果，核对内容与保存位置。

这是一个练习任务。请先读取我提供的项目资料。
列出你实际读到的文件及各自用途，不修改任何文件。
如果文件无法读取，说明原因，不要推测内容。
最后给出下一步可以完成的三个小任务。

这个练习同时验证窗口、模型连接、资料提供和工具读取能力。若只收到一段泛泛回复，追问具体读取了哪个文件、返回了什么内容。

10. 日常任务怎样说清楚

一次清晰的任务至少包含目标、材料、操作范围、输出格式与完成标准。任务越复杂，越应该先做小样例。

整理项目资料

目标：把当前资料整理成一份项目说明。
先检查目录和文件，再列出已有信息、矛盾和缺口。
不修改原文件；先在对话中给出目录和样稿。
确认后保存新文件，并说明保存位置。

修复一个具体问题

问题现象：……
复现步骤：……
期望行为：……
请先查明原因，只修改相关部分，保留已有无关改动。
完成后说明修改文件、验证方式、检查结果和未解决事项。

批量处理前先验证

先处理其中一份样例，展示处理规则和结果。
不要直接覆盖原文件。输出保存到新的目录。
我确认样例后，再按同样规则处理剩余文件，并列出失败项。

多轮任务中，改变要求时明确“哪些保持不变、哪些需要修改”。一次完全不同的任务适合另开会话，以免旧材料和限制继续影响结果。

11. 查找、安装与启用技能

Box 的技能属于它管理的私有环境。技能让 Codex 按更明确的方法完成某类任务，但不自动提供外部账号、软件许可证或缺失工具。

1. 打开“技能”，查看当前已安装和已启用的内容。
2. 在精选内容或 SkillHub 中按任务搜索，阅读技能说明与来源。
3. 安装需要的技能，等待结果，不要把搜索结果卡片当成已经安装。
4. 确认技能已启用。如果有需要同步环境的提示，按提示完成。
5. 回到由 Box 打开的 Codex，用一个小任务验证，并说明希望使用的技能。
6. 不再需要时在技能页关闭相应技能，减少不相关规则对任务的影响。

技能安装保护提示内容被隔离时，不要手动绕过。技能显示已安装但任务仍无法完成时，继续检查该技能依赖的工具、网络、登录状态和模型能力。

Box 技能目录与 Codex 插件市场是不同入口。某个插件加载失败，不一定意味着 Box 技能安装失败，也不一定是模型密钥错误。

12. 分清三种语言设置

Box 界面语言

影响 Box 自己的菜单、按钮和提示。更改 Box 界面语言，不能直接据此判断 Codex 客户端和 AI 回复会一起改变。

Codex 客户端界面语言

影响 Codex 窗口中的界面。Box 的“Codex 管理”提供对应的语言状态和处理入口时，按页面提示操作；旧配置可能需要先确认保留当前或跟随系统。具体客户端语言能力以安装的 Codex 版本为准。

模型回复语言

1. 进入“Codex 管理”，找到“模型回复语言”。
2. 需要中文输出时选择简体中文；不需要统一干预时保留“不干预（默认）”。
3. 按界面提示保存或同步，在新会话中验证。
4. 任务中的代码、路径、专有名词可以保留原文；需要特定文档语言时在任务中另行说明。

模型回复语言是任务指令层面的偏好，不是对每次输出语言的绝对保证。如果仍使用英文，先确认设置作用于新会话，并检查当前任务或技能是否提出了不同语言要求。

13. 查看 Token、积分与调用明细

1. 打开“用量与账户”，先确认当前账号。
2. 查看本月账号总用量、输入与输出、缓存相关字段和消耗。
3. 在明细中按时间和模型找到相应请求，核对来源标签。
4. 使用上一页、下一页查看更早记录，需要时调整每页数量。
5. 页面可见时会定期自动刷新，当前版本约每 60 秒刷新一次；需要立即检查时点击“刷新用量”。

账号总用量不等于只有当前 Box 窗口的用量。明细可能包括 Box Codex、可选连接检测以及其他或旧版来源。查看一项任务的消耗时，应同时核对时间、模型和来源。

• Token 是模型处理内容的计量单位，不能按汉字数一比一换算。
• 输入可能含会话历史和工具返回，所以短问题也可能带来较多输入。
• 复杂任务通常会多次调用模型；一次点击不是一次调用的保证。
• 积分或消耗以账号提供的计费明细为准，不要把 Token 数直接视为金额。
• 自定义服务的账单通常需要到服务方查看，不能假定会完整显示在 Cloud 用量里。

发现异常时先核对是否有其他设备、任务或连接检测正在使用账号。反馈应提供相关时间与记录，不需要发送密钥。

14. 私有环境与原版 Codex 如何共存

Box 使用自己的私有配置与技能，并通过自己的入口启动对应环境。电脑原有 Codex 的配置与 Box 的配置应分别理解。

1. 日常使用 Box 模型时，从 Box 首页打开 Codex。
2. 怀疑打开了错误环境时，回到“Codex 管理”查看私有目录、应用路径和当前模型状态。
3. 切换配置前先保存正在编辑的内容。
4. 需要重启时优先使用 Box 提供的安全重启入口，由它处理自己管理的实例。

原版窗口和 Box 窗口同时存在时，不要把其中一个窗口的成功或失败直接归因到另一个环境。也不要直接从 Box 私有安装目录手动启动程序，这可能使 Box 无法正确识别进程归属。

“恢复原配置”与“卸载 Codex”

这两项不是普通重试按钮。“恢复原配置”会切换回原配置使用方式；“卸载 Codex”用于卸载 Box 管理的私有 Codex。先阅读确认框说明、保存工作，再执行对应操作。需要回到 Box 环境时使用“切回 Box 并打开 Codex”或页面给出的重新配置入口。

不要手动删除私有目录来处理登录或模型问题。里面可能含仍需保留的环境信息与技能。

15. 首页状态与下一步动作

未安装／需私有副本

选择模型后执行安装、配置并打开。检测到系统原版不等于 Box 私有环境已就绪。

未选择模型／需选择模型

进入模型页选用一个有权限且兼容的模型，然后返回首页。

配置待同步／已选择，待同步

保存 Codex 工作，执行同步配置并打开；需要时由 Box 安全重启。

模型需更换／资格已变更

核对账号权益和目录状态，选择当前可用模型，不要反复同步已不可用的模型。

需重新安装

安装完整性或运行环境需要恢复。保留反馈信息后按页面提供的重新安装入口处理。

原配置模式

当前没有使用 Box 的常规模型配置。需要使用 Box 时点击切回 Box 的入口。

运行正常／配置就绪

可以打开 Codex。仍应通过真实小任务确认网络、模型和工具在当前时刻可用。

16. 用诊断定位问题

1. 进入“Codex 管理 → 诊断与修复”，点击“运行环境诊断”，或使用首页的“查看诊断”。
2. 逐项阅读 Cloud、Codex、私有环境及相关网络检查结果。
3. 根据失败项处理。网络失败先检查连接；模型不可用先选择其他可用模型；配置需同步则保存工作后同步。
4. 重试当前步骤后再次检查状态，记录哪些项已恢复。
5. 仍有问题时点击“获取反馈信息”。

“刷新在线状态”用于重新读取当前状态，“运行环境诊断”用于检查环境，“获取反馈信息”用于生成可复制报告。三个动作的目的不同，复制报告本身不会修复环境。

当前版本诊断还会检查插件市场依赖的部分公共站点。Cloud 正常但这些站点不可达时，可能仍能完成模型任务，却无法加载某些插件。应按失败站点排查网络，不要先反复改模型密钥。

17. 更新 Box 与 Codex

更新 Box

1. 先保存 Codex 中的文件、未发送文字和当前任务结果。
2. 打开“Codex 管理 → 软件更新”，核对“当前版本”，点击“检查更新”。
3. 有新版时查看版本说明，选择“查看并更新”或页面提供的更新入口。
4. 确认后等待下载与校验，按引导让 Box 正常关闭它管理的私有 Codex，再进行安装。
5. 需要处理保存确认时，先在相应窗口完成，不要为了继续安装而强行结束进程。
6. 重启后核对当前版本，检查模型与登录状态，再运行一次短任务。

如果暂时不能结束工作，可以选择稍后更新。更新失败时先使用“重新检查”或“重试更新”，保留错误信息；官网下载中心也会提供当前正式安装包。

Codex 的更新

Box 自身与它管理的 Codex 分别有版本。Codex 安装、兼容和完整性以 Box 当前提供的状态与治理过的安装信息为准；不要将网上找到的任意安装文件直接覆盖到 Box 私有目录。

18. 长对话与上下文不足

长任务会累计材料、工具结果和历史对话。即使当前消息很短，也可能接近模型能处理的上下文范围。设置里显示的上下文不是建议你一次粘贴同等大小的全部资料。

1. 先缩小当前任务，只提供相关材料，避免反复贴入相同文件全文。
2. 让 AI 在阶段结束时保存结论、改动和下一步，不把所有进展只留在聊天里。
3. 出现上下文不足时，保留已完成文件，让当前任务尽可能整理交接说明。
4. 新建任务，提供交接说明与必要文件，再从未完成部分继续。
5. 如果频繁在短任务中出现，检查模型配置的上下文是否真实，核对 Box 版本和具体错误。

请整理一份给新会话的交接说明：
原始目标、已确认的要求、已完成事项、修改过的文件及位置、
验证结果、尚未解决的问题、建议的下一步。
只记录已确认事实，不要把计划写成已完成。

19. 常见问题逐项处理

20. 换机、退出与保留资料

1. 换机前先保存实际项目文件和重要任务结论，记录当前使用的模型与技能。
2. 新电脑安装 Box 后，用自己的账号恢复相应产品权益；按设备名额提示处理授权。
3. 重新准备私有 Codex，配置模型并确认技能状态。不要假定私有环境和聊天内容会自动跨电脑同步。
4. 自定义服务需要时重新提供密钥；复制旧电脑的加密文件不能保证在新机可用。
5. 新环境验证完成后，再按自己的数据保留要求处理旧电脑。

退出账号、恢复原配置、卸载私有 Codex、卸载 Box、删除项目文件是不同操作。执行前阅读对应确认框，不要用一种操作代替另一种目的。

21. 获取并提交反馈信息

1. 在问题出现后尽快进入“Codex 管理”，运行诊断。
2. 点击“获取反馈信息”，等待本地报告生成。
3. 在报告窗口检查内容，再点击“复制反馈信息”。生成报告不会自动替你发送给支持人员。
4. 补充发生时间、操作步骤、期望结果与实际结果。
5. 通过联系与反馈提交。不要另外粘贴密码、激活码全文、API Key 或客户原始材料。

产品与版本：lastAI Box …
系统：Windows … / x64
当前模型与来源：Cloud / 自定义供应商 …
问题发生步骤：…
具体提示与发生时间：…
是否使用 Box 打开的 Codex：是 / 不确定
已尝试：…
反馈报告：粘贴已检查的脱敏内容