OpenClaude Vibe 项目

项目简介

OpenClaude 是一款开源的编码 Agent 命令行工具（CLI），其核心理念是「一个 CLI 对接所有云端和本地模型后端」，支持 OpenAI 兼容 API、Gemini、GitHub Models、Codex OAuth、Codex、Ollama、Atomic Chat 等多种大模型服务提供商。开发者希望让用户只需维护一套终端工作流，不必为每个模型提供商单独学习一套工具。

该项目采用终端优先（terminal-first）设计，支持 prompts、tools、agents、MCP（Model Context Protocol）、斜杠命令和流式输出，所有交互在终端内完成，无需图形界面。它同时提供 VS Code 扩展，可在 IDE 内使用相同的工作流。

核心功能

多后端统一接入 通过一套 CLI 接入十余家模型提供商的 API，不需为每个提供商单独安装 SDK 或配置认证流程，换后端只需改一行配置。

终端优先的 Agent 工作流 在终端内完成完整的编码 Agent 流程：bash 命令执行、文件读写、工具调用、Streaming 输出，所有操作历史可在同一会话中追溯。

MCP 协议支持 内置对 Model Context Protocol 的完整支持，可连接各种 MCP 服务器扩展功能，例如连接数据库、搜索工具、API 等外部服务。

斜杠命令系统 通过 /provider 等斜杠命令引导式配置模型提供商、保存连接配置文件，支持多组配置快速切换。

VS Code 扩展 提供官方 VS Code 扩展，在编辑器内直接使用相同 Agent 工作流，无需切换到独立终端窗口。

流式输出 所有模型响应以流式（streaming）方式实时展示，终端内即刻看到 AI 思考过程，提升交互效率。

技术实现

OpenClaude 基于 Node.js 开发（通过 npm 分发 @gitlawb/openclaude），核心架构采用模块化设计，将模型提供商抽象为统一接口层，每新增一个 provider 只需实现标准接口而无需改动核心逻辑。

通信层支持 OpenAI 兼容格式，这意味着任何提供 OpenAI API 兼容端点的服务商（包括本地 Ollama、Gemini、Codex 等）都可以无缝接入。Agent 执行引擎负责维护会话状态、管理工具调用序列、解析 MCP 协议消息。

项目使用 GitHub Actions 做 CI 检查，包含 PR 检查、工作流测试等自动化环节，确保各平台兼容性。

快速上手

第一步：安装 CLI

npm install -g @gitlawb/openclaude

或通过 GitHub Releases 下载对应平台的二进制文件。

第二步：配置模型提供商 运行 openclaude 后，使用 /provider 命令进入引导式配置，输入 API Key 和端点地址，配置自动保存到本地 profile。

第三步：启动会话

openclaude

进入交互式终端会话，直接用自然语言描述任务，Agent 自动调用工具执行。

第四步：在 VS Code 中使用 安装 openclaude VS Code 扩展，打开命令面板（Cmd/Ctrl+Shift+P），搜索 OpenClaude: Start，即可在编辑器内启动 Agent 会话。

适用人群

• 习惯在终端工作的开发者
• 需要同时对接多个大模型服务的研究者或工程师
• 使用 Claude Code、Codex 等工具但希望统一工作流的用户
• 对 MCP 协议有需求、想自行搭建 Agent 环境的开发者

官方链接

• GitHub 仓库：https://github.com/Gitlawb/openclaude
• npm 包：https://www.npmjs.com/package/@gitlawb/openclaude
• VS Code 扩展：VS Code Marketplace 搜索「OpenClaude」