ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

CodeWhale Windows安装避坑指南:从VC运行时错误到10分钟跑通

CodeWhale Windows安装避坑指南:从VC运行时错误到10分钟跑通 CodeWhale Windows安装避坑指南从VC运行时错误到10分钟跑通【免费下载链接】CodeWhaleOpen-source coding agent for your terminal, built in Rust and on a journey of continuous community improvement. Issues and PRs welcome.项目地址: https://gitcode.com/GitHub_Trending/de/CodeWhaleCodeWhale 是一个用 Rust 编写的终端 AI 编程智能体coding agent开源免费能在你自己的电脑上读文件、改代码、跑命令、自行验证结果。本文手把手带你完成 CodeWhale 的 Windows 安装逐个排掉VC 运行时错误、环境变量、终端选择三大新手坑10 分钟跑通你的第一个 AI 编程会话。 第一步如何下载 CodeWhale Windows 安装包x64 / arm64 怎么选打开项目发布页找到最新版本的文件列表。普通 Intel / AMD 处理器的 Windows 电脑推荐下载codewhale-windows-x64-portable.zipWindows 便携版便携版 解压即用不需要安装脚本不用装 npm、Scoop、Cargo也不用双击安装程序解压后包含codewhale.exe主程序、codew.exe短命令名、codewhale.bat智能启动器文件名带arm64的是 ARM 架构设备专用普通电脑不要选⚠️坑位 1列表里的codewhale-windows-x64.exe是纯命令行程序不是安装器双击只会打开默认的 cmd 窗口。想要传统安装体验请下载CodeWhaleSetup.exe它会自动加入 PATH 并注册开始菜单未签名时点更多信息 → 仍要运行即可。如果你习惯用包管理器也可以直接在 PowerShell 里执行winget install Hmbown.CodeWhale包清单见项目内packaging/winget/Hmbown.CodeWhale.yaml一步完成安装和 PATH 配置。️ 第二步环境变量配置教程任意目录直接运行 codewhale便携版解压后要配好环境变量才能在任何文件夹里直接输入codewhale启动把 zip 解压到一个固定目录例如D:\codewhale此时codewhale.exe完整路径为D:\codewhale\codewhale.exe ⚠️坑位 2放好后不要再移动否则下面的环境变量会立刻失效打开 Windows【设置】→【系统】→【系统信息】点击右侧【高级系统设置】在弹出的【系统属性】窗口点【环境变量(N)…】在用户变量里找到Path→【编辑(E)…】→【新建(N)】填入程序所在目录D:\codewhale一路【确定】保存⚠️坑位 3改完环境变量后已经打开的终端窗口必须关掉重开才会生效。这是输入 codewhale 提示不是内部或外部命令的最常见原因。以后出新版本在终端运行codewhale update即可自动下载、校验并替换程序文件配置和对话记录都会保留。⚠️ 第三步VCRUNTIME140_1.dll 报错修复方法VC 运行时新手遇到的最经典报错第一次双击codewhale.exe弹出由于找不到 VCRUNTIME140_1.dll无法继续执行代码。别慌这只是系统缺少微软 Visual C 运行库两分钟就能解决浏览器搜索 Microsoft Visual C Redistributable进入微软官方下载页下载最新版64 位系统选 x6432 位选 x86双击安装完成后重新启动codewhale.exe离线 / 内网备选方案从其他已安装该运行库的 Windows 电脑复制C:\Windows\System32\VCRUNTIME140_1.dll到本机同目录或放到codewhale.exe同级目录下。️ 第四步终端怎么选为什么不要用 cmdCodeWhale 是 TUI终端用户界面程序界面渲染非常依赖终端能力推荐Windows Terminal在微软商店搜索终端即可安装支持更多颜色、Unicode 字符和 GPU 渲染运行 CodeWhale 更稳定流畅不推荐系统自带的 cmd命令提示符功能有限可能出现显示异常甚至崩溃装好后打开 Windows Terminal输入codewhale回车能进入界面就说明安装成功。 第五步首次启动10 分钟跑通 AI 编程智能体第一次运行codewhale会走一个简短的设置流程选择语言配置模型 / API key默认服务商 DeepSeek命令codewhale auth set --provider deepseek确认运行时权限建议 Ask 模式每一步操作都弹窗问你不批不动确认你的 constitution行为准则⚠️坑位 4如果 PowerShell 提示禁止运行脚本执行一次Set-ExecutionPolicy -Scope CurrentUser RemoteSigned -Force即可只影响当前用户、无需管理员权限一次设置永久生效。设置完成后你会看到下面这张主界面 —— CodeWhale 终端编程智能体正式跑通新手第一任务口诀建一个空文件夹 →cd进去 → 运行codewhale→ 先按 Plan 模式让它出方案 → 满意后切 Act 模式动手全程保持 Ask 权限放心让它干活。 Windows 安装避坑速查表现象原因解决办法提示找不到VCRUNTIME140_1.dll缺少 VC 运行库按第三步安装微软官方运行库codewhale不是内部或外部命令环境变量未配好或终端没重开见第二步坑位 2、3提示禁止运行脚本PowerShell 执行策略限制执行一次执行策略命令坑位 4cmd 里显示异常或崩溃cmd 渲染能力有限改用 Windows Terminal双击 exe 只弹出黑窗口x64.exe 不是安装器用codewhale.bat或CodeWhaleSetup.exe 延伸阅读docs/zh_hans/WINDOWS_BEGINNER.md官方 Windows 新手完整指南含模型切换与常用命令速查、docs/INSTALL.md全平台安装文档。【免费下载链接】CodeWhaleOpen-source coding agent for your terminal, built in Rust and on a journey of continuous community improvement. Issues and PRs welcome.项目地址: https://gitcode.com/GitHub_Trending/de/CodeWhale创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表