使用文档
按下面的步骤使用 Codex、会话、本地机器和工作区文件。
开始对话
- 1登录后选择一个在线环境。
- 2进入对话页,确认模型和工作目录。
- 3输入任务并发送;回复、工具调用和运行状态会出现在当前会话中。
选择环境
环境决定 Codex 在哪里运行,也决定可以访问哪些文件和会话。切换环境时不会沿用另一个环境的会话。
会话与模型
- 每个会话只属于当前环境。页面地址同时包含环境和会话标识,刷新后仍会回到同一处。
- “新建会话”会创建空白对话;打开左侧记录可以继续已有会话。
- 模型按会话选择。修改当前会话的模型不会影响其他会话。
- 需要继续已有 Codex CLI 会话时,点击“导入会话”。每次先加载最近 10 个,再按需继续加载。
- 导入不会复制或转换会话,只保存 Codex 原生 Session ID 索引;原始记录仍保留在本机。
- CLI 和 Web 继续同一个 Session ID 时,Agent Host 会监听 Codex rollout 变化并同步当前页面;连接中断时由定时刷新兜底。
连接本地环境
每个账号都可以连接自己的本地 Codex 环境。先在 Linux 或 macOS 机器上安装 WeAgent Host,然后启动一个平台服务器可以访问的 HTTP 端口:
curl -fsSL https://codex.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 后,先完成登录或模型配置,再运行 sudo systemctl restart weagent;如果是前台运行,停止后重新执行 weagent。回到网页刷新环境状态即可重新检测。
平台服务器与本机处于同一局域网或 VPN 时填写内网地址;否则使用内网穿透或端口映射,填写服务器能够访问的公网 IP 或域名。
其他用户注册后会获得独立云环境,也可以在个人设置中连接自己的本地环境。
Web 任务由 Host 在后台启动 Codex app-server。关闭网页不会停止正在执行的任务,重新进入会话后会从服务器事件游标继续接收输出。
文件
打开右侧文件区后,可以展开目录、创建文件或文件夹、重命名、移动、上传和删除,也可以在多个标签页中同时打开文件。
图片生成
- 1先选择图片模型。
- 2在下一行选择尺寸。
- 3填写提示词;需要修改图片时再添加参考图。
- 4开始生成后,结果会保存到当前环境的工作区。
定时任务
在对话左侧打开“定时任务”。定时任务有独立的任务列表和运行历史,不会出现在普通聊天会话中。
- 1新建任务并选择执行一次、每天或固定间隔。
- 2选择发送固定消息,或选择由 Codex 执行。
- 3Codex 任务必须指定模型和工作目录;没有特殊要求时保留默认工作目录即可。
- 4创建后可查看下一次运行时间、成功次数,或执行暂停、修改、立即运行和删除。
- 5点击运行历史可查看每次结果;Codex 的工具调用和独立会话只在这里展示。
用量
点击右上角头像进入“个人设置”,可在“详细用量”和“使用日志”中查看调用次数、Token、图片数量、费用及逐条记录。
常见问题
本地环境为什么显示离线?
确认 weagent 仍在运行,并从平台服务器检查填写的 IP 和端口是否可达、Token 是否一致。
从哪个目录启动 Host 有区别吗?
没有。访问范围由 --workspace 决定,不是命令启动目录。
为什么没有自动显示全部本地会话?
点击“导入本地会话”后会扫描 Codex 会话,并从最近 10 个开始分页加载;不会因当前项目目录不同而遗漏历史会话。
云环境和本地环境的文件分别在哪里?
云环境文件保存在持久工作区;本地 Host 直接读写其工作区,权限与运行 Host 的系统账号一致。