日榜 #12026-09-02

Gitlawb/openclaude

runs anywhere. uses anything

★ 31.3k stars · ▲ +80 今日 · 🔶 TypeScript · 📜 NOASSERTION · 官網在 GitHub 開啟 ↗

aiai-agentai-toolsclicoding

這是什麼

OpenClaude 是一個以終端機為中心的 open-source coding-agent CLI，目標是把雲端與本機模型後端收斂到同一套工作流裡。README 的定位很清楚：它不是只綁單一模型或單一供應商的聊天殼，而是讓使用者用同一個 CLI 接 OpenAI-compatible APIs、Gemini、GitHub Models、Codex OAuth、Codex、Ollama、Atomic Chat 等後端，同時保留 prompts、tools、agents、MCP、slash commands 與 streaming output。換句話說，它解決的是「AI coding 工具愈來愈多、供應商愈來愈分散」之後的操作碎片化問題；核心做法則是把 provider 設定、工作階段、工具呼叫與 coding-agent 流程包成一個可在終端機內反覆使用的入口。

為什麼上榜

這個專案目前有 31,270 stars，今日新增 80 stars，題目本身正踩在開發者很在意的交會點：既想要 coding agent 的便利，又不想被單一模型平台鎖死。README 強調的「One CLI across cloud APIs and local model backends」正是最大賣點；它把 OpenAI 相容服務、本機 Ollama、GitHub Models、Codex 相關路徑與多個 gateway 放在同一套設定裡，對正在比較 Claude Code、Codex、OpenCode、Ollama 或各式 OpenAI-compatible provider 的使用者很有吸引力。另一個有趣之處是它不只談模型連線，也把 bash、file tools、grep、glob、agents、tasks、MCP、web tools 這些 coding-agent 基本能力列為同一個工作台的一部分，因此更像「可換引擎的終端代理環境」，而不是單純 API wrapper。

適合誰，可以拿來做什麼

OpenClaude 適合已經習慣在終端機工作、也願意設定模型 provider 的開發者。它可以拿來跑一般 coding-agent 任務、在既有專案中使用工具與 slash commands、接雲端模型做程式修改，或接本機 Ollama 測試較私有、可離線的開發流程。README 也提到可 resume 或 continue conversation，並支援用 --fork-session 分岔對話紀錄，適合需要保留上下文但又想嘗試不同方向的任務。若要跑長時間、非互動式 prompt，背景 session 功能可用 openclaude --bg 啟動，再用 openclaude ps、openclaude logs、openclaude kill 管理。不過它的上手門檻不是零：npm 安裝要求 Node.js >=22.0.0，若後續提示缺少 ripgrep，還需要在系統層安裝 rg。

上手

README 提供了明確 quick start。最基本安裝方式是 npm 全域安裝；Arch Linux 使用者也可走 AUR。啟動後，建議先用 /provider 進行 guided provider setup，或用 /onboard-github 設定 GitHub Models。

npm install -g @gitlawb/openclaude@latest
openclaude

常用檢查與更新指令如下：

openclaude --version
npm view @gitlawb/openclaude dist-tags
npm install -g @gitlawb/openclaude@latest

若要快速接 OpenAI 相容 provider，README 示範以環境變數啟動；若要接本機 Ollama，則把 OPENAI_BASE_URL 指到 http://localhost:11434/v1，並設定模型名稱。不過 README 也特別提醒：OpenClaude 不會自動載入專案 .env，建議用 /provider 儲存 provider profiles，或明確使用 --provider-env-file .env。

README 重點摘要

支援多種 cloud APIs 與 local model backends，包含 OpenAI-compatible、Gemini、GitHub Models、Codex/OAuth、Ollama 與多個 gateway。
內建 coding-agent 常見工作流：bash、file tools、grep、glob、agents、tasks、MCP、web tools、slash commands 與 streaming output。
npm 安裝與 runtime 需要 Node.js >=22.0.0；source build 與本機開發才需要 Bun。
背景 session 是本機 child process，不是 daemon 或網路服務；logs 通常存於 ~/.openclaude/bg-sessions/，也可用 OPENCLAUDE_CONFIG_DIR 改位置。
OpenClaude 使用自己的設定位置 ~/.openclaude 與 ~/.openclaude.json，README 明確提醒不要把 Claude Code 的 .claude 與 credentials 直接整包搬過來。