适合谁
- 开发者希望使用非 Anthropic 模型但仍使用 Claude Code 风格的工作流
- 需要支持多种云 API 和本地模型的多提供商环境
- 希望在 CLI 中使用先进的代理功能和工具循环
- 需要灵活配置提供商和模型
O
35FMRS · D
OpenClaude Improved 是一个功能强大的 CLI 编程代理，支持多种 LLM 提供商，保留了 Claude Code 的许多核心功能，并添加了如提供商路由、MCP 支持等功能。适合需要灵活选择模型的开发者，但需要注意其非官方性质及执行命令的风险。
OpenClaude Improved 是一个开源的 CLI 编程代理，基于 Claude Code 构建，但支持多种 LLM 提供商，包括 OpenAI 兼容 API（如 OpenRouter、DeepSeek、Groq）、Ollama 本地模型、Gemini、GitHub Models 等。它提供与 Claude Code 相同的工具和代理工作流，包括 Bash 执行、文件读写、搜索、多步工具循环、流式输出、视觉支持、仓库映射等。此外，它还包含多个 agent routing、MCP 支持、gRPC 服务器和 VS Code 扩展等功能。
工具能力
bash
在本地执行 shell 命令
read
读取文件内容
write
写入文件内容
edit
编辑文件内容
grep
在文件系统中搜索文本
glob
使用 glob 模式匹配文件路径
agents
启动子代理以处理特定任务
tasks
创建和管理后台任务
mcp
通过 MCP 协议与外部工具集成
slash commands
执行内置斜杠命令，如 /provider 和 /buddy
安装接入
- 确保已安装 Node.js >= 22 和 Bun。
- 克隆仓库并进入目录。
- 运行
bun install安装依赖。 - 运行
bun run build构建项目。 - 运行
npm install -g .全局安装 CLI。 - 运行
openclaude启动代理。
选型与风险
不适合谁
- 需要官方 Anthropic 认证或企业支持的用户
- 需要图形界面、非高级用户的用户
- 期望零配置开箱即用的用户
- 需要官方 Claude Code 兼容层的用户（此项目是独立复刻，不是官方）
所需权限
- 文件系统访问：读写、编辑代码文件
- 执行系统命令（Bash）
- 网络访问：调用云端 API（如 OpenAI、Gemini）或本地 Ollama 服务
- 可能访问环境变量中的 API 密钥
- 用户配置目录（~/.openclaude/）的读写权限
风险与副作用
- 因为执行任意 Bash 命令，有可能导致系统损坏或数据丢失，尤其是使用不信任的提示时
- API 密钥可能通过环境变量暴露，需小心管理
- 项目处于积极开发阶段，API 可能变化
- 非官方复刻，可能存在兼容性或稳定性问题
- MCP 工具可能引入第三方代码执行风险
常见排障
- 启动时提示 '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 编程
本地模型开发（如 Ollama）
使用 MCP 工具扩展编码工作流
在 CI 中使用无头模式
在 VS Code 中使用交互式聊天
支持客户端
Claude Desktop完整支持