从零开始：Windows 上安装 Claude Code 完全指南
本文面向谁？
本文面向 从未接触过 AI 编程工具 的同学，从概念介绍到动手安装，手把手带你走上 AI 辅助编程之路。
一、AI 编程工具全景：Claude Code vs Trae vs Trae Solo
在开始安装之前，先搞清楚市面上几个主流工具到底是什么、有什么区别。
1.1 Claude Code — 终端里的 AI 程序员
Claude Code 是 Anthropic（Claude 的开发商）推出的 命令行 AI 编程助手。它运行在终端（Terminal）中，能直接读取你的项目文件、执行命令、修改代码、运行测试、操作 Git——几乎所有你在终端里能做的事，它都能帮你做。
核心特点
- 终端原生：不需要 IDE，打开终端就能用
- Agentic（智能体）模式：不只是聊天，而是自主分析→规划→执行→验证的完整闭环
- 深度项目理解：能读懂整个代码库的上下文
- 支持多种模型：Claude Sonnet、Opus、Haiku 等
- 可接入第三方 API：通过 cc-switch 等工具，可以用国内中转服务
1.2 Trae — 字节跳动的免费 AI IDE
Trae（The Real AI Engineer）是字节跳动推出的 AI 原生集成开发环境（IDE），基于 VS Code 构建。它把 AI 能力深度集成到了代码编辑器中。
核心特点
- 图形界面：像 VS Code 一样的编辑器，有代码高亮、文件树等
- Builder 模式：用自然语言描述需求，AI 自动生成整个项目
- Chat 模式：侧边栏对话，支持图片输入（如截图报错）
- 目前免费：所有功能免费使用
- 支持中文：界面和对话都支持中文
1.3 Trae Solo — 全自动 AI 开发平台
Trae Solo 是 Trae 的进阶版本，定位为 “AI 全栈工程师”。它更强调从需求到部署的全流程自动化。
核心特点
- 需求→代码→部署：输入一句话需求，自动完成开发全流程
- 无需编程基础：面向非程序员，用自然语言驱动
- 自动部署：开发完成后直接部署上线
- 邀请制：目前需要邀请码才能使用
1.4 三者对比一览
| 特性 | Claude Code | Trae | Trae Solo |
|---|---|---|---|
| 形态 | 命令行（CLI） | 图形 IDE | 图形 IDE + 云平台 |
| 学习曲线 | ⭐⭐⭐ 需要终端基础 | ⭐ 零基础可用 | ⭐ 零基础可用 |
| 适合人群 | 开发者、有终端经验者 | 所有开发者 | 非程序员、产品经理 |
| 代码控制力 | ⭐⭐⭐⭐⭐ 完全掌控 | ⭐⭐⭐⭐ 较好 | ⭐⭐⭐ 自动化为主 |
| 费用 | 需要 Claude 订阅或 API | 免费（目前） | 需要邀请码 |
| 模型 | Claude 全系列 | Claude + GPT-4o | Claude + GPT-4o |
| 离线使用 | ❌ | ❌ | ❌ |
我的推荐
如果你是 开发者或计算机相关专业学生，强烈推荐从 Claude Code 入手。它虽然在终端里运行，但能让你真正理解 AI 是如何与代码交互的，而且控制力最强、灵活性最高。配合 cc-switch，还能用上性价比极高的第三方 API。
二、安装前准备：升级 PowerShell 7.6
Windows 自带的 PowerShell 5.1 版本较老，很多现代脚本和工具需要 PowerShell 7.x。Claude Code 的安装脚本也需要在 PowerShell 7 中运行。
2.1 为什么要升级？
| 对比项 | PowerShell 5.1（自带） | PowerShell 7.6（最新） |
|---|---|---|
| 跨平台 | ❌ 仅 Windows | ✅ Windows/macOS/Linux |
| 性能 | 较慢 | 显著提升 |
| 新语法 | 不支持 | 支持 ??、?. 等 |
| 模块兼容 | 部分不兼容 | 更好的兼容性 |
| 安全更新 | 已停止 | 持续更新 |
2.2 安装步骤
前提条件
确保你的 Windows 版本是 Windows 10 (1809+) 或 Windows 11。
方法一：使用 winget（推荐）
打开 PowerShell（管理员模式），运行：
# 安装 PowerShell 7.6
winget install Microsoft.PowerShell
# 安装完成后，关闭当前窗口，重新打开一个新的 PowerShell 7 窗口
# 验证版本
pwsh --version注意
安装完成后，新版本的可执行文件名是
pwsh，不是powershell。你可以在开始菜单搜索 “PowerShell 7” 来打开它。
方法二：使用 MSI 安装包
- 访问 PowerShell GitHub Releases
- 下载
PowerShell-7.6.x-win-x64.msi - 双击运行安装向导
- 安装完成后从开始菜单打开 “PowerShell 7”
方法三：使用 winget 安装独立版本（不覆盖系统版本）
# 安装独立版本，不影响系统自带的 PowerShell 5.1
winget install Microsoft.PowerShell --source winget2.3 设置 PowerShell 7 为默认终端
推荐设置
安装完 PowerShell 7 后，建议将其设为 Windows Terminal 的默认终端：
- 打开 Windows Terminal
- 按
Ctrl + ,打开设置 - 在 启动 → 默认配置文件 中选择 PowerShell 7
- 或者在标签栏的下拉箭头中，右键点击 PowerShell 7 → 设为默认配置文件
2.4 验证安装
# 在 PowerShell 7 中运行
pwsh --version
# 应该输出类似：PowerShell 7.6.x
# 检查 .NET 版本（PowerShell 7.6 基于 .NET 9）
dotnet --list-runtimes三、安装 Claude Code
3.1 前提条件
安装前检查清单
- 已安装 PowerShell 7.6+
- 已安装 Git for Windows
- 有 Claude 账号（Pro/Max/Team）或 API Key
如果还没安装 Git，先安装：
winget install Git.Git安装完成后 关闭并重新打开 PowerShell 7，确保 git 命令可用。
3.2 一键安装 Claude Code
打开 PowerShell 7，运行以下命令：
irm https://claude.ai/install.ps1 | iex这条命令做了什么？
irm（Invoke-RestMethod）：从网络下载安装脚本|（管道）：将下载的内容传递给下一个命令iex（Invoke-Expression）：执行下载的脚本
安装过程会自动：
- 下载 Claude Code 的最新版本
- 安装到系统路径中
- 配置自动更新
3.3 验证安装
# 检查版本
claude --version
# 启动 Claude Code
claude安装成功标志
如果看到 Claude Code 的欢迎界面，说明安装成功！首次启动会提示你登录账号。
3.4 登录账号
启动 claude 后，会自动引导你登录。支持以下方式：
- Claude Pro/Max/Team 订阅：通过浏览器 OAuth 登录
- Claude Console（API）：使用 API Key 登录
- 第三方云服务：AWS Bedrock、Google Vertex AI 等
# 如果需要重新登录
/login
# 退出
exit四、配置 cc-switch 接入第三方 API
为什么需要 cc-switch？
Claude 官方 API 对国内用户可能存在访问限制，且价格较高。cc-switch 是一个开源的桌面工具，可以帮你：
- 一键切换到国内 API 中转服务（价格更低）
- 管理多个 API 提供商配置
- 支持 Claude Code、Codex、Gemini CLI 等多个工具
- 50+ 内置提供商预设
4.1 什么是 cc-switch？
CC Switch 是一个跨平台桌面应用（GitHub 上 50k+ star），用 Tauri 构建，支持 Windows、macOS、Linux。
核心功能：
- 提供商管理：50+ 预设，一键导入 API Key
- 快速切换：系统托盘一键切换，无需重启终端
- 本地代理：格式转换、自动故障转移
- MCP 管理：统一管理多个工具的 MCP 服务器
- 用量追踪：实时查看花费、请求数、Token 用量
4.2 安装 cc-switch
Windows 安装
- 访问 cc-switch Releases 页面
- 下载最新的
CC-Switch-v{版本号}-Windows.msi安装包 - 双击运行安装向导
- 安装完成后启动 CC Switch
便携版
如果不想安装，也可以下载
CC-Switch-v{版本号}-Windows-Portable.zip便携版，解压即用。
macOS 安装（Homebrew）
brew tap farion1231/ccswitch
brew install --cask cc-switchLinux 安装
# Debian/Ubuntu
sudo dpkg -i CC-Switch-v*-Linux.deb
# Fedora/RHEL
sudo rpm -i CC-Switch-v*-Linux.rpm
# 或使用 AppImage
chmod +x CC-Switch-v*-Linux.AppImage
./CC-Switch-v*-Linux.AppImage4.3 配置第三方 API 提供商
启动 CC Switch 后，按以下步骤配置：
步骤一：添加提供商
- 点击主界面的 “添加提供商” 按钮
- 从预设列表中选择一个 API 中转服务
- 填入你的 API Key
- 点击 “启用”
步骤二：选择中转服务
以下是几个常用的中转服务商（cc-switch 内置预设）：
注意事项
- 选择服务商时注意其 稳定性 和 合规性
- 首次使用建议小额充值测试
- 部分服务商提供 CC Switch 用户专属折扣
步骤三：切换提供商
配置完成后，切换提供商非常简单：
方式一：主界面切换
- 在 CC Switch 主界面选择目标提供商
- 点击 “启用”
- 重启终端（Claude Code 支持热切换，无需重启）
方式二：系统托盘切换
- 点击系统托盘中的 CC Switch 图标
- 直接点击要切换的提供商名称
- 即时生效
4.4 验证配置
# 启动 Claude Code
claude
# 测试是否正常工作
claude "你好，请介绍一下你自己"如果能正常收到回复，说明配置成功！
五、Claude Code 实战：常用命令与技巧
5.1 启动方式
# 交互模式（推荐）
claude
# 单次任务模式
claude "修复这个 bug"
# 一次性查询，执行后退出
claude -p "解释这个函数的作用"
# 继续上次的对话
claude -c
# 恢复历史对话
claude -r5.2 交互模式常用命令
| 命令 | 功能 | 示例 |
|---|---|---|
/help | 查看帮助 | /help |
/clear | 清空对话历史 | /clear |
/login | 重新登录 | /login |
/cost | 查看当前会话花费 | /cost |
? | 查看所有快捷键 | ? |
Tab | 命令补全 | Tab |
↑ | 历史命令 | ↑ |
Ctrl+D 或 exit | 退出 | exit |
5.3 实际使用场景
场景一：理解一个陌生项目
# 进入项目目录
cd /path/to/project
# 启动 Claude Code
claude
# 询问项目概况
这个项目是做什么的？
# 查看技术栈
这个项目用了哪些技术？
# 查看目录结构
解释一下文件夹结构场景二：修复 Bug
# 描述问题
登录页面输入错误密码后白屏了，帮我修复
# Claude 会自动：
# 1. 分析相关代码
# 2. 找到问题所在
# 3. 提出修复方案
# 4. 等你确认后修改代码场景三：添加新功能
# 用步骤描述需求
1. 创建一个用户个人资料的数据库表
2. 创建获取和更新用户资料的 API 端点
3. 构建一个允许用户查看和编辑信息的网页场景四：Git 操作
# 查看修改了哪些文件
我修改了哪些文件？
# 提交代码
用描述性的提交信息提交我的修改
# 创建分支
创建一个名为 feature/quickstart 的新分支场景五：代码审查
# 审查代码
审查我的修改并提出改进建议
# 写测试
为计算器函数编写单元测试
# 重构代码
将认证模块重构为使用 async/await5.4 进阶技巧
提高效率的技巧
- 具体描述：不要说”修复 bug”，而要说”修复登录页面输入错误密码后白屏的 bug”
- 分步拆解：复杂任务拆成多步，每步明确目标
- 先让 Claude 了解：修改前先让它分析代码，如
分析数据库结构- 善用 CLAUDE.md：在项目根目录创建
CLAUDE.md文件，写入项目规范，Claude 会自动遵循
CLAUDE.md 示例
# 项目规范
## 技术栈
- 前端：React + TypeScript
- 后端：Node.js + Express
- 数据库：PostgreSQL
## 代码规范
- 使用中文注释
- 函数命名使用 camelCase
- 组件命名使用 PascalCase
- 每个函数不超过 50 行
## 测试要求
- 所有新功能必须有单元测试
- 测试覆盖率不低于 80%六、常见问题排查
Q1：安装 Claude Code 时提示 “irm 不是内部命令”
原因
你可能在 CMD 中运行了 PowerShell 命令。
解决方法：打开 PowerShell 7（不是 CMD），或者使用 CMD 版本的安装命令：
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdQ2：Claude Code 启动后无法登录
可能原因
- 网络问题（无法访问 claude.ai）
- 需要使用代理
解决方法：
- 如果使用 cc-switch，确保已正确配置第三方 API
- 如果直接使用官方 API，确保网络可以访问 claude.ai
Q3：cc-switch 切换后 Claude Code 没反应
解决方法
Claude Code 支持热切换，通常不需要重启。如果没生效：
- 检查 cc-switch 是否显示 “已启用”
- 尝试重启终端
- 运行
/login重新认证
Q4：PowerShell 7 安装后找不到 pwsh 命令
解决方法
- 关闭当前终端，重新打开
- 检查安装路径是否在 PATH 环境变量中
- 尝试使用完整路径：
"C:\Program Files\PowerShell\7\pwsh.exe"
七、总结与推荐
为什么推荐 Claude Code？
- 控制力最强：终端原生，完全掌控代码修改过程
- 最灵活：支持多种模型、多种 API 提供商
- 最透明：每一步操作都可见、可确认
- 学习价值高：使用过程中能真正理解 AI 如何与代码交互
- 社区活跃：cc-switch 50k+ star，生态丰富
推荐的学习路径
graph TD A[安装 PowerShell 7.6] --> B[安装 Git for Windows] B --> C[安装 Claude Code] C --> D[安装 cc-switch] D --> E[配置第三方 API] E --> F[开始使用！] F --> G[创建 CLAUDE.md] G --> H[探索更多功能]
相关资源
写在最后
AI 编程工具正在改变我们写代码的方式。无论你是刚入门的学生，还是经验丰富的开发者，现在都是拥抱 AI 辅助编程的最佳时机。Claude Code + cc-switch 的组合，让你在 Windows 上也能流畅地使用世界顶级的 AI 编程助手。
开始你的 AI 编程之旅吧！ 🚀
创建于 2026-04-25 | 最后更新：2026-04-25