Gitlawb/openclaude

OpenClaude – 开源且以终端为先的代码代理CLI

是什么

• 一个基于 Node.js 的命令行界面，让您从单一终端窗口与多种 LLM 提供商（OpenAI 兼容 API、Gemini、GitHub Models、Ollama、Atomic Chat 等）进行交互。
• 集成了 代码代理 功能：bash 执行、文件读写、grep/glob、多步工具调用，以及一个“代码库地图”（repo map），可将当前代码库的结构视图注入提示中。
• 可召唤一个像素艺术“伙伴”为终端增添一点趣味。

主要功能（如 README 所述）

• 统一的提供方管理 – /provider 会引导您完成设置，并将配置文件存储在 ~/.openclaude-profile.json。支持数十种云网关（OpenAI、Gemini、Fireworks AI 等）和本地后端（如 Ollama）。
• 工具驱动的工作流 – 内置命令支持 bash、文件编辑、glob 模式匹配和自定义代理；CLI 支持逐 token 流式输出，并可在单次对话中重复调用工具。
• 后台会话 – 以非交互方式运行脱离终端的提示（openclaude --bg …），使用 ps 列出，查看日志或终止任务。所有会话数据均保存在 ~/.openclaude/bg-sessions/ 目录下。
• 代码库地图 – 自动生成的仓库图（按 PageRank 排序），可通过 REPO_MAP 标志注入上下文（使用 /repomap 查看）。
• VS Code 扩展 – 内置扩展可让您从编辑器启动 OpenClaude，并提供主题支持。
• 伙伴角色 – 可选的真彩色像素艺术角色，可对每条输入消息做出反应（/buddy）。

典型使用场景

• 无需离开终端，快速让 LLM 生成、重构或调试代码。
• 执行多步自动化任务，模型可自主决定调用 shell 命令或编辑文件。
• 对隐私敏感的工作使用本地模型（Ollama），或切换到云提供商以使用更大模型。
• 将长时间运行的任务（如修复测试）置于后台，同时继续其他工作。
• 利用代码库地图让模型了解大型代码库的结构。

安装与快速入门

# 需要 Node ≥22
npm install -g @gitlawb/openclaude@latest   # 或通过 Arch 的 AUR
openclaude                                 # 启动 REPL

• 运行 /provider 配置后端（API 密钥、基础 URL、默认模型）。
• 使用 /onboard-github 配置 GitHub Models，或设置环境变量如 OPENAI_API_KEY 和 OPENAI_MODEL 以使用 OpenAI。
• 使用 --resume <id> / --continue 和 --fork-session 恢复或分叉对话。
• 后台任务：openclaude --bg "fix failing tests"。

支持的提供方（摘录）

提供方	配置方式	说明
OpenAI 兼容（OpenAI、OpenRouter、DeepSeek、Groq、LM Studio 等）	/provider 或环境变量	使用标准 /v1 聊天端点
Gemini	/provider 或环境变量	仅需 API 密钥
Ollama	/provider 或环境变量	本地推理，无需 API 密钥
GitHub Models	/onboard-github	交互式引导
Atomic Chat、Bedrock、Vertex 等	/provider 或环境变量	多种云网关
多个合作伙伴网关（AI/ML API、Novita AI、Concentrate、Exa 等）	/provider	自动发现各服务的模型

生态系统与社区

• 讨论与 Discord – GitHub Discussions 和公共 Discord 服务器的链接位于徽章栏中。
• VS Code 扩展 – 从编辑器启动 OpenClaude 并支持主题集成。
• 合作伙伴集成 – 列出的合作伙伴（GitLawb、Bankr.bot、Atomic Chat、Xiaomi MiMo、Atlas Cloud 等）提供 OpenClaude 可路由的 API 密钥或网关。
• 安全与许可 – MIT 许可，包含 SECURITY.md 文件和正式的安全策略。

成熟度

• 活跃维护中（徽章显示最近的日/月趋势数据、PR 检查的 CI 徽章、npm 下载量徽章）。
• 支持广泛的提供方，具备高级功能如代码库地图、后台会话和 gRPC 服务器（参见文档）。
• README 中提到提供方特定的限制（如 Anthropic 功能可能缺失，小型本地模型可能表现不佳），表明已获得真实使用反馈。

总结 OpenClaude 是一个真正的开源 CLI，将 LLM 驱动的代码辅助功能带入终端，支持灵活的后端、工具调用循环，并提供可选的 UI 亮点。文档完善、可扩展，适合希望用单一、可脚本化的接口访问多个 LLM 服务的开发者。