零基础新手指南：15 分钟开始 vibe coding

不需要编程基础，只要识字、会打字。这一页带你从零开始：装好工具、完成配置，然后让 AI 帮你写出真正能用的软件。全程免费额度内完成。有问题随时写信给 support@apiboop.com。

什么是 vibe coding？

传统编程像亲手盖房子：每一块砖都要自己码。vibe coding 像请了一位随叫随到的工程队：你用日常语言说"我要一个记账小程序"，AI 就把代码写好、跑起来，还能按你的要求反复改。你负责说清楚想要什么和验收结果，写代码的活交给 AI。

你需要准备的只有三样：一台电脑（Windows / macOS / Linux 都行）、一个邮箱、15 分钟。

第 1 步 · 注册并拿到你的"钥匙"（API Key）

点首页的「立即开始」，用邮箱注册（需要邀请资格码——本阶段是受邀试用）。
进入控制台 → Keys，点「创建」。
屏幕会显示一个 am- 开头的字符串——这就是你的 API Key，相当于钥匙。它只显示这一次，立刻复制，保存到记事本里，别发给任何人。

第 2 步 · 安装三样工具（每样都有"已装？跳过"判断）

AI 编程工具是"住在终端里的程序员"。这一步装三样，每样先花 10 秒判断是否已经装过——装过的直接跳过。终端（Windows 按 Win 键输入 PowerShell 回车；macOS 打开启动台搜"终端"）就是一个"用打字代替点击"的窗口，别怕输错——它会直接告诉你哪里错了。

2.1 Node.js —— AI 工具的运行环境

判断：在终端输入 node -v——显示版本号 = 已装，跳到 2.2；报"npm 不是内部或外部命令 / command not found" = 没装，往下走。

打开 nodejs.org 的下载页：最上方的命令行代码块（写着 fnm 的）直接忽略——那是给进阶用户的；确认版本号旁有 LTS 标记（如 v26.13.0 LTS），往下找"或者获得适用于 …平台的 Node.js® 构建"，点绿色的 "Windows 安装程序(.msi)"（macOS 是 "macOS 安装程序(.pkg)"）。
双击安装，一路下一步（保持默认勾选，包括 Add to PATH）。
关键：关掉所有终端窗口，重新开一个——刚装的程序只有新终端才找得到。
验证：新终端输入 node -v 和 npm -v，都有版本号 = 成功。仍报错？重启电脑再试一次。

2.2 一个 AI 编程工具（三选一）

判断：终端输入 claude --version 有版本号 = 已装；没有就选一个装（推荐新手用 Claude Code）：

Claude Code：npm install -g @anthropic-ai/claude-code，看到 "added 1 package" 字样即成功。
Codex CLI：npm install -g @openai/codex。
Gemini CLI：npm install -g @google/gemini-cli。

npm 下载慢或失败，重试一次通常就好。

2.3 cc-switch —— 配置管理器（"一键导入"的载体）

判断：开始菜单（macOS：启动台）搜 "CC Switch"——搜得到 = 已装，直接进入第 3 步。它是专门管理 AI 编程工具配置的桌面软件，第 3 步的"一键导入"由它完成；没有它也可以手动复制配置（见第 3 步说明），二选一。

打开下载页：github.com/farion1231/cc-switch/releases/latest（永远指向最新版）。
在 Assets 资产列表里，Windows 点形如 CC-Switch-v…-Windows.msi 的文件（认准 -Windows.msi 结尾；不要下带 arm64、Portable、.sig 的，也不要下 Source code）。macOS 点 CC-Switch-v…-macOS.dmg。
双击安装。Windows 可能弹蓝色警告"Windows 已保护你的电脑"——点 更多信息 → 仍要运行（开源免费，可放心），然后一路下一步。
macOS：打开 .dmg，把 CC Switch 图标拖进 Applications 文件夹；首次打开若提示"无法验证开发者"：系统设置 → 隐私与安全性 → 点"仍要打开"。
装完打开 CC Switch 备用。

第 3 步 · 一键配置：选工具、选模型、点一下

下面选好你的工具和默认模型，点一下导入按钮就全部配好——Base URL、API Key、模型一起带过去，CLI 里零手工配置。没装 cc-switch？用向导下方的"复制配置"手动方式，效果完全一样，不用回头安装。

一键配置（推荐）

选工具、选模型、点一下——不用手写任何配置文件。

第 1 步 · 选择你的工具

第 2 步 · 选择默认模型(导入后立即可用,随时可换)

claude-sonnet-5-5推荐claude-haiku-5-5快速claude-opus-5-5高性能glm-5.3-flash快速

一键导入到 claude-sonnet-5-5

不用 cc-switch?复制这段配置到指定文件即可:

# %USERPROFILE%\.claude\settings.json  (macOS/Linux: ~/.claude/settings.json)
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.apiboop.com",
    "ANTHROPIC_AUTH_TOKEN": "am-xxxx",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5"
  }
}

导入包含 Base URL、API Key 与所选模型,CLI 无需任何手工配置。需要 cc-switch 桌面版: 下载 / 了解 cc-switch

第 4 步 · 第一次对话

新建一个文件夹（比如桌面上右键 → 新建文件夹，命名 my-first-app）。
在终端里进入它：输入 cd 加一个空格，把文件夹拖进终端窗口，回车。
输入启动命令：Claude Code 输 claude；Codex 输 codex；Gemini 输 gemini。第一次会让你确认一些权限提示，看到 Yes/允许就选允许。
看到输入框后，把下面第一个练习的提示词复制粘贴进去，回车——接下来就是见证奇迹的时刻。

第 5 步 · 三个手把手练习（从易到难）

每个练习都是"复制提示词 → 粘贴 → 等 AI 写完 → 按它说的运行"。做完三个，你就已经会 vibe coding 了。

练习 A（10 分钟）：命令行记账本

效果：一个能记账、查余额的小工具，数据不会丢。

把这段话原样发给 AI

用 Python 写一个命令行记账小工具：可以记录收入和支出（金额 + 备注），随时查看当前余额和全部流水，数据保存在本地文件 money.json 里，程序退出再打开数据还在。写完之后一步一步告诉我怎么运行它。

练习 B（20 分钟）：你的个人主页

效果：一个真正能打开的网页，做完可以发给朋友看。

把这段话原样发给 AI

用 HTML + CSS + JavaScript 写一个单文件的个人主页 index.html：包含我的名字、一段自我介绍、三个兴趣爱好卡片，配色要好看，手机上打开也要排版正常。写完告诉我怎么在浏览器里打开看效果。

练习 C（30 分钟）：番茄钟待办清单

效果：一个实用的学习/工作软件——做完它你就从"新手"毕业了。

把这段话原样发给 AI

做一个「番茄钟 + 待办清单」网页应用：可以添加待办事项、点击勾选完成、删除；页面中央有一个 25 分钟倒计时番茄钟，可以开始/暂停/重置；所有数据保存在浏览器 localStorage 里，刷新页面不丢失。单文件实现，界面要现代美观。写完教我怎么打开使用。

继续迭代的心法

AI 写完只是第一版。接下来用日常语言继续提要求："把标题改成红色"、"加一个导出按钮"、"数字看不清，字放大一点"。它会一直改到你满意。改坏了就说"刚才那个改动撤销，回到上一版"。

常见名词小词典

终端 / 命令行：用打字代替鼠标点击操作电脑的窗口。
API Key：你的专属钥匙，证明"这个请求是你发的"，费用记在你的账户。
Token：AI 计费的计数单位，约等于一个词/半个汉字。每次调用的用量在控制台 → Usage 透明可查。
模型（Model）：不同的"AI 大脑"。便宜的适合日常任务，贵的能力强。切换不用重新配置，在工具里说"/model"或改一行设置即可。
提示词（Prompt）：你对 AI 说的话。写得越具体，结果越好。

卡住了？

AI 报错 → 把红色报错文字整段复制发给它，说"帮我解决"——报错是给 AI 看的路标。
连不上 / 提示额度 → 控制台首页看余额和试用额度；额度类错误的含义见 API 文档的错误表。
其它问题 → support@apiboop.com，附上你看到的提示文字。

进入完整 API 文档看模型与价格

API 文档 · apiboop.com