自学教程

Claude Code DeepSeek 配置

Claude Code 教程

Claude Code 默认调用 Anthropic 的 Claude 模型，同时支持自定义接入第三方模型，例如 DeepSeek。通过修改配置，可让 Claude Code 的智能体能力复用 DeepSeek 大模型。

说明：该能力依赖 OpenAI 兼容接口，DeepSeek 提供 OpenAI 格式 API，因此可以接入。

获取 DeepSeek API Key

  1. 打开 DeepSeek 开放平台：https://platform.deepseek.com/
  2. 登录账号，进入 API Keys 页面
  3. 点击创建新密钥，复制生成的 sk-xxxx 密钥
  4. 密钥仅展示一次，请保存好，不要提交到代码仓库

环境变量配置

Claude Code 通过环境变量指定自定义模型地址与密钥。

macOS / Linux / WSL

临时设置（当前终端生效）

export ANTHROPIC_BASE_URL="https://api.deepseek.com/v1"
export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxxxxxxxxxx"
export ANTHROPIC_MODEL="deepseek-chat"

永久配置（zsh，macOS）

echo 'export ANTHROPIC_BASE_URL="https://api.deepseek.com/v1"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxxxxxxxxxx"' >> ~/.zshrc
echo 'export ANTHROPIC_MODEL="deepseek-chat"' >> ~/.zshrc
source ~/.zshrc

永久配置（bash）

echo 'export ANTHROPIC_BASE_URL="https://api.deepseek.com/v1"' >> ~/.bashrc
echo 'export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxxxxxxxxxx"' >> ~/.bashrc
echo 'export ANTHROPIC_MODEL="deepseek-chat"' >> ~/.bashrc
source ~/.bashrc

Windows PowerShell

临时设置

$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/v1"
$env:ANTHROPIC_API_KEY="sk-xxxxxxxxxxxxxxxxxxxx"
$env:ANTHROPIC_MODEL="deepseek-chat"

永久设置（用户环境变量）

[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "[https://api.deepseek.com/v1](https://api.deepseek.com/v1)", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-xxxxxxxxxxxxxxxxxxxx", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "deepseek-chat", "User")

验证配置

新开终端，启动 Claude Code：

claude

成功启动后，后续任务请求会转发到 DeepSeek 接口。

注意：切换模型后，/model 命令不再切换 Claude 系列模型，而是使用你配置的 DeepSeek 模型。

两种模型接入对比

模式模型接口地址计费
默认ClaudeAnthropic 官方地址Anthropic 计费
自定义DeepSeekapi.deepseek.com/v1DeepSeek 单独计费

非交互式调用示例

git diff | claude -p "审查本次代码变更，找出潜在问题"

环境变量存在时，自动使用 DeepSeek 模型执行任务。

常见问题

  1. 401 鉴权失败：检查 API Key 是否复制完整，有无多余空格。
  2. 接口报错：确认 ANTHROPIC_BASE_URL 填写正确，网络可访问 DeepSeek 接口。
  3. 模型不支持工具调用：优先使用 deepseek-chat，部分旧版本模型对工具调用支持较差，会导致 Claude Code 智能体无法正常读写文件、执行命令。
  4. 环境变量不生效：修改环境变量后必须新开终端。

安全提示

  • API Key 不要硬编码写入代码，禁止提交到 Git。
  • 不要将密钥分享给他人，泄露后立刻在 DeepSeek 平台删除密钥。
  • 使用第三方模型，所有项目上下文会发送至 DeepSeek API，请不要上传高度敏感业务代码。
标签：

0 条笔记