어려운 말 사전
산초 강좌와 「AI 기초 다지기」에 나오는 낯선 말 86개를 쉬운 말로 풀었습니다.
기초 강좌 몇 편에서 배우는 말인지로 묶었고, 오른쪽 칸은 산초 강좌 몇 편에 나오는지입니다. 찾을 때는 Ctrl+F 로 말을 쳐 보세요.
© 2026 crazy4eu (cwkim83) · 강좌 자료 CC BY-NC-ND 4.0 — 맨 아래 「저작권 · 라이선스」
1편 내 컴퓨터와 인터넷 저편에서 배우는 말
| 말 | 쉬운 뜻 | 이렇게 쓰여요 | 산초 강좌 |
|---|---|---|---|
127.0.0.1localhost (loopback) | '바로 이 컴퓨터 자신'을 가리키는 약속된 주소예요. 이 주소로 연 화면은 내 PC 에서만 보이고, 같은 와이파이의 다른 기기에서는 열리지 않습니다. | 주소가 127.0.0.1인 건, 이 컴퓨터 안에서만 열린다는 뜻입니다. | 1 · 9편 |
| 데이터베이스 database (DB) | 자료를 체계적으로 보관하고 찾아 주는 전용 저장 시스템이에요. 산초는 이것 없이 data 폴더의 JSON 파일로 대신해서 설치와 관리가 쉽습니다. | Sancho는 데이터베이스 대신 파일을 씁니다. | 1 · 2 · 6편 |
| 로컬 local | 내 컴퓨터 안에서 일이 벌어진다는 뜻이에요. 자료와 프로그램이 내 PC 안에 있고, 인터넷 저편의 남의 컴퓨터(클라우드)를 거치지 않습니다. | 코드 탭에서 로컬을 고르고, 방금 만든 폴더를 엽니다. | 1편 |
| 브라우저 browser | 인터넷 화면을 열어 보는 프로그램(크롬·엣지 등)이에요. 서버가 내어 준 화면을 우리 눈에 보이게 그려 줍니다. | 보세요. 브라우저에서 서버로, 서버에서 Claude Code로, 그리고 데이터 폴더로 이어지는 길이 한눈에 보입니다. | 1 · 2 · 3 · 4 · 5 · 6 · 7 · 9 · 10편 |
| 서버 server | 누가 부르면 대답해 주는 프로그램이에요. 식당 카운터 직원처럼 손님(브라우저)이 주문하면 화면과 자료를 내어 주며, 큰 기계가 아니라 내 PC 안에서도 돌 수 있습니다. | 서버는 비서의 몸통입니다. 화면을 보여 주고, 로그인을 확인하고, 나중에는 두뇌에 일을 넘깁니다. | 1 · 2 · 3 · 4 · 5 · 6 · 7 · 8 · 9 · 10편 |
| 주소 URL | 인터넷(또는 내 PC 안)에서 어떤 화면이나 자료를 찾아가는 위치예요. 건물의 도로명 주소와 같고, 웹 주소를 URL 이라고 부릅니다. | 터널 주소로 토큰 없이 열면, 접속 토큰이 필요하다는 화면만 나옵니다. | 1 · 5 · 6 · 9 · 10편 |
| 클라우드 cloud | 인터넷 저편에 있는 남의 큰 컴퓨터에 자료를 맡기고 빌려 쓰는 방식이에요. 어디서든 열 수 있는 대신, 내 자료가 밖으로 나간다는 점을 늘 생각해야 합니다. | 다만 Claude 웹에서 물으면 그 내용은 Anthropic 쪽으로 전달된다는 점도 설정 화면에 적어 두었습니다. | 9편 |
| 터널 tunnel (Cloudflare Tunnel) | 내 컴퓨터 안의 서비스를 인터넷의 임시 주소로 이어 주는 통로예요(여기서는 Cloudflare 터널). 밖에서 휴대폰으로 쓸 수 있지만 문을 여는 일이라, 접속 토큰과 로그인 두 겹으로 잠급니다. | 터널 주소로 토큰 없이 열면, 접속 토큰이 필요하다는 화면만 나옵니다. | 9편 |
| 포트 port | 한 컴퓨터 안에서 프로그램마다 배정된 창구 번호예요. 주소가 건물이라면 포트는 그 안의 호수 같아서, 산초 서버는 8790번 창구에서 손님을 받습니다. | 주소: http://127.0.0.1:8790 (이 PC 에서만 열린다) | 1 · 9편 |
| 폴더·경로 folder / path | 폴더는 파일을 담는 서랍이고, 경로는 그 서랍까지 찾아가는 길(예: 문서\my-agent\data)이에요. 'data/' 처럼 슬래시로 층을 나눠 적기도 합니다. | 파일 탐색기에서 빈 폴더를 하나 만들어 주세요. 저는 문서 폴더 안에 my-agent 라는 폴더를 만들었습니다. | 1 · 2 · 3 · 4 · 5 · 6 · 8 · 10편 |
| data 폴더 data folder | 산초가 일하면서 만든 자료(일정·기억·기록 등)를 모두 모아 두는 서랍이에요. 개인 자료가 들어 있어서 Git 에는 올리지 않습니다. | 데이터 폴더는 Git에 올리지 말라고 했더니, 그걸 막는 파일까지 알아서 만들었네요. | 1 · 2 · 3 · 4 · 5 · 6 · 9 · 10편 |
2편 글자로 컴퓨터에 시키기에서 배우는 말
| 말 | 쉬운 뜻 | 이렇게 쓰여요 | 산초 강좌 |
|---|---|---|---|
| 명령어 command | 컴퓨터에게 '이걸 해라' 하고 글자로 적어 주는 한 줄이에요. 산초 강좌에서 Claude 가 실행 전에 허락을 묻는 것이 바로 이 명령어입니다. | 보이시죠? 명령을 실행하기 전에 허락을 묻습니다. | 1 · 2 · 3 · 5 · 8 · 9편 |
| 설치 install | 프로그램을 내 컴퓨터에 깔아서 쓸 수 있게 준비하는 일이에요. 이미 깔려 있으면 다시 설치할 필요가 없습니다. | Node.js도 깃도 이미 깔려 있어서, 설치할 것은 없었습니다. | 1 · 5 · 9 · 10편 |
| 터미널 terminal | 글자로 컴퓨터에 시키는 창이에요. 마우스 대신 명령어를 입력하고 엔터를 누르면 컴퓨터가 그대로 실행합니다. | 터미널에서 직접 server.js 를 망가뜨리고(사람이 실수한 상황) start.bat 으로 켜기 | 8편 |
| 파일 확장자 file extension | 파일 이름 끝, 점 뒤의 글자(.docx, .json, .md 등)로 어떤 종류의 파일인지 알려 줍니다. 예를 들어 .json 은 자료를 적은 파일, .md 는 서식 있는 메모 글, .html 은 화면 파일이에요. | 기억은 memory.md라는 파일에 한 줄씩 적으라고 일러두는 겁니다. | 1 · 2 · 3 · 4 · 5 · 6 · 7 · 8 · 10편 |
| 패키지·라이브러리 package / library | 다른 사람이 미리 만들어 둔 기능 부품 묶음이에요. 산초는 외부 패키지 없이 Node.js 내장 기능만 쓰도록 해서 설치할 것이 적고 관리가 쉽습니다. | 엑셀 파일도 외부 패키지 없이 직접 만들고, WBS 화면에는 투입 공수 카드를 붙였습니다. | 1 · 3 · 7 · 9 · 10편 |
| CLI Command-Line Interface | 글자 명령으로 쓰는 프로그램 방식이에요. 마우스로 누르는 화면(GUI)과 달리 터미널에서 명령어 한 줄로 프로그램을 부립니다. | 서버가 claude 를 실행한다: claude -p --output-format stream-json --verbose --include-partial-messages --model sonnet | 1편 |
| JSON JavaScript Object Notation | 자료를 정해진 모양으로 적는 글 형식이에요. '이름: 값' 짝을 줄줄이 적은 메모장이라고 보면 되고, 산초는 일정·할 일을 이 형식의 파일로 저장합니다. | 비밀번호는 scrypt 해시로 data/users.json 에 저장, 평문 저장 금지. | 1 · 2 · 3 · 4 · 5 · 6 · 7 · 9 · 10편 |
| Node.js | 자바스크립트로 쓴 프로그램을 내 컴퓨터에서 돌려 주는 엔진이에요. 산초 서버가 이것으로 돌아가므로, 산초를 쓰려면 먼저 깔려 있어야 합니다. | 첫 요청은 간단합니다. Node.js와 Git이 깔려 있는지 확인하고, 이 폴더를 Git 저장소로 만들어 달라고 했습니다. | 1 · 8편 |
3편 작업 저장과 공유에서 배우는 말
| 말 | 쉬운 뜻 | 이렇게 쓰여요 | 산초 강좌 |
|---|---|---|---|
| 되돌리기 rollback / revert | 잘못된 변경을 이전의 멀쩡한 상태로 돌리는 일이에요. Git 으로 앞 단계로 돌아가거나, 산초처럼 '정상이던 마지막 버전'으로 되돌려 다시 켜기도 합니다. | 되돌리기 전의 상태도 리비전으로 자동 저장됩니다. 실수로 되돌려도 다시 돌아올 수 있게요. | 1 · 3 · 4 · 5 · 7 · 8편 |
| 라이선스 license | 만든 사람이 '이 자료를 어디까지 써도 되는지' 밝히는 사용 허락 조건이에요. 산초 강좌 영상·글에는 '저작자 표시·비영리·변경 금지'(CC BY-NC-ND 4.0) 조건이 적혀 있습니다. | README.md 를 처음 쓰는 사람용으로(설치 5분 · 화면 · 안전 · 1~10편 요약 · 라이선스) | 10편 |
| 리비전 revision (Rev) | 문서나 공정표의 저장된 판(Rev)이에요. 'Rev 저장'을 눌러 두면 나중에 그 판으로 되돌릴 수 있어서 Git 의 커밋과 닮았습니다. | 공정표는 자주 바뀌니까 리비전 저장이 꼭 필요합니다. | 3편 |
| 브랜치 branch | 작업 기록의 갈래예요. 본 줄기는 그대로 두고 따로 보관하거나 시험하고 싶은 변경을 갈래에 둡니다. 산초의 감시자는 망가진 변경을 보존용 브랜치에 남겨 둡니다. | 망가진 변경을 보존 브랜치에 커밋해 둔 뒤 last-good 버전으로 되돌려 다시 켰습니다. | 8편 |
| 저장소 repository (repo) | Git 이 작업 기록(커밋)을 모아 두는 폴더예요. 산초 강좌의 코드는 GitHub 의 my-agent-Sancho 저장소에 있고, 2편처럼 '자료를 모아 두는 곳'이라는 일반적인 뜻으로 쓰일 때도 있습니다. | 오늘 만든 코드는 GitHub 의 my-agent-Sancho 저장소, ep1 태그에 있습니다. | 1 · 2 · 3 · 4 · 5 · 6 · 7 · 8 · 9 · 10편 |
| 커밋 commit | Git 에서 지금까지의 작업을 한 번 저장하는 일, 또는 그렇게 저장된 한 시점이에요. 게임의 세이브 포인트와 같고, '왜 바꿨는지' 메모를 함께 남깁니다. | Git 커밋은 게임의 세이브 포인트 같은 겁니다. | 1 · 2 · 3 · 4 · 5 · 6 · 7 · 8 · 9 · 10편 |
| 태그 tag | 특정 커밋에 붙이는 이름표예요. 산초 강좌는 편마다 ep1 … ep10, v1.0 태그를 붙여 두어서, 막히면 그 편의 완성본을 찾아볼 수 있습니다. | 모두 고치고 점검은 321개가 됐습니다. 커밋하고 ep3 태그를 붙였습니다. | 1 · 2 · 3 · 4 · 5 · 6 · 7 · 8 · 9 · 10편 |
| Git | 작업을 단계마다 저장해 두는 프로그램이에요. 게임의 세이브 파일처럼 잘못되면 앞 단계로 돌아갈 수 있습니다. | Git은 작업을 단계마다 저장해 두는 장치입니다. 잘못되면 언제든 앞 단계로 되돌릴 수 있어서, 처음부터 켜 두는 게 좋습니다. | 1 · 4 · 8 · 10편 |
| GitHub | Git 저장소를 인터넷에 올려 두는 웹 서비스예요. 공개해 두면 누구나 볼 수 있고, 산초 강좌의 코드도 여기서 받아 볼 수 있습니다. | 오늘 만든 코드는 GitHub 의 my-agent-Sancho 저장소, ep1 태그에 있습니다. 막히면 그 코드를 열어 비교해 보세요. | 1 · 2 · 3 · 4 · 5 · 6 · 7 · 8 · 9 · 10편 |
| push | 내 컴퓨터 Git 저장소의 변경을 GitHub 같은 인터넷 저장소로 올리는 일이에요. 반대로 내려받는 일은 clone·pull 이라고 부릅니다. | — | |
| README | 저장소 맨 앞에 두는 '사용 설명서' 글(README.md)이에요. 무엇인지, 어떻게 설치하고 쓰는지, 라이선스는 무엇인지 처음 보는 사람을 위해 적습니다. | 리드미도 처음 쓰는 사람을 위해 새로 썼습니다. | 10편 |
4편 AI 는 어떻게 말을 하나에서 배우는 말
| 말 | 쉬운 뜻 | 이렇게 쓰여요 | 산초 강좌 |
|---|---|---|---|
| 두뇌 | 산초 강좌에서 비서가 생각하고 답하는 부분을 부른 말이에요. 산초의 두뇌는 내 PC 의 Claude Code 이고, 화면과 서버(몸통)와는 따로입니다. | 두뇌를 붙이기 전에 일부러 가짜 답으로 화면부터 확인합니다. | 1 · 4 · 5편 |
| 모델 model | AI 의 종류·등급 이름이에요. 같은 Claude 라도 모델에 따라 속도·꼼꼼함·사용량이 달라서 일에 맞게 바꿔 씁니다(예: Sonnet, Opus). | 모델은 Sonnet 5.5, 권한 모드는 처음이니까 수동으로 둡니다. | 1 · 2 · 3 · 4편 |
| 사용량(한도) usage limit | Claude 를 쓰면 쓴 만큼 사용량이 쌓이고, 요금제마다 쓸 수 있는 한도가 정해져 있어요. 산초 강좌에서는 모델을 바꾸면 대화를 다시 읽느라 사용량을 더 쓴다는 경고가 뜹니다. | 모델을 바꾸면 경고가 뜹니다. 지금까지의 대화를 새 모델이 다시 읽어야 해서, 사용량을 조금 더 쓴다는 뜻입니다. | 1 · 2 · 4편 |
| 시스템 프롬프트 system prompt | 대화가 시작되기 전에 AI 에게 미리 깔아 주는 기본 지침이에요. 산초는 이름·말투·'기억해' 규칙 같은 것을 이 지침에 적어 둡니다. | 비서가 말로 예약을 만들 수 있게 시스템 프롬프트에 schedule.json 형식을 적는다. | 1 · 2 · 4 · 8 · 10편 |
| 토큰 token | 비밀번호처럼 '나임'을 증명하는 긴 문자열이에요(접속 토큰·봇 토큰). 대화창에 붙여 넣거나 남에게 보이면 안 됩니다. AI 쪽에서는 글을 잘게 나눈 단위를 뜻하기도 하며 사용량도 이 단위로 셉니다. | 토큰은 비밀번호와 같아서 대화창에 붙여 넣으면 안 됩니다. | 3 · 4 · 9 · 10편 |
| 프롬프트 prompt | AI 에게 보내는 글, 곧 '시킬 말'이에요. 산초 강좌에서는 '요청문'이라고 불렀고, 무엇을 왜 어디까지 만들지 분명히 적을수록 잘 만들어집니다. | 로그인은 요청문에 연습용 계정을 적어 줘서 비서가 했습니다. 실제 비밀번호는 요청문에 쓰지 마세요. | 1 · 2 · 4편 |
| 환각(지어내기) hallucination | AI 가 모르는 것을 모른다고 하지 않고 그럴듯하게 지어내는 일이에요. 숫자·출처·날짜처럼 중요한 것은 꼭 직접 확인해야 합니다. | — | |
| AI Artificial Intelligence | 사람처럼 글을 읽고 쓰고 판단해 주는 컴퓨터 프로그램을 통틀어 부르는 말이에요(인공지능). 이 강좌에서는 Claude 같은 대화형 AI 를 가리킵니다. | 이름은 나의 AI 비서, Sancho입니다. | 1 · 2 · 3 · 4 · 5 · 6 · 7 · 8 · 9 · 10편 |
| Haiku | Claude 모델 가족의 하나로 Opus·Sonnet 과 같은 시리즈 이름이에요. 일반적으로 가볍고 빠른 쪽을 가리킵니다(산초 강좌에는 나오지 않아요). | — | |
| LLM Large Language Model | 아주 많은 글을 읽고 '다음에 올 말'을 맞히도록 훈련된 AI 모델이에요(거대 언어 모델). 산초 강좌에서는 이 부분을 '두뇌'라고 불렀습니다. | 비서는 우리가 쓰는 Claude Code를 그대로 불러서 생각하게 합니다. | 1 · 4 · 5편 |
| Opus | Claude 모델 중 더 꼼꼼한 쪽이에요. 산초 강좌에서는 Sonnet 이 만든 결과를 Opus 가 검증하는 역할을 맡았습니다. | 일은 가볍고 빠른 Sonnet 5.5가 하고, 마지막 검증은 더 꼼꼼한 Opus가 합니다. | 1 · 2 · 3 · 4 · 5 · 6 · 7 · 8 · 9 · 10편 |
| Sonnet | Claude 모델 중 가볍고 빠른 쪽이에요. 산초 강좌에서는 Sonnet 5.5 가 코드를 만드는 일을 맡았습니다. | 여기까지 Sonnet이 만들었습니다. 이제 모델을 Opus로 바꿔서 검증을 맡깁니다. | 1 · 2 · 3편 |
5편 내 PC 에서 도는 AI에서 배우는 말
| 말 | 쉬운 뜻 | 이렇게 쓰여요 | 산초 강좌 |
|---|---|---|---|
| 로컬 LLM local LLM | 인터넷 없이 내 컴퓨터 안에서 도는 AI 예요. 자료가 밖으로 나가지 않고 공짜로 쓸 수 있지만, 보통 클라우드의 큰 AI 보다 느리고 덜 똑똑합니다. | — | |
| Ollama | 내 컴퓨터에서 AI 모델을 내려받아 돌릴 수 있게 해 주는 프로그램이에요. 로컬 LLM 을 쓸 때 많이 쓰는 도구 중 하나입니다. | — |
6편 Claude 의 여러 문에서 배우는 말
| 말 | 쉬운 뜻 | 이렇게 쓰여요 | 산초 강좌 |
|---|---|---|---|
| 채팅 chat | AI 와 글로 주고받는 대화창이에요. 산초 화면에서도 가운데에 같은 모양의 채팅창이 있습니다. | 로그인 화면이 뜨고, 로그인하면 왼쪽에 업무 메뉴, 가운데에 채팅창이 있습니다. | 1 · 2 · 3 · 4 · 5 · 7 · 8 · 9 · 10편 |
| Claude | Anthropic(앤트로픽)이 만든 AI 의 이름이에요. 채팅 앱·웹·Claude Code 등 여러 문으로 쓸 수 있습니다. | 만드는 도구는 Claude 데스크톱 앱의 코드 탭 하나입니다. | 1 · 2 · 3 · 5 · 6 · 8 · 9 · 10편 |
| Claude Code | Claude 데스크톱 앱의 코드 탭에서 쓰는, 파일을 읽고 고치고 명령을 실행하며 일하는 Claude 예요. 산초의 두뇌가 바로 이것입니다. | 말을 걸면 내 Claude Code가 생각해서 답하고, 기억해 달라고 한 것은 새 대화에서도 기억합니다. | 1 · 4 · 5 · 6 · 10편 |
| Code 탭 Code tab | Claude 데스크톱 앱 위쪽에 있는 탭이에요. 여기서 폴더를 골라 Claude Code 에게 일을 시키며, 프로·맥스·팀 같은 유료 요금제에서 쓸 수 있습니다. | Claude 데스크톱 앱을 설치하고 로그인한 다음, 위쪽의 코드 탭을 누릅니다. 코드 탭은 프로나 맥스, 팀 같은 유료 요금제에서 쓸 수 있습니다. | 1 · 2 · 5편 |
| Cowork | Claude 에게 내 컴퓨터의 폴더를 맡기고 문서 정리·보고서 같은 사무 일을 시키는 방식이에요(산초 강좌에는 나오지 않아요). | — |
7편 Claude 에 손 달기 ①에서 배우는 말
| 말 | 쉬운 뜻 | 이렇게 쓰여요 | 산초 강좌 |
|---|---|---|---|
| 커넥터 connector | Claude 에 Gmail·캘린더 같은 외부 앱을 연결해 두는 통로예요. 5편에서는 클로드 웹의 설정에서 연결해 두면 같은 계정의 Claude Code 에서도 쓸 수 있었습니다. | 클로드 웹사이트의 설정에서 지메일과 구글 캘린더를 연결해 두면, 같은 계정으로 로그인한 Claude Code에서도 쓸 수 있습니다. | 1 · 5 · 8 · 9편 |
| MCP Model Context Protocol | AI 와 다른 앱이 도구를 주고받는 약속된 방식(규격)이에요. 9편에서는 산초를 MCP 창구로 만들어, Claude 웹의 커스텀 커넥터에 주소만 넣으면 부를 수 있게 했습니다. | MCP라는 약속된 방식이라, Claude 웹의 커스텀 커넥터에 주소만 넣으면 됩니다. | 9 · 10편 |
8편 Claude 에 손 달기 ②에서 배우는 말
| 말 | 쉬운 뜻 | 이렇게 쓰여요 | 산초 강좌 |
|---|---|---|---|
| 스킬 skill | AI 에게 가르쳐 두는 '일하는 절차서'예요. 한 번 적어 두면 다음 대화부터 AI 가 알아서 읽고 따르며, 산초 2편에서는 일정 파일의 위치와 형식을 스킬로 가르쳤습니다. | 비서에게 일정 파일의 위치와 형식을 알려 주는 규칙을 하나 줍니다. 이걸 스킬이라고 합니다. | 1 · 2 · 3 · 4 · 5 · 7 · 10편 |
| 플러그인 plugin | 스킬·명령·커넥터 같은 여러 기능을 한 꾸러미로 묶어 한 번에 설치하는 부가 기능이에요(산초 강좌에는 나오지 않아요). | — | |
| 확장 프로그램 extension | 프로그램에 기능을 덧붙이는 작은 부품이에요. 앱이나 브라우저에 설치하면 없던 기능이 생깁니다(산초 강좌에는 나오지 않아요). | — |
9편 바이브 코딩 기본기에서 배우는 말
| 말 | 쉬운 뜻 | 이렇게 쓰여요 | 산초 강좌 |
|---|---|---|---|
| 계획 모드 Plan mode | Claude 가 파일을 고치지 않고 읽고 설계만 하는 모드예요. 큰 기능을 만들기 전에 설계를 먼저 보고 확인하려고 씁니다. | 계획 모드에서는 비서가 코드를 고치지 않고, 읽고 설계만 합니다. | 3 · 8편 |
| 권한 모드 permission mode | Claude 가 파일을 고치거나 명령을 실행할 때 어디까지 묻고 어디까지 알아서 할지 정하는 설정이에요. 수동(매번 물음), 편집 자동 수락, 자동, 계획(고치지 않고 계획만)이 나옵니다. | 모델은 Sonnet 5.5, 권한 모드는 편집 자동 수락으로 둡니다. 파일 수정은 알아서 하고, 명령을 실행할 때만 묻는 모드입니다. | 1 · 2 · 3 · 4편 |
| 바이브 코딩 vibe coding | 코드를 직접 쓰지 않고 말로 AI 에게 시켜서 만드는 방식이에요. 산초 강좌의 첫째 규칙은 '한 번에 하나씩'입니다. | 한 번에 하나씩, 이게 바이브 코딩의 첫째 규칙입니다. | 1편 |
| 승인 approve | Claude 가 파일을 고치거나 명령을 실행하기 전에 '해도 될까요?' 하고 물을 때 사람이 허용·수락을 누르는 일이에요. 무엇을 하려는지 읽어 보고 누르는 것이 안전하게 쓰는 기본입니다. | 무엇을 실행하는지 읽어 보고 허용을 누르면 됩니다. | 1 · 2 · 3 · 7 · 8편 |
10편 AI 에게 맡겨도 되는 이유에서 배우는 말
| 말 | 쉬운 뜻 | 이렇게 쓰여요 | 산초 강좌 |
|---|---|---|---|
| 감시자 watchdog | 서버를 지켜보다가 꺼지거나 안 켜지면 last-good 버전으로 되돌려 다시 켜 주는 보조 프로그램이에요. 사람이 망가뜨린 작업도 지우지 않고 보존 브랜치에 남깁니다. | 감시자는 서버가 켜지지 않는 걸 보고, 망가진 변경을 보존 브랜치에 커밋해 둔 뒤 last-good 버전으로 되돌려 다시 켰습니다. | 8편 |
| 검증 verify / validate | 만든 것이 정말 맞는지 따로 다시 확인하는 일이에요. 산초 강좌는 Sonnet 이 만들고 Opus 가 검증하며, 고치기 전에 문제 목록부터 보여 달라고 합니다. | Sonnet이 만든 걸 Opus가 잡아냈습니다. 검증이 왜 필요한지 보여 주는 장면이죠. | 1 · 2 · 3 · 4 · 5 · 6 · 7 · 8 · 9 · 10편 |
| 관문 gate | 고친 코드가 통과해야만 서버를 다시 켜 주는 검문소예요. 문법 검사와 selftest 를 통과해야 하고, 하나라도 실패하면 변경을 버립니다. | 비서는 시킨 대로 고쳤지만, 관문이 문법 검사에서 막고 변경을 되돌렸습니다. | 8편 |
| 권한 permission | 누가 무엇을 해도 되는지의 허락 범위예요. 산초는 메일 읽기·명령 실행 같은 위험한 능력을 스위치로 꺼 두고, 필요할 때만 사람이 켭니다. | 메일처럼 민감한 것은 스위치로 켜고 끕니다. 연결된 앱, 명령 실행, 내 폴더 읽기. 기본은 모두 꺼짐입니다. | 1 · 5 · 6 · 8 · 10편 |
| 보호 장치 | Opus 5.5 에 들어 있는 안전 장치로, 공격처럼 보이는 작업을 감지하면 세션을 멈춰요. 6·8편에서는 요청을 '설계한 규칙대로 동작하는지 확인' 쪽으로 바꾸거나 가볍게 줄여 다시 시도해 통과했습니다. | Opus 5.5의 보호 장치가 이 작업을 사이버 공격처럼 보고 멈춘 겁니다. | 6 · 7 · 8편 |
| 불변 층 | 비서가 절대 고치지 못하게 막아 둔 파일 묶음이에요. start.bat·selftest 핵심 검사처럼 안전장치 자체를 비서가 망가뜨리지 못하게 지키는 층입니다. | 불변 층: start.bat 과 selftest 의 핵심 검사는 비서가 수정하지 못하게(자기 수정 때 허용 폴더에서 뺀다). | 8편 |
| 에이전트 agent | 목표를 주면 스스로 계획하고, 파일 읽기·명령 실행 같은 도구를 써 가며 일을 끝까지 해 보는 AI 예요. 산초 강좌에서는 Claude Code 가 탐색 에이전트를 따로 보내 코드를 나눠 읽기도 합니다. | 비서는 탐색 에이전트 2개를 보내 코드를 읽은 뒤, 갈림길 3개를 쉬운 말로 물었습니다. | 1 · 3 · 8편 |
CLAUDE.md | Claude Code 가 일을 시작할 때마다 제일 먼저 읽는 '일하는 법' 메모 파일이에요. 말투·규칙·하지 말아야 할 일을 적어 두면 매번 그대로 따릅니다. | Claude Code는 매번 처음 보는 사람처럼 일합니다. 그래서 일하는 법을 CLAUDE.md라는 파일에 적어 둡니다. | 1 · 2 · 3 · 4편 |
| last-good | '마지막으로 정상이던 버전'에 붙여 두는 Git 표시(태그)예요. 서버가 망가지면 감시자가 이 버전으로 되돌려 다시 켭니다. | 30초 동안 건강 검사를 통과하자, 감시자가 이 커밋에 last-good 표시를 옮겨 붙였습니다. | 8 · 9편 |
| selftest(자동 점검) self-test | 프로그램이 스스로 고장 났는지 검사하는 자동 시험이에요. 강좌에서 '점검은 941개입니다'라고 할 때의 점검이 이것이고, 기능을 만들 때마다 검사 항목도 같이 만듭니다. | 기능을 만들면 그 기능을 검사하는 selftest 항목도 같이 만든다(node selftest.js). | 1 · 2 · 3 · 4 · 5 · 6 · 7 · 8 · 9 · 10편 |
산초 강좌에서 만나는 말
기초 강좌에서는 따로 다루지 않지만, 산초 강좌 화면과 요청문에 나오는 말입니다.
| 말 | 쉬운 뜻 | 이렇게 쓰여요 | 산초 강좌 |
|---|---|---|---|
| 노드 node | 워크플로에서 한 단계 한 단계를 나타내는 블록이에요. 산초에는 '매일 시각', '데이터 읽기', '알림' 같은 노드 12가지가 있습니다. | 캔버스에서 노드를 끌어 놓고 선으로 잇기. | 10편 |
| 대시보드 dashboard | 여러 정보를 한 화면에 모아 보여 주는 첫 화면이에요. 산초 대시보드는 오늘 일정·마감 임박 할 일 같은 숫자 카드와 채팅창이 함께 있습니다. | 대시보드는 출근해서 제일 먼저 보는 화면입니다. | 1 · 2 · 3 · 4 · 6 · 7 · 9 · 10편 |
| 비밀번호 해시 password hash | 비밀번호를 되돌릴 수 없는 다른 글자로 바꿔 저장하는 방식이에요. 파일을 누가 열어 봐도 원래 비밀번호를 알 수 없습니다. | 비밀번호는 그대로 저장하지 않고 해시라는 방식으로 바꿔서 저장합니다. 파일을 누가 열어 봐도 비밀번호를 알 수 없게요. | 1편 |
| 세션 session | Claude Code 와 이어서 나누는 작업 대화 한 판이에요. 대화가 길어지면 AI 가 앞 내용을 흐리게 기억해서, 편마다 새 세션을 열어 짧게 끊어 씁니다. | 새 편을 시작할 때는 새 세션을 엽니다. | 1 · 2 · 3 · 4 · 5 · 6 · 7 · 8 · 9 · 10편 |
| 스트리밍(SSE) streaming / SSE | 글자가 만들어지는 대로 조금씩 화면에 흘려 보내는 방식이에요. SSE 는 서버가 화면에 계속 소식을 보내는 기술 이름이고, 산초 채팅이 글자가 오는 대로 나오는 까닭입니다. | 답은 글자가 오는 대로 흘러나오게(서버에서 SSE 로 스트리밍). | 1 · 2 · 6편 |
| 예약 schedule | 정해진 시각에 AI 가 혼자 일하게 걸어 두는 일이에요(예: 매일 아침 7시 브리핑). 6편의 회의실 예약은 이름만 같은 다른 기능입니다. | 이십육 초 만에 비서가 예약을 추가했다고 답하고, 예약 칸에 아침 일곱 시 브리핑이 생겼습니다. | 1 · 4 · 6 · 10편 |
| 워크트리 worktree | 같은 프로젝트의 작업용 사본을 따로 만드는 Git 기능이에요. 같은 폴더에서 이어 만들 때는 꺼 둡니다. | 워크트리가 켜져 있으면 꺼 주세요. 작업용 사본을 따로 만드는 기능이라, 같은 폴더에서 이어 만들 때는 끕니다. | 2 · 3 · 4편 |
| 워크플로 workflow | 일의 순서를 블록(노드)으로 이어 놓은 자동화 흐름이에요. 시작 → 데이터 읽기 → 조건 나누기 → 알림처럼 이어 붙여 한 번에 돌립니다. | 워크플로 메뉴를 만들어 줘(public/m/workflow.html, db/workflows.json). n8n 처럼 노드를 이어 붙이는 자동화. | 1 · 9 · 10편 |
| 위키 wiki | 주제별로 정리해 쌓아 두는 지식 문서 모음이에요. 산초에게 '위키에 저장해'라고 하면 조사한 내용을 문서로 남기고, 관련 질문을 받으면 위키부터 찾아봅니다. | 위키에 저장해라고 하면 주제별 문서로 정리해 두고, 관련 질문을 받으면 위키부터 찾아봅니다. | 10편 |
| 텔레그램 봇 Telegram bot | 텔레그램(메신저 앱)에서 자동으로 메시지를 보내 주는 계정이에요. 산초는 예약 결과를 휴대폰으로 보내는 데 쓰고, 봇을 만들면 받는 토큰은 비밀번호처럼 지켜야 합니다. | 텔레그램에서 봇을 하나 만들고 토큰을 설정에 넣으면 됩니다. | 4 · 10편 |
| 호출 대기(웨이크워드) wake word | 마이크가 항상 듣고 있다가 '산초야' 같은 부르는 말이 나올 때만 깨어나는 기능이에요. 말소리가 구글·마이크로소프트 서버로 갈 수 있어서 필요할 때만 켭니다. | 설정 "산초야 호출 대기"를 켜면 마이크가 항상 듣고 있다가 "산초야"로 시작하는 말만 받는다. | 9편 |
| 환경변수 environment variable | 프로그램이 실행될 때 옆에 따라붙는 설정값이에요. 1편에서는 이 값이 자식 Claude 에 넘어가 '로그인 안 됨'이 나서, 실행 전에 지우도록 요청문에 적었습니다. | claude 를 실행할 때 CLAUDE 로 시작하는 환경변수와 ANTHROPIC_BASE_URL 을 지우고 실행해. | 1편 |
| API Application Programming Interface | 프로그램끼리 요청을 주고받는 창구예요. 산초 서버의 /api 주소들이 화면과 서버가 대화하는 창구이고, 로그인하지 않으면 거절됩니다. | 로그인 없이 /api 나 화면 데이터에 접근되는 곳이 있는지 | 1 · 2 · 6 · 7 · 8편 |
| API 키 API key | AI 서비스를 프로그램에서 쓰기 위한 비밀 열쇠예요. 보통 쓴 만큼 요금이 붙는데, 산초는 내 구독으로 로그인한 Claude Code 를 쓰므로 API 키가 필요 없습니다. | API 키도, 따로 내는 요금도 없습니다. | 1편 |
| EVMS Earned Value Management System | 계획 대비 얼마나 했는지를 금액으로 비교하는 일정·비용 관리 방식이에요. 일정 성과 SPI 가 1보다 작으면 계획보다 늦다는 뜻입니다. | 위의 제작 단계 진도율이 47%에서 55%로, 그리고 전체 진도율과 EVMS 숫자가 함께 바뀝니다. | 3편 |
| OKR Objectives and Key Results | 목표(Objective)와 핵심 결과(Key Result)로 목표를 관리하는 방식이에요. 핵심 결과 달성률을 평균 내서 위 목표의 진척이 자동으로 올라갑니다. | 다음은 목표 관리, OKR입니다. 전사, 부서, 개인 목표를 나무 모양으로 잇고, 목표마다 핵심 결과를 둡니다. | 7편 |
| PWA Progressive Web App | 웹사이트를 휴대폰 홈 화면에 추가해 앱처럼 쓰는 방식이에요. 산초는 홈 화면에 추가하면 주소창 없이 앱처럼 열립니다. | 홈 화면에 추가하면 앱처럼 열리는 PWA도 만들었습니다. | 9편 |
| WBS Work Breakdown Structure | 프로젝트를 큰 단계와 작은 작업으로 쪼갠 공정표예요(작업분할구조). 누가·언제부터 언제까지·얼마나 했는지가 한눈에 보입니다. | WBS는 프로젝트를 큰 단계와 작은 작업으로 쪼갠 표입니다. | 1 · 3 · 7 · 9 · 10편 |