LangChain 教程 02｜环境安装：从 0 到 1 搭建开发环境

❝

📖 本篇导读：这是 LangChain 系列教程的第 2 篇。本篇将手把手教你搭建 LangChain 开发环境，包括安装核心包、配置模型集成、安全管理 API Key。读完预计需要 5 分钟。

简单来说

安装 LangChain 只需 3 步：安装核心包、安装模型集成包、配置 API Key。

就像组装电脑一样：先装主板（核心包），再装显卡（模型），最后插电源（API Key）。

🎯 本节目标

读完本节，你将能够回答这些问题：

• ❓ 安装 LangChain 需要什么环境？Node.js 版本有什么要求？
• ❓ 为什么要安装 @langchain/core？它和 langchain 有什么区别？
• ❓ 不同的模型提供商（OpenAI、Anthropic、Google）需要安装什么包？
• ❓ API Key 怎么配置？放在哪里安全？
• ❓ 安装后如何验证环境是否正确？

核心痛点与解决方案

痛点：AI 开发环境搭建的三大坑

举个例子： 你想先试试 OpenAI，后来觉得 Anthropic 更适合。

传统做法：

1. 安装 openai SDK2. 写 OpenAI 集成代码3. 硬编码 API Key4. 想换 Anthropic？重复 1-3 步

解决：LangChain 统一管理

# 1. 安装核心包（所有模型通用）npm install langchain @langchain/core# 2. 安装需要的模型集成npm install @langchain/openai  # OpenAInpm install @langchain/anthropic  # Anthropic# 3. 配置 API Key（环境变量）export OPENAI_API_KEY=sk-xxxexport ANTHROPIC_API_KEY=sk-ant-xxx

效果对比：

生活化类比：组装你的 AI 开发环境

安装流程图

┌─────────────────────────────────────┐│                                     ││   1. 检查 Node.js 版本 ≥ 20         ││      ↓                              ││   2. 安装核心包                      ││      langchain + @langchain/core     ││      ↓                              ││   3. 安装模型集成                    ││      @langchain/openai 等            ││      ↓                              ││   4. 配置 API Key（环境变量）         ││      ↓                              ││   5. 验证安装成功                    ││      ↓                              ││   6. 开始开发！                      ││                                     │└─────────────────────────────────────┘

安装步骤详解

1. 环境准备

Node.js 版本要求： ≥ 20.x

检查版本：

node -v# v20.11.1 ✅ 合格# v18.17.0 ❌ 不合格（需要升级）

升级 Node.js：

• 使用 nvm（推荐）：

  nvm install 20nvm use 20

• 或下载安装包：访问 Node.js 官网

2. 安装核心包

为什么需要两个核心包？

安装命令：

# npmnpm install langchain @langchain/core# pnpmpnpm add langchain @langchain/core# yarnyarn add langchain @langchain/core# bunbun add langchain @langchain/core

❝

💡 人话解读：

• langchain 是完整的工具箱，包含所有工具
• @langchain/core 是工具箱的基础零件，被其他模块依赖
• 两个都要装，否则会缺零件

3. 安装模型集成包

根据你想用的模型选择：

❝

⚠️ 注意：安装哪个模型的包，才能用哪个模型。如果只装了 @langchain/openai，就不能用 Anthropic 的模型。

4. 配置 API Key

最安全的方式：环境变量

方法一：临时设置（仅当前终端）

# OpenAIexport OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxx# Anthropicexport ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxxxxxxxxxx# Googleexport GOOGLE_API_KEY=AIzaSyxxxxxxxxxxxxxxxxxxxxxxxx

方法二：持久设置（推荐）

Mac/Linux：

编辑 ~/.bashrc 或 ~/.zshrc：

# 打开文件nano ~/.zshrc# 添加以下内容export OPENAI_API_KEY=sk-xxxexport ANTHROPIC_API_KEY=sk-ant-xxx# 保存并生效source ~/.zshrc

Windows：

1. 右键"此电脑" → 属性 → 高级系统设置 → 环境变量
2. 在"用户变量"中点击"新建"
3. 变量名输入 OPENAI_API_KEY，变量值输入你的 API Key
4. 同理添加其他 API Key

方法三：使用 .env 文件（开发环境）

安装 dotenv：

npm install dotenv

创建 .env 文件：

# .env 文件OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxxxxxxxxxx

在代码中加载：

import dotenv from"dotenv";dotenv.config();  // 加载 .env 文件// 现在可以用 process.env.OPENAI_API_KEY 了

❝

⚠️ 安全提示：

• .env 文件不要提交到 GitHub！在 .gitignore 中添加 *.env
• 生产环境建议使用云服务的密钥管理服务

验证安装

快速验证：10 行代码

import { createAgent } from"langchain";// 测试 OpenAIconst agent1 = createAgent({  model: "openai:gpt-4.1",});// 测试 Anthropic （需要安装 @langchain/anthropic）const agent2 = createAgent({  model: "anthropic:claude-3.5-sonnet",});console.log("LangChain 安装成功！");console.log("OpenAI 模型配置：", agent1 ? "✅" : "❌");console.log("Anthropic 模型配置：", agent2 ? "✅" : "❌");

常见错误与解决方案

❝

💡 人话解读：

• 找不到模块 → 没装对应的包
• API Key 错误 → 配置有问题
• 版本错误 → Node.js 版本太低

业务场景：不同用户的安装选择

示例：企业级配置（Azure OpenAI）

安装：

npm install langchain @langchain/core @langchain/openai

配置：

export AZURE_OPENAI_API_KEY=xxxxxxxxxxxxxxxxexport AZURE_OPENAI_ENDPOINT=https://your-resource.openai.azure.com/export AZURE_OPENAI_DEPLOYMENT_NAME=gpt-4

使用：

const agent = createAgent({  model: "azure-openai:gpt-4",});

总结对比表

核心要点回顾

1. ✅ 环境要求：Node.js 20+，Bun v1.0.0+（如果用 Bun）

2. ✅ 必装包：langchain + @langchain/core（核心框架）

3. ✅ 模型包：想用哪个模型，就装哪个模型的集成包

• OpenAI → @langchain/openai
• Anthropic → @langchain/anthropic
• Google → @langchain/google-genai

4. ✅ API Key 配置：

• 开发环境：.env 文件 + dotenv
• 生产环境：环境变量或云服务密钥管理
• 绝对不要硬编码在代码里！

5. ✅ 验证步骤：

• 运行简单的创建 Agent 代码
• 检查是否能成功初始化不同模型
• 处理常见错误：模块缺失、API Key 错误、版本问题

记住：安装配置是 AI 开发的第一步，也是最基础的一步。

把环境搭好，后面的开发会顺畅很多。就像盖房子一样，地基打好了，楼才能盖得高。

现在，你的 LangChain 开发环境已经准备就绪，接下来就是创造奇迹的时候了！🚀

分享前端技术干货、实战经验与行业思考。聚焦 JavaScript、框架、工程化与 AI驱动的Web前沿趋势。探索大模型应用、智能UI实践与工具提效，用AI赋能前端开发。关注我，一起精进技能，探索技术新边界！