💬말로 만드는 AI▶ 유튜브
🌱 기초

어려운 말 사전

산초 강좌와 「AI 기초 다지기」에 나오는 낯선 말 86개를 쉬운 말로 풀었습니다.
기초 강좌 몇 편에서 배우는 말인지로 묶었고, 오른쪽 칸은 산초 강좌 몇 편에 나오는지입니다. 찾을 때는 Ctrl+F 로 말을 쳐 보세요.
© 2026 crazy4eu (cwkim83) · 강좌 자료 CC BY-NC-ND 4.0 — 맨 아래 「저작권 · 라이선스」

1편 내 컴퓨터와 인터넷 저편에서 배우는 말

말쉬운 뜻이렇게 쓰여요산초 강좌
127.0.0.1
localhost (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 sonnet1편
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편
GitHubGit 저장소를 인터넷에 올려 두는 웹 서비스예요. 공개해 두면 누구나 볼 수 있고, 산초 강좌의 코드도 여기서 받아 볼 수 있습니다.오늘 만든 코드는 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편
HaikuClaude 모델 가족의 하나로 Opus·Sonnet 과 같은 시리즈 이름이에요. 일반적으로 가볍고 빠른 쪽을 가리킵니다(산초 강좌에는 나오지 않아요).—
LLM
Large Language Model
아주 많은 글을 읽고 '다음에 올 말'을 맞히도록 훈련된 AI 모델이에요(거대 언어 모델). 산초 강좌에서는 이 부분을 '두뇌'라고 불렀습니다.비서는 우리가 쓰는 Claude Code를 그대로 불러서 생각하게 합니다.1 · 4 · 5편
OpusClaude 모델 중 더 꼼꼼한 쪽이에요. 산초 강좌에서는 Sonnet 이 만든 결과를 Opus 가 검증하는 역할을 맡았습니다.일은 가볍고 빠른 Sonnet 5.5가 하고, 마지막 검증은 더 꼼꼼한 Opus가 합니다.1 · 2 · 3 · 4 · 5 · 6 · 7 · 8 · 9 · 10편
SonnetClaude 모델 중 가볍고 빠른 쪽이에요. 산초 강좌에서는 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편
ClaudeAnthropic(앤트로픽)이 만든 AI 의 이름이에요. 채팅 앱·웹·Claude Code 등 여러 문으로 쓸 수 있습니다.만드는 도구는 Claude 데스크톱 앱의 코드 탭 하나입니다.1 · 2 · 3 · 5 · 6 · 8 · 9 · 10편
Claude CodeClaude 데스크톱 앱의 코드 탭에서 쓰는, 파일을 읽고 고치고 명령을 실행하며 일하는 Claude 예요. 산초의 두뇌가 바로 이것입니다.말을 걸면 내 Claude Code가 생각해서 답하고, 기억해 달라고 한 것은 새 대화에서도 기억합니다.1 · 4 · 5 · 6 · 10편
Code 탭
Code tab
Claude 데스크톱 앱 위쪽에 있는 탭이에요. 여기서 폴더를 골라 Claude Code 에게 일을 시키며, 프로·맥스·팀 같은 유료 요금제에서 쓸 수 있습니다.Claude 데스크톱 앱을 설치하고 로그인한 다음, 위쪽의 코드 탭을 누릅니다. 코드 탭은 프로나 맥스, 팀 같은 유료 요금제에서 쓸 수 있습니다.1 · 2 · 5편
CoworkClaude 에게 내 컴퓨터의 폴더를 맡기고 문서 정리·보고서 같은 사무 일을 시키는 방식이에요(산초 강좌에는 나오지 않아요).—

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.mdClaude 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편