本文档介绍如何在 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 KeyJSON 格式正确,没有多余的逗号或语法错误
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 中的模型名称是否正确。
配置说明
环境变量说明:
可用模型说明: