Claude Code-DeepSeek接入保姆指南

概述

Claude Code是Anthropic官方推出的命令行AI编程代理工具，通过智能体工作流（Agentic Workflow）和MCP协议实现对本地文件系统、API及开发工具链的直接操控。由于网络环境限制，国内用户无法直接访问Anthropic官方API，本文采取了使用国内DeepSeek官方API Key接入方案，帮助开发者构建稳定、高效的AI结对编程工作流。

一、通过DeepSeek API接入

环境要求

• 操作系统：Windows 10/11、macOS 10.15+、Ubuntu 18.04+
• 核心依赖：Node.js 18+ (LTS版本)
• 安装命令：npm install -g @anthropic-ai/claude-code

1. 安装Node.js（包含npm包管理器）
2. 获取DeepSeek API Key（前往DeepSeek开放平台注册并创建）

配置步骤

1. 全局安装Claude Code

#安装命令
npm install -g @anthropic-ai/claude-code
#查看安装的版本
claude -v

2. 创建配置文件

在用户目录下创建 .claude/settings.json 文件：

Windows: C:\Users\你的用户名\.claude\settings.json

配置文件内容：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-你的DeepSeek密钥",
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "API_TIMEOUT_MS":"600000",      
    "ANTHROPIC_MODEL": "deepseek-reasoner",
    "ANTHROPIC_SMALL_FAST_MODEL": "deepseek-reasoner",  
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-reasoner",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-reasoner",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-reasoner",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-reasoner",
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "32000"
  },
  "permissions": {
    "allow": [],
    "deny": []
  },
  "alwaysThinkingEnabled": false
}

参考Deepseek官方的Anthropic API配置

3. 模型配置说明

env 对象 (环境变量配置)

这个部分定义了工具运行时所需的环境变量，主要用于配置与 AI 服务的连接和模型选择。

配置项	解释
ANTHROPIC_AUTH_TOKEN	认证令牌。这是调用 API 所必需的密钥。值 sk-58******************* 是一个被掩码处理的 API Key（通常以 sk- 开头）。******************* 表示这里隐藏了真实密钥的后半部分，出于安全考虑不应明文暴露。
ANTHROPIC_BASE_URL	API 基础 URL。这指定了 AI 服务的具体接入点。这里设置为 https://api.deepseek.com/anthropic，意味着这个工具实际上是通过 DeepSeek 的 API 来使用兼容 Anthropic 格式的模型（如 deepseek-chat 和 deepseek-reasoner）。这是一种常见的做法，通过一个统一的接口来访问不同的大模型提供商。
API_TIMEOUT_MS	API 请求超时时间。单位是毫秒（ms）。这里设置为 600000 ms，即 10 分钟。这是一个非常长的超时时间，表明该工具可能用于处理需要长时间运行的、复杂的代码生成或分析任务，防止在模型“思考”或生成长内容时被过早断开连接。
ANTHROPIC_MODEL	默认主模型。当工具需要一个通用的、平衡的模型时，会使用这里指定的模型。这里设置为 deepseek-chat，即 DeepSeek 的聊天模型。
ANTHROPIC_SMALL_FAST_MODEL	小型快速模型。用于执行简单、快速的任务（如单行代码补全、简短回答），以节省成本和加快响应速度。这里同样指向了 deepseek-chat，可能意味着在当前配置下，没有区分更小或更快的模型，或者 deepseek-chat 本身就被用作默认的快速模型。
ANTHROPIC_DEFAULT_OPUS_MODEL	Opus 级别默认模型。“Opus”是 Anthropic 对其最强大模型的内部代号（如 Claude 3 Opus）。这里映射到 deepseek-reasoner，表明 deepseek-reasoner 被当作是 DeepSeek 系列中最强大、最适合复杂推理任务的模型。当工具需要最强能力时，会调用此模型。
ANTHROPIC_DEFAULT_SONNET_MODEL	Sonnet 级别默认模型。“Sonnet”是 Anthropic 对其平衡性能和成本模型的代号（如 Claude 3 Sonnet）。这里映射到 deepseek-chat，意味着 deepseek-chat 被视为在能力和速度/成本之间的一个良好平衡点。
ANTHROPIC_DEFAULT_HAIKU_MODEL	Haiku 级别默认模型。“Haiku”是 Anthropic 对其最快、最轻量级模型的代号（如 Claude 3 Haiku）。这里同样映射到 deepseek-chat，和 SMALL_FAST_MODEL 情况类似，可能表示没有更小的模型可用，或者统一使用 chat 模型。
CLAUDE_CODE_SUBAGENT_MODEL	Claude 代码子代理模型。当主工具需要委派一个专门的“子任务”（例如，在代码库中查找文件、执行特定命令）给另一个AI代理时，会使用这个模型。这里设置为 deepseek-chat。
CLAUDE_CODE_MAX_OUTPUT_TOKENS	Claude 代码最大输出令牌数。“令牌”（Token）是模型处理文本的基本单位，大约相当于单词的一部分。这里设置为 32000，是一个非常高的上限，允许模型生成非常长的代码文件、详细的文档或复杂的分析报告。这直接关联到 API_TIMEOUT_MS 的长超时设置。

---

permissions 对象 (权限控制)

这个部分用于控制工具可以执行哪些操作。

配置项	解释
allow	允许列表。一个数组，列出了工具被明确允许执行的操作。当前为空数组 []，意味着没有单独允许任何特殊权限。
deny	拒绝列表。一个数组，列出了工具被明确禁止执行的操作。当前为空数组 []，意味着没有单独拒绝任何操作。
综合解读	当两个列表都为空时，通常意味着该工具将使用其内置的默认权限策略。一般来说，为了安全起见，这类工具的默认策略会比较保守，可能会在执行某些敏感操作（如删除文件、执行系统命令）前向用户请求确认。

---

alwaysThinkingEnabled 标志 (功能开关)

配置项	解释
alwaysThinkingEnabled	始终启用思考模式。这是一个布尔值（true/false）开关。 - false (当前值)：表示不总是启用。工具可能会在需要时（例如，面对复杂问题时）才进入一个更深度的“思考”或“规划”模式。 - 如果设为 true：工具可能会对所有请求都默认采用更冗长、更具步骤性的推理过程，即使对于简单问题也是如此，这可能会增加延迟和 token 消耗，但有时能产生更严谨的答案。

4. 低成本配置方案

如需降低成本，可替换为deepseek-chat模型：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-你的DeepSeek密钥",
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "API_TIMEOUT_MS":"600000",
    "ANTHROPIC_MODEL": "deepseek-chat",
    "ANTHROPIC_SMALL_FAST_MODEL": "deepseek-chat",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-reasoner",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-chat",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-chat",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-chat",
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "32000"
  },
  "permissions": {
    "allow": [],
    "deny": []
  },
  "alwaysThinkingEnabled": false
}

5.运行Claude

在powershell中运行如下命令

在powershell中运行
#进入工作目录，选择信任工作目录
cd D:\workReport
#执行claude
claude
#第一次对话
你现在使用的是哪个大模型？

对话答案如下，说明你已经在ClaudeCode中正常配置了Deepseek，下面就可以愉快的工作了。

二、总结

通过官方DeepSeek API Key的配置方案，Claude Code已不仅仅是一个辅助工具，而是具备了初级工程师能力的"数字员工"。它能够理解项目结构、自主排查错误并提交代码，代表了AI编程工具从IDE插件向操作系统级Agent进化的新方向。

---