OpenClaude — 通用终端 AI 编程代理
一个终端，打通云端与本地模型，支持多提供商与完整编码代理工作流。
证据显示有权限控制机制（canUseTool 回调、权限模式），但未提供默认最小权限的详细说明；用户确认机制存在（权限提示），但未明确默认行为；数据流透明度部分：README 说明配置存储位置，但未详细说明数据流向；敏感数据处理：有安全策略和隐私验证脚本，但未详细说明加密存储；依赖安全：有依赖固定和 overrides，但未提供漏洞扫描证据；外部影响：有 WebSearch 和 WebFetch 工具，但未说明默认网络行为；回滚：未提及任何回滚机制；来源归属：README 声明源自 Claude Code，但未提供具体代码来源。
自洽性：README 与 package.json 描述一致，但存在一些不一致（如版本号、许可证声明）；依赖可用性：依赖固定版本，但未提供依赖可用性保证；失败消息：有错误处理代码，但未提供用户友好的失败消息示例。
受众和场景：README 面向开发者和非技术用户，提供了多种安装和设置指南；能力边界：明确列出支持的功能和限制；触发精度：命令和工具定义明确，但未提供详细的触发条件；环境适配：支持多种操作系统和 Node.js 版本，但未提供所有环境的测试证据。
信息架构：README 结构清晰，有目录和分区；安装说明：提供了多种安装方式，但未提供详细的故障排除；命名稳定性：版本号存在，但未提供命名约定；示例和 FAQ：提供了多个示例，但未提供 FAQ；已知限制：部分提及，但不全面；许可证：许可证文件存在，但声明不明确（NOASSERTION）；版本变更日志：未提供；维护责任：有安全策略和社区渠道，但未明确维护者。
输出可用性：提供了 CLI 和 SDK，输出格式未详细说明；边际价值：提供了多提供商支持，但未与其他工具比较；成本效益：未提供性能或成本数据。
声明可追溯性：README 中的声明未提供具体证据；跨来源佐证：有 CI 和测试，但未提供独立验证；事实与推断分离：未明确区分事实和推断。
- 许可证声明为 NOASSERTION，且 LICENSE 文件表明代码源自 Anthropic 的专有软件，存在法律风险。
- 未提供回滚机制，用户无法在出现问题时回退到之前的状态。
- 依赖安全未提供漏洞扫描证据，存在潜在风险。
- 未提供版本变更日志，用户难以追踪更新内容。
这个 Agent 能做什么，适合哪些场景？
OpenClaude 是一个开源的编码代理 CLI，旨在统一云端和本地模型提供商的接入。它支持 OpenAI 兼容 API、Gemini、GitHub Models、Codex OAuth、Codex、Ollama、Atomic Chat 等多种后端，同时保持单一终端工作流：提示、工具、代理、MCP、斜杠命令和流式输出。其核心功能包括引导式提供商设置（/provider）、可保存的配置文件、多代理路由与步骤限制，以及内置的 VS Code 扩展。OpenClaude 还包含一个无头 gRPC 服务器，可将代理能力集成到其他应用。项目源自 Claude Code，但已大幅修改以支持多提供商，并采用 MIT 许可证（对修改部分）。
OpenClaude 作为命令行工具（openclaude）运行，支持多种模型提供商的配置。它执行工具驱动的编码工作流，包括 Bash、文件读写编辑、grep、glob、代理、任务、MCP 和斜杠命令。通过 /provider 命令提供交互式设置，支持从 Ollama 等本地服务或 OpenAI 等云端 API 调用模型。它支持流式输出、多步工具循环、图像输入（URL 或 base64）以及仓库地图生成（REPO_MAP 标志）。还提供后台会话（--bg）、会话恢复（--resume）、分叉（--fork-session）等高级功能。此外，内置一个像素艺术伙伴（/buddy），在用户操作时显示动画。项目还包含一个 VS Code 扩展和无头 gRPC 服务器（src/proto/openclaude.proto）。
- 开发者希望在不同模型提供商之间切换，但不想重学习各家的 CLI。
- 使用 Ollama 本地模型的用户，希望保留与云端 API 一致的工作流。
- 需要将代理功能集成到 CI/CD 或自定义 UI 的团队，可使用 gRPC 服务器。
- 使用 VS Code 的开发者，希望通过扩展进行启动集成和主题支持。
- 希望利用 GitHub Models 或 Codex 的认证，但需要统一入口的用户。
- 需要在后台运行长任务并监控日志的用户。
这个 Agent 有哪些优点和局限？
- 多提供商统一工作流，无需每提供商单独工具。
- 支持本地模型（Ollama），提供无 API 密钥的路径。
- 内置仓库地图和后台会话等高级功能。
- 包含 VS Code 扩展和无头 gRPC 服务器，便于集成。
- 社区活跃，有 Discord 和 X 等渠道。
- 并非所有提供商行为完全一致，工具质量取决于所选模型。
- 需要 Node.js >=22.0.0，可能对旧环境不友好。
- 部分提供商（如 AI/ML API）存在限制（如只能列出聊天模型）。
- 背景会话不支持完整重新附加终端。
- 项目源自 Claude Code，但已修改；许可证为 MIT（修改部分），但继承代码版权仍属 Anthropic。
如何安装或部署这个 Agent？
需要 Node.js >=22.0.0。全局安装：npm install -g @gitlawb/openclaude@latest。Arch Linux 用户可通过 paru -S openclaude 安装。若安装后提示 ripgrep not found，请系统级安装 ripgrep 并确认 rg --version 可用。
如何使用这个 Agent？
启动：openclaude。首次使用，运行 /provider 进行引导式提供商设置，保存配置文件（.openclaude-profile.json）。示例（OpenAI）：export CLAUDE_CODE_USE_OPENAI=1; export OPENAI_API_KEY=sk-...; export OPENAI_MODEL=gpt-4o; openclaude。继续或恢复会话：openclaude --continue 或 openclaude --resume <session-id>。后台运行：openclaude --bg "fix tests"。查看日志：openclaude logs <name>。
这个 Agent 与同类方案有什么区别？
与 Claude Code 相比，OpenClaude 旨在支持多提供商，而 Claude Code 主要为 Anthropic 模型设计。