夜雨聆风Claude Code 安装与 API 接入教程（纯小白版）
先把这几个词捋清楚，不然后面肯定懵。
Claude 就是一个 AI 名字，跟你说 ChatGPT 差不多。Claude Code 呢，就是装在电脑里的 AI 工具，能帮你处理代码、改文件、查问题，比网页聊天强多了。
dbskill 是装进 Claude Code 里的能力包。你可以理解成：先有手机（Claude Code），再装 App（dbskill）。
还有一个你肯定见过的——GitHub。它就是放项目代码的网站，dbskill 的下载地址就在那儿。
第一步：先看看你电脑是啥系统
Mac 用户左上角有苹果图标，Windows 用户左下角有开始菜单。这两个系统的安装命令不一样，别混着用。
第二步：装 Claude Code
Windows 用户
先装一个前置软件 Git for Windows。不用深究是啥，当成必装的基础组件就行，一路默认安装。
然后打开 PowerShell——开始菜单搜索 PowerShell，点开就能看到深色窗口，前面带个 PS。
把下面这条命令整行复制进去，按回车：
irm https://claude.ai/install.ps1 | iex
弹出很多英文？别慌，那是安装过程，等它跑完就行。
装完了跑一下：
claude --version
有版本号出来就是成功了。你也可以再跑一下 claude doctor 做更全面的检查。
Mac 用户
按 Command + 空格搜索「终端」，回车打开。然后把官方安装命令整行复制进去：
curl -fsSL https://claude.ai/install.sh | bash
跑完执行 claude --version 验证，有版本号就说明装好了。同样可以用 claude doctor 再检查一遍。
第三步：装 dbskill
Claude Code 装好了，接下来才轮到 dbskill。顺序别反，dbskill 是给它用的，不是单独软件。
去 dbskill 的 GitHub 仓库，Windows 在 PowerShell、Mac 在终端执行这条命令：
npx skills add dontbesilent2025/dbskill
你不用搞懂 npx 是啥，当成安装口令就行。装好之后，在 Claude Code 里试试 /dbs 或 /dbs-diagnosis 这些命令，能调出来就说明装上了。
第四步：接账号还是接 API？
门装好了还得有钥匙。Claude Code 需要官方账号（Pro/Max/Team）或第三方 API 才能用。
有官方账号：运行 claude，浏览器会弹出来让你登录认证，按指示走完就行。第一次运行如果浏览器没自动弹，可以按 c 复制登录链接，手动粘贴到浏览器打开。
没有官方账号：走第三方 API 路线。我自己用的是云卷API，注册完直接给 API Key，不用折腾那些兑换码什么的流程。对接了 Claude、OpenAI、Gemini 这几个主流模型，切换顺，接口也稳，新手上来不想研究太多可以直接试这个。
如果你想多对比几家，Codesome（https://v3.codesome.cn/）和 Ofox（https://ofox.ai/x/dbskill）也都可以看看，各有特点。
第五步：把 API 接进去
拿到第三方 API 后，你会得到两样东西：服务地址（Base URL） 和 钥匙（API Key 或 Token）。先在当前窗口临时测试，能跑通了再考虑长期保存。
Windows 用户在 PowerShell 里跑：
$env:ANTHROPIC_BASE_URL="https://yunjuan.top/v1/chat/completions"; $env:ANTHROPIC_API_KEY="你的钥匙"; claude
Mac 用户在终端里跑：
ANTHROPIC_BASE_URL="https://yunjuan.top/v1/chat/completions" ANTHROPIC_API_KEY="你的钥匙" claude
能用了？好，然后可以考虑写进配置文件长期保存。官方配置文件路径是 ~/.claude/settings.json，格式大概是：
{
"$schema": "https://json.schemastore.org/claude-code-settings.json",
"env": {
"ANTHROPIC_BASE_URL": "https://yunjuan.top/v1/chat/completions",
"ANTHROPIC_API_KEY": "你的钥匙"
}
}
现在看不懂没关系，先跑通再说。
第六步：第一次怎么验证
别一上来就用它干正事。桌面新建一个文件夹，比如叫 claude-test，进去启动 Claude Code，让它帮你创建个小文件，或者试试 /dbs 能不能调出来。
卡住了？看这儿
黑窗口弹一堆英文是不是坏了？ 大多数时候不是，是在正常工作。
明明装好了还是不能用？ 关掉窗口重新打开试试，再跑一次 claude --version。
有账号还是登不进去？ 免费账号没有 Claude Code 权限，得是 Pro 以上才行。
买了第三方服务还是接不上？ 确认你拿的是 API Key 不是兑换码，Codesome 那边这两个是分开的。
说真的，这玩意儿步骤确实多，但真不是技术活。主要是网上教程默认你懂一半，害得很多小白卡在莫名其妙的地方。只要把「装工具」「装能力包」「接权限」这三件事分开一步步来，你已经比很多人强了。
