YAML 설정 파일(YAML Config)은 기계 옆에 붙여 둔 설정 메모 같은 것 — '이름: 값' 형태로 프로그램의 동작 방식(모델, 주소, 옵션 등)을 사람이 읽기 쉽게 적어 두는 .yaml 형식의 설정 파일이에요.
YAML 설정 파일은 기계 옆에 붙여 둔 설정 메모와 비슷해요. '온도: 180도, 시간: 20분'처럼 항목과 값을 적어 두면 기계가 그대로 따라 하죠. YAML은 이런 메모를 '이름: 값' 형태로, 들여쓰기로 묶음을 표현해 적는 형식이에요. JSON보다 괄호와 따옴표가 적어서 사람이 읽고 고치기 편해 설정 파일에 많이 쓰여요. 파일 이름은 보통 .yaml이나 .yml로 끝나요.
강의에서는 AI 에이전트의 설정이 config.yaml 파일에 들어 있는 장면이 나와요. 어떤 AI 모델을 쓸지(model), 어느 회사 모델을 부를지(provider), 접속 주소(base_url) 같은 항목이 이 파일에 적혀 있어요. Claude를 연결할 때 provider를 CLI 방식으로 바꾸고, 기본 모델과 폴백(예비) 모델이 제대로 들어갔는지 이 파일을 열어 확인해요. 'config.yaml은 어떻게 열고 수정하나요?'의 답은 VS Code 같은 편집기나 서버 터미널의 nano로 열어 값을 고치고 저장한 뒤 프로그램을 다시 시작하는 거예요. 직접 고치기 어렵다면 Claude Code에게 '이 항목을 이렇게 바꿔 줘'라고 시켜도 돼요.
YAML에서 초보가 가장 많이 겪는 오류는 들여쓰기예요. 들여쓰기는 탭 대신 띄어쓰기로 하고, 같은 단계의 항목은 칸 수를 정확히 맞춰야 해요. 콜론(:) 뒤에 한 칸을 띄우지 않아도 오류가 나요. 그리고 API 키 같은 비밀 값은 설정 파일에 직접 적기보다 환경 변수나 시크릿으로 빼 두는 게 안전해요. 고치기 전에 원본을 복사해 두면 잘못됐을 때 쉽게 되돌릴 수 있어요.
AI와 함께 나만의 사이트·서비스를 만드는 법을 강의에서 배워보세요.