openclaude

环境要求

• Node.js >= 22.0.0（npm 安装与运行时必需）
• npm 包管理器（用于全局安装）
• Bun 仅在源码构建与本地开发时需要，普通用户不必安装
• 如使用本地模型，需自备 Ollama 服务；如使用云端模型，需自备 API Key
• 安装后若提示 ripgrep not found，需系统级安装 ripgrep

安装与启动步骤

1. 1检查 Node 版本

   先确认本机 Node.js 版本不低于 22.0.0，版本过低时 npm 全局安装和运行都会失败。

   node -v

   复制

2. 2全局安装 CLI

   通过 npm 全局安装官方发布的 OpenClaude 包，安装过程需要联网。Arch Linux 用户也可改用 AUR 包 paru -S openclaude。

   npm install -g @gitlawb/openclaude@latest

   复制

3. 3验证安装版本

   查看已安装的版本号，同时可对比 npm 上的最新 dist-tags，确认是否需要升级。

   openclaude --version
   npm view @gitlawb/openclaude dist-tags

   复制

4. 4配置 OpenAI 密钥

   macOS / Linux 下通过导出环境变量接入 OpenAI 兼容接口，把 sk-your-key-here 换成你自己的真实密钥。

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

   复制

5. 5配置 OpenAI(PowerShell

   Windows PowerShell 下的等价写法，环境变量仅在当前会话生效，新开窗口需重新设置。

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

   复制

6. 6启动 OpenClaude

   直接运行命令进入终端交互界面，即可使用提示词、工具、agents、MCP 与斜杠命令。

   openclaude

   复制

7. 7可选：接入本地 Ollama

   把 OpenAI 兼容地址指向本机 Ollama 服务并使用本地模型，无需云端密钥。

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

   复制

关键配置

如何确认成功

运行 openclaude --version 能输出已安装版本号；再执行 openclaude 能正常进入终端交互界面即表示成功。

常见问题

注意事项

• npm 安装与运行时要求 Node.js >= 22.0.0，Bun 仅源码构建和本地开发需要，普通用户无需安装。
• 环境变量方式设置的密钥只在当前终端会话有效，关闭窗口后需重新导出。
• 示例密钥 sk-your-key-here 必须替换成你自己的真实密钥，切勿直接使用。
• Windows PowerShell 与 macOS/Linux 的环境变量语法不同，请按对应系统选择命令。