我有个朋友，最近迷上了用 AI 写代码。

他不是程序员，就是想让 AI 帮他做个小工具，自动整理一下文件夹。折腾了半天，光是"怎么装环境"这一步就把他劝退了——什么 Python、Node.js、npm，一个都没听说过。

后来他发现了这个东西：OpenClaude Portable。

装在 U 盘里，插到哪台电脑上都能跑，什么都不用提前装。

0-nOiM

它到底是什么

你可以把它理解成一个"随身携带的 AI 助手"，专门帮你写代码、改代码、做自动化任务。

你告诉它"帮我写一个脚本，把桌面上所有 jpg 文件移到一个叫'图片'的文件夹里"，它就去写，写完还问你要不要执行。你说行，它就真的帮你执行了。整个过程不需要你懂编程。

它本质上是把一个 AI 编程工具，打包进了一个可以到处带着走的文件夹。

0-bSTi

第一步：下载项目

去 GitHub 搜索 OpenClaude-Portable，找到项目页面，点绿色的 Code 按钮，选 Download ZIP，下载完解压到任意位置——U 盘或者电脑本地都行。

国内访问 GitHub 有时候较慢，如果打不开，可以多刷新几次，或者换个时间段再试。解压后你会看到一个文件夹，里面有 START.bat、start.sh 等文件。

0-nyZg

第二步：选 AI 服务（国内用户）

这一步是国内用户最需要注意的地方。项目支持 7 种 AI，但并不是每种在国内都能顺畅使用。

首选推荐：DeepSeek（国产，国内直连）

DeepSeek 是国内的 AI 公司，API 在国内可以直接访问，不需要任何特殊网络环境。去 platform.deepseek.com 注册账号，进入"API Keys"页面创建一个 Key，复制保存好。价格很便宜，新用户注册后有赠送额度，日常轻度使用基本够用。DeepSeek API 文档

备选：阿里云百炼 / 火山引擎（国内云厂商托管的 DeepSeek）

如果 DeepSeek 官方 API 偶尔不稳定，可以用阿里云百炼或字节跳动的火山引擎，它们都提供 DeepSeek 模型的 API 接入，新用户赠送的 token 额度更多，服务也更稳定。不过这两个平台目前还不在项目的原生支持列表里，需要通过 OpenRouter 或手动配置接入，稍微麻烦一点。博客园

完全免费、不联网：Ollama 离线模式

AI 跑在你自己电脑上，数据不出门，也不需要 API Key。代价是对电脑配置有要求，速度比云端慢。Ollama 官网在国内访问有时偏慢，可以搜索"Ollama 国内镜像"找到加速下载地址。

不建议国内用户直接使用的服务：OpenAI、Anthropic Claude、Google Gemini、NVIDIA NIM——这些在国内网络环境下无法直接访问。

0-rOPP

第三步：启动

Windows 用户： 双击 START.bat。

Mac / Linux 用户： 打开终端，进入文件夹，输入：

chmod +x start.sh
./start.sh

第一次启动会自动下载 Node.js（约 25MB）和 AI 引擎（约 5MB）。这一步需要联网，国内下载速度一般没问题。下完之后会让你选 AI 服务、填 API Key，填完就进入主菜单了。之后每次启动，直接跳过这些步骤，秒进菜单。

0-OCOZ
0-tDPL

第四步：看懂菜单，选一个模式

1) 普通模式  — AI 每次操作前会先问你
2) 无限制模式 — AI 全自动，不打扰你
3) 打开网页界面
4) 切换 AI 服务
5) 下载本地模型（离线用）

新手选 1，普通模式。AI 在帮你写文件或执行命令之前，会先告诉你它打算做什么，你确认了它才动。10 秒内不按任何键，它也会自动选普通模式。

如果你信任它、想让它自己跑完所有步骤不来烦你，才选 2。

0-Xvnn

第五步：开始对话

启动后，直接用中文跟它说话就行。几个实际可以用的例子：

"帮我写一个脚本，把当前文件夹里所有 .txt 文件合并成一个，文件名叫 output.txt。"

"我有一个 Excel 表格，第一列是姓名，第二列是手机号，帮我写个脚本把手机号中间四位替换成星号。"

"帮我做一个简单的网页，上面有一个按钮，点了之后显示'你好'。"

它会先告诉你它的思路，然后写出代码，问你要不要执行。你觉得没问题，回复"是"或者"执行"就行。

想用网页界面？

在菜单选 3，然后打开浏览器访问：

http://localhost:3000

这是一个类似 ChatGPT 的聊天界面，操作更直观，还能看到 AI 的"思考过程"。不喜欢命令行黑框的用户，用这个更舒服。

0-GEFP

有什么要注意的

第一次用必须联网。 需要下载运行环境，约 30MB，国内速度一般正常。之后如果你用 Ollama 离线模式，就不需要联网了。

U 盘速度会影响体验。 如果你的 U 盘是老款 USB 2.0，读写会比较慢。有条件的话，把文件夹复制到电脑本地的 SSD 上跑，快很多。

API Key 存在哪？ 就存在文件夹里的 data/ai_settings.env 这个文件里，不会上传到任何地方，也不会写入你的电脑系统。U 盘丢了记得及时去 DeepSeek 平台把 Key 作废。

它适合谁

不会写代码，但想让 AI 帮你做点自动化的事——整理文件、批量重命名、写个小脚本——这个工具就是为这种需求做的。你不需要懂任何编程知识，不需要提前配置环境，也不需要一直用同一台电脑。

项目在 GitHub 上完全开源，搜 OpenClaude-Portable 就能找到。