最新版本 v1.5.5

Codex Harness

智慧自動化辦公助手，讓工作更高效

跨平台支援

同時支援 Windows 和 macOS 系統，無論您使用什麼裝置都能享受同樣的體驗。

Windows 版本

適用於 Windows 10 / 11 (64位元) 系統

立即下載
codex-harness-1.5.5-windows-x64-portable.zip 240.6 MB v1.5.5 檢視安裝教學
暂无可用版本
Windows 10/11 64位元
4GB 以上記憶體
500MB 可用空間
網路連線啟用

macOS 12+

立即下載
Codex harness_1.5.5_universal_signed.dmg 423.0 MB v1.5.5 檢視安裝教學

安裝指南

只需四步，即可開始使用蝦殼 OpenClaw

1

下載安裝包

點選上方下載按鈕，取得最新版 Windows 安裝包。下載完成後，雙擊執行安裝程式。

2

完成安裝精靈

依照安裝精靈提示，選擇安裝路徑並完成安裝。安裝過程通常只需要幾分鐘。

3

付款並取得啟用碼

安裝完成後，透過微信支付完成授權付費，系統將自動為您產生啟用碼和初始 Token。

4

啟用並開始使用

輸入啟用碼完成初始化，即可開始體驗蝦殼 OpenClaw 的智慧自動化辦公功能。

安裝前注意事項

安裝過程中需要完成付費才能繼續使用。付費後您將取得永久授權和初始 Token 額度。如有優惠碼，請在付款頁面輸入以享受折扣。

詳細安裝教學

檢視外部教學

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

版本歷史

檢視所有歷史版本及更新日誌

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