前言相比手动安装 Node.js、再敲命令行一键安装包将环境配置、依赖安装与客户端部署一并打包省去了繁琐的搭建步骤非常适合不想折腾、希望快速上手的用户。全程只需按提示操作几分钟内即可开始使用。一、下载安装包打开官网入口https://codex.ikidi.top/找到下载区按你的系统选择对应的安装包。下载完成后双击运行安装程序。Windows 下若弹出安全提示选择「仍要运行」或「更多信息 → 仍然运行」即可继续这是本地部署包正常现象。⚙️二、完成安装按安装向导一路「下一步」选择安装目录后可保持默认。等待进度条走完勾选「创建桌面快捷方式」方便下次打开。安装结束后直接点击「完成」启动客户端。macOS 用户如果遇到「无法打开因为无法验证开发者」到「系统设置 → 隐私与安全性」里点「仍要打开」。三、登录与激活首次打开客户端进入登录界面。使用手机号或邮箱注册账号获取验证码后完成登录已有账号直接登录。登录后按界面提示完成激活。激活通过后即可进入主界面使用全部功能。️四、配置模型与密钥进入「设置」面板找到模型配置项。填入你的模型密钥或选择中转网关的方式接入。在模型列表里挑选要用的模型DeepSeek、Kimi、通义千问、OpenAI 等并按需调整上下文长度、输出参数。保存后即可生效不同任务可以随时切换不同模型。五、启用技能与插件在内置技能库里勾选你要用的技能Word、Excel、PPT、PDF、浏览器控制、桌面控制等。有外部系统要对接的可到「MCP / 插件」里添加 MCP 服务器把更多业务工具接入进来。按需开启即可不需要的技能先关掉保持界面清爽。六、下达第一条任务回到主对话界面用大白话输入需求例如把桌面上的「销售数据.xlsx」里的重复行删掉并按金额降序排列Agent 会据此调用技能、操作文件执行前会给出变更预览。确认无误后让它执行完成后可查看差异对比与执行日志。⏰七、配置定时任务可选有周期性重复工作的进入「定时任务」模块新建任务选择触发频率按小时、每天、工作日或直接写 Cron 表达式。设定监控目标例如网页内容变化、本地文件变动、Git 状态、API 返回结果。保存后任务会自动按计划执行每轮日志都会留档方便事后核对。八、对接飞书可选查看客户端内置的「飞书集成」帮助文档。按文档完成授权绑定。绑定后即可直接在飞书里下发指令Windows/macOS 端自动执行并回传结果适合团队协同。❗九、常见问题安装包打不开 / 被杀软拦截添加信任后重试或联系站点获取最新版本。登录收不到验证码稍等片刻重新发送检查手机号或邮箱是否填错。模型连接异常确认密钥有效、余额充足用中转网关时核对网关地址与模型名。技能调用失败确认对应技能已在技能库开启再重试任务。写在最后一键安装包核心优势就是省去重复的环境搭建工作仅靠鼠标操作就能快速部署 Codex Harness。新手上手建议先从简单任务尝试执行前仔细查看变更预览熟悉工具运行逻辑之后再把复杂度更高的工作交给 Agent 处理。下载地址:https://codex.ikidi.top/