OpenClaude Portable

想象一下，将全功能的 AI 编码代理装进一个 USB 驱动器，插入任何电脑（Windows/Linux/macOS），只需双击启动，即可开始智能编程。

OpenClaude 是一个完全便携、零痕迹的 AI 编码代理解决方案。它捆绑了独立的 Node.js 运行时、智能系统提示代理以及基于 Web 的仪表板，所有数据均保留在项目文件夹内，不向宿主机器写入任何文件。无论是保护隐私、规避公司限制，还是实现真正的移动办公，OpenClaude 都提供了完美的答案。

核心亮点：自由、私密、高效

1. 真正的即插即用 (Plug & Play)

• 零安装：无需在宿主机器上配置环境、安装依赖或修改注册表。
• 跨平台共享：data/ 文件夹可在 Windows、Linux 和 macOS 之间无缝共享，你的会话、配置和密钥随你同行。
• 自动引导：首次运行自动下载必要组件（Node.js + 引擎），后续启动秒开。

2. 极致隐私与零痕迹

• 数据隔离：所有 API 密钥、日志、会话历史均存储在 data/ 目录中。
• 环境变量重定向：自动重定向 XDG_CONFIG_HOME 等系统变量，确保宿主系统保持绝对干净。
• 无遥测：除了你选择的 AI 提供商外，不向任何第三方发送数据。

3. 本地模型加速引擎

在 CPU 或 USB 2.0 上运行本地大模型通常面临高延迟痛点。OpenClaude 内置智能提示词压缩代理：

• 90% 精简率：将长达 10,000 tokens 的系统提示压缩至约 300 tokens。
• 显著提速：在纯 CPU 硬件上，首 Token 延迟从 60-120 秒降至 5-20 秒。
• 离线可用：完美支持 Ollama 离线模式，无网也能写代码。

4. 7 大模型提供商支持

灵活选择最适合你的模型：

• 云端主流：Anthropic Claude, OpenAI, Google Gemini, DeepSeek, NVIDIA NIM, OpenRouter.
• 本地离线：Ollama (支持 Gemma, Qwen, Phi3 等轻量级模型)。

快速开始

Windows 用户

1. 解压 OpenClaude 到任意文件夹或 U 盘。
2. 双击 START.bat。
3. 首次运行会自动下载组件并引导配置 API Key 或本地模型。
4. 之后每次双击即可直接进入主菜单。

Linux / macOS 用户

chmod +x start.sh
./start.sh

主菜单功能

• Launch AI：正常模式，执行文件写入或命令前需确认。
• Limitless Mode：无限模式，代理全自动执行，无需批准（慎用）。
• Open Dashboard：打开浏览器访问 http://localhost:3000，享受 ChatGPT 风格的可视化交互界面。
• Change Provider：切换模型提供商或更新 API Key。
• Setup Offline：下载并配置本地 Ollama 模型。

本地模型推荐 (Ollama)

为了在便携设备或 CPU 上获得最佳体验，推荐使用以下轻量级模型：

💡 提示：如果 USB 2.0 读取成为瓶颈，建议将 data/ollama/ 文件夹复制到本地 SSD 运行，速度将有质的飞跃。

安全与隐私保障

• API Key 安全：密钥仅明文存储于本地 data/ai_settings.env，不上传云端。
• 批准模式：默认情况下，代理在执行任何潜在危险操作（如删除文件、运行 Shell 命令）前都会请求用户确认。
• 会话恢复：使用 RESUME.bat <session-id> 可随时恢复中断的工作流，避免重复劳动。

常见问题

• Q: 可以在没有网络的电脑上使用吗？
  • A: 可以。选择 Ollama 提供商并下载本地模型后，即可完全离线使用。
• Q: 会留下垃圾文件吗？
  • A: 不会。删除整个 OpenClaude 文件夹即可彻底卸载，不留任何痕迹。
• Q: 为什么本地模型这么慢？
  • A: CPU 推理本身较慢。请尝试更小的模型（如 1B-2B 参数），或使用内置的提示词压缩功能。若可能，将模型文件移至本地 SSD。