一份国内 Windows 系统安装 Claude Code 的实践纪要

碎碎念：久仰 claude code 大名很久了，都说多牛多好用，一直没上手试试。近期项目上活较少了，摸鱼蹭公司网捣鼓了一下，这里记录了安装和第一次使用的过程。

✅ 一、系统与依赖要求（必须满足）

Windows 10（2004+）/ Windows 11（推荐）
Node.js 18+ / 20.x / 22.x LTS（推荐 22.x）（不支持 25.x+）
Git for Windows（必需，内部依赖 bash）
管理员权限、稳定网络

✅ 二、配置npm国内加速

npm 换国内源（关键，否则安装卡死）

arduino 复制代码

npm config set registry https://registry.npmmirror.com/ 
npm config get registry

✅ 三、安装 Claude Code（npm方式）

我试过网上可以搜到winget方式安装、官方脚本安装和直接在claude.ai官网下载安装包三种方式安装都失败了，最终通过npm方式成功完成了安装。

这些我尝试安装失败的方式在这我就不赘述了。下边是我尝试可行的安装方式。

1）npm 方式安装

管理员身份打开 PowerShell：

bash 复制代码

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

2）验证安装

css 复制代码

bash claude --version

输出版本号即安装成功。

✅ 四、首次启动 & 测试

复制代码

claude

启动成功如下图所示：

✅ 五、登录

第一次打开会看到未登录提示：Not logged in · Run /login

看到 Not logged in 这个提示不用着急，这通常不是程序出了问题，而是 Claude Code 还没完成登录或配置。可以先通过 claude /login 命令在浏览器中完成登录，如果这个方法无效，通常是以下几种情况之一：

🔑 方案一：尝试通过浏览器登录（首选）

这是最直接的方法，大部分情况下可以解决问题。

在终端中直接运行命令：claude /login 。
系统会自动打开一个浏览器页面，用你的 Anthropic 账号完成登录和授权即可。

🖥️ 方案二：检查设备存储空间

如果登录过程显示"浏览器已成功"，但终端仍然提示未登录 ，很可能是存储空间问题。 Claude Code 需要把登录凭证写入本地文件，如果磁盘空间满了，写入会静默失败，导致状态丢失。可以通过以下步骤解决：

检查存储空间 ：在终端运行 df -h 命令，查看磁盘使用率（Use%）是否为 100% 。
释放空间 ：
- 清理 npm 缓存：npm cache clean --force 。
- 清理 pip 缓存：rm -rf ~/.cache/pip 。
- 删除不再使用的项目文件夹（特别是里面的 node_modules 目录）。
释放空间后，再次运行 claude login 即可。

🚀 方案三：配置第三方 API 接入（国内用户推荐）

如果你和我一样在国内使用无法直接登录，或者不想订阅 Claude 官方服务，可以通过配置第三方 API 来使用，这也是国内开发者最常用的方法。可以选择阿里云百炼、智谱等平台。我这里是使用的阿里云百炼平台的API，阿里云的百万token计划，新用户可以免费使用模型三个月。

操作步骤：

跳过官方登录验证 ：在你的用户目录下找到或新建 .claude.json 文件，写入以下内容，阻止程序启动时强制连接 Anthropic 官方服务器。路径: C:\Users\你的用户名\.claude.json
json 复制代码
```
{
    "hasCompletedOnboarding": true
}
```
配置 API 密钥和地址 ：找到或新建 settings.json 文件，填入你申请的 API 信息。路径: C:\Users\你的用户名\.claude\settings.json

以下以阿里云百炼 为例，你需要将其中的 YOUR_API_KEY 替换成你自己的真实密钥：
json 复制代码
```
{    
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://dashscope.aliyuncs.com/apps/anthropic",
        "ANTHROPIC_MODEL": "qwen3.6-plus"
    }
}
```

如果和我一样使用的是阿里云百炼平台需要注意以下事项：

模型选择：需要在阿里云百炼平台-模型-工作台-模型用量中查看可用的免费模型；
打开免费额度用完即停按钮，以防token超出产生额外费用

重启 Claude Code ：配置完成后，重新打开终端，输入 claude 即可开始使用。

📌 如果问题依然存在，还可以尝试

检查网络与代理 ：如果你是官方登录用户，请确保终端可以正常访问 api.anthropic.com 。
检查 Node.js 版本 ：Claude Code 需要 Node.js 18.0 或更高版本，可以通过 node --version 查看。
更新到最新版 ：运行 npm install -g @anthropic-ai/claude-code@latest 更新工具。

✅ 六、配置中文回答

如果你和我一样，希望我的CC一直用中文输出，不用每次重复让它用中文进行回答，可以进行全局的提示词配置：

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

json 复制代码

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "sk-你的密钥",
        "ANTHROPIC_BASE_URL": "https://dashscope.aliyuncs.com/apps/anthropic",
        "ANTHROPIC_MODEL": "qwen3.6-plus",
        "ANTHROPIC_SMALL_FAST_MODEL": "qwen3.6-flash"
    },
    "system_prompt": "你是一个AI编程助手。请始终使用简体中文回答。无论用户使用什么语言提问，都必须用中文回复。代码注释也使用中文。",
    "permissions": {
        "allow": ["Read", "Edit", "Bash"]
    }
}

保存后，重启 Claude Code 即可全局生效。