Claude Code + dbskill 零基础安装指南：从环境准备到 API 接入

前置概念（先把这些词翻成大白话）

术语	人话解释
Claude	一个 AI 产品名字，对标 ChatGPT
Claude Code	装在电脑里的 AI 工具，处理代码比网页版强
dbskill	装进 Claude Code 里的能力包，得先有 Claude Code 再装它
GitHub	存代码的网站，dbskill 的下载地址就在那儿
PowerShell / 终端	Windows/Mac 里的文字输入窗口，复制命令进去按回车执行

---

环境判断：Windows 还是 Mac？

两个系统的安装命令不一样，不能混用。

• Windows：左下角有开始菜单
• Mac：左上角有苹果图标

---

第一步：安装 Claude Code

Windows

1. 先装 Git for Windows（Claude Code 的前置依赖，一路默认安装）
2. 开始菜单搜索 PowerShell，打开深色窗口
3. 复制官方安装命令，整行粘贴进去，回车：

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

4. 等安装完成，执行 claude --version 验证（也可用 claude doctor 做全面检查）

Mac

1. Command + 空格 → 搜索「终端」→ 回车打开
2. 复制官方安装命令，整行粘贴进去：

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

3. 执行 claude --version 验证（可用 claude doctor 再检查）

第二步：安装 dbskill

前提：Claude Code 已装好。

dbskill 仓库地址：github.com/dontbesilen…

Windows 在 PowerShell、Mac 在终端执行：

npx skills add dontbesilent2025/dbskill

安装成功后，在 Claude Code 里调用 /dbs 或 /dbs-diagnosis 验证。

---

第三步：认证方式选择

Claude Code 需要登录认证，两条路：

方案 A：官方账号

运行 claude → 浏览器弹出登录 → 完成认证。第一次运行如果浏览器没自动弹，可按 c 复制登录链接手动打开。

限制：免费账号没有 Claude Code 权限，需要 Pro/Max/Team。

方案 B：第三方 API

适合没有官方账号的用户，主流选择：

对于有API接入需求的技术团队，云卷API（yunjuan.top/） 也是一个值得考虑的选项，他们对接了多个模型平台，接口稳定性不错。

第四步：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 或 /dbs-diagnosis 测试 dbskill 是否可用
• 让它创建一个小文件，验证整体可用性

---

常见卡点排查

现象	可能原因	解决方式
弹一堆英文	安装过程正常输出	等它跑完，看最后结果
装了但不能用	窗口未刷新	关掉重开，再跑一次 claude --version
账号登不进去	免费账号无权限	确认是 Pro 及以上账号
买完服务接不上	拿的是兑换码不是 API Key	云卷Api平台需要先兑换再创建 API Key

核心就三件事：装工具 → 装能力包 → 接权限。顺序别反，每一步都有验证命令，按步来就行。