Claude Code在Windows/WSL-Linux/VS Code三平台上的安装配置参考

Windows上安装Claude Code1. Powershell中使用命令行安装Claude CodeClaude Code官网上 Quickstart - Claude Code Docs 推荐的Windows安装命令为irm https://claude.ai/install.ps1 | iex # 下载所需的网络问题读者自行解决安装相关路径需要关注一下涉及到后续一些配置的修改。默认的安装路径为C:\user\用户名\。其中有两个关键的配置文件C:\user\用户名\.claude.json以及C:\user\用户名\.claude\setting.json后续的配置过程需要修改这两个文件。安装完成后如果执行claude命令无法执行需要把可执行文件的路径添加到系统环境变量中按Win R键输入sysdm.cpl并回车。点击窗口上方的“高级”然后点击最下面的环境变量。在用户变量中找到Path双击打开然后添加路径C:\Users\用户名\.local\bin。打开Powershell执行命令claude。应该就能看到页面但是此时由于国内网络会红字提示网络问题这里先不要管退出即可。claude --version也可验证安装是否完成。注意⚠️笔者在使用上面安装命令之前修改了环境变量USERPROFILE; HOME的值目的是让claude装到特定目录。$env:USERPROFILE D:\Tools\Claude$env:HOME D:\Tools\Claude但是以上命令只在临时打开的命令行有效再次打开新命令行时变量会恢复为原本的值。这样的结果是虽然我们把claude装到了特定目录但是后续的配置文件.claude还是会产生在C:\Users\wsy\.claude这个文件夹中的配置文件setting.json后续在添加国产大模型API Key的时候需要修改。笔者自己的误操作导致后续配置的时候出了很多问题因此在此记录一下。读者安装的时候不要乱做修改。由于国内并不能原生访问Claude官网和对应国外模型因此我们下一步需要绕过注册流程并配置国产模型API。2. 编辑.claude.json文件添加配置{hasCompletedOnboarding: true,...}该配置表示初始化已经完成以跳过注册登录过程。3. 获取API Keys一般需要到你用的API的官网获取相关入口很容易找到。以DeepSeek为例 DeepSeek 。获取到的API Key自己复制下来保存好。4. 编辑.claude/setting.json文件添加配置{env: {ANTHROPIC_AUTH_TOKEN: 你的API KEY,ANTHROPIC_BASE_URL: 你的BASE_URL,ANTHROPIC_MODEL: 你使用的API名字},...}阿里云百炼官方文档中的配置大模型服务平台百炼控制台{env: {ANTHROPIC_AUTH_TOKEN: YOUR_API_KEY,ANTHROPIC_BASE_URL: https://dashscope.aliyuncs.com/apps/anthropic,ANTHROPIC_MODEL: qwen3.6-plus,ANTHROPIC_SMALL_FAST_MODEL: qwen3.6-flash,ANTHROPIC_DEFAULT_HAIKU_MODEL: qwen3.6-flash,ANTHROPIC_DEFAULT_SONNET_MODEL: qwen3.6-plus,ANTHROPIC_DEFAULT_OPUS_MODEL: qwen3.6-plus,CLAUDE_CODE_SUBAGENT_MODEL: qwen3.6-plus}}小米MIMO的官方文档配置Xiaomi MiMo Home{env: {ANTHROPIC_BASE_URL: BASE_URL,ANTHROPIC_AUTH_TOKEN: MIMO_API_KEY,ANTHROPIC_MODEL: mimo-v2.5-pro,ANTHROPIC_DEFAULT_SONNET_MODEL: mimo-v2.5-pro,ANTHROPIC_DEFAULT_OPUS_MODEL: mimo-v2.5-pro,ANTHROPIC_DEFAULT_HAIKU_MODEL: mimo-v2.5-pro}}DeepSeek中的官方文档配置接入 Claude Code | DeepSeek API Docs$env:ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropic$env:ANTHROPIC_AUTH_TOKEN你的 DeepSeek API Key$env:ANTHROPIC_MODELdeepseek-v4-pro[1m]$env:ANTHROPIC_DEFAULT_OPUS_MODELdeepseek-v4-pro[1m]$env:ANTHROPIC_DEFAULT_SONNET_MODELdeepseek-v4-pro[1m]$env:ANTHROPIC_DEFAULT_HAIKU_MODELdeepseek-v4-flash$env:CLAUDE_CODE_SUBAGENT_MODELdeepseek-v4-flash$env:CLAUDE_CODE_EFFORT_LEVELmaxDeepSeek这种直接在命令行中直接修改环境变量的方式笔者不推荐原因主要有以下几点。此种环境变量定义只在当前shell中有效每次打开新的shell中都要重新执行。在shell中直接定义环境变量的优先级低于Claude配置文件.claude/setting.json这会造成以下问题假如你在shell中配置了环境变量ANTHROPIC_AUTH_TOKEN的值同时.claude/setting.json文件中也定义了该值那么会以.claude/setting.json中定义的优先笔者水平有限遇到这个问题之后排查了很久希望读者注意。5. 在shell中运行Claude创建项目文件夹在文件夹中右键点击在终端中打开执行命令claude然后执行/status命令查看基本信息即可看到如下界面至此成功安装。二、在WSL上安装Claude Code由于Claude Code是原生为Unix系统Linux/macOS设计的因此其更适合在Linux/macOS上运行它深度依赖这两类系统内置的命令行工具和各种机制。由于 Windows 的文件路径格式反斜杠、权限管理和底层逻辑与Unix差异巨大Claude在Windows上执行代码重构或系统命令时容易出各种问题但肯定不是不能用运行效率和稳定性不如在原生Unix环境下好。WSL能够在Windows上去运行一个UNIX环境从未能够解决上述问题。WSLWindows Subsystem for LinuxWindows上的Linux子系统是Windows 10/11自带的兼容层功能。它无需安装虚拟机或双系统就能直接在Windows里运行真实的Linux环境如Ubuntu、Debian等。它支持运行Bash脚本、Linux命令行工具grep、sed、awk 等以及大部分开发必备的软件Node.js、Python、GCC、Docker 等。WSL 2 使用真正的Linux内核比第一代性能更强、系统调用更完整而且文件访问与Windows互通开发体验非常丝滑。因此本节主要介绍WSL的安装然后在WSL中安装Claude Code。1. WSL安装点击任务栏搜索输入启用或关闭Windows功能回车打开。勾选“适用于Linux的Windows子系统”“虚拟机平台”。重启。打开Powershell输入命令wsl --install# 后面会提示输入用户名和密码自定义即可然后就安装完成了默认安装发行版是Ubuntu使用命令wsl --list --online可以查看wsl支持的其他发行版。使用wsl --list -v可以查看当前设备安装了哪些版本PS C:\Users\wsy wsl --list -vNAME STATE VERSION* Ubuntu Stopped 2PS C:\Users\wsy启动已安装的Ubuntu的命令为wsl -d Ubuntu。在Powershell上方的下箭头列表里也可以打开如图所示2. 在WSL-Ubuntu上安装Claude Code在Ubuntu命令行住输入命令curl -fsSL https://claude.ai/install.sh | bash # 下载所需的网络问题读者自行解决# 将可执行文件的位置给PATHecho export PATH$HOME/.local/bin:$PATH ~/.bashrc sou