Node.js（前置依赖）

安装步骤

1. 下载：点击上方「下载 Node.js 22 LTS」，进入官方下载页。
2. 选版本：点绿色大按钮 Download Node.js 22 LTS（自动匹配你的系统）。
3. 安装：双击安装包 → 一路点「Next / 下一步」→ 直到安装完成。Windows 用户确认勾选了「Add to PATH」（默认已勾）。
4. 验证：打开终端（Windows 按 Win+R 输入 cmd 回车；Mac 用「终端」App），输入：

   node -v

   看到 v22.x.x 之类的版本号 = 装好了 ✅。再输入 npm -v 也能显示版本 = 完整。

VS Code

安装步骤

1. 下载：点击上方「下载 VS Code」，按你的系统下载（Windows / Mac）。
2. 安装：双击安装包 → 一路下一步。Windows 建议勾选「添加到 PATH」和「在资源管理器右键菜单打开」。
3. 验证：打开 VS Code，能正常显示欢迎页 = 成功 ✅。

玩法 B：装 Cline 扩展（编辑器内 AI 对话）

1. VS Code 左侧点「扩展」图标（四个方块），搜索 Cline → 点 Install 安装。
2. 安装后点右侧 Cline 图标打开面板。
3. 顶部 API Provider 选 OpenAI Compatible。
4. 按下面填好（API Key 用第 ③ 步第 2 步创建的 Key）：

Claude Code 接入（保姆级分步）

Claude Code 是 Anthropic 的终端 AI 编程工具，是本教程的重头戏。跟着下面 6 步走完就能用。

第 1 步：安装 Claude Code

前提：Node.js 18+（还没装的，先回到上面 Node.js）。

方式 A（推荐）— 官方一键脚本：

1. 点击下载：下载安装脚本
2. 在脚本所在目录打开终端（Mac / Linux），运行 bash install-claude-code.sh
3. 提示 > 时，粘贴你在控制台创建的 API Key，回车
4. 脚本自动完成「安装 + 写配置」。看到 Done! = 成功 ✅

方式 B — 手动安装：按你的系统执行：

复制# 方式1：官方原生安装器（推荐，零依赖、自动更新）
curl -fsSL https://claude.ai/install.sh | bash

# 方式2：npm 安装（兜底，需已装 Node.js）
npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

复制:: Windows 二选一：

:: 方案 A（推荐）：先装 WSL（微软商店搜 "WSL" 安装，重启），
:: 打开 Ubuntu 终端后运行：
curl -fsSL https://claude.ai/install.sh | bash

:: 方案 B（图省事）：直接用 Node.js 的 npm 安装
npm install -g @anthropic-ai/claude-code

验证：终端输入 claude --version，能显示版本号 = 安装成功 ✅

第 2 步：获取 API 密钥

1. 登录 AICraft Console
2. 找到「API Key」卡片 → 点「创建」
3. 复制生成的 sk- 开头密钥（sk- 后 40 位 hex）

第 3 步：配置 settings.json

用了一键脚本的顾客：脚本已自动写好，跳过本步，直接去第 4 步。
手动安装的顾客：找到配置文件（不存在就新建）：

如果 .claude 文件夹不存在，先创建它：

复制mkdir -p ~/.claude && touch ~/.claude/settings.json

复制New-Item -ItemType Directory -Force -Path "$HOME\.claude" | Out-Null
New-Item -ItemType File -Force -Path "$HOME\.claude\settings.json" | Out-Null

粘贴以下内容，把 YOUR_API_KEY 换成你的真 Key：

复制{
  "env": {
    "ANTHROPIC_BASE_URL": "https://aicraftapi.com",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_MODEL": "auto",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "auto",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "auto",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "auto",
    "CLAUDE_CODE_SUBAGENT_MODEL": "auto"
  }
}

第 4 步：验证连接

1. 打开新终端，进入你的项目目录：

   cd your-project
   claude

2. 启动后输入 /status，核对：

3. 问一句：「你好，介绍一下你自己」 → 有回复 = 全部打通 ✅

第 5 步：与 VS Code 合并使用（Vibe Coding）

1. VS Code 菜单「文件 → 打开文件夹」，选你的项目目录
2. 按 Ctrl+`（Ctrl + 左上角反引号）打开内置终端
3. 输入 claude 回车启动
4. 让 Claude 改代码 → 改动实时出现在编辑器左侧文件里

第 6 步：启用深度推理（可选）

在 Claude Code 中输入 /config → 将 Thinking mode 设为 true → 退出重进生效。

常见问题（报错急救）

配置后 Web Search 能用吗？

能用。AICraft 不禁用 Claude Code 的原生搜索。如需接入 MCP 搜索服务，参考 腾讯云 MCP 市场。

model: "auto" 会选什么模型？

Router 按任务选择：编码用 DeepSeek、中文用 Qwen、创意用 MiniMax。查看 X-AICraft-Routed-To 响应头。参见 Auto Router。

用 CC Switch 切换提供商（Windows / Mac 图形界面）

CC Switch 是免费开源的 Claude Code 提供商切换工具，用图形界面帮你写好 ~/.claude/settings.json，不用手改配置、一键在多个提供商间切换。和上面的「第 3 步手写 settings.json」二选一即可。

1. 下载安装：GitHub 搜 farion1231/claude-code-switch，或去官网下载 Windows / Mac 安装包（装完桌面出现 CC Switch 图标）。
2. 打开 CC Switch → 「添加提供商」，按下表填：

技能包（可选）

136 个 AI 开发技能，覆盖编码、测试、部署、安全、文档全流程。下载后导入到 Claude Code 中直接调用。

安装

解压到 Claude Code 的 skills 目录：

复制# 1. 下载并解压
unzip aicraft-skills.zip -d ~/.claude/skills/

# 2. 验证
ls ~/.claude/skills/
# 应看到 136 个技能目录（python / fastapi / code-review ...）

复制:: 1. 下载 aicraft-skills.zip
:: 2. 解压到 %USERPROFILE%\.claude\skills（右键压缩包 → 解压到 .claude\skills）

:: 3. PowerShell 验证
dir $env:USERPROFILE\.claude\skills\

使用

在 Claude Code 中输入 /skill-name 即可调用。例如：

复制/python-patterns         # 获取 Python 设计模式指导
/code-review             # 审查当前代码
/test-driven-development # TDD 开发流程
/deployment-strategies   # 部署策略建议
/security                # 安全审查
/api-design              # API 设计最佳实践