OpenClaude

OpenClaude 是一个开源的编码智能体（coding-agent）CLI，支持云端及本地模型提供商。

你可以使用 OpenAI 兼容的 API、Gemini、GitHub Models、Codex OAuth、Codex、Ollama、Atomic Chat 以及其他受支持的后端，同时保持以终端优先的工作流：支持提示词（prompts）、工具（tools）、智能体（agents）、MCP、斜杠命令（slash commands）以及流式输出。

OpenClaude 同时也镜像发布在 GitLawb： gitlawb.com/node/repos/z6MkqDnb/openclaude

快速入门 | 设置指南 | 提供商 | 源码构建与开发 | VS Code 扩展 | 赞助商 | 社区

赞助商

GitLawb | Bankr.bot | Atomic Chat | Xiaomi MiMo

Star 历史

为什么选择 OpenClaude

在云端 API 和本地模型后端之间使用统一的 CLI
使用 /provider 在应用内保存提供商配置
可与 OpenAI 兼容服务、Gemini、GitHub Models、Codex OAuth、Codex、Ollama、Atomic Chat 及其他受支持的提供商配合使用
将编码智能体工作流整合到一处：bash、文件工具、grep、glob、智能体、任务（tasks）、MCP 和网页工具
使用内置的 VS Code 扩展以获得启动集成和主题支持

快速入门

安装

npm install -g @gitlawb/openclaude@latest

如果你使用的是 Arch Linux，可以通过社区维护的 AUR 包进行安装：

paru -S openclaude

如果安装后报错 ripgrep not found，请确保系统中已安装 ripgrep，并在启动 OpenClaude 前确认在同一终端中 rg --version 可以正常运行。

验证 / 排查安装版本：

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

启动

openclaude

在 OpenClaude 内部：

运行 /provider 进行引导式提供商设置并保存配置
运行 /onboard-github 进行 GitHub Models 接入

最快速的 OpenAI 设置

macOS / Linux:

export CLAUDE_CODE_USE_OPENAI=1
export OPENAI_API_KEY=sk-your-key-here
export OPENAI_MODEL=gpt-4o

openclaude

Windows PowerShell:

$env:CLAUDE_CODE_USE_OPENAI="1"
$env:OPENAI_API_KEY="sk-your-key-here"
$env:OPENAI_MODEL="gpt-4o"

openclaude

最快速的本地 Ollama 设置

macOS / Linux:

export CLAUDE_CODE_USE_OPENAI=1
export OPENAI_BASE_URL=http://localhost:11434/v1
export OPENAI_MODEL=qwen2.5-coder:7b

openclaude

Windows PowerShell:

$env:CLAUDE_CODE_USE_OPENAI="1"
$env:OPENAI_BASE_URL="http://localhost:11434/v1"
$env:OPENAI_MODEL="qwen2.5-coder:7b"

openclaude

设置指南

面向初学者的指南：

进阶与源码构建指南：

受支持的提供商

提供商	设置路径	备注
OpenAI-compatible	`/provider` 或环境变量	适用于 OpenAI、OpenRouter、DeepSeek、Groq、Mistral、LM Studio 及其他兼容 `/v1` 的服务器
Hicap	`/provider` 或 OpenAI 兼容环境变量	使用 `api-key` 验证，自动发现未认证 `/models` 中的模型，并支持 `gpt-` 模型的响应模式
Gemini	`/provider` 或环境变量	仅支持 API key
GitHub Models	`/onboard-github`	交互式接入，支持保存凭据
Codex OAuth	`/provider`	在浏览器中打开 ChatGPT 登录并安全存储 Codex 凭据
Codex	`/provider`	使用现有的 Codex CLI 授权、OpenClaude 安全存储或环境变量凭据
Gitlawb Opengateway	`/provider` 或零配置回退	位于 `https://opengateway.gitlawb.com/v1` 的免费智能网关；通过 `OPENAI_MODEL` 路由 Xiaomi MiMo 和 GMI Cloud 合作伙伴模型
OpenCode Zen	`/provider` 或环境变量	按量付费 AI 网关（41 种模型）；使用 `OPENCODE_`

Gitlawb/openclaude