【AI入门知识点】告别繁琐配置!Claude Code + DeepSeek 直连方案打造最强 VSCode 编程助手
在 AI 编程领域,Claude Code 凭借其强大的 Agent 能力(自动读写文件、执行命令)一直是开发者的梦中情“器”。然而,官方 API 的高昂费用和网络限制,让许多国内开发者望而却步。
这篇文章我们不通过 cc-switch 转发请求的方案,而是使用 Claude Code 官方提供了更直接、更高效的原生配置方式!利用 DeepSeek 官方兼容 Anthropic 的接口,我们无需任何第三方转发工具,仅需修改一个配置文件,即可在 VSCode 中完美运行。
这套方案不仅省去了中间代理的不稳定因素,还能让你直接享受 DeepSeek 极具竞争力的价格。今天,就让我们一起来解锁这个**“直连流”**的高性价比 AI 编程环境搭建指南!
✨ 方案优势:为什么选择原生配置?
* 零额外依赖:无需安装 cc-switch 或其他代理软件,系统更纯净。
* 连接更稳定:减少了本地代理转发的中间环节,降低报错概率。
* 配置更简单:只需修改 JSON 文件,无需图形化界面操作。
🛠️ 准备工作
在开始之前,请确保你已具备以下条件:
* Node.js 环境(用于运行 Claude Code CLI)。
* VSCode 编辑器。
* DeepSeek API Key(获取方式见下文)。
第一步:获取 DeepSeek API Key
1. 访问 DeepSeek 开放平台 并登录。https://platform.deepseek.com/
2. 进入控制台,点击左侧菜单的 “API keys”。
3. 点击 “创建新的 API Key”,复制生成的密钥(以 sk- 开头)。
* Tip:建议首次充值 10-20 元,对于个人日常开发调试来说,这笔费用足够使用数月甚至更久。
第二步:安装 Claude Code CLI
打开终端(Terminal),执行以下命令全局安装 Claude Code 命令行工具:
npm install -g @anthropic-ai/claude-code
安装完成后,输入 claude --version 验证是否安装成功。
第三步:创建核心配置文件(关键步骤!)
这是本教程的核心所在。我们需要在用户主目录下创建一个特定的配置文件,告诉 Claude Code 去连接 DeepSeek 的服务器。
1. 创建文件夹:
在你的用户主目录(Windows 通常是 C:\Users\你的用户名\,Mac/Linux 是 /Users/你的用户名/ 或 ~/)下,创建一个名为 .claude 的隐藏文件夹。
2. **创建文件**:
在 .claude 文件夹内,新建一个名为 settings.json 的文件。
3. **写入配置**:
将以下代码复制到 settings.json 中,并将 <你的DeepSeek_API_Key> 替换为你在第一步复制的实际密钥。
{
"env": {
"ANTHROPIAN_AUTH_TOKEN": "sk-你的DeepSeek_API_Key",
"ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
"ANTHROPIC_MODEL": "deepseek-v4-pro[1m]",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro[1m]",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro[1m]",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
"CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash",
"API_TIMEOUT_MS": "600000",
"CLAUDE_CODE_EFFORT_LEVEL": "max"
}
}
配置项详解:
* ANTHROPIC_BASE_URL: 指向 DeepSeek 的 Anthropic 兼容接口地址。
* ANTHROPIC_MODEL: 指定默认使用的模型,这里设置为 DeepSeek 的主力模型 deepseek-v4-pro[1m]。
* ANTHROPIC_DEFAULT_HAIKU_MODEL: 将轻量级模型映射为 deepseek-v4-flash,用于快速响应,提升交互流畅度。
第四步:VSCode 插件安装与最终配置
1. 打开 VSCode,前往扩展商店搜索 Claude Code,安装由 Anthropic 官方发布的插件。
2. 打开 VSCode 的设置(Ctrl + ,),搜索 Claude Code: Environment Variables。
3. 点击 “在 settings.json 中编辑”,添加以下内容以确保插件读取本地配置:
"claudeCode.environmentVariables": {
"ANTHROPIC_AUTH_TOKEN": "ignored",
"ANTHROPIC_BASE_URL": "ignored"
}
注:这里填写 "ignored" 是为了防止 VSCode 插件试图连接官方服务器,强制它去读取我们刚才创建的全局 .claude/settings.json 文件。
🚀 验证与使用
一切就绪!重启 VSCode,按下快捷键(默认 Ctrl + U)唤起 Claude Code 面板。
输入指令:“请写一个 Python 函数,用于计算斐波那契数列的第 n 项。”
如果 AI 能够迅速生成代码且无报错,恭喜你!你已经成功拥有了一个免费(低成本)、高速、功能完整的 AI 编程搭档。
💡 常见问题排查
* 报错 Authentication Fails 或 Governor 拦截:
* 请检查 API Key 是否复制正确,且没有过期。
* 检查 settings.json 文件的路径是否正确(必须在用户主目录下的 .claude 文件夹中)。
* 确保 DeepSeek 账户余额充足或有可用额度。
* 模型找不到(Model Not Found):
* DeepSeek 的模型名称可能会随官方更新而变化。如果报错提示模型不存在,请前往 DeepSeek 官网文档核对最新的模型名称(如 deepseek-coder 系列或其他新命名规则),并更新配置文件。
* Windows 下无法创建 .claude 文件夹:
* 如果系统提示文件夹名称不能为空,可以尝试在资源管理器地址栏直接输入完整路径 C:\Users\你的用户名\.claude 并回车创建;或者使用命令行 mkdir .claude 创建。
这套方案省去了中间层,是目前连接 DeepSeek 使用 Claude Code 最为优雅的方式。快去体验丝滑的 AI 编程吧!
AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。
更多推荐

所有评论(0)