OpenClaude Improved

社区

随处运行，兼容万物

分类: 开发工具第 391 / 438
Stars: ★ 569 非常热门
传输方式: stdio（本地进程）
运行环境: Node.js >=22 · Bun 1.3.13+
凭据: 可选 API Key
许可证: 其他 / 未声明
最近提交: 2 个月前
工具数: 10

35FMRS · D

OpenClaude Improved 是一个功能强大的 CLI 编程代理，支持多种 LLM 提供商，保留了 Claude Code 的许多核心功能，并添加了如提供商路由、MCP 支持等功能。适合需要灵活选择模型的开发者，但需要注意其非官方性质及执行命令的风险。

最强项 · 维护活跃度 12/20 最弱项 · 可靠性 3/20

可靠性

3/20

安全与权限

4/20

维护活跃度

12/20

文档质量

10/20

安装易用性

6/20

查看各项评分依据

可靠性 3/20: 仓库根目录是本服务器路径，但没有找到 MCP 服务器清单（如 mcp-server 配置或 package.json 中的 MCP 相关条目）。README 描述的是 CLI 编码代理，而非明确声明 MCP 服务器功能。核心代码和测试声明存在，但未提供可验证的执行证据；唯一可用的证据是构建和测试命令的文档说明。根据静态校准规则，无法将可靠性评定为高于 12，且未提交测试覆盖关键路径，故仅给予基础分。
安全与权限 4/20: 安全评分较低，因为存在重大未缓解风险：项目直接允许任意工具执行（Bash、读写/编辑），且未提供明确的使用前确认或沙箱机制。README 中提到外部提供商（如 Opengateway）和凭据存储在本地配置文件中，但未明确说明加密或最小权限原则。未发现恶意软件或凭据窃取证据，但存在未确认的危险操作，且凭据处理细节不足，因此评为 4 分。
维护活跃度 12/20: 仓库活跃，有 569 星和 3 个未解决问题，未归档。有 MIT 许可证（尽管 README 中注明派生 Claude Code 代码仍归 Anthropic 所有）。有提交和构建/测试脚本，表明持续维护。但未提供发布历史或版本信息，也未提供安全响应渠道的详细信息（SECURITY.md 已提及但未包含在源材料中）。由于缺少明确的发布和治理证据，给予 12 分。
文档质量 10/20: README 覆盖安装、快速入门、提供商、配置和常见问题，内容详尽。但缺少服务器特定的 MCP 协议文档、工具参数、限制和成本细节。未提供故障排除部分（除非计入常见问题）。文档可读性较好，但假设用户熟悉 Claude Code 环境。未包含可审核的安装或使用证据。因此给予 10 分。
安装易用性 6/20: 安装步骤已清晰说明（需要 Node >=22 和 Bun，然后构建并全局安装）。但缺少特定客户端（如 Claude Desktop）的配置示例，以及 MCP 服务器配置的具体示例。平台兼容性声明充分（Windows/macOS/Linux），但未提供验证过的逐步指南。由于缺乏可验证的执行证据，根据静态校准，设置得分上限为 15，此处给予 6 分。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件执行命令或代码访问网络控制浏览器

适合谁

开发者希望使用非 Anthropic 模型但仍使用 Claude Code 风格的工作流
需要支持多种云 API 和本地模型的多提供商环境
希望在 CLI 中使用先进的代理功能和工具循环
需要灵活配置提供商和模型

不适合谁

需要官方 Anthropic 认证或企业支持的用户
需要图形界面、非高级用户的用户
期望零配置开箱即用的用户
需要官方 Claude Code 兼容层的用户（此项目是独立复刻，不是官方）

所需权限

文件系统访问：读写、编辑代码文件
执行系统命令（Bash）
网络访问：调用云端 API（如 OpenAI、Gemini）或本地 Ollama 服务
可能访问环境变量中的 API 密钥
用户配置目录（~/.openclaude/）的读写权限

风险与副作用

因为执行任意 Bash 命令，有可能导致系统损坏或数据丢失，尤其是使用不信任的提示时
API 密钥可能通过环境变量暴露，需小心管理
项目处于积极开发阶段，API 可能变化
非官方复刻，可能存在兼容性或稳定性问题
MCP 工具可能引入第三方代码执行风险

安装接入

准备工作

运行环境：Node.js >=22 · Bun 1.3.13+

OPENAI_API_KEY 可选密钥 OpenAI 或任意兼容网关的 API 密钥，可在 /provider 中保存或通过环境变量提供。

FIRECRAWL_API_KEY 可选密钥可选，用于启用 JS 渲染的网页抓取，从 firecrawl.dev 获取。

AIMLAPI_API_KEY 可选密钥 AI/ML API (api.aimlapi.com/v1) 的密钥。

FIREWORKS_API_KEY 可选密钥 Fireworks AI 的密钥，提供 276 个精选模型。

LONGCAT_API_KEY 可选密钥 LongCat (api.longcat.chat/openai/v1) 的密钥。

CLINE_API_KEY 可选密钥 ClinePass (api.cline.bot/api/v1) 的密钥，有用量上限。

OPENCODE_API_KEY 可选密钥 OpenCode Zen/Go (opencode.ai) 的密钥。

MIMO_API_KEY 可选密钥 Xiaomi MiMo (mimo.mi.com) 的密钥，使用 api-key 头认证。

NEARAI_API_KEY 可选密钥 NEAR AI (cloud-api.near.ai/v1) 的密钥。

CLOUDFLARE_API_TOKEN 可选密钥 Cloudflare Workers AI 的 API 令牌，从 Cloudflare 控制台获取。

其他可选配置项（6 个）

CLAUDE_CODE_USE_OPENAI 可选设为 1 以启用 OpenAI 兼容后端，从 shell 导出。

OPENAI_MODEL 可选指定模型名，例如 gpt-4o 或 Ollama 的 qwen2.5-coder:7b。

OPENAI_BASE_URL 可选指向 OpenAI 兼容 /v1 端点，例如 Ollama 的 http://localhost:11434/v1。

OPENCLAUDE_OLLAMA_NUM_CTX 可选覆盖 Ollama 上下文窗口大小（默认请求 32768）。

OLLAMA_CONTEXT_LENGTH 可选 Ollama 侧的备选上下文长度覆盖。

OPENCLAUDE_CONFIG_DIR 可选将配置目录从默认的 ~/.openclaude/ 重定位。

确保已安装 Node.js >= 22 和 Bun。
克隆仓库并进入目录。
运行 bun install 安装依赖。
运行 bun run build 构建项目。
运行 npm install -g . 全局安装 CLI。
运行 openclaude 启动代理。

验证是否装好

构建并全局安装后运行 openclaude 命令；若进入交互式 CLI 并能用 read 或 bash 工具回答关于当前目录的问题，说明安装成功。若 grep 报 ripgrep not found，请系统级安装 ripgrep。

常见排障

启动时提示 'ripgrep not found'：请安装 ripgrep 并确保 `rg` 命令可用。
连接 Ollama 失败：确认 Ollama 运行在正确的端口（默认 11434），并可调整 `OPENCLAUDE_OLLAMA_NUM_CTX` 或 `OLLAMA_CONTEXT_LENGTH`。
某些提供商 API 认证失败：检查环境变量是否正确设置，并使用 `/provider` 命令交互式配置。
构建失败：确保 Node.js 版本满足要求，并重新运行 `bun install`。
会话异常：使用 `--resume` 或 `--fork-session` 恢复正常。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

用 bash 工具列出当前目录的所有文件并统计总数
读取 src/index.ts 文件并总结其主要功能
用 grep 工具在整个仓库中搜索 TODO 注释并列出位置
把 README 里的安装步骤改写并写入 SETUP.md 文件

工具能力 10

bash 写入

在本地执行 shell 命令

read 只读

读取文件内容

write 写入

写入文件内容

edit 写入

编辑文件内容

grep 只读

在文件系统中搜索文本

glob 只读

使用 glob 模式匹配文件路径

agents 写入

启动子代理以处理特定任务

tasks 写入

创建和管理后台任务

展开其余 2 个工具

mcp 写入

通过 MCP 协议与外部工具集成

slash commands 只读

执行内置斜杠命令，如 /provider 和 /buddy

使用场景

使用任意支持的提供商进行 AI 编程

本地模型开发（如 Ollama）

使用 MCP 工具扩展编码工作流

在 CI 中使用无头模式

在 VS Code 中使用交互式聊天

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

OpenClaude Improved 是一个开源的 CLI 编程代理，基于 Claude Code 构建，但支持多种 LLM 提供商，包括 OpenAI 兼容 API（如 OpenRouter、DeepSeek、Groq）、Ollama 本地模型、Gemini、GitHub Models 等。它提供与 Claude Code 相同的工具和代理工作流，包括 Bash 执行、文件读写、搜索、多步工具循环、流式输出、视觉支持、仓库映射等。此外，它还包含多个 agent routing、MCP 支持、gRPC 服务器和 VS Code 扩展等功能。