🔥 中国用户必看！Windows 10 完美配置 Claude Code 全攻略 – 从零到成功运行，解决网络访问问题，ClaudeYY 镜像服务器配置教程
最近看到很多Claude Code的自来水文章，说实在的我有点心动了，本着与时俱进的想法，我在用顺Cursor后，决定还是要摆脱舒适区，去学习一下Claude Code。因为是完全的0帧起手，所以在 Windows 10 上安装 Claude Code 时遇到了各种问题，从环境变量配置到镜像服务器设置，经过一番折腾，终于搞定了这个问题，今天把完整的配置过程分享给大家。这篇文章将手把手教你如何在 Windows 10 上完美配置 Claude Code，同时分享怎么解决中国用户无法访问官方服务的方法。
📋 适用环境与前置要求
- 操作系统：Windows 10 (版本 1809 或更高) / Windows 11
- Node.js：v18.0.0 或更高版本（推荐 v22.19.0+）
- npm：v8.0.0 或更高版本（推荐 v10.9.3+）
- PowerShell：5.1 或更高版本（Windows 10 自带）
- Git：v2.30.0 或更高版本（可选但强烈推荐）
- 网络环境：能够访问互联网，建议稳定的网络连接
- 权限要求：管理员权限（用于安装软件和设置环境变量）
⏱️ 预计完成时间：15-30分钟（取决于网络速度和系统配置）
🔍 问题背景与技术原理
Claude Code 是 Anthropic 推出的 AI 编程助手，可以在命令行中直接使用。但是有个问题，Claude Code 官方明确禁止中国用户使用其服务。后来我发现了 ClaudeYY，这是一个专门为中国用户提供的 Claude Code 服务，我试了试，感觉还不错。
没有设置镜像API的话，无法直接使用Claude Code
经过我的测试，ClaudeYY 确实比较稳定，而且使用体验和官方版本基本一致。我了解到他们严格采用官方标准搭建，只是对访问路径进行了优化，没有做其他改动。最重要的是，我用了一段时间，没有发现降智或者安全问题，服务也比较稳定。
🚀 Claude Code 的优势：
- 命令行原生支持：直接在终端使用，无需打开 IDE，更轻量级
- 项目无关性：不依赖特定项目结构，可以在任何目录使用
- 脚本友好：支持 `-p` 参数，完美适合自动化脚本和批处理
- 资源占用低：不需要运行完整的 IDE，内存和 CPU 占用更少
- 跨平台一致：在 Windows、macOS、Linux 上体验完全一致
- 快速响应：启动速度快，无需等待 IDE 加载
⚙️ 预备组件安装
在安装 Claude Code 之前，我们需要确保系统已经安装了必要的组件。这些组件是 Claude Code 正常运行的基础。
步骤 1：检查 Node.js 安装
执行命令：
node --version npm --version
预期结果：显示版本号，如 v22.19.0 和 10.9.3
小白提示：如果没有安装，请到 nodejs.org 下载安装，安装一路默认选择即可！
步骤 2：检查 Git 安装
执行命令：
git --version
预期结果：显示版本号，如 git version 2.51.0.windows.1
小白提示：如果没有安装，请到 git-scm.com 下载安装，安装一路默认选择即可！
📦 Claude Code 安装
现在开始安装 Claude Code。这个过程相对简单，主要是通过 npm 进行全局安装。
步骤 3：安装 Claude Code
执行命令：
npm install -g @anthropic-ai/claude-code
预期结果：显示安装成功信息
小白提示：如果遇到权限问题，可能需要以管理员身份运行 PowerShell
步骤 4：验证安装
执行命令：
claude --version
预期结果：显示版本号，如 1.0.113 (Claude Code)
小白提示：如果提示找不到命令，可能需要重启 PowerShell
如图，我这是安装成功后的界面，首次会让大家选择主题模式，大家在使用Claude Code的时候，输入对应选项的数字即可
🔧 环境变量配置
环境变量配置是整个过程中最关键的一步。正确配置环境变量是 Claude Code 能够正常工作的前提。
步骤 5：设置 ClaudeYY 服务器环境变量
执行命令：
$env:ANTHROPIC_BASE_URL = "http://ai.claudeyy.com/api/"
预期结果：命令执行无错误
小白提示：这个地址是我用的 ClaudeYY 服务器，专门解决我们中国用户访问不了官方服务的问题，目前ClaudeYY官方的API地址https://www.claudeyy.com/api在我此时此刻是用不了的，后面加客服QQ后看到签名才知道有个备用接口http://ai.claudeyy.com/api/，测试无误，也不知道这个ClaudeYY官方咋想的，没有在官网里通知，害我折腾好久……
步骤 6：设置 API 密钥
如图，直接复制ClaudeYY密钥
执行命令：
$env:ANTHROPIC_API_KEY = "your-api-key-here"
预期结果：命令执行无错误
小白提示：请将 “your-api-key-here” 替换为您的实际 API 密钥
步骤 7：永久保存环境变量
执行命令：
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "http://ai.claudeyy.com/api/", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "your-api-key-here", "User")
预期结果：命令执行无错误
小白提示：这样设置后，重启电脑后环境变量仍然有效
🌐 ClaudeYY 服务器设置
ClaudeYY 是专门为中国用户提供的 Claude Code 镜像服务。通过配置 ClaudeYY 服务器，我们可以绕过网络限制，正常使用 Claude Code 的所有功能。
我的实际配置经历
在配置过程中，我尝试了好几个服务器地址，踩了不少坑，最终选择了 ClaudeYY 的服务：
https://www.claudeyy.com/api– 这个我用得最多，比较稳定http://ai.claudeyy.com/api/– 备用地址，有时候主站卡的时候用这个https://api.anthropic.com– 官方服务器，我试过，确实连不上，他M的官方够拽~
🛠️ 故障排除
在配置过程中，你可能会遇到各种问题。这里我总结了最常见的问题和解决方案，希望能帮你快速解决问题。
🔍 常见问题及解决方案
问题 1：显示 “Missing API key · Run /login”
解决方案：
# 重新设置环境变量 $env:ANTHROPIC_BASE_URL = "http://ai.claudeyy.com/api/" $env:ANTHROPIC_API_KEY = "your-api-key-here" # 验证设置 echo $env:ANTHROPIC_BASE_URL echo $env:ANTHROPIC_API_KEY
问题 2：一直显示 “Boondoggling…” 或 “Osmosing”
解决方案：
# 按 Esc 键中断当前请求 # 然后尝试官方服务器 $env:ANTHROPIC_BASE_URL = "https://api.anthropic.com"
问题 3：Git 命令找不到
解决方案：
# 临时添加 Git 到 PATH
$env:PATH += ";C:\Program Files\Git\bin\"
# 永久添加 Git 到 PATH
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\Program Files\Git\bin\", "User")
问题 4：PowerShell 执行策略阻止脚本运行
解决方案：
# 以管理员身份运行 PowerShell，然后执行： Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
小白提示：执行策略更改时，系统会询问是否确认，输入 Y 并按回车即可
问题 5：环境变量在新会话中不生效
解决方案：
# 检查永久环境变量是否设置成功
[Environment]::GetEnvironmentVariable("ANTHROPIC_BASE_URL", "User")
[Environment]::GetEnvironmentVariable("ANTHROPIC_API_KEY", "User")
# 如果返回空值，重新设置
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "http://ai.claudeyy.com/api/", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "your-api-key-here", "User")
小白提示：设置完成后需要重启 PowerShell 才能生效
💡 基本使用方法
配置完成后，你就可以开始使用 Claude Code 了。这里介绍一些基本的使用方法和技巧。
启动 Claude Code
执行命令：
claude
预期结果：显示欢迎界面和配置信息
小白提示：首次启动会显示主题选择，直接按回车使用默认主题
基本对话
示例命令：
你好，请用中文和我对话 请帮我写一个Python函数 请解释这段代码的功能
预期结果：Claude 会用中文回复您的问题
小白提示：可以直接输入中文，Claude 会自动识别并回复中文
可以让Claude给你一些简单的指导，让你快速开始第一个项目
常用命令
常用命令：
/help # 显示帮助信息 /status # 查看当前配置 /init # 创建项目文件 /theme # 更改主题 /exit # 退出程序
预期结果：执行相应的功能
小白提示：所有命令都以 “/” 开头
高级使用技巧
技巧示例：
# 直接提问（非交互模式） claude -p "请帮我写一个Python函数" # 调试模式 claude -p "hello" --debug # 查看详细帮助 claude --help
预期结果：获得更详细的输出信息
小白提示：调试模式可以看到详细的连接和错误信息，有助于排查问题
自动化配置 – 避免手动选择
解决方案：
# 方法1：使用非交互模式（推荐） claude -p "你的问题" --output-format text # 方法2：预设默认配置 claude config set -g theme dark claude config set -g auto-accept true # 方法3：使用环境变量预设 $env:CLAUDE_THEME = "dark" $env:CLAUDE_AUTO_ACCEPT = "true"
预期结果：Claude Code 自动使用预设配置，无需手动选择
小白提示：使用 `-p` 参数可以完全跳过交互界面，直接获得结果
📝 总结与感悟
通过这次完整的配置过程，我学到了很多宝贵的经验。希望这些经验能帮助到更多遇到同样问题的朋友。
通过这次配置，我学到了几个重要的知识点：
- 环境变量的重要性：在 Windows 上配置开发工具时，环境变量是关键，需要同时设置当前会话和永久配置。
- ClaudeYY 确实有用：对于我们中国用户来说，ClaudeYY 确实是使用 Claude Code 的关键，能有效解决官方服务连不上的问题。
- 故障排除的方法：遇到问题时，要系统性地检查每个环节，从环境变量到网络连接。
- PowerShell 的使用：在 Windows 上进行开发配置，熟练掌握 PowerShell 是必要的。
- 自动化配置的重要性：使用 `-p` 参数和预设配置可以避免手动选择，提高工作效率。
- 工具选择的考虑：Claude Code 相比 Cursor 更适合轻量级、脚本化的使用场景。
✅ 快速配置检查清单
配置完成后，你可以按照以下清单检查是否成功：
- ✅ Node.js 和 npm 已安装并能正常使用
- ✅ Git 已安装并能正常使用
- ✅ Claude Code 已安装并能显示版本号
- ✅ 环境变量已正确设置（当前会话和永久配置）
- ✅ ClaudeYY 服务器地址已配置
- ✅ API 密钥已设置
- ✅ Claude Code 能正常启动并显示欢迎界面
- ✅ 能够进行中文对话
🎯 检查结果：如果以上所有项目都打勾，说明配置完全成功！现在你可以开始使用 Claude Code 进行 AI 编程了。
本文章由AI帮我润色生成，希望这篇文章能帮助到遇到同样问题的朋友。如果大家在操作过程中遇到问题，欢迎在评论区留言讨论，我们一起解决！
原文链接：https://www.amazon888.com/blog/24369.html，转载请注明出处和链接。
评论0