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

二十一_
0 阅读7分钟

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

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

简单来说

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

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

🎯 本节目标

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

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

核心痛点与解决方案

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

痛点传统做法有多痛苦
依赖混乱各种 SDK 装一堆，版本冲突项目跑不起来，debug 半天
API Key 管理硬编码在代码里，泄露风险账号被盗，API 费用爆炸
模型切换想换模型？重写集成代码时间全浪费在重复工作上

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

传统做法：

1. 安装 openai SDK
2. 写 OpenAI 集成代码
3. 硬编码 API Key
4. 想换 Anthropic？重复 1-3 步

传统做法 vs LangChain 方案对比

解决：LangChain 统一管理

# 1. 安装核心包（所有模型通用）
npm install langchain @langchain/core

# 2. 安装需要的模型集成
npm install @langchain/openai  # OpenAI
npm install @langchain/anthropic  # Anthropic

# 3. 配置 API Key（环境变量）
export OPENAI_API_KEY=sk-xxx
export ANTHROPIC_API_KEY=sk-ant-xxx

效果对比：

指标传统做法LangChain
依赖管理多个 SDK 冲突统一包管理
API Key硬编码在代码环境变量安全管理
模型切换重写集成代码改一行字符串
版本控制混乱统一版本兼容

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

组件类比作用
Node.js电源插座提供运行环境
langchain主板核心框架，提供基础功能
@langchain/coreCPU核心库，所有功能的基础
@langchain/openaiNVIDIA 显卡提供 OpenAI 模型能力
@langchain/anthropicAMD 显卡提供 Anthropic 模型能力
API Key电费卡没有它，模型用不了
环境变量保险箱安全存放 API Key

安装流程图

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

LangChain 安装流程图

安装步骤详解

1. 环境准备

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

检查版本：

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

升级 Node.js：

  • 使用 nvm（推荐）：

    nvm install 20
nvm use 20

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

2. 安装核心包

为什么需要两个核心包？

包名作用大小是否必需
langchain完整框架，包含所有功能较大✅ 必需
@langchain/core核心库，提供基础类型和接口较小✅ 必需

安装命令：

# npm
npm install langchain @langchain/core

# pnpm
pnpm add langchain @langchain/core

# yarn
yarn add langchain @langchain/core

# bun
bun add langchain @langchain/core

💡 人话解读：

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

LangChain 包依赖关系图

3. 安装模型集成包

根据你想用的模型选择：

模型提供商安装命令模型标识示例
OpenAInpm install @langchain/openaiopenai:modelopenai:gpt-4.1
Anthropicnpm install @langchain/anthropicanthropic:modelanthropic:claude-3.5-sonnet
Googlenpm install @langchain/google-genaigoogle:modelgoogle:gemini-1.5-pro
Mistralnpm install @langchain/mistralaimistralai:modelmistralai:mistral-large-2
Coherenpm install @langchain/coherecohere:modelcohere:command-r-plus
Azure OpenAInpm install @langchain/openaiazure-openai:modelazure-openai:gpt-4

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

4. 配置 API Key

最安全的方式：环境变量

方法一：临时设置（仅当前终端）
# OpenAI
export OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxx

# Anthropic
export ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxxxxxxxxxx

# Google
export GOOGLE_API_KEY=AIzaSyxxxxxxxxxxxxxxxxxxxxxxxx
方法二：持久设置（推荐）

Mac/Linux：

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

# 打开文件
nano ~/.zshrc

# 添加以下内容
export OPENAI_API_KEY=sk-xxx
export 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-xxxxxxxxxxxxxxxxxxxxxxxx
ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxxxxxxxxxx

在代码中加载：

import dotenv from "dotenv";
dotenv.config();  // 加载 .env 文件

// 现在可以用 process.env.OPENAI_API_KEY 了

⚠️ 安全提示：

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

API Key 配置方式安全等级对比

验证安装

快速验证：10 行代码

import { createAgent } from "langchain";

// 测试 OpenAI
const 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 ? "✅" : "❌");

常见错误与解决方案

错误信息原因解决方案
Cannot find module 'langchain'核心包没安装运行 npm install langchain @langchain/core
Provider not found: openai模型集成包没安装运行 npm install @langchain/openai
API key not foundAPI Key 没配置检查环境变量或 .env 文件
429 Too Many RequestsAPI 调用频率过高检查是否有死循环，或升级 API 计划
401 UnauthorizedAPI Key 无效检查 API Key 是否正确，是否过期
Node.js version v18.x is not supportedNode.js 版本太低升级到 Node.js 20+

💡 人话解读：

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

验证安装与错误处理流程图

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

用户类型需求推荐安装包配置重点
新手学习快速上手，试试不同模型langchain @langchain/core @langchain/openai @langchain/anthropic用 .env 文件管理 API Key
生产开发稳定可靠，安全第一langchain @langchain/core @langchain/openai使用云服务密钥管理
成本敏感想省钱，用开源模型langchain @langchain/core @langchain/mistralai选择便宜的模型
多模型对比实验不同模型效果所有模型集成包环境变量统一管理
Azure 用户企业级需求，合规要求langchain @langchain/core @langchain/openai配置 Azure 端点

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

安装：

npm install langchain @langchain/core @langchain/openai

配置：

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

使用：

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

总结对比表

包名作用是否必需大小适用场景
langchain完整框架，所有功能✅ 必需较大所有场景
@langchain/core核心库，基础类型✅ 必需较小所有场景
@langchain/openaiOpenAI 集成❌ 按需中等使用 OpenAI 模型
@langchain/anthropicAnthropic 集成❌ 按需中等使用 Claude 模型
@langchain/google-genaiGoogle 集成❌ 按需中等使用 Gemini 模型
@langchain/mistralaiMistral 集成❌ 按需中等使用 Mistral 模型
dotenv加载 .env 文件❌ 开发环境很小本地开发

核心要点回顾

  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 开发环境已经准备就绪，接下来就是创造奇迹的时候了！🚀

关注「WEB大前端」，每周分享技术实践和行业洞察。

avatar
文章
阅读
粉丝