IT 용어 사전 — 개발자 말, 노무사 말로 번역하기

코드를 다루는 사람들은 파일이 바뀔 때마다 그 이력을 기록합니다. 취업규칙을 개정할 때 v1, v2, v3를 남기는 것과 똑같은 원리입니다. 이 도구의 이름이 Git이고, Git을 둘러싼 용어들을 하나씩 번역해 보겠습니다. ┌─────────────────────────────────────────────────────────┐ │ 개발 용어 │ 뜻 │ 노무사 번역 │ ├─────────────────────────────────────────────────────────┤ │ 깃(Git) │ 파일 변경 이력을 자동 기록하는 │ 취업규칙 v1 → v2 → v3… │ │ │ 타임머신 │ 버전 관리 시스템 │ ├─────────────────────────────────────────────────────────┤ │ 레포(Repository) │ Git이 관리하는 프로젝트 폴더 │ 사건 파일 전체가 담긴 캐비닛. │ │ │ 전체 │ 열면 관련 서류가 다 들어 있음 │ ├─────────────────────────────────────────────────────────┤ │ 커밋(Commit) │ 변경사항을 저장하는 행위 │ 서류에 "검토완료" 도장 찍기. │ │ │ │ 도장 찍은 시점으로 언제든 돌아갈 수 있음│ ├─────────────────────────────────────────────────────────┤ │ 브랜치(Branch) │ 원본을 건드리지 않고 사본에서 │ 취업규칙 개정안을 별도 문서에서 │ │ │ 작업하는 것 │ 작업하는 것. 확정 전까지 원본은 안전 │ ├─────────────────────────────────────────────────────────┤ │ 푸시(Push) │ 내 작업을 서버에 올리는 것 │ 완성된 서류를 공유 폴더에 업로드 │ ├─────────────────────────────────────────────────────────┤ │ 풀(Pull) │ 서버의 최신 내용을 내 컴퓨터로 │ 공유 폴더에서 최신 서류를 다운로드 │ │ │ 가져오는 것 │ │ ├─────────────────────────────────────────────────────────┤ │ 머지(Merge) │ 두 작업을 하나로 합치는 것 │ 개정안을 원본 취업규칙에 최종 반영 │ └─────────────────────────────────────────────────────────┘ 정리하면 이렇습니다. 레포라는 캐비닛 안에서 브랜치로 사본을 만들고, 작업이 끝나면 커밋으로 도장을 찍고, 푸시로 서버에 올리고, 머지로 원본에 반영합니다. 취업규칙 개정 절차와 흐름이 거의 같습니다.

코드를 작성하는 것과 그것을 세상에 공개하는 것은 별개입니다. 사무실을 인테리어하는 것과 간판을 걸고 오픈하는 것이 다른 것처럼요. 이 과정에서 나오는 용어들을 번역해 보겠습니다. ┌─────────────────────────────────────────────────────────┐ │ 개발 용어 │ 뜻 │ 노무사 번역 │ ├─────────────────────────────────────────────────────────┤ │ 배포(Deploy) │ 만든 것을 인터넷에 공개하는 것 │ 사무실 오픈하고 간판 거는 것 │ ├─────────────────────────────────────────────────────────┤ │ 서버(Server) │ 24시간 돌아가는 컴퓨터 │ 사무실 안내데스크. │ │ │ │ 항상 누군가 지키고 있어야 함 │ ├─────────────────────────────────────────────────────────┤ │ 호스팅(Hosting) │ 서버를 빌려 쓰는 것 │ 건물에 사무실을 임대하는 것 │ ├─────────────────────────────────────────────────────────┤ │ 도메인(Domain) │ 인터넷 주소 │ 사무실 주소. │ │ │ (예: handong-labor.com) │ 명함에 찍히는 그 주소 │ ├─────────────────────────────────────────────────────────┤ │ 빌드(Build) │ 코드를 실행 가능한 형태로 변환 │ 원고를 인쇄소에 보내 책으로 │ │ │ │ 만드는 과정 │ ├─────────────────────────────────────────────────────────┤ │ Vercel │ 무료 배포 서비스 │ 무료로 간판 걸어주는 건물. │ │ │ │ 이 교육 포털도 Vercel에서 돌아갑니다 │ └─────────────────────────────────────────────────────────┘ 흐름을 정리하면: 코드를 빌드해서 실행 가능한 형태로 만들고, 호스팅 서비스(예: Vercel)에 배포하면, 도메인 주소로 누구나 접속할 수 있게 됩니다. 사무실 인테리어 → 건물 임대 → 간판 설치 → 오픈, 이 순서와 같습니다.

API는 프로그램끼리 소통하는 방법입니다. 노무사 업무로 치면 기관 간에 정해진 양식으로 공문을 주고받는 것과 같습니다. ┌─────────────────────────────────────────────────────────┐ │ 개발 용어 │ 뜻 │ 노무사 번역 │ ├─────────────────────────────────────────────────────────┤ │ API │ 프로그램끼리 소통하는 │ 노동위원회 접수 창구. │ │ (Application Programming │ 창구 │ 정해진 양식으로 서류를 내면 │ │ Interface) │ │ 결과를 돌려줌 │ ├─────────────────────────────────────────────────────────┤ │ MCP │ AI가 외부 서비스를 │ 사무장이 Gmail, 캘린더, 노션을 │ │ (Model Context Protocol) │ 직접 사용하는 연결 통로 │ 대신 조작할 수 있게 해주는 권한 │ ├─────────────────────────────────────────────────────────┤ │ 엔드포인트(Endpoint) │ API의 특정 주소 │ 노동위원회의 각 부서 접수처. │ │ │ │ 부당해고 접수처, 임금체불 접수처 │ │ │ │ 가 따로 있는 것처럼 │ ├─────────────────────────────────────────────────────────┤ │ 토큰(Token) │ API 사용 인증키 │ 공문 발송 시 직인 또는 서명. │ │ │ │ 이것 없으면 접수 자체가 안 됨 │ ├─────────────────────────────────────────────────────────┤ │ 웹훅(Webhook) │ 이벤트 발생 시 자동 알림│ 사건 진행 상황이 바뀌면 │ │ │ │ 자동으로 알려주는 것 │ └─────────────────────────────────────────────────────────┘ MCP는 이 과정에서 특히 중요합니다. Phase 8에서 Claude Code에 Gmail, Google Calendar, Notion 등을 MCP로 연결하면, AI가 직접 이메일을 보내거나, 일정을 잡거나, 노션에 기록을 남길 수 있게 됩니다. 마치 유능한 사무장에게 각 시스템의 접근 권한을 주는 것과 같습니다.

이 과정에서 가장 자주 등장하는 용어들입니다. Claude Code라는 AI 비서를 제대로 부리려면 이 용어들은 꼭 알아둬야 합니다. ┌─────────────────────────────────────────────────────────┐ │ 용어 │ 뜻 │ 노무사 번역 │ ├─────────────────────────────────────────────────────────┤ │ 프롬프트(Prompt) │ AI에게 주는 지시/질문 │ 의뢰인이 노무사에게 사건을 │ │ │ │ 설명하는 것. 잘 설명해야 좋은 │ │ │ │ 결과가 나옴 │ ├─────────────────────────────────────────────────────────┤ │ 컨텍스트(Context) │ AI가 기억하는 대화 맥락 │ 상담 기록. 길수록 이전 얘기를 │ │ │ │ 더 잘 기억함 │ ├─────────────────────────────────────────────────────────┤ │ 할루시네이션(Hallucination) │ AI가 없는 정보를 │ 존재하지 않는 판례번호를 │ │ │ 지어내는 것 │ 만들어내는 것. 반드시 검증 필수! │ ├─────────────────────────────────────────────────────────┤ │ CLAUDE.md │ AI에게 주는 업무 지시서 │ 신입 직원에게 건네는 사무실 │ │ │ │ 업무 매뉴얼 │ ├─────────────────────────────────────────────────────────┤ │ 스킬(Skill) │ /명령어로 실행하는 │ 업무 매뉴얼의 한 페이지. │ │ │ 자동화 기능. │ /퇴직금계산 → 정해진 절차대로! │ │ │ .claude/commands/ 또는 │ │ │ │ .claude/skills/에 작성 │ │ ├─────────────────────────────────────────────────────────┤ │ MCP 서버(MCP Server) │ 외부 서비스를 Claude에 │ 스마트폰에 앱 설치하는 것. │ │ │ 연결하는 확장 도구. │ Gmail, 캘린더, Notion 등 연결 │ │ │ claude mcp add로 추가 │ │ ├─────────────────────────────────────────────────────────┤ │ 코워크(Cowork) │ AI와 역할 분담하며 협업 │ 경력 노무사와 수습 노무사가 │ │ │ │ 사건을 나눠 처리하는 것 │ ├─────────────────────────────────────────────────────────┤ │ 워크트리(Worktree) │ 같은 프로젝트를 여러 │ 같은 캐비닛 서류를 여러 책상에 │ │ │ 폴더에서 동시 작업 │ 펼쳐놓고 동시에 작업 │ ├─────────────────────────────────────────────────────────┤ │ 리모트 컨트롤 │ 다른 기기에서 원격 접속 │ 사무실 컴퓨터를 집이나 폰에서 │ │ (Remote Control) │ │ 원격 조작하는 것 │ ├─────────────────────────────────────────────────────────┤ │ 마켓플레이스 │ 플러그인/스킬을 │ 노무사 업무에 필요한 도구를 │ │ (Marketplace) │ 다운받는 곳 │ 사는 철물점 (앱스토어와 비슷) │ ├─────────────────────────────────────────────────────────┤ │ 오토 모드 │ Shift+Tab으로 활성화. │ 사무장에게 "알아서 처리해"라고 │ │ (Auto Mode) │ 안전 분류기가 위험한 │ 위임하되, 위험한 건은 자동 차단 │ │ │ 작업은 자동 차단 │ │ ├─────────────────────────────────────────────────────────┤ │ 디스패치 │ Task 도구로 최대 ~7개 │ 비서 3명에게 각각 다른 사건을 │ │ (Dispatch) │ 서브에이전트를 동시 │ 맡겨서 동시에 처리시키는 것. │ │ │ 실행. 각자 독립 컨텍스트│ 모바일에서도 디스패치 가능 │ ├─────────────────────────────────────────────────────────┤ │ 컴퓨터 유스 │ AI가 화면을 보고 │ 사무장이 내 컴퓨터 앞에 앉아 │ │ (Computer Use) │ 마우스/키보드를 조작 │ 직접 화면을 보며 작업하는 것 │ ├─────────────────────────────────────────────────────────┤ │ 훅(Hooks) │ 특정 이벤트 발생 시 │ 사무실 규칙표. "서류 수정 전 │ │ │ 자동 실행되는 규칙 │ 반드시 원본 복사" 같은 자동 규칙 │ ├─────────────────────────────────────────────────────────┤ │ SDK │ Claude Code 기반으로 │ 나만의 전용 AI 비서 프로그램을 │ │ (Software Development Kit) │ 커스텀 도구를 개발하는 │ 만들 수 있는 개발 도구 모음 │ │ │ 키트 │ │ └─────────────────────────────────────────────────────────┘ 이 중에서 프롬프트, 컨텍스트, 할루시네이션 세 가지는 AI를 쓰는 한 매일 마주치는 개념입니다. 프롬프트를 잘 써야 좋은 답이 나오고, 컨텍스트가 충분해야 맥락을 이해하며, 할루시네이션은 항상 경계해야 합니다. 오토 모드, 디스패치, 컴퓨터 유스, 훅은 Phase 12에서 자세히 배웁니다.

이 과정에서 간단한 웹사이트를 만들어 보게 됩니다. 집을 짓는 것에 비유하면 이해가 쉽습니다. ┌─────────────────────────────────────────────────────────┐ │ 개발 용어 │ 뜻 │ 노무사 번역 │ ├─────────────────────────────────────────────────────────┤ │ HTML │ 웹페이지의 뼈대 (내용/구조) │ 진정서의 사실관계, 법리, 결론 │ │ │ │ = 내용 자체 │ ├─────────────────────────────────────────────────────────┤ │ CSS │ 웹페이지의 디자인 (옷) │ 서류의 서식, 글꼴, 여백 설정 │ │ │ │ = 보기 좋게 꾸미는 것 │ ├─────────────────────────────────────────────────────────┤ │ JavaScript │ 웹페이지의 동작 (두뇌) │ 계산기 기능, 양식 검증 │ │ │ │ = 뭔가 움직이고 반응하게 하는 것 │ ├─────────────────────────────────────────────────────────┤ │ React / Next.js │ 웹사이트 건축 키트 │ 인테리어 업체. │ │ │ │ HTML+CSS+JS를 편하게 조립해 줌 │ ├─────────────────────────────────────────────────────────┤ │ 컴포넌트(Component)│ 재사용 가능한 UI 부품 │ 서식 템플릿. │ │ │ │ 한 번 만들면 여러 서류에 재사용 │ ├─────────────────────────────────────────────────────────┤ │ npm │ 코드 패키지 설치 도구 │ 앱스토어. │ │ │ (Node Package Manager) │ 필요한 도구를 검색해서 설치 │ ├─────────────────────────────────────────────────────────┤ │ 터미널(Terminal) │ 키보드로 컴퓨터에 명령 │ 노위 전자접수 시스템. │ │ │ 내리는 창 │ 마우스 대신 글자로 조작 │ ├─────────────────────────────────────────────────────────┤ │ Node.js │ JavaScript 실행 환경 │ 엑셀의 VBA 엔진. │ │ │ │ JS 코드가 돌아가는 무대 │ └─────────────────────────────────────────────────────────┘ 집 짓기로 비유하면: HTML이 골조(뼈대), CSS가 인테리어(페인트, 가구 배치), JavaScript가 전기·수도(움직이는 것들)입니다. React/Next.js는 이 모든 걸 쉽게 조립할 수 있게 도와주는 건축 회사이고, npm은 자재를 사오는 곳입니다. 터미널은 이 모든 작업을 지시하는 현장소장의 무전기입니다.

개발 세계에는 영어 줄임말이 정말 많습니다. 처음 보면 당황스럽지만, 풀어서 보면 별것 아닌 경우가 대부분입니다. 앞으로 자주 마주칠 줄임말을 미리 정리해 두겠습니다. ┌─────────────────────────────────────────────────────────┐ │ 줄임말 │ 풀어쓰기 │ 한마디 번역 │ ├─────────────────────────────────────────────────────────┤ │ CLI │ Command Line Interface │ 터미널에서 글자로 조작하는 │ │ │ │ 프로그램 (마우스 대신 키보드) │ ├─────────────────────────────────────────────────────────┤ │ SSG │ Static Site Generation │ 미리 만들어둔 웹페이지. │ │ │ │ 빠르고 저렴함 │ ├─────────────────────────────────────────────────────────┤ │ SSR │ Server Side Rendering │ 요청할 때마다 새로 만드는 │ │ │ │ 웹페이지. 항상 최신 상태 │ ├─────────────────────────────────────────────────────────┤ │ env │ Environment Variable │ 비밀번호 같은 설정값을 안전하게 │ │ │ │ 저장하는 곳. 금고 속 열쇠 │ ├─────────────────────────────────────────────────────────┤ │ JSON │ JavaScript Object Notation │ 데이터를 정리해서 저장하는 형식. │ │ │ │ 엑셀 표와 비슷한 역할 │ ├─────────────────────────────────────────────────────────┤ │ Markdown │ (.md 파일) │ 간단한 서식 문법. │ │ │ │ **굵게**, - 목록 등 │ │ │ │ 메모장처럼 가볍게 문서 작성 │ ├─────────────────────────────────────────────────────────┤ │ PR │ Pull Request │ 코드 변경 사항을 검토 요청하는 것. │ │ │ │ 상급자에게 "검토해주세요" 올리기 │ └─────────────────────────────────────────────────────────┘ SSG와 SSR의 차이를 노무사 업무로 비유하면 이렇습니다. SSG는 자주 쓰는 답변서 템플릿을 미리 만들어 놓는 것이고, SSR은 매번 의뢰인 상황에 맞게 새로 작성하는 것입니다. 템플릿이 빠르지만 유연성이 떨어지고, 매번 새로 쓰면 느리지만 맞춤형이죠. env(환경 변수)는 특히 중요합니다. API 키, 비밀번호 같은 민감한 정보를 코드에 직접 적으면 위험하니까, 별도의 안전한 장소(env 파일)에 보관합니다. 의뢰인 개인정보를 사건 파일과 분리해서 잠금장치가 있는 곳에 보관하는 것과 같습니다.