Dernière version v1.5.5

Codex Harness

Assistant intelligent pour travailler plus efficacement

Multiplateforme

Compatible Windows et macOS.

Version Windows

Pour Windows 10 / 11 (64 bits)

Télécharger maintenant
codex-harness-1.5.5-windows-x64-portable.zip 240.6 MB v1.5.5 Voir le tutoriel d'installation
暂无可用版本
Windows 10/11 64 bits
4 Go+ RAM
500 Mo d'espace libre
Réseau pour l'activation

macOS 12+

Télécharger maintenant
Codex harness_1.5.5_universal_signed.dmg 423.0 MB v1.5.5 Voir le tutoriel d'installation

Guide d'installation

4 étapes pour commencer avec OpenClaw

1

Télécharger l'installateur

Cliquez sur le bouton puis lancez l'installateur.

2

Terminer l'assistant

Suivez les instructions pour finaliser l'installation.

3

Payer et obtenir le code

Après l'installation, payez pour obtenir votre code d'activation et Token initial.

4

Activer et utiliser

Entrez le code d'activation pour commencer.

Notes avant installation

Un paiement est requis pendant l'installation. Après paiement, vous obtenez une autorisation permanente et un Token initial.

Tutoriel d'installation détaillé

Voir le tutoriel externe

本文适用于 Windows 便携压缩包和 macOS 应用包。不同版本的文件名、界面文案可能略有差异,请以实际下载的版本为准。

一、下载前准备

从软件官方发布页面或发布方提供的下载渠道获取安装包,并根据电脑类型选择版本。

电脑类型应选择的版本如何查看
Windows,Intel / AMD 处理器Windows x64 便携版 ZIP设置 → 系统 → 系统信息或关于 → 系统类型
Windows,ARM 处理器Windows ARM64 便携版 ZIP(如发布方提供)同上,查看是否为基于 ARM 的处理器
Mac,Apple 芯片,如 M1 / M2 / M3 / M4 系列macOS Apple Silicon / ARM64 / aarch64苹果菜单 → 关于本机 → 芯片
Mac,Intel 处理器macOS Intel / x64 / x86_64(如发布方提供)苹果菜单 → 关于本机 → 处理器

若提供 macOS Universal 通用版,可按发布说明安装。最低系统版本要求以对应版本的发布说明为准。

安装和首次使用时请保持网络连接。使用成品安装包不需要先安装 Rust、Git 或开发环境;具体任务需要额外工具时,再按任务提示配置。

二、Windows 便携版安装

1. 下载压缩包

下载名称中包含 windows 和 portable.zip 的文件,例如:

codex-harness-版本号-windows-x64-portable.zip

2. 完整解压

  1. 在下载文件上点击鼠标右键,选择“全部解压缩”或解压软件中的“解压到”。

  2. 选择一个固定、可写入的文件夹,例如 D:\Apps\CodexHarness,也可以选择个人用户目录下的文件夹。

  3. 等待全部文件解压完成,再打开解压后的文件夹。

不要在压缩包预览窗口中直接运行程序,也不要只提取一个 EXE。

主程序通常为 codex-harness.exe。它需要同目录中的 binaries 文件夹及其他配套资源,请保留解压后的完整目录结构。

3. 启动应用

双击 codex-harness.exe 启动。便携版不需要经过安装向导,通常也不需要使用管理员身份运行。

首次启动可能需要初始化内置资源,请等待主界面出现。

如需桌面快捷方式,可右键主程序,选择“发送到 → 桌面快捷方式”;部分 Windows 11 电脑需要先点击“显示更多选项”。创建快捷方式即可,不要把主程序单独移到桌面。

4. 处理首次启动提示

  • 如果出现 Windows SmartScreen 提示,在确认下载来源可信、文件与发布版本一致后,可根据提示选择“更多信息 → 仍要运行”。受组织管理的电脑可能需要管理员协助。

  • 如果提示缺少 Microsoft Edge WebView2 Runtime,请从 微软 WebView2 官方页面 安装适合系统架构的 Evergreen Runtime,完成后重新打开应用。

  • 如果安全软件明确报告恶意内容,先停止启动并向发布方核实,不要直接关闭安全软件。

三、macOS 版本安装

根据下载文件的格式,选择下面一种安装方法。应用名称以实际文件为准。

  1. 双击下载的 .dmg 文件,等待磁盘映像打开。

  2. 将窗口中的 Codex Harness 应用图标拖入 Applications / 应用程序 文件夹。

  3. 等待复制完成。

  4. 打开 Finder → 应用程序,找到 Codex Harness 并启动。

  5. 安装完成后,可在 Finder 边栏推出该磁盘映像。

请从“应用程序”文件夹启动,不要长期直接运行 DMG 窗口内的应用。

首次打开时被系统阻止

如果提示“无法验证开发者”或“无法验证是否包含恶意软件”:

  1. 先确认应用来自可信发布渠道,并且下载的架构与本机匹配。

  2. 尝试在 Finder 中按住 Control 点击应用,选择“打开”;是否提供此选项取决于 macOS 版本。

  3. 如果仍被阻止,打开“系统设置 → 隐私与安全性”,查找该应用对应的拦截提示;如系统提供“仍要打开”,可按提示确认。

如果提示“应用已损坏”,先删除这次下载的应用副本,重新下载匹配机型的完整安装包,并确认系统版本符合要求;仍无法打开时,将完整提示提供给发布方。

如果系统明确提示“将损坏你的电脑”或检测到恶意软件,请停止打开并向发布方核实。

按需授予权限

普通聊天不需要预先开启所有系统权限。使用相关功能时,再根据应用提示授权:

功能可能需要的系统权限
读取或保存指定文件对相应文件、文件夹的访问权限
显示任务完成提醒通知权限
屏幕识别、电脑控制(对应版本支持时)屏幕录制或屏幕与系统音频录制、辅助功能权限

修改系统权限后,如果应用提示重新启动,请先退出应用,再重新打开。

四、首次使用

  1. 登录账号:点击左下角的“未登录”或账户入口,完成登录。

  2. 选择模型:等待账户模型同步,在输入框右下方选择当前账号可用的模型。若没有可选模型,进入模型设置检查账户状态和渠道配置。

  3. 选择项目(可选):普通聊天可以不选择项目。需要处理已有项目文件时,选择对应的项目文件夹。

  4. 发送第一条消息:例如“你好,请用中文介绍一下你能做什么”,确认能够正常收到回复。

  5. 开始任务:按需要添加附件、选择访问模式,再描述要完成的工作。

部分任务可能需要单独安装浏览器、开发工具或其他依赖。完成软件安装与完成某一项任务的环境配置,是两个不同步骤。

五、更新与卸载

Windows 便携版更新

  1. 等待任务完成并退出旧版应用。

  2. 下载新版完整 ZIP,解压到一个新文件夹。

  3. 从新文件夹启动新版,确认可以正常使用。

  4. 将桌面快捷方式更新为新版主程序的位置,再按需要删除旧程序文件夹。

不要只替换 EXE,也不要混用不同版本的 binaries 或资源文件。

macOS 更新

退出旧版应用,按前面的 DMG 或 ZIP 安装步骤,将新版 .app 复制到“应用程序”文件夹;系统询问是否替换时,确认版本正确后选择替换。

数据保留与卸载

卸载 Windows 便携版时,退出应用后删除程序文件夹和快捷方式即可;macOS 可将“应用程序”中的应用移入废纸篓。这些操作通常不会同时删除用户数据。若还需清理用户数据,请确认不再需要其中的会话、配置和生成文件后再操作。

六、常见问题

现象建议处理方法
Windows 双击没有反应,或提示找不到组件确认已经完整解压;检查主程序旁的资源文件是否齐全,以及安全软件是否隔离了文件;若提示缺少 WebView2,则安装对应运行时
Windows 提示“此应用无法在你的电脑上运行”检查下载的是 x64 还是 ARM64,并核对系统版本要求
macOS 提示不支持此应用检查 Apple Silicon / Intel 架构是否匹配,以及 macOS 版本是否满足发布要求
应用能打开,但没有模型可选先登录,等待模型同步,再检查模型设置及账户可用权限
发送消息失败展开错误详情并复制诊断信息,根据具体原因检查网络、账户、模型或文件权限
更新后仍然打开旧版本检查快捷方式、任务栏或 Dock 指向的是否为新版本应用

联系支持时,建议提供:系统版本、电脑架构、应用版本、安装包文件名,以及完整报错文字。不要发送 API Key、密码或登录令牌。

Historique des versions

Consultez les versions précédentes et les changements

v1.5.5
最新版本
2026/09/30 · 240.6 MB · 104
## 主要更新 - Windows 版本首次启动会自动创建桌面快捷方式。 - 官方模型默认输出长度提升至 `32K`。 - 自定义模型默认输出长度调整为 `16K`。 - 优化文件资源右键菜单: - 打开文件所在位置 - 复制文件路径 - 使用系统浏览器打开链接 - 复制链接 ## 问题修复 - 修复 Windows 文件路径显示为 `/C:/...` 导致无法打开的问题。 - 修复中文路径、空格路径和历史会话文件资源无法右键打开的问题。 - 修复复制文件路径格式错误的问题。 - 修复部分模型返回 `tool_calls` 时出现请求错误的问题。 - 修复模型输出达到长度限制后重复重试的问题。 - 优化错误提示,让模型、权限和请求失败原因更清晰。
下载此版本
v1.5.4
2026/09/30 · 240.5 MB · 4
## 新功能 - 新增会话资源右键菜单:文件链接支持“打开文件所在位置”和“复制文件路径”,网页链接支持“使用系统浏览器打开链接”和“复制链接”。 - 未关联项目的会话支持独立本地工作目录,可在当前权限范围内执行命令、创建文件和安装技能,并在后续会话中继续使用。 - 新增可展开的错误详情与诊断信息复制功能,便于排查发送失败、模型调用失败等问题;诊断信息自动隐藏常见凭据及本地路径。 ## 体验优化 - 优化任务运行期间的消息发送,支持通过发送菜单选择“立即引导”或“排队发送”,并通过快捷键临时切换发送方式。 - 跟进消息默认处理方式调整为“立即引导”,可在设置中切换为“排队发送”。 - 完善消息队列状态提示,支持将排队消息立即用于引导当前任务,并在发送状态不明确时核对接收结果,减少重复发送。 - 优化命令输出展示,使用纯文本实时更新,自动跟随最新内容;向上滚动查看已有输出时暂停自动跟随。 - 新会话默认使用 KD 渠道的 `deepseek-v4.1-flash` 模型及高思考强度,避免受最近查看的历史会话模型影响。 - 优化模型思考能力的默认配置与识别,统一新增模型和已有模型的能力设置处理。 ## 界面与交互 - 重新设计启动进度样式,以细进度条替代大圆环,移除百分比数字和省略号,调整标题、说明文字及间距。 - 启动时有明确进度则按比例展示,等待阶段使用平缓滑动动画,并适配减少动态效果设置。 - 输入框统一采用纯文本编辑,移除自动 Markdown 预览及对应设置,减少输入时的界面干扰。 - 完善任务停止中的状态提示,停止期间限制重复操作。 - 优化无输出命令的提示,区分“运行中等待输出”和“进程未返回输出”。 ## 问题修复 - 修复命令结束或回合结束事件可能清空已接收输出的问题。 - 修复历史消息加载期间,新到达的命令输出可能被旧数据覆盖的问题。 - 修复历史会话中 Windows 文件路径经过 Markdown 编码后无法识别,导致资源右键菜单不显示的问题。 - 修复 Windows 路径中反斜杠被当作 Markdown 转义符处理,导致 `.codex-kd` 等目录路径不完整的问题。 - 修复补充消息发送失败或任务状态变化时,消息接收状态不明确、内容恢复不完整等问题。 - 改善 API Key 无效、模型不存在及无模型访问权限等错误的识别与提示,区分所选模型与实际调用模型,减少诊断信息误导。
下载此版本
v1.5.2
2026/09/28 · 314.3 MB · 8
## 新功能 - 支持 Windows ZIP 免安装便携版,以及压缩包更新。 - 支持普通文件附件,可通过选择、拖放或粘贴添加文件。 - 新增消息队列,可等待当前任务完成后发送,也可立即补充指令。 - 支持 Anthropic Messages 协议,兼容更多模型服务。 - 完善 MCP 服务管理,支持配置导入、编辑、启停、授权及状态查看。 ## 体验优化 - 更新弹窗可随时关闭,下载将在后台继续;更新按钮显示圆环进度,点击即可查看详情。 - 优化更新时的程序退出和文件替换流程,增加文件占用检查与失败回滚。 - 优化应用数据的本地保存,设置、草稿及会话相关数据不再依赖浏览器缓存长期存储。 - 完善发送快捷键、通知、字体、主题及终端布局等设置,并补充主要界面的中英文切换。 - 完善浏览器选择、无头模式和调试端口设置,优化浏览器及计算机控制状态显示。 ## 界面与交互 - 统一蓝色开关与音量滑块,优化浅色、深色主题下的标签和提示样式。 - 增强“官方提供”标识的可读性;思考选项仅在选定模型后显示。 - 统一命令与思考活动组的展开字号,优化输入框背景和深色主题下套餐的选中样式。 - 优化余额与充值金额展示,统一人民币格式,避免卡片内金额换行或溢出。 - 优化设置反馈和错误提示,增加状态图标与关闭操作。 ## 问题修复 - 修复未选择项目的会话自动关联其他项目目录、加载其他项目信息的问题。 - 修正命令活动组计时,按开始至结束的完整时长计算,包含命令间的等待时间;改善重启后计时丢失的问题。 - 修复 Responses 协议对话兼容问题,完善接口地址处理、连接检测和最大输出长度设置。 - 修复部分模型对话中的图片传递异常,以及切换服务商后删除模型定位错误的问题。 - 修复部分新安装环境无法发送消息、后端重复启动及旧程序误加载的问题。 - 修复内置浏览器处理本地路径和页面跳转时的异常,改善导航失败反馈。 - 修复部分 MCP 状态读取及授权确认异常,以及个别会话消息重复显示的问题。
下载此版本
v1.5.0
2026/09/26 · 209.7 MB · 20
新增与改进 - 新增设备标识管理,用于识别常用设备并限制重复注册。 - 新增设备注册次数记录,同一设备最多注册 3 个账号。 - 登录和注册请求增加设备标识提交。 - 设备受到登录限制时,显示“请在常用设备上登录”。 - 官方渠道模型改为登录账户关联: - 未登录时隐藏官方模型列表。 - 未登录时显示“登录后可见”。 - 登录后同步官方模型、余额和使用量。 - 未登录时打开模型选择菜单,直接显示登录入口。 - 未登录发送消息时弹出登录窗口,不再向模型发送请求。 - 自定义渠道商入口调整为左侧供应商列表中的占位卡片。 - 优化供应商列表和模型列表的布局、交互及状态展示。 - 优化模型选择菜单,支持供应商分组、模型搜索和登录状态控制。 - 更新下载完成后自动启动安装流程: - 自动关闭当前应用。 - 自动显示安装器进度。 - 安装完成后自动重新启动应用。 - 优化 Windows 桌面通知: - 抑制重复任务通知。 - 合并同一会话的通知。 - 应用回到前台后自动清理活动通知。 - 改进 WebView2 子窗口的前台状态判断。 - 更换应用 Logo、标题栏图标、关于窗口图标、favicon 和桌面打包图标。 界面优化 - 登录弹窗改为显示完整尺寸的新 Logo。 - 修复 Logo 被旧黑色圆角底座缩小的问题。 - 登录和刷新按钮在窄窗口下保持单行显示。 - 窄窗口下余额和使用量自动采用简化显示格式。 - 自定义渠道商卡片增加状态标识、说明文字和进入提示。 - 优化供应商列表、项目列表和模型设置页面的视觉层级。 - 统一部分操作反馈为顶部居中的消息提示。 - 优化任务完成通知和侧边栏状态展示。 问题修复 - 修复未登录时仍可浏览官方模型的问题。 - 修复未登录状态下发送消息的问题。 - 修复模型选择状态与登录状态不同步的问题。 - 修复供应商添加入口固定在页面底部的问题。 - 修复 Logo 引用旧 SVG 导致桌面端和网页端图标不一致的问题。 - 修复重复任务完成通知持续弹出的问题。 - 修复应用回到前台后通知未清除的问题。 - 修复更新安装过程中后台进程占用文件的问题。 - 修复更新包下载完成后仍需要用户手动打开安装包的问题。 - 修复设备标识在重启或软件卸载后丢失的问题。 - 修复设备限制导致登录失败时缺少明确提示的问题。
下载此版本
v1.3.9
2026/09/23 · 209.3 MB · 25
新功能 - 输入框新增 `#` 技能快捷菜单,支持搜索、鼠标选择、方向键切换,以及 Enter、Tab 确认选择。 - `/` 命令与 `#` 技能选中后以卡片形式显示在输入框内,支持点击移除,或在输入框为空时按退格删除。 - 已选命令支持随会话草稿保留,切换会话后可继续编辑,自动更新前也会检查未发送的命令卡片。 - 命令执行记录新增耗时显示,执行中实时更新,完成后保留,并支持重新打开会话时恢复。 体验优化 - `/compact`、`/plan` 等命令改为先添加到输入框,确认发送后再执行,便于继续补充内容。 - 技能列表按来源分组,官方内置技能置顶,共享技能及个人安装技能随后显示,项目、管理员和其他来源技能单独归类。 - 技能菜单支持完整列表竖向滚动,方向键选择时自动滚动到对应项。 - 技能搜索统一按名称和显示标题匹配,不区分大小写;`#` 搜索无匹配时自动隐藏菜单。 - 技能名称保持单行,过长名称和描述以省略号显示,避免长描述挤压名称。 - 统一新会话输入框布局,将命令、技能卡片、图片附件和工具栏收纳在同一输入区域内。 - 调整思考及命令记录的间距、字号和展开区域样式,改善阅读体验。 问题修复 - 修复新会话中已选技能卡片显示在输入框边框外的问题。 - 修复技能搜索因描述中的数字、版本号等内容而匹配到无关技能的问题。 - 修正技能来源识别,避免将个人安装技能混入官方内置分类。 - 修复部分执行耗时在关闭窗口到托盘或重启后丢失的问题,隐藏窗口前及时保存相关数据。 - 改善 Windows 窗口圆角表现,在调整大小、显示缩放变化及从托盘恢复时重新应用窗口样式,最大化时保持直角。
下载此版本
v1.3.5
2026/09/22 · 209.3 MB · 15
新功能 - 支持在任务执行过程中继续发送文字和图片,引导当前任务,无需先停止生成。 - 输入框支持按会话保留文字、图片、已选技能和访问模式,切换会话或进入设置后返回可继续编辑。草稿保留范围为本次应用运行期间。 - 图片预览支持放大、缩小、拖动和还原,支持滚轮与双击调整,缩放范围为 100% 至 400%;输入框和会话消息共用同一套预览。 - Git 分支列表同时显示本地分支和远程分支,选择远程分支时自动创建并切换到对应的本地跟踪分支。 - 命令直接修改的文件也会计入本轮变更统计,并与补丁修改的文件合并显示,避免重复计算。 - 个人菜单显示高级权限状态和精确到期时间,购买页及支付成功页面按实际有效期展示。 - 新增软件宣传页面,展示工作台、主要能力和版本更新内容。 体验优化 - 任务执行中,输入内容后显示发送按钮,同时保留独立的停止入口;输入框为空时显示停止按钮。 - 待接收的消息显示“等待接收”,收到服务器回显后自动取消提示。 - 新对话保留所选项目、模型和思考强度,避免受到其他会话选择的影响。 - 变更文件列表只显示文件名,悬停可查看完整路径;鼠标移向列表时不会立刻收起。 - 任务完成通知显示用户问题、完成结果或失败原因,上下文压缩也会单独提示。 - 浏览器操作指令支持出现在句子中间或后半段,增加“内置浏览器打开”“右侧标签页打开”等表达。 - 优化个人菜单的权限状态卡片、购买弹窗及新对话页面的图片附件布局。 - 权限购买的支付状态查询更快,支付成功后优先使用订单返回的权限信息。 - 更新技能和内置插件时保留已有本地文件,增量补充缺失内容,减少覆盖本地修改的风险。 - 自动更新前检查所有会话的未发送草稿,包括当前未打开的页面。 - 安装更新时优先恢复上次实际安装位置,避免开发版本将安装目录带到调试目录。 - 完善文件编辑规则,明确 CSS 和批量文本替换也应通过补丁工具完成,并仅报告工具确认成功的修改。 - 充值弹窗禁止选择、复制和剪切内容,并移除订单号复制入口。 问题修复 - 修复任务执行中输入内容后仍无法发送的问题。 - 修复同一轮任务中的追加消息可能覆盖原用户消息,以及服务器回显造成消息重复显示的问题。 - 修复切换会话或进入设置页面后,未发送内容和输入框选项丢失的问题。 - 修复发送失败后草稿被清空,以及旧请求完成后误清除新编辑内容的问题。 - 修复中文输入法确认候选词时误发送消息或执行快捷命令的问题。 - 修复快速切换会话时,旧会话的加载结果覆盖当前所选项目的问题。 - 修复窗口仍在前台、但焦点进入页面内部时,任务栏未读徽标和完成通知误触发的问题。 - 修复当前正在查看的会话被标记为未读的问题。 - 修复远程分支不显示的问题,并排除远程 HEAD 指针。 - 修复权限到期时间缺失时无法正确判断有效期的问题;已到期权限不再视为可用。
下载此版本