Dr. Claw 多模型后端配置教程:Claude Code、Gemini CLI、Codex、OpenRouter 一键接入(新手完整指南)

原创2026-10-14 04:37:121,639 阅读

Dr. Claw 多模型后端配置教程:Claude Code、Gemini CLI、Codex、OpenRouter 一键接入(新手完整指南)

Dr. Claw 是一个开源的多模型 AI 研究工作台(AI Lab / 研究 IDE),让你在一套界面里同时接入 Claude Code、Gemini CLI、Codex 和 OpenRouter 四大模型后端。本教程将带你从零完成 Dr. Claw 多模型后端配置:3 步启动应用、逐个打通每个后端、并在聊天界面自由切换模型——无需订阅、跑在你自己的机器上,数据与 GPU 全部由你掌控。

Dr. Claw 多模型 AI 研究工作台主界面

为什么推荐 Dr. Claw 的多模型后端

很多 AI 工具只能绑定单一模型厂商,而 Dr. Claw 把 Claude Code、Gemini CLI、Codex、OpenRouter 都做成了一等公民:

  • 🧠 四大执行引擎自由切换:不同任务用不同模型,界面随时换
  • 🔑 一个 Key 解锁数百模型:通过 OpenRouter 接入 GPT、Claude、Gemini、DeepSeek、Qwen、Kimi 等
  • 🛠️ 与工具能力对齐:无论选哪个后端,都支持文件读写、Shell、搜索、网页抓取等完整工具调用
  • 📊 覆盖科研全流程:文献调研 → 想法生成 → 实验 → 论文写作 → 成果展示

后端的安装检测与登录状态都集中在 Settings → 智能体 页面管理(见 src/components/Settings.jsx),每个后端独立显示"已登录 / 未安装 / 已断开"状态,配置互不干扰。

快速上手:3 步启动 Dr. Claw

前置条件:Node.js v20 或更高(推荐 v22 LTS)。

第 1 步:零安装启动(推荐)

npx dr-claw

或者全局安装:

npm install -g dr-claw
dr-claw

第 2 步:打开浏览器访问 http://localhost:3001,注册并登录你的账户。

第 3 步:在侧边栏点击齿轮图标打开 Settings,进入 智能体 页签,开始配置下文介绍的后端。

💡 也可以从源码运行(便于二次开发):git clone https://gitcode.com/gh_mirrors/dr/dr-claw 后执行 npm install && npm run dev,完整步骤见 README.zh-CN.md。

逐个接入 4 大模型后端

后端一:接入 Claude Code

步骤 操作
1. 安装 CLI npm install -g @anthropic-ai/claude-code
2. 登录 终端执行 claude,按提示完成 OAuth 授权
3. 界面确认 Settings → 智能体 → Claude 卡片显示"已登录"

如果 claude 不在系统 PATH 中,可在 .env 里指定 CLAUDE_CLI_PATH 指向二进制位置。

后端二:接入 Gemini CLI

步骤 操作
1. 安装 CLI npm install -g @google/gemini-cli
2. 登录 终端执行 gemini 完成 Google 登录,或设置 export GOOGLE_API_KEY=...
3. 界面确认 Settings → 智能体 → Gemini 卡片显示"已登录"

路径异常时可用 GEMINI_CLI_PATH 覆盖默认命令名,全部变量说明见 docs/configuration.zh-CN.md。

后端三:接入 Codex

步骤 操作
1. 安装 CLI npm install -g @openai/codex
2. 登录 codex login,或 export OPENAI_API_KEY=...
3. 界面确认 Settings → 智能体 → Codex 卡片显示"已登录"

⚠️ 使用 Codex 后端时,.env 中的 OPENAI_API_KEY 是应用侧识别密钥的关键变量;CLI 不在默认 PATH 时用 CODEX_CLI_PATH 指定。

后端四:OpenRouter 一个 Key 接入数百模型

OpenRouter 是唯一的"免 CLI 安装"后端——无需任何本地工具,一个 API 密钥即可路由到数百个模型。配置密钥有三种等价方式:

  1. 界面:Settings → OpenRouter,粘贴你的 Key
  2. 环境变量:export OPENROUTER_API_KEY=sk-or-...
  3. .env 文件:写入 OPENROUTER_API_KEY=sk-or-...

设置默认模型:

OPENROUTER_MODEL=moonshotai/kimi-k2.5

不设置时默认为 anthropic/claude-sonnet-4.6。OpenRouter 还支持直接输入任意模型 slug(如 deepseek/deepseek-r1、qwen/qwen3-235b-a22b),内置模型清单定义在 shared/modelConstants.js,相关路由实现在 server/openrouter.js。

Dr. Claw 聊天界面选择 AI 助手与模型

在 Chat 中选择与切换模型

配置完成后,进入任意项目的 Chat 页签:

  1. 在输入框上方的 Choose Your AI Assistant(选择你的 AI 助手)区域,点击目标后端(Claude Code / Gemini / Codex / OpenRouter)
  2. 在下拉框中选择具体模型——OpenRouter 会实时拉取完整模型列表,也支持手动输入自定义模型名
  3. 开始对话即可,界面上会显示"Ready to use ... with {{model}}"提示

切换后端不会影响项目数据,只更换"执行引擎"。此外 Research Lab 的任务执行也可以从 CLI 选择器中选择 Claude Code、Gemini CLI 或 Codex 作为执行后端;Auto Research 无人值守研究同样支持这四类引擎(见 README.zh-CN.md 的 Usage Guide 章节)。

Dr. Claw 项目仪表盘与自动研究

常见问题排查:配置不生效怎么办

  • 🔍 状态显示"未安装 CLI":确认终端能直接运行 claude / gemini / codex;不行就用 *_CLI_PATH 变量指定完整路径
  • 🔄 改了 .env 没生效:系统环境变量优先于 .env,检查是否有同名变量覆盖;改完务必重启应用(加载逻辑见 server/load-env.js)
  • 💬 Shell 标签页报 posix_spawnp failed:执行 npm rebuild node-pty --build-from-source 修复原生模块
  • ⚖️ 权限相关:各后端的权限(允许/禁止的工具、跳过权限提示)在 Settings → 权限 中按提供方独立配置,放宽前请阅读说明
  • 🧾 更多问题:完整"问题 → 原因 → 解决方案"清单见 docs/faq.zh-CN.md

进阶:终端直接跑 OpenRouter 模型

不想开浏览器?Dr. Claw 内置了纯终端的 Agent 会话命令,任意 OpenRouter 模型均可用:

export OPENROUTER_API_KEY=sk-or-...
node server/cli.js chat --model moonshotai/kimi-k2.5

该命令提供与 UI 相同的工具调用能力(文件 I/O、Shell、Grep、Glob、网页搜索/抓取),适合轻量工作流。

Dr. Claw 终端 Agent 会话示例

相关文件与资料导航

内容 路径
中文总文档与快速上手 README.zh-CN.md
完整环境变量参考(.env) docs/configuration.zh-CN.md
故障排查 FAQ docs/faq.zh-CN.md
全量模型定义与默认值 shared/modelConstants.js
后端登录与状态检测界面 src/components/Settings.jsx
OpenRouter 后端路由 server/openrouter.js
终端聊天 CLI server/cli.js

小结

  • ✅ 先 npx dr-claw 启动,再进 Settings → 智能体 逐个验证后端状态
  • ✅ Claude Code / Gemini CLI / Codex 走"安装 CLI + 登录",OpenRouter 只需一个 API Key
  • ✅ Chat 页签的 Choose Your AI Assistant 可随时切换后端与模型
  • ✅ 出问题先查 docs/faq.zh-CN.md 和 docs/configuration.zh-CN.md

按以上步骤走完,你就拥有了一个"模型随心换"的本地 AI 研究工作台——把选型时间省下来,专注研究本身吧 🚀

登录后查看全文
dr-claw