OpenClaude + DeepSeek V4-Pro 配置

roct2026-05-25 11:49

适用系统：macOS 目标：在你的 Mac 上用 OpenClaude（开源 AI 编程助手 CLI）接入 DeepSeek V4-Pro 模型 预计耗时：10 分钟

一、你需要准备什么

项目 说明
一台 Mac 电脑 任何近几年的 Mac 都行
网络 能访问 deepseek.com
终端 打开方式：Command + 空格 → 输入 Terminal → 回车

二、第一步：安装 Node.js

OpenClaude 需要 Node.js 20 或更高版本。

检查是否已安装

打开终端，输入：

bash 复制代码 
node --version

如果显示 v20.x.x 或更高，跳到第三步。如果报错或版本太低，继续往下。

安装 Node.js

方法一：去官网下载安装包（最简单）

  1. 打开浏览器访问 nodejs.org/
  2. 下载 LTS 版本（绿色按钮）
  3. 双击 .pkg 文件，一路点「继续」直到安装完成

方法二：用 Homebrew（如果你装了 brew）

bash 复制代码 
brew install node

安装完后验证：

bash 复制代码 
node --version
npm --version

两个都有输出就 OK。

三、第二步：安装 ripgrep

OpenClaude 依赖 ripgrep 做代码搜索。

由于 Homebrew 默认连接 GitHub，国内网络可能很慢或卡住，建议先设置国内镜像源再安装：

bash 复制代码 
export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.ustc.edu.cn/brew.git"
export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles"
HOMEBREW_NO_AUTO_UPDATE=1 brew install ripgrep

如果你没装 Homebrew，先装它：

bash 复制代码 
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

验证：

bash 复制代码 
rg --version

有输出就行。

四、第三步：安装 OpenClaude

bash 复制代码 
npm install -g @gitlawb/openclaude

等它跑完，验证：

bash 复制代码 
openclaude --version

如果提示 command not found，关掉终端重新打开再试。

五、第四步：获取 DeepSeek API Key

  1. 打开浏览器访问 platform.deepseek.com
  2. 注册账号（支持手机号/邮箱）
  3. 登录后，点左侧菜单「API Keys」
  4. 点「创建 API Key」
  5. 复制生成的 key（类似 sk-xxxxxxxxxxxxxxxx）

⚠️ 这个 key 只显示一次，复制好保存到安全的地方！

六、第五步：配置并启动

方式一：一次性启动（每次打开终端都要输）

bash 复制代码 
export CLAUDE_CODE_USE_OPENAI=1
export OPENAI_BASE_URL=https://api.deepseek.com/v1
export OPENAI_API_KEY=sk-你的key粘贴在这里
export OPENAI_MODEL=deepseek-v4-pro
openclaude

方式二：写入配置文件（推荐，一劳永逸）

这个方式是把环境变量写入你 Mac 的 shell 配置文件，这样每次打开终端都会自动加载，不用重复输入。

配置文件是哪个？

  • 如果你用的是 macOS Catalina (10.15) 或更新系统，默认 shell 是 zsh，配置文件是 ~/.zshrc
  • 如果你用的是老版 macOS，默认 shell 是 bash，配置文件是 ~/.bash_profile
  • ~ 代表你的用户主目录，比如 /Users/你的用户名/

怎么确认你用的是哪个 shell？ 在终端输入：

bash 复制代码 
echo $SHELL
  • 输出 /bin/zsh → 用 ~/.zshrc
  • 输出 /bin/bash → 用 ~/.bash_profile

操作步骤：

  1. 在终端里逐行粘贴执行（以 zsh 为例）：
bash 复制代码 
echo 'export CLAUDE_CODE_USE_OPENAI=1' >> ~/.zshrc
echo 'export OPENAI_BASE_URL=https://api.deepseek.com/v1' >> ~/.zshrc
echo 'export OPENAI_API_KEY=sk-你的key粘贴在这里' >> ~/.zshrc
echo 'export OPENAI_MODEL=deepseek-v4-pro' >> ~/.zshrc
source ~/.zshrc

⚠️ 把 sk-你的key粘贴在这里 替换成你在第四步获取的真实 API Key！

  1. source ~/.zshrc 的作用是让配置立即生效（否则要关掉终端重新打开）

如果你用的是 bash，把上面的 ~/.zshrc 全部换成 ~/.bash_profile：

bash 复制代码 
echo 'export CLAUDE_CODE_USE_OPENAI=1' >> ~/.bash_profile
echo 'export OPENAI_BASE_URL=https://api.deepseek.com/v1' >> ~/.bash_profile
echo 'export OPENAI_API_KEY=sk-你的key粘贴在这里' >> ~/.bash_profile
echo 'export OPENAI_MODEL=deepseek-v4-pro' >> ~/.bash_profile
source ~/.bash_profile

想看看写进去没有？ 可以用这个命令查看文件内容：

bash 复制代码 
cat ~/.zshrc

你应该能在最后几行看到刚才加的 4 行 export。

另一种更直观的方式：直接打开文件编辑（适合不习惯命令行的人）

如果你觉得上面的 echo >> 命令不好理解，可以直接用文本编辑器打开配置文件，把内容粘贴进去：

  1. 在终端输入以下命令，用 VS Code 打开配置文件：
bash 复制代码 
code ~/.zshrc

如果你没装 VS Code，也可以用 Mac 自带的文本编辑器打开：

bash 复制代码 
open -a TextEdit ~/.zshrc

或者用 nano 编辑器（终端内）：

bash 复制代码 
nano ~/.zshrc
  1. 文件打开后，滚动到最底部，在末尾新起一行，粘贴以下 4 行内容：
bash 复制代码 
export CLAUDE_CODE_USE_OPENAI=1
export OPENAI_BASE_URL=https://api.deepseek.com/v1
export OPENAI_API_KEY=sk-你的key粘贴在这里
export OPENAI_MODEL=deepseek-v4-pro

⚠️ 把 sk-你的key粘贴在这里 替换成你的真实 API Key！

  1. 保存文件：

    • VS Code / TextEdit：Command + S
    • nano：Ctrl + O 回车保存，Ctrl + X 退出

  2. 回到终端，让配置生效：

bash 复制代码 
source ~/.zshrc

如果文件不存在（打开是空白的），没关系，直接粘贴进去保存就行，系统会自动创建这个文件。

以后每次打开终端直接输入 openclaude 就能用了。

方式三：用 OpenClaude 内置的 /provider 交互配置

bash 复制代码 
openclaude

进入后输入：

bash 复制代码 
/provider

然后按提示操作：

  1. 选择 OpenAI-compatible
  2. Base URL 填：https://api.deepseek.com/v1
  3. API Key 填：你的 key
  4. Model 填：deepseek-v4-pro
  5. 保存 profile

以后直接 openclaude 启动即可。

七、在 VS Code 中使用（图形界面方式）

OpenClaude 自带 VS Code 扩展，可以直接在 VS Code 里用图形界面操作，不用每次都开终端。

7.1 安装 VS Code 扩展

方法一：从源码安装（OpenClaude 官方扩展）

OpenClaude 的 VS Code 扩展在仓库的 vscode-extension/openclaude-vscode/ 目录下，目前需要手动构建安装：

  1. 克隆仓库：
bash 复制代码 
git clone https://github.com/Gitlawb/openclaude.git
cd openclaude/vscode-extension/openclaude-vscode
  1. 安装依赖并构建：
bash 复制代码 
npm install
npm run build
  1. 打包成 .vsix 文件：
bash 复制代码 
npx vsce package
  1. 在 VS Code 中安装：
    • 打开 VS Code
    • 按 Command + Shift + P 打开命令面板
    • 输入 Install from VSIX
    • 选择刚才生成的 .vsix 文件
    • 重启 VS Code

方法二：用 VS Code 插件市场的第三方集成插件（更简单）

如果你不想手动构建，可以用市场上已有的兼容插件：

  1. 打开 VS Code
  2. 按 Command + Shift + X 打开扩展面板
  3. 搜索 Claude Code Integration（作者 maskzh）
  4. 点击「安装」

这个插件支持 DeepSeek、OpenRouter 等多种 OpenAI 兼容后端，可以直接在 VS Code 标题栏启动 AI 终端。

7.2 配置 DeepSeek V4-Pro

如果用的是 OpenClaude 官方扩展：

扩展会自动读取你在第五步/第六步配置的环境变量（~/.zshrc 里的那些），所以如果你已经配好了环境变量，直接用就行。

也可以在 VS Code 的设置里配置：

  1. 按 Command + , 打开设置
  2. 搜索 openclaude
  3. 找到 Provider 相关设置，填入：
    • Base URL: https://api.deepseek.com/v1
    • API Key: 你的 key
    • Model: deepseek-v4-pro

如果用的是 Claude Code Integration 插件：

  1. 按 Command + , 打开设置
  2. 搜索 claude code integration
  3. 添加一个 DeepSeek 配置：
    • API Base URL: https://api.deepseek.com/v1
    • API Key: 你的 DeepSeek key
    • Model Name: deepseek-v4-pro

7.3 使用方式

启动 OpenClaude 面板：

  • 按 Command + Shift + P → 输入 OpenClaude → 选择 OpenClaude: Open Panel
  • 或者点击 VS Code 左侧活动栏的 OpenClaude 图标

在面板里你可以：

  • 直接输入自然语言指令（和终端版一样）
  • 看到 AI 正在读取/修改哪些文件
  • 实时预览代码变更的 diff
  • 一键接受或拒绝修改
  • 查看 token 消耗

快捷操作示例：

  1. 选中一段代码 → 右键 → Ask OpenClaude → 输入你的问题
  2. 在编辑器里遇到报错 → 打开 OpenClaude 面板 → 输入「帮我修复当前文件的错误」
  3. 打开一个文件 → 在面板输入「解释这个文件的逻辑」

7.4 VS Code 终端方式（最简单的替代方案）

如果你不想装额外插件，最简单的方式是直接在 VS Code 内置终端里用：

  1. 按 ``Control + ``` 打开 VS Code 内置终端
  2. 输入 openclaude 回车
  3. 开始对话

这种方式和在外部终端用完全一样，但好处是不用切换窗口，AI 可以直接操作你当前打开的项目文件。

八、验证是否成功（终端或 VS Code 均适用）

启动 openclaude 后，输入一句话测试：

复制代码 
你好，请介绍一下你自己

如果收到正常回复，恭喜你，部署成功！

九、使用案例

案例 1：让 AI 帮你写代码

进入你的项目目录，然后启动：

bash 复制代码 
cd ~/my-project
openclaude

输入：

复制代码 
帮我写一个 Vue 3 的登录页面组件，包含用户名、密码输入框和登录按钮

它会直接在你的项目里创建文件。

案例 2：让 AI 修 Bug

bash 复制代码 
我的 src/utils/request.ts 文件里的请求拦截器有问题，token 过期后没有自动刷新，帮我修复

它会读取你的文件，分析问题，然后直接修改。

案例 3：让 AI 解释代码

bash 复制代码 
解释一下 src/apis/useSSEClient.ts 这个文件的逻辑

案例 4：让 AI 写测试

bash 复制代码 
给 src/pages/recordMinutes/hooks/useRecordList.ts 写单元测试

案例 5：让 AI 做代码审查

bash 复制代码 
审查 src/apis/request.ts 的代码质量，指出潜在问题和改进建议

案例 6：批量重构

csharp 复制代码 
把项目里所有用 var 声明的变量改成 const 或 let

案例 7：生成文档

bash 复制代码 
根据 src/apis/ 目录下的所有 API 文件，生成一份 API 接口文档

十、常用命令速查

在 OpenClaude 里输入 作用
/provider 管理模型配置
/help 查看所有可用命令
/clear 清空对话历史
/cost 查看本次会话的 token 消耗
Ctrl + C 中断当前输出
Ctrl + D 或输入 /exit 退出 OpenClaude

十一、费用说明

DeepSeek V4-Pro API 定价（目前有 75% 折扣，截至 2026/05/31）：

项目 原价 折后价
输入 (每百万 token) $1.74 ~$0.435
输出 (每百万 token) $3.48 ~$0.87
缓存命中输入 更低 再打 8-9 折

日常编程使用，一天大概几毛到几块人民币。

十二、常见问题

Q: 提示 EACCES permission denied

bash 复制代码 
sudo npm install -g @gitlawb/openclaude

Q: 提示 401 Unauthorized

API Key 不对，去 platform.deepseek.com 重新生成一个。

Q: 提示 model not found

确认 OPENAI_MODEL 设置的是 deepseek-v4-pro（注意大小写和拼写）。

Q: 响应很慢

DeepSeek V4-Pro 是 1.6T 参数的大模型，首次响应可能需要几秒。如果想要更快的响应，可以换用 deepseek-v4-flash（更快更便宜，但能力稍弱）：

bash 复制代码 
export OPENAI_MODEL=deepseek-v4-flash

Q: 想同时用多个模型怎么办？

用 /provider 保存多个 profile，启动时选择不同的 profile 即可。

十三、更新 OpenClaude

当 OpenClaude 发布新版本时，一行命令即可更新：

bash 复制代码 
npm install -g @gitlawb/openclaude@latest

更新完验证：

bash 复制代码 
openclaude --version

如果更新后遇到问题，可以先卸载再重装：

bash 复制代码 
npm uninstall -g @gitlawb/openclaude
npm install -g @gitlawb/openclaude@latest

十四、卸载

如果不想用了：

bash 复制代码 
npm uninstall -g @gitlawb/openclaude

然后删掉 ~/.zshrc 里加的那几行环境变量。

参考链接

相关推荐
浩风祭月9 小时前
我用 Cursor 把一个订单状态机从 800 行重构到 120 行，且逻辑零差错
前端·后端
风骏时光牛马9 小时前
GraphQL实战避坑代码案例
前端
ZengLiangYi9 小时前
Tailwind CSS v4 + Vite：现代前端样式方案
前端·css·vite
好运常在9 小时前
如何用Python实现办公自动化？
前端
ZC跨境爬虫9 小时前
跟着 MDN 学CSS day_12 ：（值与单位的技能测试与深入理解）
前端·javascript·css·ui·交互
lichenyang4539 小时前
从 AI 聊天组件源码复盘工程化架构：MVVM、解耦、Provider 与 SSE 流式响应
前端
Maimai108089 小时前
TanStack Table 入门：为什么它是 React 表格开发里的“表格引擎”
前端·javascript·react.js·架构·前端框架·reactjs
踩着两条虫9 小时前
VTJ.PRO 开源 AI 低代码引擎深度评测大纲
前端·低代码·开源软件
你听得到1110 小时前
从 Figma 走查到 AI 可验证产物：我如何重构客户端 UI 交付链路
前端·vue.js·flutter
热门推荐
01GitHub 镜像站点02Codex 接入 DeepSeek API 完整配置文档03【踩坑记录 | 第一篇】微软商店无法使用时，如何手动安装 OpenAI Codex？附`.msix`文件系统错误解决方法04裂开！ChatGPT 居然开始要手机号验证，附详细解决方法05CC-Switch & Claude 基于 Linux 服务器安装使用指南06【AI】2026 年具身智能模型和世界模型总结07Codegraph 实战：用知识图谱让 AI 编程效率翻倍08几个好用的ip纯净度检测网站09Cursor 接入 DeepSeek‑V4‑Pro 完整指南（2026 实测）10装上就回不去了：CodeGraph 让 AI 编程效率飙升 92%，它到底做了什么？