K-garoo Social Club K-garoo Works WarRoom

▸ Session 02 Room

오늘은 터미널에서 시작해 Repo, MCP, Skills까지 한 번에 연결합니다.

Session 02는 2026년 4월 29일 수요일에서 2026년 4월 30일 목요일 22:00-24:00 KST로 옮겨 진행합니다. 완벽한 결과물보다도, 실제로 파일이 바뀌고 로컬에서 확인되고 GitHub로 올라가고 Repo 구조를 읽고, MCP와 Skills로 외부 문맥과 작업 레시피까지 붙이는 한 번의 전체 루프를 경험하는 데 집중합니다.

120minutes 9topics 1full loop
session-02-room.md
22:00 terminal + CLI basics
22:15 Codex surfaces: app / CLI / IDE
22:35 tiny app + local dev
23:00 GitHub + repo + first push
23:30 MCP + Notion MCP
23:45 skills + reusable workflows
23:58 Q&A + member showcase
00

오늘의 목표

Start Here

설명을 많이 듣는 것보다, 실제로 한 사이클을 끝까지 돌려보는 것이 목표입니다.

오늘은 “도구 이름을 이해했다”에서 끝내지 않고, 터미널에서 프로젝트를 열고, Codex로 손을 움직이고, 로컬에서 확인하고, GitHub에 올리고, MCP로 외부 문맥까지 붙이는 감각을 한 번에 맞춥니다.

terminal → Codex → local dev → GitHub → MCP → Notion context
거창한 앱을 완성하는 날이 아닙니다. 대신 앞으로 어떤 프로젝트든 반복할 수 있는 작업 루틴을 만드는 날입니다.
01

라이브 아젠다

Live

시간대별로 집중 포인트를 나눠서 달립니다.

시간주제목표
22:00Terminal, CLI, 왜 중요한가현재 위치, 폴더 이동, 명령 기반 작업 감각을 맞춥니다.
22:15Codex, Claude Code, App/CLI/IDE 표면어떤 인터페이스에서 어떤 작업을 맡길지 이해합니다.
22:40간이 앱 만들기 + 로컬 Dev 테스트작은 결과물을 바로 띄워봅니다.
23:05GitHub, Repo, 첫 Push작업을 저장소와 원격 히스토리로 올리는 흐름을 완성합니다.
23:30MCP 이해 + Notion MCP 연결외부 문맥과 도구를 에이전트에 붙이는 개념을 봅니다.
23:45Skills 이해 + 사용 예시반복 작업을 더 안정적으로 수행하는 방법을 이해합니다.
23:58Q&A + 짧은 공유마지막 남은 질문과 보여주고 싶은 내용을 정리합니다.
02

접속 전 체크

Preflight

미팅 중 설치 대기를 줄이기 위해 이 상태까지 맞추고 시작합니다.

  • 오늘 접속 링크는 Google Meet 바로 입장 ↗입니다.
  • Codex Mac OS App 설치 및 로그인 완료
  • Antigravity Mac OS App 설치 및 로그인 완료
  • GitHub 계정 준비 및 가능한 경우 로컬 로그인 확인
  • Notion 가입 및 macOS 앱 설치 완료
  • 오늘 열어볼 프로젝트 폴더 또는 만들고 싶은 한 줄 아이디어 준비
Setup Guide Kangaroo Setup

맥북 기본 세팅, 단축키, Day 0 앱 설치를 먼저 점검할 수 있습니다.

설치 가이드 보기 →
03

터미널, CLI, 왜 중요한가

오늘 필요한 최소 명령만 직접 써보면 충분하지만, 왜 이 인터페이스가 중요한지는 같이 이해해야 합니다.

터미널은 컴퓨터와 텍스트 명령으로 대화하는 창입니다. Finder처럼 눈으로 클릭하는 인터페이스가 아니라, 파일과 폴더와 실행 흐름을 더 직접적으로 다루는 작업 공간입니다.

CLI는 `Command Line Interface`의 줄임말입니다. 버튼 대신 명령어를 입력해 컴퓨터에게 일을 시키는 방식이라고 이해하면 됩니다. 개발 도구와 에이전트는 이 CLI 세계와 잘 맞기 때문에, Codex나 Claude Code도 기본적으로는 CLI 감각 위에서 강해집니다.

AI 코딩에서 터미널이 중요한 이유는 간단합니다. 에이전트가 지금 어떤 폴더를 보고 있는지, 어떤 명령을 실행했는지, 어떤 파일이 바뀌었는지를 가장 정확하게 드러내는 표면이기 때문입니다.

개념왜 중요한가
Terminal텍스트 명령으로 컴퓨터를 다루는 창작업 상태와 실행 결과를 가장 직접적으로 본다.
CLI명령어 기반 인터페이스복사, 실행, 자동화, 재현이 쉽다.
GUI버튼과 창을 클릭하는 일반 앱 화면입문은 쉽지만 반복 작업은 느려질 수 있다.
pwd                 # 지금 위치
ls                  # 현재 폴더 보기
cd Documents        # 폴더 이동
mkdir my-project    # 새 폴더 만들기
open .              # Finder에서 현재 폴더 열기
code .              # 에디터에서 현재 폴더 열기

핵심은 명령어를 많이 외우는 것이 아니라, “내가 어디에 있고 무엇을 열었는지”를 Codex와 같은 기준으로 볼 수 있게 되는 것입니다. 이 감각이 생기면 AI에게도 더 정확한 지시를 줄 수 있습니다.

04

Codex, Claude Code, App/CLI/IDE

Workflow

오늘은 한 도구에 모든 걸 몰기보다, 어떤 표면에서 어떤 작업을 맡길지 감각을 잡습니다.

Codex와 Claude Code 같은 코딩 에이전트는 단순히 “답변해주는 챗봇”이 아니라, 실제 프로젝트 폴더를 읽고 수정하고 실행하는 작업자에 가깝습니다. 다만 이 작업자를 어디서 부를지에는 여러 표면이 있습니다.

표면설명우리 클럽 기본값
CLI터미널에서 바로 프로젝트를 열고 작업하는 방식개발자 기본 표면, 보조 루트
IDEVS Code, Cursor, Windsurf 같은 에디터 안에서 쓰는 방식선택 표면
Desktop App로컬 프로젝트와 diff를 눈으로 보며 쓰는 앱 형태우리 클럽의 기본 입구
Web/CloudGitHub 저장소 기반으로 원격 작업이나 백그라운드 분석을 맡기는 방식확장 표면

Codex는 App, CLI, IDE, Cloud처럼 여러 표면을 가질 수 있고, Claude Code는 전통적으로 CLI 감각이 강한 편입니다. 우리 클럽이 `Codex Mac App`을 먼저 쓰는 이유는 프로젝트가 눈앞에 보이고, diff와 작업 흐름이 초보자에게 더 명확하게 보이기 때문입니다.

  • Codex는 실제 프로젝트 폴더를 읽고 수정하는 메인 작업 에이전트로 둡니다.
  • Antigravity는 아이디어 정리, 대안 비교, 프롬프트 다듬기 같은 보조 흐름으로 병행합니다.
  • Claude Code는 긴 맥락 재정리, 다른 관점의 리뷰, 비교용 보조 도구로 이해하면 좋습니다.
  • 작업 순서는 보통 “목표 한 줄 정리 → 프로젝트 폴더 열기 → Codex 지시 → 로컬 확인 → 필요시 보조 에이전트로 보완” 흐름으로 잡습니다.
정리하면, CLI는 개발자의 기본 언어이고, IDE는 작업 맥락을 붙들기 좋은 편의 표면이고, Desktop App은 초반 학습 속도를 가장 잘 올려주는 입구입니다. 그래서 우리는 Codex Mac App으로 시작합니다.
Guide CODEX Starter

Codex를 프로젝트에 붙이고 첫 세션을 시작하는 흐름을 따로 정리한 문서입니다.

CODEX Starter 보기 →
05

GitHub, Repo, 그리고 첫 Push

Ship

오늘 만든 작업 흔적을 로컬에만 남기지 않고, 저장소와 원격 히스토리로 남기는 감각을 잡습니다.

Git은 코드 변경 이력을 관리하는 버전 관리 시스템이고, GitHub는 그 Git 저장소를 인터넷 위에서 협업하고 공유하게 만든 서비스입니다. GitHub는 2008년에 공개되었고, 이후 개발자들이 코드를 저장하고 이슈를 관리하고 Pull Request로 리뷰하는 기본 협업 공간이 되었습니다.

여기서 `Repo`는 `Repository`의 줄임말입니다. 쉽게 말하면 프로젝트 파일과 변경 이력과 관련 문맥을 함께 담아두는 작업 상자입니다. 코드 몇 개만 들어있는 폴더가 아니라, “이 프로젝트가 어떻게 바뀌어왔는지”까지 포함하는 기록 공간입니다.

용어의미간단한 비유
Git변경 이력을 관리하는 엔진버전 기록 장치
GitHubGit 저장소를 올려두고 협업하는 웹 플랫폼온라인 협업 작업실
Repo프로젝트 파일 + 히스토리 + 설정이 담긴 저장소작업 상자 + 기록 보관함

Codex와 연결해서 보면, Repo는 AI가 읽을 “현장”입니다. 로컬에서 프로젝트 폴더를 열어주거나 GitHub와 연결된 표면에서 repo를 기준으로 작업하게 하면, Codex는 구조를 요약하고, 진입점을 찾고, 실행 방법을 정리하고, 필요한 수정까지 이어갈 수 있습니다.

예시 요청:
"이 repo 구조를 먼저 요약해줘."
"실행 방법과 핵심 진입 파일을 찾아줘."
"어디가 가장 위험한 부분인지 5개만 꼽아줘."
"로컬에서 dev 서버를 띄울 준비를 해줘."
git status
git add .
git commit -m "session 02 first pass"
git push -u origin main

오늘 중요한 것은 Git의 모든 개념을 완벽히 이해하는 것보다, “내 작업이 원격 저장소로 올라간다”, “이제 이 repo를 기준으로 Codex와 배포 흐름이 이어질 수 있다”는 감각을 눈으로 확인하는 것입니다.

06

MCP란 무엇인가

Context

에이전트가 프로젝트 밖의 문맥과 도구도 읽고 쓸 수 있게 연결하는 개념을 봅니다.

MCP는 `Model Context Protocol`의 줄임말입니다. 어렵게 생각하지 말고, 에이전트에게 프로젝트 밖의 손과 눈을 더 붙여주는 표준 연결 규칙이라고 이해하면 됩니다.

MCP가 없으면 Codex는 주로 지금 열어둔 프로젝트와 로컬 도구를 중심으로 일합니다. MCP가 붙으면 Notion, GitHub, 문서 서버, 관측 도구 같은 외부 시스템의 문맥과 도구를 읽을 수 있게 됩니다.

구분MCP 없이MCP와 함께
문맥현재 폴더와 대화 중심외부 문서, 저장소, 서비스 문맥까지 확장
행동 범위로컬 편집과 실행 중심연결된 시스템의 조회/업데이트까지 가능
예시로컬 코드 수정Notion 문서 읽기, GitHub 정보 조회, Docs 검색

오늘은 개념을 잡고, 가능하면 Notion MCP까지 붙여보는 흐름을 확인합니다. 이렇게 되면 “이 Notion 페이지 읽고 요약해줘”, “회의 메모를 문서 초안으로 정리해줘” 같은 요청이 훨씬 자연스러워집니다.

codex mcp add notion --url https://mcp.notion.com/mcp
codex mcp login notion
codex mcp list

위 명령은 현재 로컬 Codex CLI 도움말 기준으로 확인한 형태입니다. 환경에 따라 추가 설정이 필요할 수 있으므로, 미팅 중 현재 설치 상태를 먼저 확인하고 진행합니다.

07

Skill이 무엇인가

Reusable Workflow

Skill은 반복 작업을 더 안정적으로 수행하게 만드는 작업 레시피입니다.

Skill은 “이런 일을 할 때는 이런 순서와 기준으로 진행하라”는 재사용 가능한 작업 레시피입니다. 단순 프롬프트 한 줄보다 더 구조적이고, 반복 작업에서 결과 품질을 일정하게 맞추는 데 유리합니다.

개념무엇을 추가하는가한 줄 설명
MCP외부 도구와 데이터 접근에이전트의 손과 눈을 늘린다
Skill작업 방식과 절차에이전트의 일하는 법을 고정한다
Repo실제 프로젝트 현장에이전트가 일할 대상 그 자체다

즉, Repo는 작업 현장이고, MCP는 외부 연결이고, Skill은 그 작업을 어떻게 잘 수행할지에 대한 레시피입니다. 셋이 붙으면 Codex는 단순 답변기가 아니라 꽤 안정적인 작업자로 바뀝니다.

Codex에서는 요청 내용이 Skill 설명과 잘 맞으면 자동으로 적절한 Skill을 불러올 수 있고, 필요하면 Skill 이름을 직접 써서 명시적으로 사용할 수도 있습니다.

예시:
"이 회의 내용을 Notion용 회의록 초안으로 정리해줘."
"이 repo를 읽고 배포 위험 요소만 정리해줘."
"$openai-docs Codex Mac app과 CLI 차이를 공식 문서 기준으로 요약해줘."
"$skill-creator 우리 팀용 회의록 정리 스킬 하나 설계해줘."
좋은 Skill은 프롬프트를 길게 쓰지 않아도, 늘 비슷한 품질의 결과를 내게 해줍니다. K-garoo에서는 자주 반복되는 좋은 작업 흐름은 Skill 후보로 본다고 이해하면 됩니다.
08

운영 & 후속

Follow-up

오늘의 기록이 다음 회차 자산으로 이어지도록 정리합니다.

  • 실버벨님은 가능하면 녹음을 깔끔하게 부탁드립니다. macOS 기본 녹음도 괜찮습니다.
  • 미팅 후 정리된 요약은 Session 02 회의록 페이지로 아카이브합니다.
  • 홈 루트 팝업은 가장 최근 회의록 링크로 계속 갱신합니다.
  • 회의 중 표시 이름은 닉네임 기준으로 맞추고, 얼굴은 가리거나 필터를 사용합니다.
  • @춘식이 / 냉정과열정사이 님은 마지막 시간에 보여주고 싶은 것을 짧게 공유해도 좋습니다.
이번 Session 02부터는 공지 페이지, Room 페이지, 회의록 페이지를 한 세트로 계속 쌓아갈 예정입니다.