Última versión v1.5.5

Codex Harness

Asistente inteligente para trabajar con más eficiencia

Multiplataforma

Compatible con Windows y macOS para una experiencia uniforme.

Versión de Windows

Para Windows 10 / 11 (64 bits)

Descargar ahora
codex-harness-1.5.5-windows-x64-portable.zip 240.6 MB v1.5.5 Ver tutorial de instalación
暂无可用版本
Windows 10/11 64 bits
4 GB+ RAM
500 MB libres
Conexión de red para activación

macOS 12+

Descargar ahora
Codex harness_1.5.5_universal_signed.dmg 423.0 MB v1.5.5 Ver tutorial de instalación

Guía de instalación

Solo 4 pasos para empezar con OpenClaw

1

Descargar instalador

Haz clic en el botón de descarga y ejecuta el instalador.

2

Completar asistente

Sigue las instrucciones y finaliza la instalación.

3

Pagar y obtener código

Tras la instalación, paga para obtener tu código de activación y Token inicial.

4

Activar y usar

Introduce el código de activación y empieza a usar OpenClaw.

Notas antes de instalar

Se requiere pago durante la instalación. Tras pagar obtendrás autorización permanente y Token inicial.

Tutorial detallado de instalación

Ver tutorial externo

本文适用于 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、密码或登录令牌。

Historial de versiones

Consulta versiones anteriores y cambios

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 指针。 - 修复权限到期时间缺失时无法正确判断有效期的问题;已到期权限不再视为可用。
下载此版本