Twigpine/openclaude

OpenClaude – 开源编码代理 CLI

它是什么 – OpenClaude 是一个终端优先的命令行界面，可让您与各种大语言模型后端（OpenAI、Gemini、Ollama、GitHub Models、许多商业网关等）对话，并将模型用作 编码助手。它捆绑了一组工具（bash 执行、文件读写、grep/glob、网络搜索、自定义代理）和一个简单的会话系统，以便您可以保留、恢复或分支对话。

主要功能

• 一个 CLI 支持多个提供商 – 通过 /provider 命令或环境变量配置任何兼容 OpenAI 的 API、Gemini、Ollama 或列出的合作伙伴网关。
• 编码代理工作流程 – 内置工具，用于运行 shell 命令、编辑文件、搜索代码库以及调用自定义代理或“技能”。
• 会话管理 – 保存、列出、恢复、删除或分叉聊天会话；后台会话可以脱离终端运行非交互式提示。
• VS Code 扩展 – 从编辑器启动 OpenClaude，并获得主题支持。
• 跨平台 – 适用于 macOS、Linux、Windows（Node ≥ 22）。Arch Linux 提供 AUR 包。
• 可扩展 – 支持自定义斜杠命令、智能自动路由、gRPC 服务器模式、仓库地图智能和 Android 安装。

安装

# 全局 npm 安装（Node >= 22）
npm install -g @twigpine/openclaude@latest

如果您之前安装了较旧的 @gitlawb/openclaude 包，请先卸载它。在 Arch Linux 上，您也可以使用 paru -S openclaude。安装后，运行 openclaude 启动 REPL。

典型工作流程

1. 配置提供商 – 在 REPL 中运行 /provider（或设置环境变量）以选择云 API 密钥、模型和端点。
2. 开始会话 – 只需输入提示，例如 Write a function that validates an email address.
3. 使用工具 – 斜杠命令可让您运行 bash、编辑文件、grep 或调用网络搜索（/search）。
4. 管理会话 – /sessions 列出已保存的聊天；openclaude --resume <id> 或 --continue 恢复它们；--fork-session 创建对话的新分支。
5. 后台任务 – openclaude --bg "fix failing tests" 在后台运行提示；openclaude ps、logs 和 kill 管理这些任务。

支持的后端（部分）– OpenAI、OpenRouter、DeepSeek、Mistral、Gemini、Ollama（本地）、GitHub Models、Codex、Fireworks AI、LongCat、Cloudflare Workers AI、Bedrock/Vertex，以及许多合作伙伴网关（AI/ML API、Novita、ApiSmart、Concentrate、Exa、GMI Cloud、Xiaomi MiMo 等）。CLI 会自动发现每个提供商的可用模型。

社区与生态系统

• 讨论与 Discord – 提供帮助、功能想法和故障排除的活跃频道。
• VS Code 扩展 – 从编辑器启动 OpenClaude，并获得一个像素艺术“英雄”伴侣。
• 丰富的文档 – 面向非技术用户的快速入门指南、Windows/macOS/Linux 特定说明以及高级主题（智能路由、仓库地图、gRPC 服务器、Android 安装）。
• 开源 – MIT 许可，发布在 npm 上并镜像到公共 Git 仓库。

OpenClaude 本质上是 LLM 驱动编码辅助的统一前端，让开发人员留在终端中，同时无需处理单独的 SDK 或 CLI 即可在云和本地模型之间切换。