使用文档

1. 1登录后点击左侧“新建会话”，在输入区选择在线环境和项目目录。
2. 2确认模型、思考强度和权限模式。描述要完成的任务；附件可拖入输入区。
3. 3发送后查看回答、工具调用和审批请求。运行时间在回答上方，结束后显示在下方操作栏。
4. 4会话出现在左侧所属项目下；之后点击同一会话即可继续。

环境决定 Codex 在哪台机器运行。左侧同时展示各环境的项目和会话，点击会话会自动进入它所属的环境；新建会话时再选择环境。相同名称的项目在不同环境中仍各自独立。

• 会话始终属于创建时选择的环境和项目目录。悬停会话可查看环境名称、类型和在线状态。
• “新建会话”会创建空白对话；打开左侧记录可以继续已有会话。
• 模型按会话选择。修改当前会话的模型不会影响其他会话。
• 本地环境可点击“导入本机会话”继续该机器已有的 Codex CLI 会话。先加载最近 10 个，再按需加载；云环境无需导入。
• 导入不会复制或转换会话，只保存 Codex 原生 Session ID 索引；原始记录仍保留在本机。
• CLI 和 Web 继续同一个 Session ID 时，Agent Host 会监听 Codex rollout 变化并同步当前页面；连接中断时由定时刷新兜底。

后台运行与排队

消息被后端接收后，任务持续在环境中运行。刷新、关闭网页或切到其他会话只会断开查看，不会停止任务；重新打开同一会话可查看已保存的输出和待处理审批。只有主动点击停止才会中断当前轮次。

工具卡片显示执行状态，点击展开可查看命令、输入、输出或文件修改。任务结束后仍可查阅。

每个账号都可以连接自己的本地 Codex 环境。先在 Linux 或 macOS 机器上安装 WeAgent Host，然后启动一个平台服务器可以访问的 HTTP 端口：

curl -fsSL https://agent.engine.wang/install/weagent.sh | sh
weagent --listen :18080

首次启动会生成 8 位连接密码并保存到 ~/.weagent/agent-host-token。然后在右上角头像的“个人设置”中打开环境标签，点击“连接本地环境”，填写服务器能够访问的 IP:端口 和该密码。平台会先测试连接，成功后才保存环境。

默认工作区位于 Host 数据目录，和执行命令时所在目录无关。需要指定工作区时使用：

weagent --listen :18080 --workspace /workspace

如果希望自行设置连接密码，可额外传入 --token <YOUR_PASSWORD>。

安装 Codex 后，先完成登录或模型配置，再重启自己安装的 Host 服务；如果是前台运行，停止后重新执行 weagent。回到网页刷新环境状态即可重新检测。

平台服务器与本机处于同一局域网或 VPN 时填写内网地址；否则使用内网穿透或端口映射，填写服务器能够访问的公网 IP 或域名。

其他用户注册后会获得独立云环境，也可以在个人设置中连接自己的本地环境。

Web 任务由 Host 在后台启动 Codex app-server。关闭网页不会停止正在执行的任务，重新进入会话后会从服务器事件游标继续接收输出。

打开右侧文件区后，可以展开目录、创建文件或文件夹、重命名、移动、上传和删除，也可以在多个标签页中同时打开文件。

1. 1在云环境打开“生图”，选择模型与输出尺寸。
2. 2填写具体提示词；需要修改已有图片时上传参考图。
3. 3点击生成，等待画布显示完成结果；动画不代表准确完成百分比。
4. 4点击历史任务可查看完整提示词、结果或失败原因，复制提示词和下载图片。文件保存在该云环境工作区的 image-gen 目录。

在对话左侧打开“定时任务”。定时任务有独立的任务列表和运行历史，不会出现在普通聊天会话中。

1. 1新建任务并选择执行一次、每天或固定间隔。
2. 2选择发送固定消息，或选择由 Codex 执行。
3. 3Codex 任务必须指定模型和工作目录；没有特殊要求时保留默认工作目录即可。
4. 4创建后可查看下一次运行时间、成功次数，或执行暂停、修改、立即运行和删除。
5. 5点击运行历史可查看每次结果；Codex 的工具调用和独立会话只在这里展示。

文件编辑历史、删除回收站和工作区快照用途不同，恢复前先核对目录、文件名和时间。

点击右上角头像进入“个人设置”，可在“详细用量”和“使用日志”中查看调用次数、Token、图片数量、费用及逐条记录。