Claude Code 配置 DeepSeek API 教程

2026-06-27

本文档介绍如何在 Linux 环境下为 Claude Code 配置 DeepSeek API,以解决登录验证问题。


前置条件

  • 已安装 Node.js 18+

  • 已全局安装 Claude Code:npm install -g @anthropic-ai/claude-code

  • 已在 DeepSeek Platform(https://platform.deepseek.com/)注册并获取 API Key


配置步骤

1. 创建配置文件

在终端中执行以下命令,创建或覆盖 ~/.claude/settings.json 文件:

bash

cat > ~/.claude/settings.json << 'EOF'
{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "替换为你的DeepSeek API Key"
  },
  "availableModels": [
    "deepseek-v4-pro[1m]",
    "deepseek-v4-flash[1m]"
  ]
}
EOF

注意:将 替换为你的DeepSeek API Key 替换为你在 DeepSeek Platform 获取的真实密钥。

2. 验证配置

运行以下命令检查配置文件是否正确写入:

bash

cat ~/.claude/settings.json

需要确认以下几点:

  • 包含 ANTHROPIC_BASE_URL 字段,值为 https://api.deepseek.com/anthropic

  • 包含 ANTHROPIC_AUTH_TOKEN 字段,值为你的真实 API Key

  • JSON 格式正确,没有多余的逗号或语法错误

3. 重启 VS Code

完全退出 VS Code,确保所有进程都已结束,然后重新打开。

之所以需要完全退出,是因为 VS Code 及其插件只在启动时读取环境变量和配置文件,仅重新加载窗口可能无法使配置生效。

4. 测试运行

打开终端,进入你的项目目录,运行 Claude Code:

bash

cd /path/to/your/project
claude

验证成功

如果配置正确,会出现以下情况:

  • 不再弹出官方登录窗口

  • Claude Code 正常启动,可直接进行对话

  • 所有请求通过 DeepSeek API 处理


常见问题排查

仍然弹出登录框

可能原因是 VS Code 设置未关闭登录提示。解决方法:在 VS Code 设置中搜索 claudeCode.disableLoginPrompt 并勾选。

API Key 无效

可能原因是密钥过期或复制错误。解决方法:重新在 DeepSeek Platform 生成新的 API Key。

配置文件未生效

可能原因是未完全重启 VS Code。解决方法:完全退出 VS Code 后重新打开。

模型不可用

可能原因是模型名称错误。解决方法:检查 availableModels 中的模型名称是否正确。


配置说明

环境变量说明:

变量名

作用

当前值

ANTHROPIC_BASE_URL

指定 API 请求的转发地址

https://api.deepseek.com/anthropic

ANTHROPIC_AUTH_TOKEN

DeepSeek API 认证密钥

你的 API Key

可用模型说明:

模型名称

适用场景

deepseek-v4-pro[1m]

主模型,用于复杂推理和编码任务

deepseek-v4-flash[1m]

轻量模型,用于快速响应场景


PREV
linux快速安装claude code,并做国产模型配置