Node.js 22+ 环境搭建与 OpenAI/Vercel AI SDK 快速入门

一、安装 Node.js 22+

先从 Node.js 官网 下载 v22.x 稳定版（LTS 或 Current 均可），根据系统选择对应安装包。安装完成后，终端执行 node -v 和 npm -v，看到版本号即表示环境就绪。

二、初始化项目与安装依赖

在项目根目录下创建文件夹，进入终端执行初始化命令：

npm init -y

接着安装核心依赖。这里需要引入 OpenAI 官方 Node.js 库以及 Vercel AI SDK：

npm install openai@latest
npm install ai@latest

三、基础配置

1. 配置 OpenAI 库

环境变量管理是安全调用的关键。在项目根目录创建 .env 文件，填入你的 API 密钥（需提前在 OpenAI 平台获取）：

OPENAI_API_KEY=your-api-key-here

创建一个 index.js 文件进行基础测试。注意导入方式和异步处理：

import OpenAI from 'openai';

const openai = new OpenAI({
  apiKey: process.env.OPENAI_API_KEY
});

async function testOpenAI() {
  const response = await openai.chat.completions.create({
    model: 'gpt-3.5-turbo',
    messages: [{ role: 'user', content: 'Hello World' }]
  });
  console.log(response.choices[0].message.content);
}

testOpenAI();

2. 配置 Vercel AI SDK

Vercel AI SDK 同样依赖 OpenAI 的密钥，无需额外配置。它提供了更便捷的流式调用接口，修改 index.js 如下：

import { openai } from '@ai-sdk/openai';
import { streamText } from 'ai';

async function testVercelAI() {
  const result = await streamText({
    model: openai('gpt-3.5-turbo'),
    prompt: 'Hello World'
  });

  // 流式输出结果
  for await (const chunk of result.textStream) {
    process.stdout.write(chunk);
  }
}

testVercelAI();

四、运行测试

为了让环境变量生效，建议安装 dotenv 并配置启动脚本：

npm install dotenv --save-dev

在 package.json 中添加启动命令：

{
  "scripts": {
    "start": "node -r dotenv/config index.js"
  }
}

最后执行 npm start，如果终端能正常输出 AI 回复，说明整个链路已经跑通。