2026 年，30 分钟用上高效Skills（小白快速配置指南）

说实话，这两周我被同一个问题问烦了。

不是真的烦。是心疼。

后台每天都有人问："Skills 看着好厉害，但我连环境都搭不起来。"群里也是，隔三差五就有人发截图——终端里一片红色报错，配上一句"算了，我放弃了"。

我太理解这种感觉了。你在群里刷到别人用 Skills 三十秒做完一份报表，兴冲冲打开教程准备跟着学。结果第一步就看到"安装 Node.js"、"配置环境变量"、"终端输入 npm"——每个字你都认识，连在一起就像天书。

然后你默默关掉页面，跟自己说"算了，等有人出个简单点的教程再说吧"。

就像买了一把电钻，却被说明书劝退了。

电钻没问题，你也没问题。问题出在那份说明书上。

这是我被问过最多的问题——"有没有一份完全不需要编程基础的环境配置教程？"

有了。就是这篇。

你不需要会写代码。你只需要会复制粘贴。

今天这篇文章，我会把 Claude Code Skills 运行所需的全部环境配置，拆成 5 个模块，手把手带你走一遍。每一步都有截图，每一个坑我都提前帮你标出来。跟着做，30 分钟，全部搞定。

话不多说，我们开始。

先看全局地图

在动手之前，先花 30 秒看一眼我们今天要走的路。

就像装修房子，先看一眼户型图，心里有个数，干起来才不慌。

今天一共 5 个模块，按顺序来：

总计不超过 30 分钟。

看到这里你可能已经有几个词看不懂了——IDE？终端？npm？GLM？

别慌。三句话扫盲：

IDE 就是你写字用的 Word，只不过是给代码用的 Word。你不需要写代码，但需要它来看文件、开终端。

终端 就是你电脑里的对讲机。你在里面打一行字，电脑就照做。

npm 就是一个"应用商店"，用来下载和安装工具的。

就这三个。记不住也没关系，跟着做就行。

模块 1：安装你的"写字台"——IDE

第一步，给自己装一个编辑器。

我推荐两个选择：Cursor 或者 VS Code。

如果你是零基础，选 Cursor。如果你之前用过 VS Code，直接用 VS Code 也行。

为什么推荐 Cursor？

Cursor 对新手更友好——界面干净、中文支持好、终端默认就在底下。 VS Code 能干同样的活，但你可能得自己折腾几分钟设置。零基础的话，少折腾就是最大的优势。

当然，如果你已经在用 VS Code，完全不用换。VS Code 一样能跑，只是需要自己装几个插件。本文后面的操作两个编辑器通用。

下载安装 Cursor

打开 cursor.com，点击下载按钮，选择你的操作系统。

下载完成后：

- macOS：双击 .dmg 文件，把 Cursor 拖进 Applications 文件夹

- Windows：双击 .exe 安装包，一路"下一步"

安装完打开，你会看到一个欢迎界面。

长什么样不重要，你只需要认识两个地方：左边的文件树和底部的终端。

文件树就是你的文件管理器，你电脑上的文件夹和文件都会显示在这里。终端就是我们等会要用到的"对讲机"。这两个区域在整个教程里会反复用到。

备选：VS Code 用户去 code.visualstudio.com 下载安装，后续操作完全相同。

第一步，搞定。

模块 2：打开你的"对讲机"——终端配置

这一步要装两样东西：Node.js 和 Git（Windows 用户）。

还记得前面说的"对讲机"吗？现在来打开它。

- macOS：按 Command + 空格，输入"终端"或"Terminal"，回车

- Windows：按 Win + R，输入 powershell，回车

- 或者：直接在 Cursor / VS Code 里按 ` Ctrl + ``（键盘左上角那个反引号键），底部就弹出终端了

推荐用编辑器自带的终端，省得来回切窗口。

安装 Node.js

Node.js 是什么？你不需要知道。你只需要知道一件事：Node.js 就是 Claude Code 运行需要的"燃料"。 没有它，Claude Code 跑不起来。

去 Node.js 官网：https://nodejs.org/zh-cn/download

下载 LTS 版本（长期支持版）。别选右边那个"最新版"，LTS 最稳。

下载完双击安装，一路"下一步"到底。两个系统都一样，不需要改任何选项。

装完之后，打开终端，输入两行命令验证：

node -v
npm -v

看到版本号了？比如 v22.22.0 和 10.2.0？ 或者其他类似的版本号。

看到版本号跳出来的那一刻——你的电脑，刚学会了第一句新语言。

真的，就这么简单。 你可能觉得"装环境"听着吓人，其实就是下载、下一步、完事。

踩坑提醒：Node.js 版本必须 18 以上。如果你电脑上之前装过旧版本，显示 v16.x 或更低，建议卸载重装最新 LTS。别省这两分钟，后面会省你两小时的排错时间。

安装 Git（Windows 用户专属）

macOS 自带 Git，跳过这段。

Windows 用户需要手动装一下。去 git-scm.com，下载安装，一路默认选项到底。

装完在终端输入：

git --version

看到版本号就行。

常见问题：npm 报错怎么办

如果你输入 npm -v 之后看到红色报错，别慌。

大概率是两种情况：

情况一：提示"npm 不是内部命令"——说明 Node.js 没装成功，或者环境变量没配好。最简单的解决方案：卸载，重新下载安装，这次安装时记得勾选"Add to PATH"选项。

情况二：提示权限不足——macOS 用户在命令前面加 sudo，Windows 用户用管理员权限打开 PowerShell。

还是搞不定？直接在评论区发你的报错截图，我帮你看。

到这了。一半搞定了。

剩下的，只会越来越简单。

模块 3：请出主角——安装 Claude Code

前面装的都是配角。现在，主角登场。

Claude Code 是什么？一句话：

它不是聊天机器人。它是住在你终端里的 AI 同事。

你跟它说"帮我做个报表"，它不是回你一段文字——它直接动手帮你做。打开文件、写代码、跑测试、生成报告，全部自己来。你就负责看着它干活，最后验收成果。

这玩意的安装比你想象的简单得多。

macOS 安装

打开终端，输入下面这行命令：

brew install claude-code

没装 Homebrew？没关系，用这个：

curl -fsSL https://cli.claude.ai/install.sh | sh

复制。粘贴。回车。等它跑完。

Windows 安装

打开 PowerShell（管理员权限），输入：

irm https://cli.claude.ai/install.ps1 | iex

同样，复制、粘贴、回车、等着。

验证安装

装完之后，输入：

claude --version

看到版本号了？

主角已就位。

一行命令就装好了。就这？ 对，就这。难的从来不是工具本身。

安装失败？看这里

三个最常见的问题：

问题一："command not found"——关掉终端，重新打开再试。有时候安装完需要刷新一下终端的环境。

问题二：macOS 提示"无法验证开发者"——去系统偏好设置 → 隐私与安全性，点"仍然允许"。

问题三：Windows 提示"执行策略限制"——在 PowerShell 里先跑这行：Set-ExecutionPolicy RemoteSigned -Scope CurrentUser，然后重新安装。

搞不定的，老规矩，评论区发截图。

前三步都是热身。接下来，才是真正的硬骨头——但我已经把它嚼碎了喂给你。

模块 4：给 Claude Code 通电——配置 GLM Coding Plan

这是整个教程里最关键的一步，也是很多人卡住的地方。

但别怕。我把每一步都拆到了不能再细。

先说一个问题：Claude Code 装好了，为什么不能直接用？

因为它需要一个"电源"——API。你可以理解成：Claude Code 是一辆车，API 就是油。车再好，没油跑不了。

Anthropic 官方的 API 有两个问题：贵，而且需要外币信用卡。对大多数国内用户来说，门槛太高了。

所以我们用智谱的 GLM Coding Plan。

这是智谱推出的 Claude Code 专属套餐。简单来说，智谱帮你把 Claude Code 跑起来需要的 API 服务包了。你不用跟 Anthropic 官方打交道，直接在国内平台上操作。

如果 Claude Code 是一辆车，GLM Coding Plan 就是你的加油卡。 不用折腾外币卡，不用梯子，支付宝直接充。价格嘛——你自己去看，反正比 Anthropic 官方便宜得让人想骂街。

它分三档套餐——Lite、Pro、Max。新手上 Lite 就够用了，后面量上来了随时升。

步骤一：注册智谱 + 获取 API Key

打开智谱开放平台：https://open.bigmodel.cn/

没注册过的，用手机号注册一个账号。注册流程很简单，短信验证码搞定。

注册完登录，进入控制台。找到左侧菜单里的 "API Keys"，点进去。

点 "创建 API Key"，给它起个名字（随便写，比如"claude-code"），点确认。

系统会生成一串密钥。这串密钥只显示一次，复制下来，找个安全的地方存好。记事本、备忘录、密码管理器，随你。丢了就得重新建一个。

步骤二：配置 settings.json

这一步是把你的 API Key 告诉 Claude Code，让它知道去哪里"加油"。

先找到配置文件的位置：

- macOS：~/.claude/settings.json

- Windows：%USERPROFILE%.claudesettings.json

如果这个文件不存在，自己创建一个。

在终端里操作：

macOS：

mkdir -p ~/.claude
open ~/.claude

Windows：

mkdir %USERPROFILE%.claude
explorer %USERPROFILE%.claude

这会打开文件夹。在里面新建一个文件，命名为 settings.json。

用 Cursor 或者记事本打开这个文件，把下面这段内容完整复制粘贴进去：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的智谱API Key粘贴在这里",
    "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/paas/v4"
  }
}

把"你的智谱API Key粘贴在这里"替换成你刚才复制的那串密钥。 引号别删，前后别多加空格。

举个例子，替换完应该长这样：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "abc123xyz456...",
    "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/paas/v4"
  }
}

ANTHROPIC_BASE_URL 那行不用改，原封不动留着就行。这行告诉 Claude Code 去智谱的服务器拿数据，而不是去 Anthropic 官方。

保存文件。Ctrl + S（macOS 是 Command + S）。

步骤三：跳过登录配置

Claude Code 默认启动时会要求你登录 Anthropic 账号。但我们用的是智谱的 API，不需要登录官方账号。

最简单的方式，在终端里运行一键配置工具：

npx @z_ai/coding-helper

这个工具是智谱官方提供的一键配置助手，会自动帮你完成剩余的配置，包括跳过登录验证。终端里会出现几个选项，按提示操作就行。全程不超过一分钟。

如果你想手动配置（或者上面的命令跑不通），也可以手动来。在 ~/.claude/ 目录下创建一个 .claude.json 文件（注意前面有个点），内容如下：

{
  "oauthAccount": "placeholder"
}

保存。

（技术细节：智谱会自动处理模型映射，你不需要改任何东西。）

最硬的骨头，啃完了。

后面全是甜的。

模块 5：见证时刻——验证配置成功

到这一步了。

深呼吸。

你已经装了 IDE，配了终端，装了 Claude Code，接好了 API。

五个模块，四个已经搞定。全部的准备工作，都做完了。

现在，我们来看看它到底能不能跑。

启动 Claude Code

打开 Cursor（或者 VS Code），在里面新开一个终端。

先创建一个工作目录并进入：

mkdir ~/my-first-project
cd ~/my-first-project

然后输入：

claude

回车。

如果一切正常，你会看到 Claude Code 的欢迎界面。它可能会问你是否信任当前目录，选 Yes。

发送你的第一条消息

在光标闪烁的地方，打一句话：

你好，你能帮我构建 skills 吗?

回车。

等几秒钟。

你会看到它开始回复。一行一行地，像有人在那头打字一样。

那一刻你可能会愣住。不是因为它说了什么厉害的话——而是因为它真的在了。 住在你电脑里的 AI 同事，刚跟你打了第一声招呼。

如果你看到了回复——

停一下。

回头想想你 30 分钟前的状态。那时候你可能还在纠结"我到底能不能搞定这个东西"。

现在，你面前这个终端窗口里，一个 AI 正在用中文跟你对话。它不是网页上的聊天框。它住在你的电脑里。它可以帮你读文件、写代码、做报表、搭项目。

30 分钟前，你觉得这是天书。现在，天书在跟你说话了。

查看配置状态

最后一步验证。在 Claude Code 里输入：

/status

你会看到当前使用的模型、API 状态等信息。显示正常就说明一切就绪。

常见验证问题

问题一：输入 claude 后一直卡住不动——检查你的网络。智谱的 API 不需要科学上网，但你的网络得能正常访问 open.bigmodel.cn。

问题二：提示"API Key 无效"——回到步骤二，检查 settings.json 里的 Key 有没有复制完整，前后有没有多余的空格。

问题三：能启动但回复乱码——大概率是模型映射问题，用 npx @z_ai/coding-helper 重新跑一遍配置。

搞不定的，评论区等你。我说过，答到你跑通为止。

🌊

这篇是前置教程。环境搭好了，接下来才是真正好玩的部分——用 Skills 干活。

之前的 Skills 系列文章，建议按顺序补课：

- 第一篇：Claude Skills 保姆级教程 01 —— 任何水平照做就行

- 第二篇：Claude Skills 保姆级教程 02 —— 从 0 搭建自己的 Skill

- 第三篇：2026用上这些Skills，你就跑赢了90%的人

回顾一下你刚才做了什么

花 30 分钟，你完成了这些事：

✅ 装了 Cursor，有了自己的"写字台"

✅ 装了 Node.js，给系统加了"燃料"

✅ 装了 Claude Code，把 AI 同事请进了终端

✅ 配了 GLM Coding Plan，接通了"电源"

✅ 发出了第一条消息，确认一切正常

30 分钟前，你觉得"环境配置"是一座翻不过去的山。

现在你站在山顶了。

工具从来不挑人。是你选择了走到这里。

碰到任何问题，评论区直接问。截图发出来，我答到你跑通为止。

觉得有用，转发给那个也被环境配置卡住的朋友。

你的 AI 同事。已经就位。

起点。不是终点。