AI 채팅 API를 쉽게 호출하는 TypeScript CLI 입문 – 5분 만에 작동하는 미니 도구

원문 발행 2026. 10. 12. 16:46원문 언어 일본어AI 한국어 번역Qiita AI 원문 보기

요약

본 글은 Claude와 OpenAI의 채팅 API를 TypeScript 기반의 명령줄 인터페이스(CLI)로 구현하는 방법을 안내합니다. Node.js, npm, typescript 등의 도구를 사용하여 간단한 미니 CLI를 제작할 수 있으며, 모델 선택 및 환경 변수 관리가 용이하도록 설계되었습니다.

핵심 포인트

TypeScript와 commander 라이브러리를 활용하여 CLI를 구축합니다.
Claude와 OpenAI의 API 호출 구조 차이를 분기 처리하는 방법을 배웁니다.
환경 변수를 통해 여러 모델에 걸쳐 키 관리가 통합됩니다.
스트리밍 응답 및 프롬프트 템플릿 재사용 기능을 구현할 수 있습니다.

본 글에서는 Claude와 OpenAI의 채팅 API를 명령줄 인터페이스(CLI)에서 호출하는 간단한 TypeScript 기반 미니 CLI를 제작합니다.

node your-cli.ts "질문 내용"과 같이 실행하면, 응답이 표준 출력에 표시됩니다.

초보자도 npm 패키지를 설치하고 몇 줄의 코드를 작성하는 것만으로 완성할 수 있습니다.

도구	용도
Node.js (v18 이상)	실행 환경
npm / yarn	패키지 관리
`typescript`	컴파일
`commander`	CLI 파서
`node-fetch` (또는 `axios`)	HTTP 요청
`dotenv`	환경 변수 관리

# 디렉토리 생성 → 초기화
mkdir ai-cli && cd ai-cli
npm init -y
...

src

디렉토리를 만들고, index.ts에 아래 내용을 저장합니다.

// src/index.ts
import { Command } from "commander";
import fetch from "node-fetch";
...

모델 선택
-m 옵션으로 Claude와 OpenAI 중 어느 것을 지정할 수 있습니다. 기본값은 최신 gpt-4o입니다.
환경 변수
.env에 OPENAI_API_KEY=YOUR_KEY를 작성하기만 하면, Claude에서도 동일한 키 이름으로 이용할 수 있습니다.
요청 구조의 차이점
Claude와 OpenAI는 JSON 형태가 약간 다르기 때문에, options.model에서 분기 처리하고 있습니다.

# TypeScript 컴파일
npx tsc
# 실행 예시
...

스트리밍 응답을 받아 실시간으로 표시합니다.
프롬프트 템플릿을 파일로 만들어 여러 명령어에서 재사용할 수 있습니다.
Docker화하여 어떤 환경에서도 동일한 CLI가 작동하도록 합니다.

AI 자동 생성 콘텐츠

원문 바로가기

AI 채팅 API를 쉽게 호출하는 TypeScript CLI 입문 – 5분 만에 작동하는 미니 도구

요약

핵심 포인트

댓글