claude code安装教程windows

0 阅读4分钟

Claude code 终端工具安装(windows)

1、所需系统以及软件必备条件

操作系统:macOS 10.15 或更高版本、Ubuntu 20.04+/Debian 10+ 或更高版本,或者 Windows 10 或更高版本 Windows 环境特别说明:在 Windows 系统上,必须预先安装并配置好 Windows Subsystem for Linux (WSL),(版本 1 或 2 均可)或 Git for Windows(因其附带了 Git Bash 环境)。Claude Code 无法在原生的 Windows Command Prompt 或 PowerShell 中直接运行。 硬件:至少4GB内存

2、需要在windows上安装wsl Windows Subsystem for Linux (WSL)

安装 WSL 以管理员身份打开 PowerShell,运行以下命令来安装 WSL 和默认的 Ubuntu 发行版:wsl --install    安装完成后需要重启电脑

1773122440462.png

设置默认发行版:这一步至关重要。如果您安装了 Docker Desktop 等其他依赖 WSL 的工具,它们可能会将自己的服务设置为默认的 WSL 实例。这会导致 Claude Code 安装失败。请务必运行以下命令,确保 Ubuntu 是您的默认发行版:wsl --set-default Ubuntu您可以通过 wsl --list --verbose 命令检查哪个发行版旁边有星号(*),以确认默认设置。

3、重新启动后电脑会自动安装ubuntu

1773124106255.png

4、创建账号和密码 安装完ubuntu后,页面提示会创建一个默认用户账号,继续点ENTER,然后需要你输入密码,(请注意,输入密码时,屏幕上不会显示任何内容。 这称为盲人键入。 你不会看到你正在键入的内容,这是完全正常的。)然后会要求再次确认密码,请保证这两次输入的密码是一样的,而且两次密码在屏幕上不会显示任何东西

创建用户名和密码后,该帐户将是分发版的默认用户,并将在启动时自动登录。

此帐户将被视为 Linux 管理员,能够运行 sudo (Super User Do) 管理命令。

1773124323029.png

参考地址: 设置 WSL 开发环境 | Microsoft Learn

5、安装完ubuntu并设置完账号和密码后,搜索ubuntu

1773128895998.png

6、打开ubuntu,然后npm安装claude code   安装前需要有node并且版本在18.0.0以上

1773126626457.png

安装完成如下图

1773126670603.png

7、找到需要运行claude code  的项目  然后输入cmd 打开,输入claude

1773127303341.png

同时可以在这个页面 输入claude --version   获取claude code的版本,这样说明安装完成

8、由于claude code 限制区域,国内尚未是允许国家,建议使用国内模型

永久配置环境变量:本次模型API采用的国内千问的模型

在 CMD 中运行以下命令,设置环境变量。用百炼 API Key 替换 YOUR_DASHSCOPE_API_KEY,如下图

setx ANTHROPIC_API_KEY "YOUR_DASHSCOPE_API_KEY"

setx ANTHROPIC_BASE_URL "dashscope.aliyuncs.com/apps/anthro…"

setx ANTHROPIC_MODEL "qwen3.5-plus"

9、打开一个新的 CMD 窗口,运行以下命令,检查环境变量是否生效。

echo %ANTHROPIC_API_KEY%

echo %ANTHROPIC_BASE_URL%

echo %ANTHROPIC_MODEL%

10、创建跳过登录配置 ,直接用国内模型 API 就能使用claude code

文件路径:C:\Users\你的用户名.claude.json

输入

  "hasCompletedOnboarding": true

11、在cmd中直接打开或者选择你的一个项目cmd打开,输入claude,然后都选择YES

1773192408976.png 下边也选择YES

12、然后就会出现下图,你就可以对你想问的进行提问,这时候已经配置好可以使用了

1773192447497.png

(可选)更多配置模型的方式

Claude Code 支持以下模型配置方式,按优先级从高到低排列,优先级高的配置会覆盖优先级低的配置。

对话期间:执行/model <模型名称>命令切换模型。适用于临时切换模型。

/model qwen3.5-plus

启动 claude code 时:执行claude --model <模型名称>指定模型。适用于单次会话。

claude --model qwen3.5-plus

设置环境变量:可按任务复杂度配置不同级别的模型,Claude Code 会根据任务类型自动选择合适的模型。适用于全局生效。

export ANTHROPIC_DEFAULT_OPUS_MODEL="qwen3.5-plus"

export ANTHROPIC_DEFAULT_SONNET_MODEL="qwen3.5-plus"

export ANTHROPIC_DEFAULT_HAIKU_MODEL="qwen3-coder-next"

其中:

ANTHROPIC_DEFAULT_OPUS_MODEL:用于复杂推理、架构设计等高难度任务。

ANTHROPIC_DEFAULT_SONNET_MODEL:用于代码编写、功能实现等日常任务。

ANTHROPIC_DEFAULT_HAIKU_MODEL:用于语法检查、文件搜索等简单任务。

 

在 setting.json 配置文件中永久设置:在项目根目录或用户主目录创建settings.json文件,并写入模型配置信息,可分别进行项目级或用户级的永久配置。

{

  "env": {

    "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.5-plus",

    "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.5-plus",

    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3-coder-next"

  }}

其余更多模型配置的方式请参考阿里云

链接:大模型服务平台百炼控制台