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）。

典型使用情境

安裝與快速入門

# 需要 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 檔案與正式的安全政策。

成熟度

總結 OpenClaude 是一個真正的開源 CLI，將 LLM 驅動的程式碼輔助功能帶入終端，支援靈活的後端、工具呼叫循環，並提供可選的 UI 裝飾。文件完善、可擴充，適合希望以單一、可腳本化的介面存取多個 LLM 服務的開發者。