openclaude-improved 是一个用 TypeScript 编写的开源 CLI 编程智能体，定位类似 Claude Code 的可替代/增强版本。它支持在 Windows、macOS、Linux 运行，可连接 OpenAI 兼容接口、Ollama 本地模型、Gemini、GitHub Models、OpenRouter、DeepSeek、Groq、Mistral、LM Studio、Bedrock、Vertex、Cloudflare Workers AI 等多种模型与网关，并提供代码读写、Bash 执行、搜索、任务代理、MCP、会话恢复、后台任务、Repo Map、VS Code 扩展和 gRPC 无头服务等能力。对中国开发者而言，它的价值在于可灵活接入国内外模型或本地模型，降低对单一 Claude/Anthropic 服务的依赖。
适用领域
AI 编程助手 / CLI 开发工具 / Agentic AI / 编程智能体 / 大语言模型应用集成 / 代码生成与代码重构 / 本地模型与云端模型网关 / MCP / Model Context Protocol / 开发者效率工具 / VS Code 扩展 / 自动化研发工作流
配置难度
中等偏高。普通开发者可以按照 README 完成安装和基础供应商配置，但要稳定接入多模型、处理本地模型上下文、配置 Agent Routing/MCP/gRPC/VS Code 扩展，并在团队内安全落地，需要较强的命令行、Node.js、LLM API 和安全运维经验。
商业价值
对研发团队的商业价值较高，尤其适合希望构建模型无关的 AI 编程工作流、降低对单一闭源工具依赖、灵活接入国内外模型和本地模型的团队。它可用于提升代码理解、重构、测试修复、自动化开发任务和内部 AI 工具平台建设效率。但由于授权边界、供应商稳定性和 Agent 执行安全风险，企业采用前应进行许可证审查、安全沙箱隔离、密钥治理和小范围 PoC。
01
技术亮点
- 多供应商支持非常广，覆盖 OpenAI 兼容接口、Ollama、Gemini、GitHub Models、Codex、Bedrock、Vertex、Cloudflare Workers AI 以及多个网关服务。
- 支持本地模型，对关注代码隐私、成本控制或网络可用性的中国开发者较有吸引力。
- CLI 能力完整，包含 Bash、文件读写编辑、grep、glob、任务、子 Agent、Slash Commands、MCP 等。
- 支持流式输出和工具执行进度展示，交互体验接近主流 AI Coding Agent。
- Repo Map 可生成结构化仓库上下文，帮助模型理解大型代码库。
- 支持 Agent Routing，可为不同 Agent 配置不同 provider/model 和最大步骤数。
- 提供后台会话、日志查看、会话恢复和会话分叉，适合长任务。
- 提供 gRPC 无头服务，便于企业内部平台、CI 或自定义 UI 集成。
- 内置 VS Code 扩展，覆盖终端和编辑器两类场景。
- README 文档较完整，包含安装、供应商、配置、会话、开发和故障排查说明。
02
目标用户
- 希望在终端中使用 AI 编程助手的后端、前端、全栈开发者
- 希望替代或增强 Claude Code 工作流的开发者
- 需要同时使用 OpenAI、Gemini、Ollama、OpenRouter、DeepSeek 等多模型的团队
- 希望用本地模型处理代码以降低数据外传风险的企业或个人
- 需要在 CI、自定义 UI 或自动化系统中调用 AI 编程 Agent 的工具开发者
- 熟悉 Node.js、Bun、命令行环境的高级开发者
- 希望在 Windows 环境下运行类 Claude Code 工具的开发者
03
配置要求
- 必须具备 Node.js >= 22 和 Bun。
- 需要根据所选模型供应商配置 API Key、Base URL 和模型名。
- OpenAI 兼容服务常用环境变量包括 CLAUDE_CODE_USE_OPENAI=1、OPENAI_API_KEY、OPENAI_BASE_URL、OPENAI_MODEL。
- Ollama 本地模型可设置 OPENAI_BASE_URL=http://localhost:11434/v1 和 OPENAI_MODEL，例如 qwen2.5-coder:7b，通常不需要 API Key。
- Gemini、Fireworks、Cloudflare、GitHub Models、OpenRouter 等供应商需要各自的 API Key 或授权流程。
- 项目 .env 文件默认不会自动加载，如需加载供应商变量，需要使用 --provider-env-file .env。
- OpenClaude 配置目录默认为 ~/.openclaude/ 和 ~/.openclaude.json，可用 OPENCLAUDE_CONFIG_DIR 迁移。
- 它不读取 ~/.claude、项目 .claude/ 或 CLAUDE_CONFIG_DIR；从 Claude 生态迁移时需要手动迁移自定义配置，不建议复制凭据。
- 如启动提示 ripgrep not found，需要系统安装 ripgrep 并确保 rg --version 可用。
- 部分功能依赖终端能力，例如 buddy 动画需要较宽终端和较好的颜色支持。
04
适用场景
- 在已有代码仓库中让 AI 阅读、搜索、修改、重构代码
- 通过 Bash、文件读写、grep、glob 等工具完成多步骤代码任务
- 接入本地 Ollama 模型，如 qwen2.5-coder，进行离线或半离线代码辅助
- 接入 OpenRouter、DeepSeek、Groq、Mistral、LM Studio 等 OpenAI 兼容服务
- 使用 /provider 管理不同模型供应商配置，并在不同任务中切换模型
- 使用会话恢复、会话分叉和后台任务处理较长的开发任务
- 通过 Repo Map 生成代码仓库结构上下文，辅助模型理解大型项目
- 使用 MCP 扩展外部工具能力
- 通过 gRPC 服务模式集成到 CI、内部平台或自定义前端
- 使用 VS Code 扩展进行编辑器内聊天和控制
05
部署与配置
- 安装 Node.js，版本要求 >= 22。
- 安装 Bun，Windows 可使用 winget install Oven-sh.Bun，其他系统可参考 bun.sh。
- 克隆或进入项目目录，例如 cd openclaude-main。
- 执行 bun install 安装依赖。
- 执行 bun run build 构建项目。
- 执行 npm install -g . 将 openclaude 链接到全局 PATH。
- 运行 openclaude 启动 CLI。
- 首次使用推荐在 OpenClaude 内执行 /provider，按引导配置模型供应商和凭据。
- 如使用 GitHub Models，可在 OpenClaude 内执行 /onboard-github。
- 开发模式可执行 bun run dev；测试可执行 bun test。
06
风险与注意事项
- 许可证存在不确定性：仓库元数据为 NOASSERTION，README 徽章显示 MIT，但底部说明 contributor modifications 为 MIT，derived Claude Code code remains Anthropic's；企业商用前必须仔细审查 LICENSE 和来源代码授权。
- 项目与 Claude Code/Anthropic 商标和可能的派生代码有关，存在合规、商标和授权边界风险。
- AI Agent 具备执行 Bash、读写文件和修改代码能力，错误配置或误操作可能造成代码损坏、数据泄露或执行危险命令。
- 多供应商适配复杂，不同模型的工具调用、上下文长度、输出限制和视觉能力并不一致，实际稳定性依赖模型质量。
- 本地小模型在长上下文、多步骤工具调用和复杂重构任务上可能效果较差。
- 需要 Node 22 和 Bun，对部分企业内网或旧环境不够友好。
- 项目 .env 默认不自动加载，初学者可能误以为配置无效。
- 凭据会保存到本地配置文件，如 .openclaude-profile.json 或 ~/.openclaude，需要注意权限和密钥管理。
- README 中列出的供应商很多，部分小众网关的可用性、价格、隐私政策和 SLA 需要自行评估。
- GitHub stars 约 578，社区关注度不错但仍不是大型成熟基础设施项目，生产级采用需先做试点。
2026-08-02
第12名
新收录 · github_search
2026-08-01
第8名
新收录 · github_search
2026-07-31
第8名
新收录 · github_search
2026-07-30
第11名
新收录 · github_search
2026-07-29
第10名
新收录 · github_search
