开发过程手册：Claude Code + DeepSeek V4 配置与 Git 网络问题处理

1. 目标与环境

• 目标：在 VS Code 中使用 Claude Code 插件，后端模型切换为 DeepSeek V4（性价比高，兼容 Anthropic API）。

• 环境：

  • 操作系统：Ubuntu (Linux)

  • VS Code 版本 ≥ 1.98.0

  • 已安装 Claude Code for VS Code 扩展

  • 拥有 DeepSeek API Key（从 platform.deepseek.com 获取）

  这一步默认配置过Claude Code CLI，可参考deepseek文档

   #安装Claude-code
   npm install -g @anthropic-ai/claude-code
   #校验安装情况（输出版本号即可）
   claude --version

---

2. Claude Code 接入 DeepSeek V4 配置步骤

2.1 安装claude code for vscode插件

扩展直接搜索即可

2.2 获取 DeepSeek API Key

1. 访问 DeepSeek API 开放平台，注册/登录。

2. 进入控制台，创建 API Key，复制保存（只显示一次，注意保管）。

2.2 修改 VS Code 的 settings.json

方法：通过命令面板打开用户设置 JSON 文件。

• 按 Ctrl+Shift+P

• 输入 Preferences: Open User Settings (JSON)，回车

添加以下配置（替换 你的DeepSeek_API_Key 为真实 Key）：

 {
     // 你原有的其他配置保持不变 ...
     "claudeCode.preferredLocation": "panel",   // 可选：显示位置 panel/sidebar
 ​
     "claudeCode.environmentVariables": [
         {
             "name": "ANTHROPIC_BASE_URL",
             "value": "https://api.deepseek.com/anthropic"
         },
         {
             "name": "ANTHROPIC_AUTH_TOKEN",
             "value": "你的DeepSeek_API_Key"   // 换成自己在平台拿到的key
         },
         {
             "name": "ANTHROPIC_MODEL",
             "value": "deepseek-v4-pro"
         },
         {
             "name": "ANTHROPIC_SMALL_FAST_MODEL",
             "value": "deepseek-v4-flash"
         }
     ],
     "claudeCode.selectedModel": "deepseek-v4-pro" //默认使用的模型
 }

注意：ANTHROPIC_MODEL 为主模型，ANTHROPIC_SMALL_FAST_MODEL 为轻量模型。selectedModel 可单独指定默认模型。

2.3 重启 VS Code

• 完全退出 VS Code（Mac Cmd+Q，Windows 关闭所有窗口并确认进程退出）。

• 重新打开 VS Code。

2.4 验证配置

• 打开 Claude Code 面板（左侧活动栏橘色图标 → 开始新会话）。

• 输入：“你当前使用的是哪个模型？”

• 预期回答：deepseek-v4-pro 或 deepseek-v4-flash。

• 也可问：“你是谁开发的模型？” → 应回答 DeepSeek。

---

3. 模型切换（pro ↔ flash）

3.1 永久切换为 flash（省钱模式）

修改 settings.json：

• 将 "claudeCode.selectedModel" 改为 "deepseek-v4-flash"

• 可选：将环境变量中的 ANTHROPIC_MODEL 也改为 deepseek-v4-flash 保存并重启 VS Code。

3.2 临时切换（仅当前终端会话）

在 VS Code 内置终端中执行：

 export ANTHROPIC_MODEL="deepseek-v4-flash"
 claude

关闭终端后恢复原配置。

3.3 两种模型的选择建议

模型	特点	适用场景
deepseek-v4-pro	推理强，质量高	复杂代码生成、重构、调试
deepseek-v4-flash	速度快，成本低	简单问答、补全、解释

---

4. Claude Code 界面显示问题

4.1 现象

Claude Code 以独立编辑器框显示，而非侧边栏。

4.2 解决方案

• 移动到侧边栏：命令面板执行 Claude Code: Open in Side Bar。

• 或修改设置：settings.json 中设置 "claudeCode.preferredLocation": "sidebar"。

• 切换终端模式：设置 "claudeCode.useTerminal": true 可将界面改到集成终端（命令行模式）。