오늘의 목표
Start Here설명을 많이 듣는 것보다, 실제로 한 사이클을 끝까지 돌려보는 것이 목표입니다.
오늘은 “도구 이름을 이해했다”에서 끝내지 않고, 터미널에서 프로젝트를 열고, Codex로 손을 움직이고, 로컬에서 확인하고, GitHub에 올리고, MCP로 외부 문맥까지 붙이는 감각을 한 번에 맞춥니다.
terminal → Codex → local dev → GitHub → MCP → Notion context
라이브 아젠다
Live시간대별로 집중 포인트를 나눠서 달립니다.
| 시간 | 주제 | 목표 |
|---|---|---|
| 22:00 | Terminal, CLI, 왜 중요한가 | 현재 위치, 폴더 이동, 명령 기반 작업 감각을 맞춥니다. |
| 22:15 | Codex, Claude Code, App/CLI/IDE 표면 | 어떤 인터페이스에서 어떤 작업을 맡길지 이해합니다. |
| 22:40 | 간이 앱 만들기 + 로컬 Dev 테스트 | 작은 결과물을 바로 띄워봅니다. |
| 23:05 | GitHub, Repo, 첫 Push | 작업을 저장소와 원격 히스토리로 올리는 흐름을 완성합니다. |
| 23:30 | MCP 이해 + Notion MCP 연결 | 외부 문맥과 도구를 에이전트에 붙이는 개념을 봅니다. |
| 23:45 | Skills 이해 + 사용 예시 | 반복 작업을 더 안정적으로 수행하는 방법을 이해합니다. |
| 23:58 | Q&A + 짧은 공유 | 마지막 남은 질문과 보여주고 싶은 내용을 정리합니다. |
접속 전 체크
Preflight미팅 중 설치 대기를 줄이기 위해 이 상태까지 맞추고 시작합니다.
- 오늘 접속 링크는 Google Meet 바로 입장 ↗입니다.
- Codex Mac OS App 설치 및 로그인 완료
- Antigravity Mac OS App 설치 및 로그인 완료
- GitHub 계정 준비 및 가능한 경우 로컬 로그인 확인
- Notion 가입 및 macOS 앱 설치 완료
- 오늘 열어볼 프로젝트 폴더 또는 만들고 싶은 한 줄 아이디어 준비
터미널, 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에게도 더 정확한 지시를 줄 수 있습니다.
Codex, Claude Code, App/CLI/IDE
Workflow오늘은 한 도구에 모든 걸 몰기보다, 어떤 표면에서 어떤 작업을 맡길지 감각을 잡습니다.
Codex와 Claude Code 같은 코딩 에이전트는 단순히 “답변해주는 챗봇”이 아니라, 실제 프로젝트 폴더를 읽고 수정하고 실행하는 작업자에 가깝습니다. 다만 이 작업자를 어디서 부를지에는 여러 표면이 있습니다.
| 표면 | 설명 | 우리 클럽 기본값 |
|---|---|---|
| CLI | 터미널에서 바로 프로젝트를 열고 작업하는 방식 | 개발자 기본 표면, 보조 루트 |
| IDE | VS Code, Cursor, Windsurf 같은 에디터 안에서 쓰는 방식 | 선택 표면 |
| Desktop App | 로컬 프로젝트와 diff를 눈으로 보며 쓰는 앱 형태 | 우리 클럽의 기본 입구 |
| Web/Cloud | GitHub 저장소 기반으로 원격 작업이나 백그라운드 분석을 맡기는 방식 | 확장 표면 |
Codex는 App, CLI, IDE, Cloud처럼 여러 표면을 가질 수 있고, Claude Code는 전통적으로 CLI 감각이 강한 편입니다. 우리 클럽이 `Codex Mac App`을 먼저 쓰는 이유는 프로젝트가 눈앞에 보이고, diff와 작업 흐름이 초보자에게 더 명확하게 보이기 때문입니다.
- Codex는 실제 프로젝트 폴더를 읽고 수정하는 메인 작업 에이전트로 둡니다.
- Antigravity는 아이디어 정리, 대안 비교, 프롬프트 다듬기 같은 보조 흐름으로 병행합니다.
- Claude Code는 긴 맥락 재정리, 다른 관점의 리뷰, 비교용 보조 도구로 이해하면 좋습니다.
- 작업 순서는 보통 “목표 한 줄 정리 → 프로젝트 폴더 열기 → Codex 지시 → 로컬 확인 → 필요시 보조 에이전트로 보완” 흐름으로 잡습니다.
GitHub, Repo, 그리고 첫 Push
Ship오늘 만든 작업 흔적을 로컬에만 남기지 않고, 저장소와 원격 히스토리로 남기는 감각을 잡습니다.
Git은 코드 변경 이력을 관리하는 버전 관리 시스템이고, GitHub는 그 Git 저장소를 인터넷 위에서 협업하고 공유하게 만든 서비스입니다. GitHub는 2008년에 공개되었고, 이후 개발자들이 코드를 저장하고 이슈를 관리하고 Pull Request로 리뷰하는 기본 협업 공간이 되었습니다.
여기서 `Repo`는 `Repository`의 줄임말입니다. 쉽게 말하면 프로젝트 파일과 변경 이력과 관련 문맥을 함께 담아두는 작업 상자입니다. 코드 몇 개만 들어있는 폴더가 아니라, “이 프로젝트가 어떻게 바뀌어왔는지”까지 포함하는 기록 공간입니다.
| 용어 | 의미 | 간단한 비유 |
|---|---|---|
| Git | 변경 이력을 관리하는 엔진 | 버전 기록 장치 |
| GitHub | Git 저장소를 올려두고 협업하는 웹 플랫폼 | 온라인 협업 작업실 |
| 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와 배포 흐름이 이어질 수 있다”는 감각을 눈으로 확인하는 것입니다.
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 도움말 기준으로 확인한 형태입니다. 환경에 따라 추가 설정이 필요할 수 있으므로, 미팅 중 현재 설치 상태를 먼저 확인하고 진행합니다.
Skill이 무엇인가
Reusable WorkflowSkill은 반복 작업을 더 안정적으로 수행하게 만드는 작업 레시피입니다.
Skill은 “이런 일을 할 때는 이런 순서와 기준으로 진행하라”는 재사용 가능한 작업 레시피입니다. 단순 프롬프트 한 줄보다 더 구조적이고, 반복 작업에서 결과 품질을 일정하게 맞추는 데 유리합니다.
| 개념 | 무엇을 추가하는가 | 한 줄 설명 |
|---|---|---|
| MCP | 외부 도구와 데이터 접근 | 에이전트의 손과 눈을 늘린다 |
| Skill | 작업 방식과 절차 | 에이전트의 일하는 법을 고정한다 |
| Repo | 실제 프로젝트 현장 | 에이전트가 일할 대상 그 자체다 |
즉, Repo는 작업 현장이고, MCP는 외부 연결이고, Skill은 그 작업을 어떻게 잘 수행할지에 대한 레시피입니다. 셋이 붙으면 Codex는 단순 답변기가 아니라 꽤 안정적인 작업자로 바뀝니다.
Codex에서는 요청 내용이 Skill 설명과 잘 맞으면 자동으로 적절한 Skill을 불러올 수 있고, 필요하면 Skill 이름을 직접 써서 명시적으로 사용할 수도 있습니다.
예시:
"이 회의 내용을 Notion용 회의록 초안으로 정리해줘."
"이 repo를 읽고 배포 위험 요소만 정리해줘."
"$openai-docs Codex Mac app과 CLI 차이를 공식 문서 기준으로 요약해줘."
"$skill-creator 우리 팀용 회의록 정리 스킬 하나 설계해줘."
운영 & 후속
Follow-up오늘의 기록이 다음 회차 자산으로 이어지도록 정리합니다.
- 실버벨님은 가능하면 녹음을 깔끔하게 부탁드립니다. macOS 기본 녹음도 괜찮습니다.
- 미팅 후 정리된 요약은 Session 02 회의록 페이지로 아카이브합니다.
- 홈 루트 팝업은 가장 최근 회의록 링크로 계속 갱신합니다.
- 회의 중 표시 이름은 닉네임 기준으로 맞추고, 얼굴은 가리거나 필터를 사용합니다.
- @춘식이 / 냉정과열정사이 님은 마지막 시간에 보여주고 싶은 것을 짧게 공유해도 좋습니다.