dev_note417

TypeScript 시작하기:tsconfig.json과 ts-node 이해하기

san2222 — Mon, 15 Jun 2026 20:56:24 +0900

주로 온라인 에디터나 Vite를 통해 TypeScript를 사용했었다. 이번에는 TypeScript를 설치하고 실행 환경을 구성하면서 기본적인 설정과 사용 방법을 헷갈리지 않게 깔끔하게 정리하려고 한다.

1.npm으로 타입스크립트 컴파일러 등 설치

npm init으로 노드 js패키지를 초기화하고 타입스크립트가 node.js의 전역객체, 모듈의 타입 등을 알기 위해 @types/node를 설치합니다. ts-node는 ts파일을 바로 실행해 주는 도구로 tsc를 통해 ts파일을 js파일로 컴파일할 필요 없이 바로 실행해 주는 도구이다.

npm init
npm i @types/node
npm i typescript -g
npm i ts-node -g

아래 명령어를 통해 타입스크립트 컴파일러가 잘 설치되었는지 버전을 확인한다.

tsc -v

2.tsconfig 생성과 설정방법

아래 명령어를 입력하면 타입스크립트 관련 설정에 대한 tsconfig.json이 생긴다.

npx tsc --init

src폴더를 만들어주고 ts파일을 작성해 준 뒤 아래 적힌 명령어를 실행하면 ts파일이 js파일로 컴파일된다.

(src폴더 말고 본인이 원하는 폴더구조, 그냥 상단에 ts파일을 두거나 해도 된다.)

tsc src/index.ts

위에 tsc명령어를 통해 타입스크립트를 자바스크립트로 컴파일하여 사용할 수 있다.

tsc를 하고 나면 해당경로에 js파일이 생긴 것을 볼 수 있다.

2-1. include

tsconfig관련 설정에 대해 정리하려고 한다.

  "include": ["src"]

include는 프로젝트 특정 폴더 경로에 ts파일을 컴파일할 거라고 설정해 주는 부분으로 "include":["src"] 작성하면 src안에 있는 ts파일을 한 번에 컴파일할 수 있다.

tsc

include를 사용해서 컴파일해야 하는 범위를 정해주었기 때문에 tsc만 입력해도 컴파일이 된다

2-2. compilerOptions

compilerOptions는 TypeScript 컴파일러(tsc)의 동작 방식을 설정하는 옵션들을 모아놓는 객체이다.

-target

target은 TypeScript 코드를 컴파일할 때 출력할 JavaScript의 ECMAScript 버전을 지정하는 옵션이다.

{
  "compilerOptions": {
    "target": "es2025"
  }
}

예를 들어:

const add = (a: number, b: number) => a + b;

target이 오래된 버전이라면 최신 문법을 하위 버전 문법으로 변환할 수 있고,

{
  "target": "es5"
}

화살표 함수가 일반 함수로 변환된다.

var add = function (a, b) {
  return a + b;
};

반면 최신 버전인:

{
  "target": "es2025"
}

를 사용하면 최신 문법을 거의 그대로 유지한 채 출력한다.

const add = (a, b) => a + b;

-module

module은 TypeScript가 import와 export를 어떤 모듈 시스템 형식으로 출력할지 결정하는 옵션이다.

Node.js를 사용하다 보면 아래와 같이 import/export 또는 require 문법을 사용하는 코드를 볼 수 있는데, 이러한 모듈 시스템을 TypeScript가 어떤 형식으로 변환할지 설정하는 역할을 한다.

import { add } from "./math.js";
const { add } = require("./math");

예를 들어 module을 "esnext"로 설정하면 TypeScript는 컴파일 결과를 최신 ES Module(ESM) 형식으로 출력한다.

{
  "compilerOptions": {
    "module": "esnext"
  }
}

다음 TypeScript 코드가 있다고 가정해 보자.

import { add } from "./math.js";

export const result = add(1, 2);

컴파일 후에도 import와 export 문법이 그대로 유지된다.

import { add } from "./math.js";

export const result = add(1, 2);

반대로 module을 "commonjs"로 설정하면 CommonJS 형식으로 변환된다.

{
  "compilerOptions": {
    "module": "commonjs"
  }
}

동일한 TypeScript 코드는 다음과 같은 JavaScript 코드로 출력된다.

const { add } = require("./math");

exports.result = add(1, 2);

따라서 module 옵션은 TypeScript 코드의 모듈을 어떤 JavaScript 모듈 시스템 형식으로 출력할지 결정하는 설정이라고 이해하면 된다.

-rootDir, outDir

rootDir과 outDir은 TypeScript 프로젝트의 소스 코드와 컴파일 결과물을 관리하기 위한 옵션이다.

rootDir : 컴파일 시 폴더 구조를 유지할 기준 경로
outDir : 컴파일된 JavaScript 파일이 저장될 경로

예를 들어 다음과 같은 프로젝트 구조가 있다고 가정해 보자.

src
├─ index.ts
└─ utils
   └─ math.ts

그리고 tsconfig.json에 아래와 같이 설정한다.

{
  "compilerOptions": {
    "rootDir": "src",
    "outDir": "dist"
  }
}

TypeScript는 rootDir로 지정된 src 폴더를 기준으로 디렉터리 구조를 분석한 뒤, 컴파일된 결과물을 outDir로 지정된 dist 폴더에 출력한다. 컴파일이 완료되면 src폴더구조와 동일하게 아래와 같은 구조가 생성된다.

dist
├─ index.js
└─ utils
   └─ math.js

위 결과를 보면 src 내부의 폴더 구조가 그대로 유지된 채 TypeScript 파일만 JavaScript 파일로 변환되어 출력된 것을 확인할 수 있다. 따라서 rootDir은 단순히 소스 코드가 위치한 폴더를 의미하는 것이 아니라, 컴파일 과정에서 폴더 구조를 유지할 기준 경로를 지정하는 역할을 한다. 그리고 outDir은 이렇게 생성된 컴파일 결과물을 저장할 위치를 지정한다.

일반적으로 src 폴더에 TypeScript 소스 코드를 작성하고, dist 폴더에 컴파일된 JavaScript 파일을 출력하는 구조를 사용한다. 이를 통해 원본 소스 코드와 빌드 결과물을 명확하게 분리하여 관리할 수 있다.

-strict

  "compilerOptions": {
    "strict": true
  }

strict는 타입스크립트의 엄격한 타입 검사 모드를 활성화하는 옵션이다.

타입 안정성을 높이기 위해 대부분 strict: true를 사용하는 편이다.

-moduleDetection

타입스크립트는 전역 스코프를 보기 때문에 같은 경로에 있는 ts파일에 동일한 변수명이 있다거나 하면 같은 스크립트로 처리되면서 전역 변수 충돌이 발생할 수 있다. 그래서 moduleDetection을 사용하여 모듈로 판단할지 스크립트로 판단할지 결정하는 옵션이다.

{
  "compilerOptions": {
    "moduleDetection": "force"
  }
}

moduleDetection을 force로 설정하면 모듈로 인식하여 각 파일이 독립적인 스코프를 가지기 때문에 변수명이 동일하여 충돌되는 문제를 방지할 수 있다.

3.ts-node사용법

위에서 살펴본 것처럼 TypeScript 파일을 실행하려면 일반적으로 tsc 명령어를 사용하여 JavaScript 파일로 컴파일한 뒤, Node.js로 실행해야 한다. 하지만 매번 컴파일 과정을 거치는 것은 개발 중에 다소 번거로울 수 있다.

이때 ts-node를 사용하면 TypeScript 파일을 별도의 컴파일 과정 없이 직접 실행할 수 있어서 편리하며 내부적으로 변환되어 실행되기 때문에 프로젝트에 tsc와 다르게 js파일이 안 생긴다.

ts-node src/index.ts

위에 명령어대로 ts-node 적고 경로 작성해 주면 된다.

  "ts-node": {
    "esm": true
  }

ts-node를 사용하기 전 마찬가지로 tsconfig.json에 설정해야 되는 옵션이 있다.

ts파일을 ES Module(ESM) 방식으로 실행하라는 옵션으로 위에서 설명한 module: "esnext"를 ts-node가 정상적으로 실행할 수 있게 해 준다. true로 해두면 현재 프로젝트를 ES Module 환경으로 실행하라고 알려주는 설정이다.

https://san2-dev.tistory.com/12

1. TypeScript 기초입문) 변수,함수,배열 사용하는 방법

요즘 프론트엔드 강의를 보면 타입스크립트를 안 쓰는 곳이 거의 없을 지경이라고 할 정도로 많이 쓴다. Next.js 설치할 때 매번 타입스크립트 쓸 거냐는 말에 찔려 공부해서 정리할 겸 포스팅하

san2-dev.tistory.com

Google I/O 2026 정리: Antigravity CLI 설치와 Gemini Omni, AI Search 변화

san2222 — Mon, 25 May 2026 23:15:58 +0900

구글 I/O는 구글이 매년 개발자와 IT 업계에 앞으로의 기술 방향을 공개하는 행사입니다. 2026년 핵심은 AI가 답변만 하는 도구를 넘어, 코드를 만들고 검색을 대신하며 쇼핑과 영상 제작까지 연결하는 에이전트로 더 진화되는 게 눈에 보이는 것 같았습니다.

1. Google I/O 2026의 키워드는 에이전트형 AI입니다

출처:구글io

에이전트형 AI는 사용자의 요청을 듣고 다음 행동까지 이어가는 AI를 말합니다. 기존 챗봇이 “답변하는 상담원”이었다면, 에이전트는 “일을 나눠 처리하는 비서”에 가깝습니다.이번 발표는 Gemini 3.5 Flash, Antigravity 2.0, AI Search, Gemini Omni, Universal Cart가 따로 움직이는 기능이 아니라는 점이 중요합니다. 사용자가 여러 앱을 오가는 대신 AI가 검색하고, 만들고, 확인하고, 구매 흐름까지 도와주는 방향입니다.

2. Antigravity 2.0, AI 코딩 도구에서 개발 지휘실로 바뀌고 있습니다

Google I/O 2026에서 가장 눈에 들어온 발표는 Antigravity 2.0이었습니다. 기존 Antigravity가 AI와 함께 코드를 수정하는 개발 도구에 가까웠다면, 2.0은 여러 AI 에이전트에게 작업을 나눠 맡기고 전체 흐름을 관리하는 쪽으로 확장됐다는 생각이 듭니다.

구글은 Antigravity 2.0을 독립형 데스크톱 앱으로 소개했습니다. 단순히 코드를 작성하는 화면이라기보다, 여러 에이전트가 어떤 일을 하고 있는지 확인하고 조율하는 중심 공간에 가까워진 것입니다. 구글 공식 발표에서도 여러 에이전트를 병렬로 실행하고, Dynamic Subagents와 예약 작업을 지원한다고 합니다.

3. Antigravity CLI, 터미널에서도 AI 개발이 가능해집니다

예전에 안티그래비티를 사용할 때는 ide만 있어서 아쉬움이 있었는데 이번에 Antigravity CLI버전이 나오며 Google Antigravity 2.0이 출시되었다고 합니다. 원래 지원하던 제미나이 cli는 서비스 종료 수순인것 같습니다. CLI는 Command Line Interface의 줄임말로, 터미널에 명령어를 입력해 도구를 다루는 방식입니다. 이번 Antigravity CLI는 동시성제어에 좋은 go언어를 사용하였다고 합니다

4.윈도우에 Antigravity CLI를 설치해보자

파워셀을 관리자 권한으로 실행해 주고 아래 명령어를 복붙 하여 실행시켜 줍니다

irm https://antigravity.google/cli/install.ps1 | iex

cmd에 아래 명령어를 입력하여 설치를 확인해 주고 실행해 줍니다

:: 설치 버전 확인
agy --version
:: 실행 및 로그인
agy

agy 명령어를 실행하면 로그인 방식을 고르고 'If you aren't automatically redirected, paste the authorization code below:'이라고 뜬곳에 웹에서 로그인하고 나온 코드를 넣어주면 됩니다.

안티그래비티 cli에서 사용할 테마를 골라주면 Antigravity CLI 사용 데이터 수집 동의 화면이 나오는데 나의 개발 코드나 프롬프트가 수집될 수도 있다는 뜻으로도 생각돼서 개인적으로는 비동의를 눌렀는데 문제없이 넘어가지더라고요.(개인판단에 맞게 선택)

테마, 사용데이터 수집동의를 넘어가면 이제 안티그래비티 cli를 사용할 수 있게 됩니다.!

5. Managed Agents, 서버 관리 부담을 줄이는 방향입니다

Managed Agents in Gemini API도 중요한 발표입니다. 기존에는 AI가 코드를 실행하거나 도구를 쓰게 만들려면 서버, 실행 환경, 보안 설정을 개발자가 직접 챙겨야 했습니다.Managed Agents는 이런 작업 공간을 구글이 관리하는 방식에 가깝습니다. 개발자는 API를 통해 준비된 에이전트를 호출하고, AI가 안전한 환경에서 작업하도록 만들 수 있습니다. 앞으로는 “AI를 어디서 실행할지”보다 “AI에게 어떤 일을 맡길지”가 더 중요해질 수 있습니다.

6. Gemini Omni, 영상 편집도 말로 하는 시대입니다

Gemini Omni는 텍스트, 이미지, 오디오, 영상까지 함께 이해하는 멀티모달 AI입니다. 여러 종류의 자료를 한 번에 보고 이해하는 AI라고 생각하면 됩니다. 개인적으로 이번 발표에서 Gemini Omni가 꽤 눈에 들어왔습니다. 최근 OpenAI의 Sora 웹·앱 서비스가 종료됐고, API도 종료 예정이라고 안내되면서 AI 영상 생성 쪽 흐름이 다시 움직이는 느낌이 들었습니다. Sora가 업계 상단에 있던 서비스 중 하나였던 만큼, 이 변화가 작게 느껴지지는 않습니다. 특히 Gemini Omni는 영상을 새로 만드는 것뿐 아니라, 말로 편집하는 흐름이 인상적입니다. “배경을 바꿔줘”, “이 장면을 더 영화처럼 만들어줘”처럼 요청하면 영상 수정이 가능해지는 방향입니다.

영상제작을 업으로 하는 사람 입장에서는 꽤 현실적으로 와닿는 변화라고 생각합니다. 앞으로는 편집 프로그램을 잘 다루지 못해도, 아이디어만 있으면 짧은 영상 콘텐츠를 만드는 일이 훨씬 쉬워질 것 같습니다.

컨텍스트 스위칭과 하네스 엔지니어링 차이와 개념 정리

san2222 — Sun, 26 Apr 2026 11:28:30 +0900

ai를 사용하면서 개발을 하다 보면 새로운 개념들과 최신정보가 하루가 다르게 쏟아져 나옵니다.

오늘은 최근 개발을 하다가 알게된 하네스 엔지니어링이라는 용어에 대해 정리하겠습니다.

(개인적으로는 생각보다 크게 어려운 개념은 아닌데 용어가 워낙 생소해서 피곤한 것 같습니다.)

1.ai를 통해 개발하다보면 자주 듣는 컨텍스트 스위칭

ai가 처음나왔을때만 해도 프롬프트만 명확하고 구체적으로 작성하여 요청해야 ai가 실수 없이 답변을 준다 해서

프롬프트를 어떻게 하면 잘 쓰는지에 대한 이야기가 많았습니다. 하지만 어느 순간부터 ai를 통해 다양한 작업을 장시간 해야 돼서 기본적인 프롬프트를 만으로는 부족해서 나온 게 컨텍스트 스위칭입니다.

2.컨텍스트 스위칭 개념 정리

개발자가 AI 도구를 활용해 개발하다 보면 생각보다 처리해야 할 일이 많습니다. 단순히 AI에게 코드를 생성해 달라고 요청하는 것으로 끝나는 것이 아니라, 생성된 코드가 실제 프로젝트 구조에 맞는지 검토하고, 관련 문서를 확인하고, 팀의 개발 규칙이나 코드 스타일과 맞는지도 살펴봐야 합니다. 경우에 따라서는 이전 대화 이력이나 작업 의도까지 다시 정리해야 합니다.

이처럼 개발자가 코드 작성, AI 답변 확인, 문서 검토, 테스트 실행, 프롬프트 수정 사이를 계속 오가며 작업 흐름을 다시 잡는 과정이 바로 AI 개발에서 말하는 컨텍스트 스위칭입니다. 쉽게 말해, 하던 작업의 문맥을 잠시 내려놓고 다른 문맥으로 전환했다가 다시 돌아오는 과정이라고 볼 수 있습니다.

예를 들어 Claude Code를 사용해 본 분들이라면 CLAUDE.md 파일을 한 번쯤 접해보셨을 겁니다. 이 파일에는 프로젝트 규칙, 실행 명령어, 코드 스타일, 주의사항 등을 미리 정리해 둘 수 있습니다. 이렇게 작업에 필요한 정보를 구조화해 두면 AI에게 매번 같은 내용을 반복해서 설명하지 않아도 되고, 개발자 역시 작업 흐름을 다시 정리하는 시간을 줄일 수 있습니다.

결국 컨텍스트 스위칭을 줄이는 핵심은 AI가 참고해야 할 작업 문맥을 미리 정리해 두고, 개발자가 불필요하게 여러 정보 사이를 오가지 않도록 만드는 데 있습니다. AI를 잘 활용한다는 것은 단순히 좋은 답변을 얻는 것이 아니라, 개발 흐름이 끊기지 않도록 작업 환경과 문맥을 체계적으로 관리하는 것에 가깝습니다.

3. 요즘 뜨는 하네스 엔지니어링이란?

AI도구를 잘 사용하더라도 인간의 입장에서 볼 때 부족하고 실수를 할 때가 많습니다.

예를 들어 클린코드로 개발을 해야 된다, 파일용량 제한을 넘기지 말아야 된다, 폴더구조를 어떤 식으로 만들어라 등

명확하고 디테일하게 말해줘도 응답 오는 게 올바르지 않을 때가 많으며 이럴 때 인간의 개입이 많아지며 AI가 만들어내는 생산성에 비해 인간의 효율성은 차이가 나게 됩니다. 즉 보통 AI한테 작업을 요청 보내고 구현된 코드를 보고 테스트하고 잘못된 거는 다시 요청하게 되는 순서가 반복될 텐데 이를 줄이고자 하는 게 하네스 엔지니어링입니다. 개발자의 불필요한 개입을 최소한으로 줄이고 AI가 올바른 코드를 만들어 낼 수 있는 환경을 말하는 것으로 harness 또한 한국어로 말에게 사용하는 안장, 마구, 제어장치를 의미하며 AI를 좀 더 체계적으로 제어하고 관리하기 위한 환경을 구축해 간다고 생각하면 됩니다.

4. 하네스 엔지니어링 사용방법

하네스 엔지니어링은 개발에 도입하려면 생각보다 초기에 생각보다 많은 시간이 들어갑니다.

기능과 파트별로 로그를 남겨 관리한다거나 컨텍스트를 세분화해서 챕터별로 나눠 사용한다거나 CI/CD를 어떤 형식에 따라 관리할지 커밋과 머지는 어떤 형식에 따라 메시지를 쓰고 남길지 등 워크플로우와 실행 환경을 구축하는데 시간이 많이 투여되자만 한번 만들어 놓으면 좋다고 합니다.

마무리

하네스엔지니어링 안에 컨텍스트 스위칭도 포함된 큰 개념입니다.

용어가 좀 어려울 수도 있지만 결국에는 AI를 어떻게 잘 사용할지에 대한 이야기입니다.

참고 자료(더 궁금하시면 보시면 좋을 것 같아요!)

링크1

링크2

깃허브 오픈소스에 기여하는 방법정리,Trending과 first-contributions 활용법

san2222 — Mon, 23 Mar 2026 16:04:41 +0900

개발자라면 한 번쯤은 큰 오픈소스에 참여해서 기여하고 싶다고 생각한 적이 있을 것이다.

만약 꾸준히 해서 여러 오픈소스에 기여하고 star수가 많은 거에도 참여하면 취업에도 도움 된다고 들었다.

깃허브 오픈소스에 대한 기여 하려면 뭘 해야 되는지부터 고민한 뒤 정리한 글이다.

1. 깃허브 사용법( Issues, Pull requests, Actions, Security)

오픈소스 기여에 참여하려면 깃허브에 대한 기능을 어느 정도 알아야 된다.

Issues:해당 프로젝트에 대한 문제, 버그, 개선사항, 질문등을 올리는 곳으로 어느 부분 수정이 필요한다거나 프로젝트에 이런 기능이 있으면 좋겠다던가를 올리는 곳이다.
Pull requests:내가 코드를 고쳐서 프로젝트에 반영 요청을 하는 것으로 프로젝트 관리자가 내가 Pull requests 한 거를 검토하고 괜찮다고 판단하면 merge 하여 실제 프로젝트에 반영이 되면 오픈소스에 기여한 게 된다.
Actions: GitHub의 자동화/CI/CD 기능으로 워크플로우를 설정해 두는 곳이다. 프로젝트에 push,pr,merge등의 이벤트가 발생하면 정해둔 절차에 따라 자동작업이 일어난다고 보면 된다.(ex:테스트 실행, 빌드, 배포 등)
Security:프로젝트의 보안 관련 영역으로 취약점 제보, 보안 업데이트 내역등에 대한 부분이다.

2. 오픈소스 기여할만한 프로젝트 찾는 방법(Github Trending)

깃허브 트렌딩에 들어가면 요즘 인기 있는 레포지토리와 주목받는 개발자를 볼 수 있고 언어별로 필터를 설정해서 볼 수도 있다.

물론 커다란 프로젝트가 많아 기여하는데 어렵지만 다른 인기 프로젝트를 구경할 수 있는 게 좋아서 넣었다.

(혹시 모르지.. 실력이 늘면.. 될지도?)

3. 쉽게 오픈소스 기여하는 방법 first-contributions

막상 오픈소스 기여에 참여하려면 뭐부터 해야 될지 고민이 된다. 근데 알아보니 이럴 때 할 수 있는 최고의 프로젝트가 있다.

나 같은 입문 자라면 first-contributions라는 프로젝트를 추천한다. 초보자가 GitHub에서 오픈소스 기여 과정을 직접 연습해 볼 수 있도록 만들어진 저장소이다. 풀리퀘스트 해도 머지 안 해주는 거 아니냐 하실 텐데.. 심지어 프로젝트에 반영도 해준다고 한다.

이 프로젝트에서는 보통 Contributors.md 파일에 자신의 이름 한 줄을 추가하는 방식으로 기여를 진행한다.

물론 first-contributions는 어디까지나 연습용 성격이 강한 프로젝트로 실제 서비스의 버그를 고치거나 기능을 추가하는 본격적인 귀여와는 조금 차이가 있다. 오픈소스를 내 깃허브 저장소로 fork 하여 복제해 오고 로컬 컴퓨터로 clone 하고 작업해서 내 저장소에 commit, push로 반영하고 그걸 토대로 Pull Requset하는 형태인데 이거를 연습해 볼수 있다.

조코딩 x OpenAI x Primer AI 해커톤 후기: 두쫀쿠 AI 챗봇 만들기

san2222 — Tue, 17 Mar 2026 19:26:32 +0900

저번 설날, 유튜브 쇼츠를 보다가 우연히 조코딩 x OpenAI x Primer AI에서 주최한 온라인 해커톤 영상을 보게 되었다. 설날이라고 늘어져 있지만 말고 이참에 한번 나가봐야겠다 맘먹어 참가하게 되었다. 심지어 참가만 해도 OpenAI 크레딧 100달러를 준다고 해서 참가의욕이 더 올랐다고 할까... 결론적으로 설날 3일 동안 프로젝트를 만들어서 제출했다.

1. 해커톤 주제와 내가 만든 것

이번 해커톤의 주제는 OpenAI API를 활용해 실제 비즈니스 가치가 있는 서비스를 만드는 것으로 NestJS와 LangChain을 활용해 RAG를 사용해서 챗봇을 설계하고, AI 챗봇 MVP를 제작했다. 챗봇은 최근 유행하는 간식인 두쫀쿠에 대한 정보를 찾아 정리하여 챗봇이 판매처, 레시피, 상세 정보를 안내하는 기능을 제공했다.

2. 개발 과정

원래 LangChain을 강의에서 본 적이 있고, 써본 경험이 있어서 이번 프로젝트에서도 사용하게 됐다. 문서를 RAG용으로 청크 단위로 나누고 ChromaDB에 임베딩했는데, 생각보다 LLM이 내용을 제대로 읽지 못하는 경우가 있어서, 청크별로 정보 표시를 늘려서 해결했다. 아직 LLM 다루는 게 익숙하지 않아서 챗봇과 대화할 때 올바른 답변이 나오지 않는 경우가 종종 있었지만, 대부분은 원하는 답변과 거의 맞았다. 배포 후에는 카톡 로그인이 안 되는 문제도 있었다 보니.. 카톡로그인 구현하는 방법에 대해 정리해서 포스팅해야 되겠다고 느꼈다.(은근 카톡 디벨로퍼 ui에서 설정관련된 것도 생각보다 안 보였던 거 같기도 하고...)

3. 제출 결과물과 해커톤 후기

완성된 챗봇은 사용자 질문에 따라 두쫀쿠 관련 정보를 rag문서를 토대로 LLM 기반 응답을 제공하는 구조였다. 설날 동안 단기간에 만들었지만 나름 최선을 다했다고 생각한다. 온라인 해커톤이라 평가진이 서비스는 직접 확인하지 않고, MVP 문서만 보고 선발하는 경우가 있어 조금 안타깝긴 했다. 그래도 이번 경험을 통해 OpenAI API 연동, LangChain 프롬프트 체인 구성, RAG 기반 문서 검색, 벡터화 등 안 해본 경험을 해서 나름 공부 좀 된 것 같았다.

https://dujjonku.cloud/

두쫀쿠 AI 채팅

안녕하세요! 두쫀쿠 AI는 존맛탱이지만 실수할 수 있습니다. 채팅 입력 시 사용자의 정보를 수집할 수 있습니다.(악의적 요청 판단에만 사용)

dujjonku.cloud

NestJS 요청-응답 라이프사이클 정리: Controller, Provider, Module 역할

san2222 — Thu, 12 Mar 2026 00:02:08 +0900

nestjs에는 여러 과정을 지나 요청에 대한 로직을 처리하고 응답을 보내주게 되는데 아직 nestjs의 아키텍처에 대해 헷갈려서 정리하게 되었다.

1. Controller란?

Controller는 클라이언트의 HTTP(get, post, put 등) 요청을 받아서 처리하는 엔드포인트로 요청받은 파라미터를 받고 서비스를 호출하며 결과를 반환하는 곳이다. 실질적인 db의 저장, 서비스의 비즈니스 로직은 Controller에 구현하는 게 아니라 Provider(Service)에 위임하게 된다.

//http://localhost:5500/api/get
@Controller('api')
export class ApiController {
  constructor(private readonly apiService: ApiService) {}

  @Get('get')
  findAll() {
    return this.apiService.findAll();
  }

}

//http://localhost:5500/api
@Controller()
export class ApiController {
  constructor(private readonly apiService: ApiService) {}

  @Get('api')
  findAll() {
    return this.apiService.findAll();
  }

}

클래스에 @Controller 데코레이터를 붙여 사용하며 Controller안에 라우터 핸들러를 설계한다.

2.Provider란?

Provider는 NestJS에서 실질적인 비즈니스 로직을 처리하는 부분으로 보통 서비스(Service) 클래스가 Provider에 해당하며, NestJS의 의존성 주입(Dependency Injection, DI) 시스템에 의해 생성되고 관리된다.
DI는 필요한 객체를 내가 직접 만들지 않고 외부에서 constructor(생성자) 안에 넣어주는 패턴이다.

@Injectable()
export class UsersService {
  findAll() {
    return ['user1', 'user2'];
  }
}

@Injectable()을 붙인 클래스는 Nestjs의 IoC컨테이너가 주입가능한 객체 후보로 보고 Injectable 붙은 클래스를 객체(인스턴스) 형태로 관리하게 된다. 보통 Controller에 Provider(Service)를 주입해서 사용한다.

3.Module란?

Module은 기능 단위로 구성요소를 묶는 형태로 Controller, Provider, imports , exports를 관리하게 된다.
Module이 Controller, Provider를 관리해 준다고 생각하면 되며 코드상에서 Controller,Provider등을 명시해 줘야 된다.

import { Module } from '@nestjs/common';
import { UsersService } from './users.service';
import { UsersController } from './users.controller';
import { TypeOrmModule } from '@nestjs/typeorm';
import { UsersModel } from './entities/users.entity';
@Module({
  imports: [TypeOrmModule.forFeature([UsersModel])],
  exports:[UsersService], 
  controllers: [UsersController],
  providers: [UsersService],
})
export class UsersModule {}

4. NestJS CLI를 통한 Module, Controller, Provider 생성

NestJS에서 실질적인 요청 로직을 처리하는 모듈(Module), 컨트롤러(Controller), 프로바이더(Provider)는 CLI 명령어를 통해 쉽게 생성할 수 있다. CLI를 사용하면 생성된 컨트롤러와 프로바이더가 해당 모듈에 자동으로 등록된다. 모듈 또한 app.module.ts의 import에 등록해야 된다. 만약 명령어를 사용하지 않고 모듈,컨트롤러,프로바이더를 직접 생성하면 따로 등록을 직접 해줘야 돼서 번거롭다.

-각각 하나씩 만드는 방식

nest g module users
nest g controller users
nest g service users

-한 번에 만드는 방식

nest g resource users

보통 모듈을 한번에 만드는 방식을 많이 쓴다고 합니다. CRUD API 전체 구조를 한 번에 생성하는 명령어라서 rest api, msa, graphql, socketio 등 선택하라고 하며 CRUD코드도 자동으로 생성할까? 라며 선택권을 준다.
-nestjs는 컨트롤러, 모듈, 프로바이더 말고도 가드, 인터셉터 등 공부해야 될 게 많다....!

2026 정보처리기사 파이썬 공부 (클래스,상속,메서드,생성자)

san2222 — Tue, 3 Mar 2026 01:09:42 +0900

정보처리기사 준비하면서 코딩문제 풀기 위해 파이썬 클래스 개념에 대해 정리한 글로 파이썬 비중이 많은 편은 아니지만 파이썬을 사용해 본 적이 있어 정리할 겸 썼다.

1. 파이썬에서 클래스와 객체

누군가 이 글을 볼수도 있으니 설명하자면 클래스는 설계도로 붕어빵 틀이라고 많이들 비유한다.

객체(=인스턴스)는 설계도로 만든 실제 물건을 뜻하며 예를 들어 붕어빵틀에 팥을 넣으면 팥붕어빵 슈를 넣으면 슈붕어빵이 되는 것처럼 인스턴스에 인자값에 무엇을 넣느냐에 따라 설계도에 맞춰 어떻게 될지 달라지기도 한다. (객체, 인스턴스 동일한 표현)

class Dog:
    def __init__(self, name): #생성자
        self.name = name

    def say(self): #메서드
        print(f"나는 {self.name}")

d1 = Dog("초코")
d2 = Dog("바둑이")

d1.say()  # 나는 초코
d2.say()  # 나는 바둑이

자바에서는 클래스의 이름과 동일한 게 생성자였는데 파이썬에서는 __init__이 생성자가 되는 거고 보통 멤버변수는 생성자안에서 정의하여 쓴다. d1.say()를 호출하면 self는 d1이 되고, d2.say()를 호출하면 self는 d2가 됩니다.

Java의 this랑 같은 건데, 차이점은 파이썬은 메서드 파라미터에 꼭 적어야 된다.

2.파이썬에서 상속

# 부모 클래스
class Animal:
    def __init__(self):
        print('강아지')

    def speak(self):
        return "..."

# 자식 클래스 - 괄호 안에 부모를 넣으면 끝
class Dog(Animal): #부모 Animail클래스 자식Dog의 상속
    def __init__(self, name):
        super().__init__()   #super().__init__()을 써야 부모 생성자를 호출
        self.name = name
        print(self.name)

    def speak(self):        # 부모의 speak을 덮어씀 (오버라이딩)
        return "멍멍!"


d = Dog("초코")

상속을 할때 따로 자바처럼 extends를 사용하지 않는다. 자식클래스의 파라미터에다가 부모클래스를 적으면 상속이 된다.

파이썬 상속에서 가장 중요한 게 있다면 자바와 다르게 자식클래스의 생성자를 실행하기 전에 부모 클래스의 생성자를 가서 실행할 필요가 없다.(부모 생성자를 자동 호출 되는 게 아님) super().__init__() 을 명시해야만 부모 클래스의 생성자를 실행하러 가게 된다. 파이썬에서 오버로딩은 덮어써져서 마지막 거만 남게 되어 파이썬에서는 오버로딩을 사용하지 않는다고 하며 상속관계의 클래스에서 오버라이딩 된 메서드를 호출하는 건 자바와 동일하다.

3. 클래스의 변수 차이

class Food:
    count = 0        # 클래스 변수 - 모든 인스턴스가 공유 java의 static같은느낌

    def __init__(self, name):
        self.name = name
        print(self.name)
        Food.count += 1

f1 = Food("치킨")     # count = 1
f2 = Food("피자")     # count = 2
f3 = Food("햄버거")   # count = 3
print(f1.count)       # 3
print(f2.count)       # 3
print(f3.count)       # 3

self.name은 인스턴스 변수였다면 클래스 변수라는 게 있다. 생성자 밖에 변수를 지정하면 모든 인스턴스가 공유하게 되어 값이 계속 유지하게 된다. 자바에서 static과 같은 느낌이라고 보면 된다.

4. 특수 메서드(special method)란?

여기까지 정보처리기사에 나올지는 모르겠지만 개인적으로 파이썬을 좋아하는 편이라 공부할 겸 더 정리하자면

특수 메서드라고도 하며 찾아보니 매직 메서드 (magic method) 또는 던더 메서드 (dunder method)라고도 하는 것 같습니다.

class Dog:
    def __init__(self, name):    # 객체 만들 때 자동
        self.name = name

    def __str__(self):           # print() 할 때 자동
        return self.name

    def __len__(self):           # len() 할 때 자동
        return len(self.name)

    def __eq__(self, other):     # == 비교할 때 자동
        return self.name == other.name

d = Dog("초코")
print(d)            # __str__ → 초코
print(len(d))       # __len__ → 2
print(d == Dog("초코"))  # __eq__ → True

특수 메서드는 직접 호출하지 않아도 특정 상황에서 자동으로 호출됩니다.

예를 들어 print()를 쓰면 __str-__이 자동으로 호출되고 len()을 쓰면 __len__이 자동으로 호출되게 된다.

즉 인스턴스를 호출하여 조건에 맞게 사용하면 특수메서드가 자동적으로 사용되게 된다.

Go Programming 시작하기!(go언어란 무엇인가?)

san2222 — Sat, 28 Feb 2026 23:50:40 +0900

2009년에 google에서 공개한 오픈소스 프로그래밍 언어로 전설적인 엔지니어 3명( Rob Pike, Robert Griesemer, Ken Thompson)이 만들기 시작했으며 google내부에서 c++로 개발할 때 겪던 어려움을 해결하기 위해 만들어졌다.

즉, 처음부터 실무의 고통에서 출발한 언어다.

1.Go언어에 대해 알아보자

go언어가 가장 유명한이유로 동시성(Concurrency)이 언어에 내장되어 있다는 점 이제 배우기 시작해서 깊게 알지는 못하지만

고루틴( 매우 가벼운 동시 실행 함수)를 사용하며 GC가 있어 메모리 자동관리가 된다고 한다.

클래스, 상속이 없는 게 특이한 것 같다. 구조체(struct), 인터페이스(interface) 사용하여 개발한다고 한다.

컨테이너/클라우드 쪽 인프라가 go로 많이 돌아간다고 하며 도커도 go언어로 개발되었다 함.

2.Go언어 windows에 설치

해당 사이트에 접속해서 운영체제 맞게 다운로드해 주고 아래 명령어로 버전확인(설치 은근 금방 됨)

go version

vscode extension에서 해당 익스텐션 설치

3.go언어 실행 방법

go언어는 패키지(폴더) 기반의 실행구조를 가지며 파이썬과 같은 인터프리티 기반의 스크립트언어랑은 정반대이다

c, java와 같은 컴파일 기반의 형태로 명확한 시작점(main 함수)을 기준으로 실행되는 방식이다.

go mod init github.com/아이디/프로젝트명

go mod init 하고 뒤에 모듈명을 적게 되는데 보통 깃허브에 올릴 때 경로를 맞추려고 위에 처럼 작성한다.

그리고 다른 파일에서 import 할 때 go.mod에 적힌 모듈 이름을 기준으로 import 하게 된다.

func main()이 시작점이 되고 패키지 이름은 파일마다 따로가 아니라 폴더 단위로 동일해야 한다.

아래 명령어를 실행하면 같은 패키지에 속한 모든 .go 파일을 컴파일 후 실행하게 됨(폴더 안에 go파일을 실행하는 명령어)

go run .

4.build 하는 방법

프로젝트 안에 go언어를 작성하고 난 뒤에 해당 프로젝트 경로에서 아래와 같이 입력하면 된다.

현재 폴더(프로젝트) 명으로 exe파일이 만들기:

go build

exe파일명을 직접 지정 (app.exe로 이름 지정):

go build -o app.exe

깃허브에 팀원 초대해서 협업 하는방법(저장소에 이메일 알림 설정까지)

san2222 — Mon, 16 Feb 2026 21:07:42 +0900

평소에 혼자 개발하다가 이번에 친구랑 같이 개발하기로 해서 이참에 GitHub에서 팀원(협력자)을 초대하는 방법과 이메일 알림 설정을 포스팅하려고 한다.

1. 깃허브에 팀원 초대

일단 깃허브에 새로운 레포지터리를 생성하고 오른쪽 위에 톱니바퀴 아이콘 Settings를 클릭한다. Settings 페이지가 열리면 왼쪽 사이드바에서 Access 카테고리 안에 Collaborators를 바로 찾을 수 있다. Collaborators를 클릭하면 Collaborators and teams 화면이 나타난다. Manage access에 add people를 클릭하여 팀원을 초대할 수 있다

add people를 클릭하면 해당 프로젝트에 팀원을 초대할수 있다. 상대방의 github username이나 email를 입력하면 위에 이미지 처럼 입력한 값에 맞혀 사용자가 나오고 팀원을 초대할 수 있다.

팀원으로 초대 할 시 상대방이 깃허브에 입력한 이메일로 초대메일이 전송된다.

초대한 팀원의 이메일로는 이렇게 오며 Accept invitation을 누르면 팀원초대가 완료된다.

Collaborators 들어가면 Pending Invite 상태로 보이면 아직 수락 안 한 상태인 거고 수락하게 되면 왼쪽과 같이 뜨게 된다.

초대 후 7일 안에 수락 안 하면 자동 만료되며 팀원이 많아지면 팀(Team) 만들어서 초대하는 게 편합니다. (Organization 계정 필요)

2.깃허브 저장소에 이메일 알림 설정

Email notifications에서 Address에 이메일을 적으면 깃허브에 push 될 때마다 이메일이 오게 된다.

2026 클로드 코드 최신 설치방법(powershell에서 irm 방법 사용)

san2222 — Tue, 10 Feb 2026 19:28:09 +0900

클로드 코드는 Anthropic에서 만든 터미널 기반의 코딩 에이전트로 비개발자도 좀만 공부하면 흔히 말하는 바이브 코딩툴로도 유명하다. ai가 프로젝트의 전체 구조를 분석하여 리팩토링, 버그수정, 코드생성 등 다양한 작업을 수행한다. 보통 클로드 유료 요금제 플랜이 있어야 사용하기 편하지만 다른 gemini, gpt, grok 등 다른 ai를 api로 연결하여 사용할 수 있으며 가격이 저렴한 ai를 api방식으로 연결하여 사용하면 가격적인 면에서 아낄 수도 있다. 클로드 코드 설치 하려면 기본적으로 git을 설치해야 되며 npm으로 설치 시 노드도 당연히 설치돼있어야 한다.

1. npm 말고 irm, curl로 설치하는 이유

대부분의 영상에서 npm으로 설치하지만 최근에 설치하려고 보니 더 이상 사용되지 않는다고 적혀있다.

찾아보니 npm의존성을 없애고 자동업데이트와 설치 안전성을 높이기 위해 npm으로 설치를 추천하지 않는 것 같다.

2. 윈도우 powershell로 설치하는 방법

관리자 권한으로 powershell을 실행한 뒤 아래 명령어를 입력해 줍니다

irm https://claude.ai/install.ps1 | iex

3. 설치가 완료되면 환경변수 설정

설치한 뒤에 터미널에서 문제없이 사용할 수 있게 환경변수를 아래와 같이 입력해 준다.(git이 설치된 경로에 bash.exe를 선택)

환경변수 이름 : CLAUDE_CODE_GIT_BASH_PATH
경로 : C:\Program Files\Git\bin\bash.exe

4. 클로드 코드 설치 후 실행

클로드 코드를 실행할 프로젝트의 터미널을 열어서 claude 라고 입력하면 welcome to claude code라고 나오며 터미널 스타일을 고르라고 나온다. 클로드 코드를 어떤 방식으로 로그인하여 사용할지에 대해 선택하라고 나온다. 개인적으로는 요금제를 구독해서 사용해 보는 것을 추천드립니다.

1.Claude account with subscription · Pro, Max, Team, or Enterprise : 클로드의 유료 요금제(구독계정)를 사용하여 로그인
2. Anthropic Console account · API usage billing : Anthropic Console에서 api의 형태로 클로드 코드를 사용하는 방법
3. 3rd-party platform · Amazon Bedrock, Microsoft Foundry, or Vertex AI : Amazon, Microsoft, Google 같은 대기업의 클라우드 서비스를 통해 사용하는 것으로 회사에서 클라우드 서비스랑 같이 관리할 때 사용하는 방법

claude 명령어를 실행하면 위에 내용이 뜨는데 이 프로젝트가 신뢰할 수 있는 프로젝트인지 확인했는지 물어본다.

클로드 코드가 해당 폴더 안에 개발 물들을 수정, 실행 등 조작해도 되는지에 대한 보안 확인 경고로 yes를 누르면 이어서 진행된다.

최종적으로 위에 이미지처럼 나오면 클로드코드의 기본적인 설치 세팅이 완료된 것으로 사용하면 된다.

-클로드 코드 공식 설치 가이드 사이트