DeepSeek (Archive)

Archived original-language source from the legacy CrabClaw docs. This page is intentionally not machine-translated.

DeepSeek 是一家专注于 AGI 研究的中国 AI 公司，推出了 DeepSeek-V3 和 DeepSeek-R1 等模型系列，在代码生成、数学推理和多语言理解方面表现出色。

模型概览

模型	类型	上下文窗口	特点
`deepseek-v4`	下一代旗舰	—	即将推出，敬请期待
`deepseek-chat`（V3）	通用对话	64K	高性价比通用模型，MoE 架构
`deepseek-coder`（V3）	代码生成	64K	代码补全、生成、调试
`deepseek-reasoner`（R1）	深度推理	64K	链式思维推理，数学/逻辑任务

方式 A：DeepSeek API Key

适用场景： 直接 API 访问，按量计费（价格极具竞争力）。

从 DeepSeek 开放平台获取 API Key。

CLI 设置

bash

crabclaw onboard --auth-choice deepseek-api-key
# 或非交互模式
crabclaw onboard --deepseek-api-key "$DEEPSEEK_API_KEY"
crabclaw onboard --auth-choice deepseek-api-key
# 或非交互模式
crabclaw onboard --deepseek-api-key "$DEEPSEEK_API_KEY"

配置示例

json5

{
  env: { DEEPSEEK_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "deepseek/deepseek-chat" } } },
  models: {
    mode: "merge",
    providers: {
      deepseek: {
        baseUrl: "https://api.deepseek.com/v1",
        apiKey: "${DEEPSEEK_API_KEY}",
        api: "openai-completions",
        models: [
          {
            id: "deepseek-chat",
            name: "DeepSeek V3",
            reasoning: false,
            input: ["text"],
            contextWindow: 65536,
            maxTokens: 8192,
          },
          {
            id: "deepseek-coder",
            name: "DeepSeek Coder V3",
            reasoning: false,
            input: ["text"],
            contextWindow: 65536,
            maxTokens: 8192,
          },
          {
            id: "deepseek-reasoner",
            name: "DeepSeek R1",
            reasoning: true,
            input: ["text"],
            contextWindow: 65536,
            maxTokens: 8192,
          },
        ],
      },
    },
  },
}
{
  env: { DEEPSEEK_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "deepseek/deepseek-chat" } } },
  models: {
    mode: "merge",
    providers: {
      deepseek: {
        baseUrl: "https://api.deepseek.com/v1",
        apiKey: "${DEEPSEEK_API_KEY}",
        api: "openai-completions",
        models: [
          {
            id: "deepseek-chat",
            name: "DeepSeek V3",
            reasoning: false,
            input: ["text"],
            contextWindow: 65536,
            maxTokens: 8192,
          },
          {
            id: "deepseek-coder",
            name: "DeepSeek Coder V3",
            reasoning: false,
            input: ["text"],
            contextWindow: 65536,
            maxTokens: 8192,
          },
          {
            id: "deepseek-reasoner",
            name: "DeepSeek R1",
            reasoning: true,
            input: ["text"],
            contextWindow: 65536,
            maxTokens: 8192,
          },
        ],
      },
    },
  },
}

DeepSeek 作为回退

适用场景： Opus 为主力，DeepSeek 作为经济型故障转移。

json5

{
  env: { DEEPSEEK_API_KEY: "sk-..." },
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": { alias: "opus" },
        "deepseek/deepseek-chat": { alias: "deepseek" },
      },
      model: {
        primary: "anthropic/claude-opus-4-6",
        fallbacks: ["deepseek/deepseek-chat"],
      },
    },
  },
}
{
  env: { DEEPSEEK_API_KEY: "sk-..." },
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": { alias: "opus" },
        "deepseek/deepseek-chat": { alias: "deepseek" },
      },
      model: {
        primary: "anthropic/claude-opus-4-6",
        fallbacks: ["deepseek/deepseek-chat"],
      },
    },
  },
}

注意事项

模型引用格式为 deepseek/<model>。
DeepSeek API 兼容 OpenAI 格式，使用 openai-completions API 类型。
DeepSeek-R1 支持链式思维推理，设置 reasoning: true。
参见模型供应商概念了解供应商规则。
使用 crabclaw models list 和 crabclaw models set deepseek/deepseek-chat 切换模型。