在Windows系统上配置Claude Code使用DeepSeek API的操作指南

Written by

in

文章目录
  • Windows 10/11 系统 PowerShell 5.0 或更高版本 Git(用于版本控制)
  • 目录
    • 环境要求
    • 第一步:安装 Node.js
      • 1.1 下载 Node.js
      • 1.2 安装 Node.js
      • 1.3 验证安装
    • 第二步:安装 Claude Code
      • 2.1 设置执行策略
      • 2.2 安装 Claude Code
      • 2.3 验证安装
    • 第三步:配置 DeepSeek API
      • 3.1 获取 DeepSeek API Key
      • 3.2 设置环境变量(永久生效)
      • 3.3 手动设置(图形界面)
      • 3.4 可用模型
      • 3.5 验证配置
    • 第四步:启动 Claude Code
      • 4.1 基本启动
      • 4.2 继续上次会话
      • 4.3 常用命令
      • 4.4 切换模型
      • 5.2 本地初始化 Git
    • 常见问题
      • Q1: 出现 "Unable to connect to Anthropic services" 错误
      • Q2: npm 安装失败
      • Q3: 如何查看会话历史?
      • Q4: 可以使用其他模型吗?
      • Q5: VS Code 中如何使用?

    本文档详细介绍如何在 Windows 系统上配置 Claude Code 使用 DeepSeek API。

    • Windows 10/11 系统
    • PowerShell 5.0 或更高版本
    • Git(用于版本控制)

    访问 Node.js 官网 下载 LTS 版本(推荐 v18 或更高版本)。

    1. 运行下载的安装程序
    2. 勾选 "Automatically install necessary tools"
    3. 完成安装向导
    4. 重启终端

    node --version
    npm --version

    预期输出:

    v18.x.x
    9.x.x

    如果遇到脚本执行错误,先运行:

    Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

    npm install -g @anthropic-ai/claude-code
    

    claude --version
    

    预期输出:2.1.152 或更高版本

    1. 访问 DeepSeek 官网
    2. 注册/登录账号
    3. 在 API Keys 页面创建新的 API Key
    4. 复制生成的 Key(格式:sk-xxxxxxxx

    打开 PowerShell,运行以下命令(将 YOUR_API_KEY 替换为你的实际 API Key):

    [Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.deepseek.com/anthropic", "User")
    [Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "YOUR_API_KEY", "User")
    [Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "deepseek-v4-flash", "User")
    

    1. Win + R,输入 sysdm.cpl,回车
    2. 点击「高级」→「环境变量」
    3. 在「用户变量」中点击「新建」:
      • 变量名:ANTHROPIC_BASE_URL
      • 变量值:https://api.deepseek.com/anthropic
    4. 重复创建另外两个变量:
      • ANTHROPIC_AUTH_TOKEN = YOUR_API_KEY
      • ANTHROPIC_MODEL = deepseek-v4-flash
    5. 点击「确定」保存
    6. 重启终端

    模型 环境变量值 说明
    DeepSeek-V4-Flash deepseek-v4-flash 快速、经济实惠
    DeepSeek-V4-Pro deepseek-v4-pro 更强推理能力

    Get-ChildItem Env:ANTHROPIC*
    

    应该看到三个环境变量。

    claude
    

    claude --continue
    

    命令 说明
    claude 启动新会话
    claude --continue 继续上次会话
    claude --resume <session> 恢复指定会话
    claude -n "项目名" 命名当前会话
    /quitCtrl+D 退出 Claude Code
    Ctrl+C 强制中断当前操作

    临时切换(当前会话):

    $env:ANTHROPIC_MODEL="deepseek-v4-pro"
    claude
    

    永久切换:

    [Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "deepseek-v4-pro", "User")
    # 重启终端生效
    

    在项目文件夹中打开 PowerShell:

    # 初始化 Git 仓库
    git init
    
    # 配置用户信息(替换为你的信息)
    git config user.name "Your Name"
    git config user.email "your.email@example.com"
    

    添加内容:

    # Claude Code + DeepSeek 配置指南
    
    本文档介绍如何在 Windows 上配置 Claude Code 使用 DeepSeek API。
    
    ## 快速开始
    
    1. 安装 Node.js
    2. 安装 Claude Code:`npm install -g @anthropic-ai/claude-code`
    3. 配置 DeepSeek API 环境变量
    4. 运行 `claude` 开始使用
    
    详见 [完整配置指南](./CLAUDE-CODE-DEEPSEEK-SETUP.md)
    

    原因: 环境变量未正确设置或未生效。

    解决:

    1. 检查环境变量是否设置正确:
    $env:ANTHROPIC_BASE_URL
    $env:ANTHROPIC_AUTH_TOKEN
    $env:ANTHROPIC_MODEL
    1. 如果未显示值,重启终端
    2. 确认 API Key 正确且有效

    解决:

    # 清除 npm 缓存
    npm cache clean --force
    
    # 使用管理员权限重试
    npm install -g @anthropic-ai/claude-code
    

    会话保存在:C:Users<用户名>.claudesessions

    使用以下命令恢复:

    claude --resume <session-id>
    

    可以,只需修改 ANTHROPIC_MODEL 环境变量:

    [Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "deepseek-v4-pro", "User")
    

    在 VS Code 终端中运行:

    $env:ANTHROPIC_BASE_URL = "https://api.deepseek.com/anthropic"
    $env:ANTHROPIC_AUTH_TOKEN = "YOUR_API_KEY"
    $env:ANTHROPIC_MODEL = "deepseek-v4-flash"
    claude --ide
    

    以上就是在Windows系统上配置Claude Code使用DeepSeek API的操作指南的详细内容,更多关于Claude Code+DeepSeek API配置指南的资料请关注风君子博客其它相关文章!

    站内搜索