博客

DeepSeek Harness 接入 TeamoRouter:DEEPSEEK_BASE_URL 一行配置

快速回答

DeepSeek Harness(dsh)默认把模型请求发到 DeepSeek 官方 API。想换成 TeamoRouter(免代理直连、一个 key 路由多家模型、还能用 deepseek-v4-pro-free 免费档),核心就两步——设两个环境变量:

bash
export DEEPSEEK_API_KEY="sk-teamo-你的Key"
export DEEPSEEK_BASE_URL="https://api.teamorouter.com/v1"

再(可选)指定默认模型:

bash
export DEEPSEEK_DEFAULT_MODEL="deepseek-v4-pro-free"

配完重启 dsh,它就跑在 TeamoRouter 上了。下面拆开讲每一步、为什么这么配,以及容易踩的坑。

三个关键环境变量

DeepSeek Harness 通过环境变量读取模型后端配置。真正需要你关心的只有三个:

变量 作用 值示例
DEEPSEEK_API_KEY 鉴权 Key sk-teamo-xxxxxx
DEEPSEEK_BASE_URL 模型端点 https://api.teamorouter.com/v1
DEEPSEEK_DEFAULT_MODEL 默认模型 ID deepseek-v4-pro-free
  • DEEPSEEK_BASE_URL 是最关键的一行。dsh 默认指向 DeepSeek 官方公开 API;改成 TeamoRouter 后,所有模型请求就走 TeamoRouter 的 OpenAI 兼容端点。注意 /v1——OpenAI SDK 需要它,不带会报 404。
  • DEEPSEEK_API_KEY 用 TeamoRouter 的 Key(sk-teamo- 开头)。不要硬编码进仓库,放环境变量或 .env
  • DEEPSEEK_DEFAULT_MODEL 决定新建会话默认用哪个模型。填 deepseek-v4-pro 用付费 Pro,填 deepseek-v4-pro-free 用每天 200 次的免费档,deepseek-v4-flash-free 同理。

完整配置步骤

1. 拿 Key。TeamoRouter 注册,在控制台创建 API Key(sk-teamo-...)。

2. 写进 shell 配置。 编辑 ~/.zshrc(或 ~/.bashrc):

bash
# DeepSeek Harness → TeamoRouter
export DEEPSEEK_API_KEY="sk-teamo-你的Key"
export DEEPSEEK_BASE_URL="https://api.teamorouter.com/v1"
export DEEPSEEK_DEFAULT_MODEL="deepseek-v4-pro-free"

然后 source ~/.zshrc 让它生效。

3. 重启 dsh 并验证。

bash
npx @deepseek-ai/dsh web

打开 http://127.0.0.1:3080,新建一个会话,给一个能验证模型的任务:

text
用一句话介绍你自己,并告诉我你现在的模型 ID。

如果返回里带 deepseek-v4-pro-free 或你指定的模型,说明路由成功。

为什么要把 dsh 接到 TeamoRouter

默认连官方 API 有几点不便,恰好是 TeamoRouter 解决的:

  1. 免代理直连:国内直连 DeepSeek 官方 API 常有超时、连接重置,TeamoRouter 做了国内优化。
  2. 免费档deepseek-v4-pro-free / deepseek-v4-flash-free 各 200 次/天,够跑一整天的轻量 agent 任务。
  3. 一个 key、多家模型:dsh 内可以在 DeepSeek、Claude、GPT、Gemini 之间切换,不用逐个平台注册充值。
  4. 平价计费:付费 deepseek-v4-pro 是 $1.74/$3.48 平价,没有官方即将上线的峰谷浮动(详见《DeepSeek V4 调价对比》)。

常见踩坑

Q:dsh 起来了但报 404 / 连接失败? 先看 DEEPSEEK_BASE_URL 有没有带 /v1。TeamoRouter 的 OpenAI 兼容端点是 https://api.teamorouter.com/v1,OpenAI SDK 会在后面拼 /chat/completions,漏掉 /v1 会拼成错误地址。

Q:报 401 鉴权失败? Key 没生效或复制不全。echo $DEEPSEEK_API_KEY 确认是 sk-teamo- 开头、无前后空格;确认没有在控制台被删除。

Q:想在会话里临时换模型,不改默认值? 可以。DEEPSEEK_DEFAULT_MODEL 只是默认值,Web UI 的模型选择器里可以逐会话切换 deepseek-v4-prodeepseek-v4-flash 等已配置模型。

Q:付费模型和免费模型怎么切? 免费额度耗尽后,把模型 ID 从 deepseek-v4-pro-free 换成 deepseek-v4-pro 即可——付费模型没有账号级限流,是一字之差的迁移。

Q:环境变量和 .env 哪个优先? dsh 支持仓库根目录的 .env 或进程环境变量。已 export 的环境变量优先;用 .env 时记得把 .env 加进 .gitignore,别把 Key 提交上去。

配好之后,直接在 dsh 里跑 DeepSeek V4 Pro,每天先吃 200 次免费额度,超出再按平价付费。到 TeamoRouter 注册即可开始。

准备好接入了吗?登录控制台 · 购买额度 · 创建 API Key,三步即可开始。
DeepSeek Harness 接入 TeamoRouter:DEEPSEEK_BASE_URL 一行配置 · TeamoRouter