학습 자료

프로젝트 세팅 — Node · TS · @anthropic-ai/sdk 와 API 키

Article

무료 AI 편에서 우리는 LLM 이 무엇인지 개념으로 봤다. 이제부터는 다르다. 진짜 코드로, 진짜 돌아가는 AI 앱을 직접 만든다.

이 편이 끝나면 손에 하나 남는다. "내 문서에 답하는 AI 어시스턴트." 이번 Course 에서는 그걸 터미널에서 대화하는 CLI 로 만들고, 다음 Course 에서 내 문서를 검색해 답하는 앱으로 키운다.

그 첫걸음은 코드가 아니다. 재료를 준비하는 것이다. 요리를 시작하기 전에 도마와 칼을 꺼내듯, 오늘은 프로젝트를 만들고 도구를 깐다.

무엇을 깔 건가

세 가지다. 지금 다 이해 안 해도 된다. 하나씩 깔면서 설명한다.

오늘 준비할 세 가지
  1. Node.js자바스크립트를 컴퓨터에서 실행하는 엔진
  2. TypeScript타입이 붙은 자바스크립트. 실수를 미리 잡아준다
  3. @anthropic-ai/sdkClaude 를 코드로 부르는 공식 도구
여기에 API 키 하나를 더하면, 다음 강의에서 바로 Claude 와 대화할 수 있다.

Node 가 있는지 확인한다

Node.js 는 자바스크립트를 컴퓨터에서 돌리는 프로그램이다. 이미 깔려 있는 경우가 많으니 먼저 확인한다. 터미널에 이렇게 친다.

node -v
터미널
  • v22.22.2

숫자가 나오면 깔려 있는 것이다. v20 이상이면 이 편을 끝까지 따라올 수 있다. command not found 가 나오면 nodejs.org 에서 LTS 버전을 받아 깐 뒤 터미널을 새로 연다.

프로젝트 폴더를 만든다

앱이 살 집을 만든다. 원하는 위치에서 폴더를 만들고 그 안으로 들어간다.

mkdir my-ai-assistant
cd my-ai-assistant
npm init -y

npm init -y 는 package.json 이라는 파일을 만든다. 이 프로젝트가 무슨 도구를 쓰는지 적어두는 명세서다.

터미널
  • Wrote to .../my-ai-assistant/package.json:
  • {
  • "name": "my-ai-assistant",
  • "version": "1.0.0",
  • "description": "",
  • "main": "index.js",
  • "scripts": {
  • "test": "echo \"Error: no test specified\" && exit 1"
  • },
  • "keywords": [],
  • "author": "",
  • "license": "ISC"
  • }

도구를 깐다

이제 세 가지를 설치한다. SDK 하나와, TypeScript 를 돌릴 도구 둘이다.

npm i @anthropic-ai/sdk
npm i -D typescript tsx @types/node
  • @anthropic-ai/sdk: Claude 를 부르는 공식 도구 (본체)
  • typescript · @types/node: 타입을 붙여주는 도구
  • tsx: TypeScript 파일을 바로 실행해주는 도구 (컴파일 단계를 건너뛰게 해준다)

-D 는 "개발할 때만 쓰는 도구"라는 표시다. 실제 배포에는 안 들어간다.

터미널
  • $ npm i @anthropic-ai/sdk
  • added 7 packages, and audited 8 packages in 2s
  • found 0 vulnerabilities
  • $ npm i -D typescript tsx @types/node
  • added 7 packages, and audited 15 packages in 3s
  • found 0 vulnerabilities

API 키를 넣을 자리를 만든다

키 자체는 console.anthropic.com 에서 발급받는다 (결제 등록이 필요하다, 실습은 몇 센트 수준이다). 실제 발급과 첫 호출은 2강에서 한다. 오늘은 키가 안전하게 들어갈 자리만 판다.

프로젝트 루트에 .env 파일을 만들고 이렇게 적는다.

ANTHROPIC_API_KEY=여기에_발급받은_키를_붙여넣는다

그리고 이 키가 실수로 GitHub 에 올라가지 않도록 .gitignore 에 .env 를 넣는다.

# .gitignore
node_modules
.env

대신 .env.example 을 만들어 "이런 키가 필요하다"는 사실만 공유한다 (값은 비운다).

# .env.example
ANTHROPIC_API_KEY=

지금까지 만든 것

폴더 구조는 이렇게 생겼다.

my-ai-assistant/
  • my-ai-assistant
    • node_modules설치된 도구들 (건드리지 않는다)
    • package.json이 프로젝트의 명세서
    • .envAPI 키 (git 이 무시)
    • .env.example키 이름만 공유
    • .gitignore올리지 않을 것 목록

아직 우리가 짠 코드는 한 줄도 없다. 그래도 괜찮다. 집을 다 지었으니, 다음 강의에서 첫 손님(Claude)을 부른다.

정리하면

AI 앱도 결국 평범한 Node 프로젝트다. SDK 를 깔고 키를 안전하게 넣으면 준비 끝이다.

다시 짚어보기
  1. 01

    Node 가 있는지 확인했다

    node -v 로 v20 이상인지 봤다. 없으면 nodejs.org 에서 LTS 를 받는다.

    node -v
  2. 02

    프로젝트를 만들고 SDK 를 깔았다

    npm init 으로 package.json 을 만들고, @anthropic-ai/sdk 와 TypeScript 도구를 설치했다.

    npm i @anthropic-ai/sdk
  3. 03

    키를 넣을 자리를 만들었다

    .env 에 키를 넣고, .gitignore 로 그 파일을 숨겼다. 키는 코드에 직접 적지 않는다.

다음 강의에서는 드디어 첫 호출을 한다. 키를 발급받아 .env 에 넣고, 여덟 줄짜리 코드로 Claude 에게 인사를 건넨다. 그리고 돌아온 응답을 한 조각씩 뜯어본다. 그 안에 이 편 전체에서 계속 만나게 될 것들이 다 들어 있다.

프로젝트 세팅 — Node · TS · @anthropic-ai/sdk 와 API 키 — 디코드랩(DCODELAB)