简介:Claude Code 是 Anthropic 推出的代码助手,支持在 Windows 通过 WSL(Windows Subsystem for Linux)运行。本文介绍如何在 Windows 系统中启用 WSL、安装 Ubuntu 子系统、配置 Python 与 Node.js 环境,并最终安装和运行 Claude Code,以及对接deepseek大模型,内容涵盖 WSL 设置、开发工具安装、依赖配置及常见问题解决方法,助你顺利在本地环境中使用 Claude Code 提升编码效率。
一、Windows安装Claude Code
1.1配置环境
- Windows 下使用 WSL 功能需要系统是专业版
- 开启 Windows 功能,快捷键 Win + Q 搜索 "启用或关闭 Windows 功能",一共要开启三个功能,开启后需要重启一下电脑
- Hyper-V
- 适用于Linux的Windows子系统
- 虚拟机平台
1.2安装WSL2
以管理员身份打开 PowerShell,执行:
wsl --install # 如果上面的情况安装不好,使用下面的命令,指明版本 wsl --install -d Ubuntu-22.04这个命令会自动:
- 开启 WSL 功能
- 安装虚拟机平台
- 下载并安装 Ubuntu 发行版
- 将 WSL 版本设为 2
执行后重启电脑。
验证 WSL 2安装
wsl -l -v如果显示 1,升级到 WSL2:
# 将 WSL2 设置为默认版本 wsl --set-default-version 2 # 将现有发行版转换为版本 2 wsl --set-version Ubuntu-22.04 21.3初始化Ubuntu
重启后,Ubuntu 会自动打开,需要:
- 设置用户名(如
ganlan) - 设置密码(输入时不显示,正常输入后回车)
- 设置用户名(如
# 设置用户名 ganlan # 设置密码(两次) New password: ******** Retype new password: ********1.4首先更新软件源
sudo apt update && sudo apt upgrade -y(输入你的用户密码,不会显示,正常输入后回车即可)
1.5安装 Node.js 20
# 添加 Node.js 官方源 curl -fsSL https://deb.nodesource.com/setup_20.x | sudo bash - # 安装 Node.js sudo apt install -y nodejs验证安装
node --version # 应显示 v20.x.x npm --version # 应显示 10.x.x1.6 安装 Claude Code
# 全局安装 Claude Code sudo npm install -g @anthropic-ai/claude-code(需要输入密码)
验证安装
claude --version二、 配置 DeepSeek API
2.1 获取 API Key
- 访问 DeepSeek 开放平台
- 注册/登录
- 进入「API Keys」页面
- 点击「创建 API Key」
- 复制生成的密钥(类似
sk-xxxxxxxxxxxxxxxx)
2.2 设置环境变量(临时,每次需重新设置)
export ANTHROPIC_AUTH_TOKEN="你的DeepSeek API Key" export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"2.3 永久保存(写入 ~/.bashrc)
echo 'export ANTHROPIC_AUTH_TOKEN="你的DeepSeek API Key"' >> ~/.bashrc echo 'export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"' >> ~/.bashrc source ~/.bashrc2.4 验证 API 是否正常
curl -X POST https://api.deepseek.com/anthropic/v1/messages \ -H "Authorization: Bearer 你的API Key" \ -H "Content-Type: application/json" \ -d '{"model":"claude-3-haiku-20240307","messages":[{"role":"user","content":"Hello"}]}'2.5 启动 Claude Code
claude三、在VS code安装claude code插件
3.1下载安装VS code
- 访问 https://code.visualstudio.com/
- 点击 “Download for Windows” 下载最新安装包
- 运行安装程序
- 安装完成后,重新打开 VS Code,
code命令依然可用
3.2VS code安装后显示为英文,安装中文包
- 打开扩展商店:点击 VS Code 左侧的“扩展”图标 (或按
Ctrl + Shift + X)。 - 搜索并安装:在搜索框输入 “Chinese (Simplified)”,找到并安装官方语言包。
- 切换与重启:再次按
Ctrl + Shift + P,输入Configure Display Language,在列表中选择zh-cn并重启。
3.3安装claude code插件
- 在扩展商店搜索
Claude Code for VS Code作者:Anthropic - 点击 Install
- 安装完成后,VS Code 会提示重新加载窗口(或重启),点击 Reload。
3.4登录GitHub Copilot
右边面板一直让我设置GitHub Copilot并登录,需要谷歌邮箱,GitHub账号,需要VPN接收验证码,登录之后就是这样子了,前期可以先不用的
3.5登录claude code
刚进去的时候是这样的界面,因为 VS Code 的 Claude Code 扩展默认显示的是官方 Claude 服务的登录界面,而你实际使用的是通过 DeepSeek API 中转的方式。这两个通道并不互通,所以点击“登录”按钮没有反应是正常的。
需要编辑settings.json
- 按
Ctrl + Shift + P打开命令面板。 - 输入
Preferences: Open Settings (JSON)并回车。
{ "workbench.editorAssociations": { "*.ipynb": "jupyter-notebook" }, "notebook.cellToolbarLocation": { "default": "right", "jupyter-notebook": "left" }, "window.zoomLevel": -1, "security.workspace.trust.banner": "always", "claudeCode.preferredLocation": "panel", "claudeCode.environmentVariables": [ ] }- 在打开的
settings.json文件中,修改后的文件:
在[和]之间,添加了两个用逗号隔开的对象。
{ "workbench.editorAssociations": { "*.ipynb": "jupyter-notebook" }, "notebook.cellToolbarLocation": { "default": "right", "jupyter-notebook": "left" }, "window.zoomLevel": -1, "security.workspace.trust.banner": "always", "claudeCode.preferredLocation": "panel", "claudeCode.environmentVariables": [ { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-你的DeepSeek密钥" }, { "name": "ANTHROPIC_BASE_URL", "value": "https://api.deepseek.com/anthropic" } ], "claudeCode.disableLoginPrompt": true }- 保存文件,重启 VS Code。
3.6输入一个简单的指令来验证:
你好,请介绍一下你自己,并说明你现在可以帮我做什么以上配置完成!