Windows 安装教程：五步上手 Claude Code

本教程面向 Windows 用户，按顺序完成五步即可使用 Claude Code。

安装流程总览

1. 装 Git 和 Node.js（运行环境）
2. 装 Claude Code 本体
3. 装 CC Switch，配好 API
4. 装 Warp 终端（推荐）
5. 连接飞书cli

第一步：装 Git 和 Node.js

Node.js 是 Claude Code 的运行环境，必须先装；Git 会在后续步骤里被各种工具默认依赖，一起装上。

1.1 打开命令行

按 Win + R，输入 cmd，回车；或按 Win + X，选择「终端」。

1.2 安装 Git

1. 访问 Git 官网
2. 点击「Download for Windows」
3. 双击安装包，一路 Next

1.3 安装 Node.js

1. 访问 Node.js 官网
2. 下载 LTS 版本（推荐 22.x）
3. 选 Windows Installer (.msi)
4. 双击安装，一路 Next
5. 关掉命令行重新打开

1.4 验证安装

node --version

看到 v22.x.x 即成功。

常见问题：

• 提示「node 不是内部或外部命令」→ 关掉命令行重新打开，还不行就重启电脑
• 提示 'git' is not recognized → 重新装一次 Git，装完重启终端

第二步：装 Claude Code

2.1 安装

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

• 提示权限错误 → 右键「以管理员身份运行」命令提示符 / PowerShell
• 下载慢 → 先换源：npm config set registry https://registry.npmmirror.com

2.2 验证

claude --version

看到版本号即成功。

2.3 升级

Claude Code 更新频繁，建议每周执行一次：

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

第三步：装 CC Switch，配好 API

CC Switch 是桌面工具，用来管理 API 配置，免去手动改配置文件。

3.1 下载安装

1. 访问 CC Switch Releases 页面
2. 下载 Windows.msi
3. 双击安装，一路 Next

3.2 配置 API

打开 CC Switch：

1. 顶部切到 Claude 标签
2. 点右上角 + 添加新配置
3. 按下表填写信息
4. 点保存

3.3 启用配置

1. 在列表中点击刚添加的配置
2. 点「启用」—— 变成绿色高亮即生效
3. 可点「健康检查」验证连通性
4. 关掉终端重新打开即可使用

第四步（推荐）：装 Warp 终端

Warp 界面更清爽、支持智能补全，推荐使用。跳过此步不影响功能。

1. 访问 Warp 官网 下载安装
2. 双击安装包完成
3. 首次打开需注册账号（支持 GitHub 登录）

安装后打开 Warp（或系统自带终端），输入 claude 即可启动。

基本操作：

• 直接打字对话
• /help 查看帮助
• Ctrl + C 中断当前操作
• Ctrl + D 退出 Claude Code

第五步：连上飞书

安装飞书命令行工具（lark-cli），让 Claude Code 能操作飞书。按 飞书 CLI 官方 README 的推荐流程，按你的 Shell 选一条执行。

CMD 或 PowerShell 7 用户：

npm install -g @larksuite/cli && npx skills add larksuite/cli -y -g && lark-cli config init && lark-cli auth login --recommend

旧版 PowerShell（把 && 换成 ;）：

npm install -g @larksuite/cli ; npx skills add larksuite/cli -y -g ; lark-cli config init ; lark-cli auth login --recommend

这一条命令依次完成 4 件事，中间会弹出浏览器授权页，按提示点「授权」即可：

1. 安装 lark-cli（CLI 本体）
2. 安装飞书 AI Agent Skills 技能包（让 Claude Code 能操作飞书）
3. 首次初始化应用配置（没有飞书开放平台应用时按引导创建）
4. 登录并授权常用权限（--recommend 会自动勾选日历、文档、消息等常用 scope）

看到最后出现 Login successful 即全部完成。

如遇「权限错误」→ 以管理员身份运行 PowerShell。

如遇「下载慢」→ 先切国内源：npm config set registry https://registry.npmmirror.com，再重跑。

如遇「.ps1 cannot be loaded」→ 管理员 PowerShell 运行 Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned，输入 Y 确认。

验证：试两个操作

创建飞书文档

启动 claude，输入：

帮我创建一篇飞书文档，标题叫"测试文档"，内容写一段简单介绍。

等待几秒，返回文档链接即成功。

查飞书日程

输入：

我今天有什么会议？

返回今日日程列表即成功。

常见问题速查

遇到问题？

截图问 AI（GPT / Gemini / 豆包等）或内部群提问，附上报错截图。