部署Claude Code + 魔搭API 来使用Agent Skill

1. 系统要求

在开始安装之前，请确保系统满足以下要求：

组件	要求	说明
操作系统	Windows 10/11	64 位系统推荐
Node.js	v18+ 或 v20+ LTS	包含 npm 包管理器
Git	最新版	包含 git-bash

2. 安装流程概览


┌─────────────────────────────────────────────────────────┐
│  Claude Code Windows 安装流程                            │
├─────────────────────────────────────────────────────────┤
│  1. 安装 Node.js + npm  ───────────────────►  5 分钟    │
│  2. 安装 Git（含 git-bash）─────────────────►  5 分钟    │
│  3. 配置环境变量 CLAUDE_CODE_GIT_BASH_PATH ─►  2 分钟    │
│  4. 创建配置目录 ~/.claude ────────────────►  1 分钟    │
│  5. 安装 Claude Code（npm install）─────────►  5 分钟    │
│  6. 配置 PowerShell 执行策略 ──────────────►  1 分钟    │
│  7. 验证安装 ──────────────────────────────►  1 分钟    │
└─────────────────────────────────────────────────────────┘

3. 详细安装步骤

步骤 1：安装 Node.js 和 npm

Claude Code 依赖 npm 进行安装，因此需要先安装 Node.js。

下载地址 访问 Node.js 官方下载页面：https://nodejs.org/zh-cn/download/

安装步骤

选择 Windows 安装程序 (.msi)，推荐下载 LTS 长期支持版（如 20.x 版本）
- 64 位系统选择：node-v20.x.x-x64.msi
- 32 位系统选择：node-v20.x.x-x86.msi
双击下载的安装包，按以下步骤完成安装：
- 勾选 "I accept the terms in the License Agreement"，点击 Next
- 选择安装路径（默认 C:\Program Files\nodejs\ 即可），点击 Next
- 关键：确保以下选项已勾选（默认已勾选）：
  - Node.js runtime
  - npm package manager
  - Add to PATH
- 无需勾选 "Tools for Native Modules"，直接点击 Install
- 安装完成后点击 Finish

验证安装 打开命令提示符（CMD）或 PowerShell，执行以下命令：

bash
node -v    # 检查 Node.js 版本
npm -v     # 检查 npm 版本

如果能输出版本号（如 v20.11.1 和 10.2.4），说明安装成功。

步骤 2：安装 Git（含 git-bash）

Claude Code 在 Windows 上运行需要依赖 git-bash。

下载地址 访问 Git 官方下载页面：https://git-scm.com/downloads/win

安装步骤

双击下载的安装包，一路点击 Next，使用默认配置即可
关键：确保以下选项已勾选：
- Add Git to PATH
- Install Git Bash Here

查找 git-bash 路径 安装完成后，找到 bash.exe 的路径（记下来备用）：

64 位系统默认路径：C:\Program Files\Git\bin\bash.exe
32 位系统默认路径：C:\Program Files (x86)\Git\bin\bash.exe

验证路径：打开文件资源管理器，粘贴上述路径，确认 bash.exe 存在。

步骤 3：配置环境变量

Claude Code 需要通过环境变量找到 git-bash。

设置环境变量 CLAUDE_CODE_GIT_BASH_PATH

按下 Win + R，输入 sysdm.cpl，回车打开「系统属性」
切换到「高级」选项卡，点击「环境变量」
在「用户变量」区域点击「新建」：
- 变量名：CLAUDE_CODE_GIT_BASH_PATH
- 变量值：git-bash 路径（如 C:\Program Files\Git\bin\bash.exe）
点击「确定」保存所有设置

验证环境变量配置 关闭所有已打开的终端/程序，重新打开 CMD，执行以下命令：

bash
echo %CLAUDE_CODE_GIT_BASH_PATH%

如果输出你设置的 bash.exe 路径，说明配置成功。

步骤 4：创建配置目录（可选但推荐）

Claude Code 会使用用户目录下的 .claude 文件夹作为配置目录。

打开 CMD，执行以下命令自动创建：

bash
if not exist "%USERPROFILE%\.claude" mkdir "%USERPROFILE%\.claude"

验证：打开「此电脑」→ C:\Users\你的用户名，可以看到 .claude 文件夹。

步骤 5：安装 Claude Code

配置 npm 镜像（可选，加速下载） 如果 npm 下载速度慢，可配置淘宝镜像：

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

安装命令 打开 CMD 或 PowerShell，执行以下命令：

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

-g 参数表示全局安装，推荐。

安装成功后，会看到类似以下输出：

text
added 2 packages in 4s

1 package is looking for funding
  run `npm fund` for details

忽略以下提示（不影响使用）：

1 package is looking for funding - 包的公益提示
npm notice New minor version available - npm 版本更新提示

4. PowerShell 执行策略配置

如果在 PowerShell 中运行 claude 命令时出现以下错误：

text
无法加载文件 xxx.ps1，因为在此系统上禁止运行脚本

需要修改 PowerShell 执行策略。

解决方法

以管理员身份打开 PowerShell：
- 按下 Win 键，输入 PowerShell
- 右键「Windows PowerShell」，选择「以管理员身份运行」

执行以下命令：

powershell
Set-ExecutionPolicy RemoteSigned

输入 Y 并回车确认

验证：关闭所有 PowerShell 窗口，重新打开普通 PowerShell，再次运行 claude 命令

执行策略说明

策略	说明	推荐度
Restricted	禁止运行所有脚本（默认）	❌
RemoteSigned	允许本地脚本，远程脚本需签名	✅ 推荐
Unrestricted	允许所有脚本运行	❌ 不安全

5. VS Code 插件安装

5.1 安装 VS Code（如未安装） 访问 VS Code 官方下载页面：https://code.visualstudio.com/

5.2 设置 VS Code 中文界面（可选）

打开 VS Code，点击左侧边栏的「扩展」图标（快捷键 Ctrl+Shift+X）
搜索 Chinese，找到「Chinese (Simplified) Language Pack for VS Code」
点击「Install」安装，安装完成后重启 VS Code

5.3 安装 Claude Code 插件

打开 VS Code，点击左侧边栏的「扩展」图标
搜索 Claude Code，找到官方插件并安装
安装完成后，重启 VS Code
单击右上角 Claude Code 图标开始使用

5.4 配置 API Key（如使用 Coding Plan） 编辑配置文件 C:\Users\你的用户名\.claude\settings.json：

json
{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://coding.dashscope.aliyuncs.com/apps/anthropic",
        "ANTHROPIC_MODEL": "qwen3.5-plus"
    }
}

6. 常见问题解决

问题 1：提示「npm 不是内部或外部命令」

原因：Node.js 安装时未勾选「Add to PATH」

解决方法：

右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
在「系统变量」中找到「Path」，点击「编辑」
点击「新建」，添加 Node.js 安装路径（默认 C:\Program Files\nodejs\）
点击「确定」保存，重启命令提示符

问题 2：Linux/Ubuntu 系统安装 npm

如果在 Ubuntu/Debian 系统上遇到 npm: command not found：

bash
# 方案一：使用 apt 安装（推荐）
sudo apt update
sudo apt install -y nodejs npm

# 方案二：使用 NodeSource 源安装最新版
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

# 方案三：使用 nvm 安装（可指定版本）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install --lts
nvm alias default node

问题 3：提示「git-bash 找不到」

原因：环境变量路径错误或 Git 未安装

解决方法：

确认 bash.exe 路径正确
重新安装 Git 并勾选「Add to PATH」
确认环境变量 CLAUDE_CODE_GIT_BASH_PATH 已正确设置

问题 4：PowerShell 禁止运行脚本

原因：PowerShell 默认执行策略为 Restricted

解决方法：以管理员身份执行以下命令：

powershell
Set-ExecutionPolicy RemoteSigned

问题 5：npm 下载速度慢

解决方法：配置淘宝镜像

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

问题 6：进入含空格的目录

如果要进入 D:\Program Files (x86)\xxxx 这类含空格的路径：

CMD:

cmd
cd /d "D:\Program Files (x86)\xxxxx"

PowerShell:

powershell
cd "D:\Program Files (x86)\xxxx"

7. 快速命令参考

常用命令速查

命令	说明	示例
`node -v`	查看 Node.js 版本	`node -v`
`npm -v`	查看 npm 版本	`npm -v`
`git --version`	查看 Git 版本	`git --version`
`echo %VAR%`	查看环境变量	`echo %CLAUDE_CODE_GIT_BASH_PATH%`
`npm install -g`	全局安装 npm 包	`npm install -g claude-code`
`claude --version`	查看 Claude Code 版本	`claude --version`
`claude --help`	查看帮助信息	`claude --help`
`claude`	启动 Claude Code	`claude`

VS Code 常用快捷键

快捷键	功能
`Ctrl+Shift+X`	打开扩展面板
`Ctrl+Shift+P`	打开命令面板
`Ctrl+,`	打开设置

附录：安装检查清单

安装完成后，请确认以下项目：

Node.js 已安装（node -v 输出版本号）
npm 已安装（npm -v 输出版本号）
Git 已安装（git --version 输出版本号）
git-bash 路径已配置（echo %CLAUDE_CODE_GIT_BASH_PATH% 输出路径）
.claude 配置目录已创建
Claude Code 已安装（claude --version 输出版本号）
PowerShell 执行策略已配置
VS Code 插件已安装（可选）