Claude Code 接入 DeepSeek API：打造低成本终端AI编程助手

🚀 30+款热门AI模型一站整合，DeepSeek/GLM/Claude 随心用，限时 5 折。 👉 点击领海量免费额度

最近在终端里写代码时，你是否也渴望一个能理解上下文、直接帮你生成代码片段、解释复杂逻辑甚至搜索最新文档的智能助手？Claude Code 正是这样一个运行在终端里的 AI 编程伙伴。而 DeepSeek 作为国内顶尖的 AI 模型服务商，提供了强大且极具性价比的 API。将两者结合，你就能在本地终端里，以极低的成本，享受到媲美顶级商业 AI 的编程辅助体验。

本文将从零开始，手把手带你完成 Claude Code 的安装，并成功将其接入 DeepSeek API。无论你是前端、后端还是全栈开发者，这套组合都能显著提升你的日常编码效率。我们将覆盖从环境准备、安装配置、基础使用到高级技巧的全流程，并附上完整的配置文档和常见问题排查指南，确保你能一次成功，快速上手。

1. 背景与核心概念：为什么选择 Claude Code + DeepSeek？

在深入安装步骤之前，我们有必要先厘清几个核心概念，理解这个技术组合能为我们带来什么价值。

Claude Code是由 Anthropic 公司推出的一款命令行 AI 代码助手。它不是一个独立的桌面应用，而是一个通过 npm 安装的全局命令行工具。安装后，你可以在任何终端窗口中，通过输入claude命令来启动一个交互式会话。它的强大之处在于能“看见”你当前终端的工作目录、文件内容，并能根据你的自然语言指令，执行编写代码、解释代码、重构、调试、搜索等任务。它就像一个坐在你身边的资深程序员，随时准备回答你的技术问题。

DeepSeek则是深度求索公司推出的高性能 AI 大模型。其 API 服务不仅提供了与 Claude、GPT 等模型相媲美的代码生成和理解能力，更关键的是，它对开发者非常友好：提供了清晰的官方文档、稳定的服务以及极具竞争力的价格。更重要的是，DeepSeek API 完全兼容 Anthropic 的 API 协议。这意味着，所有设计用于调用 Claude API 的工具（包括 Claude Code），只需简单地修改 API 的接入地址（Base URL）和密钥（API Key），就能无缝切换到 DeepSeek 的模型上运行。

两者的结合优势：

1. 成本效益：使用 DeepSeek API 通常比直接使用原版的 Claude API 成本更低。
2. 本地化与速度：对于国内开发者，访问 DeepSeek API 的网络延迟可能更低，响应更迅速。
3. 功能无损：DeepSeek 官方文档明确指出，其 API 原生支持 Claude Code 的 Web Search（网络搜索）等高级功能。
4. 开发体验：你无需改变使用 Claude Code 的习惯，就能享受到另一个强大模型的支持。

简单来说，这个方案让你用更少的钱，在熟悉的终端工具里，获得顶级的 AI 编程辅助能力。接下来，我们就开始实战。

2. 环境准备与前置条件

在开始安装之前，请确保你的开发环境满足以下要求。这是保证后续步骤顺利进行的基础。

2.1 操作系统

本文教程覆盖三大主流操作系统：

• macOS(10.15 Catalina 或更高版本)
• Linux(主流的发行版如 Ubuntu 20.04+, CentOS 7+ 等)
• Windows(10 或 11，并推荐使用 Windows Terminal, PowerShell 或 Git Bash)

2.2 Node.js 与 npm

Claude Code 是一个 Node.js 包，因此必须预先安装 Node.js 运行环境和其包管理器 npm。

• 版本要求：Node.js 版本需要18.0.0或更高。这是 Claude Code 运行的最低要求。
• 如何检查：打开你的终端（Windows 用户打开 PowerShell 或 CMD），输入以下命令：

  node --version npm --version

• 如何安装：
  • 如果未安装或版本过低，请访问 Node.js 官网 下载并安装最新的 LTS（长期支持）版本。安装程序会自动包含 npm。

2.3 (仅 Windows 用户) Git for Windows

Windows 系统在通过 npm 安装某些包含原生依赖的包时，可能需要 Git。为了确保安装过程万无一失，建议 Windows 用户提前安装 Git for Windows。

• 下载安装：访问 Git for Windows 官网 下载安装程序，按照默认选项安装即可。
• 安装后，你可以使用随 Git 一同安装的Git Bash终端来执行后续的 Linux/Mac 风格命令，也可以继续使用 PowerShell。

2.4 DeepSeek API 密钥

这是接入 DeepSeek 服务的“通行证”。你需要在开始配置前获取它。

1. 访问 DeepSeek 开放平台 。
2. 注册并登录你的账号。
3. 在控制台界面，找到“API Keys”或“密钥管理”相关页面。
4. 点击“创建新的 API Key”。建议为 Claude Code 单独创建一个，并做好备注。
5. 创建成功后，立即复制并妥善保存这个密钥字符串。页面关闭后将无法再次查看完整密钥，只能重新创建。

安全提示：API Key 是访问你账户资源和计费的凭证，请像保护密码一样保护它，不要泄露在公开的代码仓库、截图或论坛中。

3. 安装 Claude Code

环境准备就绪后，我们开始安装 Claude Code 本身。整个过程通过一行命令即可完成。

3.1 执行安装命令

打开你的终端（Windows 用户可使用 PowerShell、CMD 或 Git Bash），输入以下命令：

npm install -g @anthropic-ai/claude-code

命令解释：

• npm install：Node.js 的包安装命令。
• -g：全局安装标志。加上这个参数，Claude Code 将被安装到系统全局路径，让你可以在任何目录下直接使用claude命令。
• @anthropic-ai/claude-code：Claude Code 在 npm 官方仓库中的包名。

安装过程：执行命令后，npm 会自动从网络下载 Claude Code 及其所有依赖包。根据你的网络状况，这可能需要几十秒到几分钟。请耐心等待，直到命令行提示安装成功。

3.2 验证安装

安装完成后，为了确认 Claude Code 已正确安装并可用，请运行版本检查命令：

claude --version

如果安装成功，终端会显示类似claude-code/1.0.0的版本号信息。这表明claude命令已经成功注册到你的系统路径中。

常见安装问题：

• 权限错误 (EACCES)：在 Linux 或 Mac 上，如果遇到权限错误，通常是因为 npm 的全局安装目录权限问题。有两种解决方案：
  1. 使用节点版本管理器 (推荐)：使用nvm或fnm来管理 Node.js，它们会配置无权限问题的安装路径。
  2. 修改 npm 全局目录权限：可以执行sudo npm install -g @anthropic-ai/claude-code使用管理员权限安装，但这可能带来安全风险，不推荐。
• 网络超时或缓慢：由于 npm 源在国外，国内用户可能会遇到下载慢或失败的情况。可以尝试切换为国内镜像源，例如淘宝镜像：

  npm config set registry https://registry.npmmirror.com npm install -g @anthropic-ai/claude-code

4. 配置环境变量以接入 DeepSeek

安装好 Claude Code 后，它默认会尝试连接官方的 Claude API。我们的核心步骤就是通过设置系统环境变量，“告诉” Claude Code 转而使用 DeepSeek 的 API 服务和模型。

环境变量的配置方式因操作系统而异。请根据你的系统选择对应的操作。

核心环境变量说明：

• ANTHROPIC_BASE_URL：将 API 请求的基地址指向 DeepSeek 的 Anthropic 兼容端点。
• ANTHROPIC_AUTH_TOKEN：填入你在 DeepSeek 平台获取的 API Key，用于身份验证。
• ANTHROPIC_MODEL/ANTHROPIC_DEFAULT_OPUS_MODEL等：指定要使用的 DeepSeek 模型。DeepSeek 提供了不同能力和价位的模型供选择。

4.1 针对 Linux 和 macOS 用户的配置

在 Linux 或 macOS 的终端中，你可以通过export命令来设置临时环境变量（仅对当前终端会话有效）。对于长期使用，建议将配置写入 shell 的启动文件（如~/.bashrc,~/.zshrc）。

方法一：临时设置（重启终端后失效）直接在终端中逐行执行以下命令，请将<your DeepSeek API Key>替换为你自己的密钥。

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic export ANTHROPIC_AUTH_TOKEN=sk-your-actual-deepseek-api-key-here export ANTHROPIC_MODEL=deepseek-v4-pro export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash export CLAUDE_CODE_EFFORT_LEVEL=max

方法二：永久设置（推荐）将上述export命令添加到你的 shell 配置文件中，这样每次打开新终端都会自动生效。

1. 使用文本编辑器打开配置文件。如果你使用 Zsh（macOS Catalina 及以后版本的默认 shell），文件是~/.zshrc；如果使用 Bash，文件是~/.bashrc或~/.bash_profile。

   # 例如，使用 nano 编辑器打开 .zshrc nano ~/.zshrc

2. 在文件的末尾，添加上述所有export行。
3. 保存并退出编辑器（在 nano 中，按Ctrl+X，然后按Y确认，再按回车）。
4. 让配置立即生效，执行：

   source ~/.zshrc # 如果你修改的是 .zshrc # 或者 source ~/.bashrc

4.2 针对 Windows 用户的配置

Windows 系统的环境变量设置方式与类 Unix 系统不同。

方法一：在 PowerShell 中临时设置在当前打开的 PowerShell 会话中执行以下命令。同样，请替换<your DeepSeek API Key>。

$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic" $env:ANTHROPIC_AUTH_TOKEN="sk-your-actual-deepseek-api-key-here" $env:ANTHROPIC_MODEL="deepseek-v4-pro" $env:ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-pro" $env:ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-pro" $env:ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash" $env:CLAUDE_CODE_SUBAGENT_MODEL="deepseek-v4-flash" $env:CLAUDE_CODE_EFFORT_LEVEL="max"

这种方式设置的环境变量只在当前 PowerShell 窗口有效。

方法二：在系统设置中永久设置（推荐）

1. 在 Windows 搜索栏输入“环境变量”，选择“编辑系统环境变量”。
2. 在弹出的“系统属性”窗口中，点击右下角的“环境变量(N)...”按钮。
3. 在“用户变量”或“系统变量”区域（建议用户变量），点击“新建...”。
4. 逐个添加上述变量。例如：
   • 变量名：ANTHROPIC_BASE_URL
   • 变量值：https://api.deepseek.com/anthropic
5. 重复步骤 3-4，添加ANTHROPIC_AUTH_TOKEN、ANTHROPIC_MODEL等所有变量。
6. 点击“确定”保存所有更改。
7. 重要：你需要完全关闭并重新打开PowerShell 或 CMD 终端，新的环境变量才会生效。

4.3 模型选择与配置解释

在配置中，我们指定了两种模型：

• deepseek-v4-pro：这是 DeepSeek 的高性能模型，对应 Claude 的 Opus/Sonnet 级别，擅长复杂推理和代码生成。我们将其设为主要和默认模型。
• deepseek-v4-flash：这是更轻量、更经济的模型，对应 Claude 的 Haiku 级别，响应速度更快，适合简单的代码补全和问答。我们将其设为子代理模型。

CLAUDE_CODE_EFFORT_LEVEL=max这个变量告诉 Claude Code 在解决问题时投入最大努力，进行更深层次的思考和分析。

5. 启动与基础使用

配置完成后，就可以开始体验 AI 编程助手了。

5.1 启动 Claude Code 会话

1. 打开你的终端。
2. 导航到你想要进行编码工作的项目目录。这是非常重要的一步，因为 Claude Code 会读取当前目录的上下文。

   cd /path/to/your/project

3. 输入启动命令：

   claude

4. 如果一切配置正确，终端会显示 Claude Code 的欢迎界面，并出现一个提示符（通常是>），等待你输入指令。

5.2 进行第一次对话

现在，你可以像与一个程序员同事聊天一样，向 Claude Code 提问或下达指令。例如：

• 解释代码：你可以输入Explain this Python function:然后粘贴一段代码。
• 生成代码：Write a Python function to calculate the factorial of a number.
• 重构代码：Refactor this code to be more Pythonic:后接代码。
• 搜索网络：Help me find the latest best practices for React state management in 2024.（注意：此功能会触发 Web Search，可能产生额外 API 调用和费用）。

Claude Code 会分析你的问题，结合当前目录的文件上下文（如果你在项目目录中），生成回答或代码。回答会直接显示在终端里。

5.3 常用交互命令

在 Claude Code 会话中，除了直接输入问题，还有一些特殊的命令：

• /help：查看所有可用的命令列表。
• /clear或Ctrl+L：清空当前终端屏幕。
• /exit或Ctrl+D：退出 Claude Code 会话。
• Ctrl+C：中断模型正在进行的回复生成。

6. 高级功能与使用技巧

掌握了基础使用后，下面是一些能让你效率倍增的高级技巧和功能详解。

6.1 利用 Web Search 获取最新信息

这是 DeepSeek API 原生支持的一个强大功能。当你的问题涉及需要最新知识（如库的版本更新、近期技术动态）时，Claude Code 可以自动调用网络搜索。

如何使用： 直接提出需要最新信息的问题即可。例如：

What are the new features in Python 3.12?

Claude Code 识别到该问题需要最新资料，会自动触发 Web Search 工具，通过 DeepSeek API 进行搜索并总结答案。

费用提示：根据 DeepSeek 官方文档，触发 Web Search 会产生额外的 LLM API 调用，用于总结搜索到的内容，因此会产生额外的 token 费用。在非必要时，可以避免提出过于开放、依赖实时信息的问题来控制成本。

6.2 模型映射机制

DeepSeek 为兼容 Claude 生态，设计了一套智能的模型映射。当你或某些集成工具（如 Claude Desktop APP 的开发者模式）尝试请求特定的 Claude 模型时，DeepSeek API 会自动将其映射到对应的自有模型上：

• 请求的模型名以claude-opus开头 → 映射到deepseek-v4-pro
• 请求的模型名以claude-haiku或claude-sonnet开头 → 映射到deepseek-v4-flash

这意味着，即使某些工具硬编码了 Claude 的模型名，你通过修改BASE_URL指向 DeepSeek，也能顺利使用 DeepSeek 的模型，兼容性非常好。

6.3 在具体项目上下文中工作

Claude Code 的核心优势之一是“上下文感知”。启动时所在的目录决定了它能“看到”哪些文件。

• 代码生成与修改：你可以说“在当前目录下创建一个utils.py文件，包含一个处理日期的函数”，它会理解“当前目录”并生成相应路径的代码。
• 代码审查：你可以让它“Review thesrc/main.jsfile and suggest improvements”，它会读取该文件并给出建议。
• 理解项目结构：你可以询问“What is the overall structure of this project?”，它会基于当前目录的文件列表进行分析。

为了获得最佳体验，务必在启动claude命令前，通过cd命令进入你的项目根目录。

6.4 与 VS Code 或 Cursor 等编辑器配合

虽然 Claude Code 运行在终端，但它与编辑器可以形成完美互补。

1. 终端操作：在 Claude Code 中生成复杂的代码逻辑、脚本或进行高层次设计讨论。
2. 编辑器粘贴：将生成的代码直接粘贴到 VS Code 或 Cursor 的编辑器中。
3. 反向操作：将编辑器里看不懂的代码片段复制到 Claude Code 终端请求解释。

你也可以探索一些社区项目，它们旨在将 Claude Code 更深度的集成到编辑器中，但本文聚焦于终端核心用法。

7. 完整配置文档与参数详解

为了方便查阅和复制，这里提供一份完整的配置清单，并对关键参数做进一步解释。

7.1 环境变量完整清单（Linux/macOS）

将以下内容保存到你的 shell 配置文件（如~/.zshrc）中，并替换your_api_key_here。

# DeepSeek API 端点配置 export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic # 你的 DeepSeek API 密钥 (务必保密！) export ANTHROPIC_AUTH_TOKEN=sk-your_api_key_here # 主模型配置：使用 DeepSeek 的高性能模型 export ANTHROPIC_MODEL=deepseek-v4-pro # 默认模型映射配置（用于兼容性） export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro # 映射 Claude Opus export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro # 映射 Claude Sonnet export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash # 映射 Claude Haiku # Claude Code 特定配置 export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash # 子代理使用轻量模型 export CLAUDE_CODE_EFFORT_LEVEL=max # 设置思考努力程度为最大

7.2 环境变量完整清单（Windows PowerShell）

在 PowerShell 中执行以下命令（临时），或将其转化为批处理脚本，或在系统环境变量中设置。

$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic" $env:ANTHROPIC_AUTH_TOKEN="sk-your_api_key_here" $env:ANTHROPIC_MODEL="deepseek-v4-pro" $env:ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-pro" $env:ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-pro" $env:ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash" $env:CLAUDE_CODE_SUBAGENT_MODEL="deepseek-v4-flash" $env:CLAUDE_CODE_EFFORT_LEVEL="max"

7.3 关键参数深度解析

• ANTHROPIC_BASE_URL：这是实现切换的核心。Anthropic 官方端点是https://api.anthropic.com，我们将其改为 DeepSeek 提供的兼容端点https://api.deepseek.com/anthropic。所有 Claude Code 发出的 API 请求都会转向这里。
• ANTHROPIC_AUTH_TOKEN：DeepSeek API 采用 Bearer Token 认证。令牌必须以sk-开头。环境变量中存储密钥比在命令行中硬编码更安全。
• CLAUDE_CODE_EFFORT_LEVEL：此变量控制 Claude Code 在解决问题时的“思考深度”。设为max会使其进行更全面的分析，生成更高质量的代码和解释，但可能略微增加响应时间。其他可选值可能包括min或medium，具体取决于 Claude Code 版本。
• 模型选择策略：deepseek-v4-pro能力更强但单价更高，deepseek-v4-flash速度更快且更经济。我们的配置将主要任务交给pro，将一些辅助性子任务交给flash，是一种兼顾效果与成本的策略。你可以根据自身需求调整，例如全部使用flash以进一步降低成本。

8. 常见问题与故障排查 (FAQ)

即使按照教程操作，也可能遇到一些问题。以下是常见问题的排查指南。

9. 最佳实践与工程建议

为了长期稳定、高效且经济地使用 Claude Code + DeepSeek 这套组合，遵循以下最佳实践至关重要。

1. API 密钥安全管理

   • 绝不提交：永远不要将包含真实 API Key 的配置文件提交到 Git 等版本控制系统。使用环境变量是首选方案。
   • 使用.env文件（进阶）：对于复杂项目，可以考虑使用dotenv等库从.env文件加载环境变量，并将.env添加到.gitignore中。但注意，Claude Code 是全局工具，从项目.env读取需要额外配置。
   • 定期轮换：定期在 DeepSeek 平台更新 API Key，废弃旧的密钥。

2. 成本控制与用量监控

   • 理解计费：DeepSeek API 按 Token 使用量计费。复杂的代码生成、长上下文对话和 Web Search 都会消耗更多 Token。
   • 设置预算提醒：在 DeepSeek 平台设置用量告警或月度预算，避免意外开销。
   • 善用轻量模型：对于简单的代码补全、语法查询，可以尝试临时将ANTHROPIC_MODEL改为deepseek-v4-flash以节省成本。

3. 提升交互效率

   • 提供清晰上下文：在提问前，用一两句话说明你的项目背景、使用的技术栈和具体目标。
   • 分步解决复杂问题：不要一次性提出一个庞大而模糊的需求。将其拆解成多个小任务，逐步与 Claude Code 协作完成。
   • 利用文件上下文：总是在项目根目录启动 Claude Code，这样它就能引用现有的代码文件，给出的建议会更贴合项目实际。
   • 批判性看待输出：AI 生成的代码可能包含错误、过时的 API 或不安全的写法。务必将其视为“初稿”，进行仔细的审查、测试和重构后再集成到核心项目中。

4. 集成到开发工作流

   • 终端多路复用：使用tmux或screen（Linux/Mac）将 Claude Code 会话保持在后台，随时切换使用。
   • 常用指令模板：将一些常用的、复杂的查询（如“为这个函数生成单元测试”）保存为文本片段，需要时快速粘贴。
   • 与 Git 结合：在提交代码前，可以让 Claude Code 审查git diff的输出，检查潜在问题。

5. 保持更新

   • 更新 Claude Code：定期运行npm update -g @anthropic-ai/claude-code来获取最新功能和修复。
   • 关注 DeepSeek 动态：关注 DeepSeek 官方文档和公告，了解新模型、API 特性、价格调整和最佳实践的变化。

通过本文从概念到实战，从安装到进阶的详细拆解，你应该已经成功在本地搭建了一个强大、经济且高效的 AI 编程助手环境。这套 Claude Code + DeepSeek 的组合，将作为你终端里的一个“超级外脑”，无论是探索新技术、解决棘手的 Bug，还是快速生成项目脚手架，都能提供实实在在的效率提升。关键在于多使用、多实践，并逐步将其融入你个人的开发习惯中。如果在使用过程中遇到新的问题，不妨回头查阅本文的配置详解和故障排查部分，或深入研读 DeepSeek 的官方 API 文档，那里有最权威和最新的信息。

🚀 30+款热门AI模型一站整合，DeepSeek/GLM/Claude 随心用，限时 5 折。 👉 点击领海量免费额度