← Back to all guides

2026 Node.js 与 TypeScript 调用 Claude、GPT 实战指南

在 2026 年，Node.js 与 TypeScript 仍是构建 AI 网关、客服系统、代码助手和自动化服务的主流技术栈。调用 Claude 或 GPT 的关键，不是手写复杂的 HTTP 封装，而是选择兼容官方协议的 API，并正确处理密钥、模型、超时、流式响应和成本控制。59API 提供 Claude 与 GPT 的按量付费访问，API 基地址为 https://api.59api.com，可配合 OpenAI SDK 使用，也兼容 Claude Code 与 Codex。

先准备 TypeScript 项目

建议使用 Node.js 20 或更高版本，并开启严格类型检查。创建项目后安装 OpenAI SDK：

npm install openai dotenv

在项目根目录创建 .env，不要把密钥写进源码或提交到 Git：

AI_API_KEY=你的59API密钥
AI_BASE_URL=https://api.59api.com

生产环境应使用云平台的 Secret、容器密钥或 CI/CD 密钥管理功能，并在日志中避免输出完整请求头。

使用 OpenAI SDK 调用 Claude 或 GPT

59API 兼容 OpenAI 的请求格式，因此可以复用成熟的 JavaScript SDK。下面的代码既适合调用 GPT，也适合调用 Claude 系列模型；实际模型名称应以 59API 控制台或文档中的可用列表为准：

import 'dotenv/config';
import OpenAI from 'openai';

const client = new OpenAI({
apiKey: process.env.AI_API_KEY,
baseURL: process.env.AI_BASE_URL
});

const response = await client.chat.completions.create({
model: 'claude-sonnet',
messages: [
{ role: 'system', content: '你是严谨的技术助手。' },
{ role: 'user', content: '用 TypeScript 解释什么是泛型。' }
],
temperature: 0.2
});

console.log(response.choices[0]?.message?.content);

对于 GPT，只需将 model 替换为账户可用的 GPT 模型。不要假设不同模型支持完全相同的参数；上线前应验证上下文长度、工具调用、视觉输入和结构化输出能力。

流式输出与超时处理

聊天界面通常需要边生成边显示。OpenAI SDK 支持流式响应：

const stream = await client.chat.completions.create({
model: 'gpt-4o-mini',
messages: [{ role: 'user', content: '写一段产品介绍。' }],
stream: true
});

for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content ?? '');
}

服务端还应设置合理的请求超时，并对网络错误、429 限流和 5xx 响应进行有限次数的指数退避。重试前要确认请求是否幂等；涉及工具调用、扣款或写入数据库时，必须使用请求 ID 或业务幂等键避免重复执行。

成本、稳定性与安全实践

• 控制输入长度：只发送必要的历史消息，较旧对话可先摘要，减少输入 Token。
• 按任务选模型：简单分类和改写使用 Haiku 或低成本 GPT，复杂推理再使用 Sonnet、Opus 或更高能力模型。
• 记录可观测数据：保存模型、延迟、状态码和 Token 用量，但要脱敏用户内容。
• 限制输出：设置 max_tokens，并在应用层校验 JSON、SQL 或工具参数。
• 保护密钥：浏览器端不要直接调用 API，统一由 Node.js 服务端代理。

59API 的优势在于按量付费、无需长期套餐，并提供 Claude Opus、Sonnet、Haiku、Fable 及 GPT 模型的访问。它使用原生官方质量模型，不通过降级模型压低价格；对于需要控制预算、又希望保留现有 OpenAI SDK 代码的团队，API 基地址保持统一，迁移成本较低。合适的做法是先用小额度测试真实请求、延迟和限流策略，再逐步接入生产流量。

接入 Claude Code 与 Codex

由于 59API 兼容相应协议，团队可以按照其最新文档配置 Claude Code、Codex 或 OpenAI SDK。重点检查环境变量名称、模型 ID 和权限范围，不要直接复制其他服务商的默认配置。若通过推荐链接注册，还可获得推荐返利，适合个人开发者和小团队持续降低 API 使用成本。完成注册并创建密钥后，先运行一条最小请求，再加入重试、监控和用量预算，通常是最稳妥的上线顺序。

Pricing · Docs