00전체 구축 순서 | SYSTEM BUILD ORDER
어떤 AI를 쓰더라도 공통 순서는 같습니다. 먼저 계정과 PC를 준비하고, GitHub로 변경이력을 만들고, AI 에이전트를 연결한 뒤 업무앱과 배포를 붙입니다. AI 제품부터 설치하면 계정·권한·저장소가 뒤섞이기 쉽습니다.
AI 업무 인프라는 어떻게 작동하는가 | HOW AI WORK INFRASTRUCTURE WORKS
AI 업무 인프라는 ChatGPT에 질문하고 답을 받는 구조를 넘어, 사람의 업무지시를 AI가 이해하고 필요한 자료와 업무도구에 접근한 뒤 파일·프로그램을 실행하고 변경이력을 남기며 실제 서비스까지 배포하는 연결구조입니다. 모든 업무가 같은 경로를 쓰는 것은 아니며, 이메일 요약처럼 코딩이 필요 없는 업무는 App과 Skill 중심으로, 웹사이트·프로그램 구축은 Codex 같은 실행 에이전트와 Git·GitHub·배포 계층까지 사용합니다.
업무의 목적·조건·우선순위·승인 기준을 정합니다. AI가 무엇을 해야 하는지 결정하는 최종 통제자입니다.
ChatGPT·Claude·Gemini 등이 요청을 이해하고 조사·분석·문서작성·계획수립 등 여러 단계의 업무를 수행합니다.
매번 같은 업무방식을 다시 설명하지 않도록 절차·금지사항·품질기준·예시를 재사용 가능한 업무규칙으로 표준화합니다.
Gmail·Drive·Calendar·Notion·GitHub 등 실제 업무서비스를 AI와 연결하고 허용된 권한 범위에서 데이터를 읽고 처리합니다.
Codex·Claude Code·Gemini CLI 등이 PC 폴더·코드·파일·터미널·Git 저장소를 읽고 실제 수정·실행·테스트를 수행합니다.
AI가 무엇을 변경했는지 기록합니다. 변경 전후를 비교하고 문제가 생기면 이전 상태로 되돌릴 수 있게 합니다.
PC의 변경이력과 프로젝트 파일을 원격 저장소에 보관하고 사람·AI·배포서비스가 함께 사용하는 기준 원본 역할을 합니다.
Cloudflare Pages·Vercel·GitHub Pages 등이 GitHub의 확정된 파일을 가져와 실제 웹사이트·서비스로 배포합니다.
전체 흐름은 사람의 지시 → AI의 판단·Work → Skill의 업무규칙 → App의 외부자료 연결 → Codex 등 실행 에이전트의 파일·코드 작업 → Git의 변경기록 → GitHub의 기준원본 저장 → Cloud 배포 → 실제 업무결과로 이해하면 됩니다. AX는 단순히 AI를 사용하는 것이 아니라 사람이 하던 업무절차를 AI·데이터·도구·자동화와 연결해 하나의 수행체계로 전환하는 것입니다. 사람이 목적과 기준을 통제하고 AI가 조사·작성·실행·반복업무를 담당하는 협업구조가 핵심입니다.
01계정·신원 준비 | ACCOUNT & IDENTITY
Google 계정은 필수 선행조건이 아닙니다. 다만 Gmail·Drive·Calendar를 사용할 경우 Google 계정이 필요합니다. AI 계정, GitHub 계정, Google 계정, 배포 계정을 어떤 이메일로 만들었는지 먼저 표로 기록합니다.
복구 가능한 이메일 1개를 기준으로 정합니다. 개인형과 조직형은 가능하면 별도 계정으로 분리합니다.
Gmail·Drive·Docs·Sheets·Slides·Calendar를 연결할 때 사용합니다. 조직 계정은 관리자 OAuth 정책을 확인합니다.
원격 저장소, 커밋, 브랜치, 배포 연결의 기준 계정입니다. 2단계 인증을 설정합니다.
ChatGPT·Claude·Gemini·Grok·Manus·Genspark를 사용할 계정을 각각 기록합니다. 같은 이메일을 강제할 필요는 없습니다.
서비스명 · 로그인 이메일 · 복구수단 · 2FA · 결제주체 · 개인/조직 구분을 기록합니다.
완료: 어떤 계정으로 로그인해야 하는지 즉시 확인 가능GitHub와 주요 AI·클라우드 계정에 2FA를 설정하고 복구코드는 별도 보관합니다.
완료: 새 기기 로그인 시 2차 인증 작동조직 자료를 개인 저장소·개인 Drive와 섞지 않습니다. 관리형 계정은 관리자 정책을 우선합니다.
완료: 자료와 권한의 소유주가 명확02PC·터미널 기본환경 | LOCAL ENVIRONMENT
초보자는 GUI와 터미널을 동시에 준비합니다. Windows는 PowerShell을 기본 셸로 두고 GitHub Desktop으로 변경을 눈으로 확인합니다. CLI는 필요할 때 단계적으로 추가합니다.
명령을 실행하는 창입니다. Windows에서는 PowerShell, macOS/Linux에서는 Terminal을 사용합니다.
파일 변경 이력을 저장합니다. git --version으로 설치 여부를 확인합니다.
Clone·Commit·Pull·Push를 화면으로 확인하는 초보자용 기본 도구입니다.
터미널에서 GitHub를 제어합니다. 설치 후 gh auth login으로 인증합니다.
Codex·Claude Code·Gemini CLI 등 npm 기반 도구 설치에 필요할 수 있습니다. 버전 요구사항은 각 제품 기준을 따릅니다.
코드를 직접 볼 때 유용합니다. 코딩을 몰라도 파일·폴더·diff 확인용으로 사용할 수 있습니다.
예: C:\AI-Work\ 아래에 프로젝트별 폴더를 둡니다. 바탕화면·다운로드 폴더를 원본 저장소로 쓰지 않습니다.
PowerShell에서 git --version을 실행합니다. 명령을 찾지 못하면 Git을 설치합니다.
GitHub Desktop 설치 → GitHub.com 계정 인증 → 기본 Git 이름·이메일 확인.
완료: 내 저장소 목록 표시자동화·터미널 작업이 필요하면 GitHub CLI를 설치하고 gh auth login을 실행합니다.
gh auth status 정상03GitHub 저장소 구축 | GITHUB FOUNDATION
GitHub는 AI가 만든 결과물을 보관하는 단순 웹하드가 아니라 변경이력과 배포의 기준 원본입니다. 원격 저장소와 PC의 로컬 저장소를 구분해야 합니다.
GitHub → New repository → 이름 입력 → Public/Private 결정 → README 초기화를 선택합니다.
완료: 저장소 주소 생성GitHub Desktop → File → Clone Repository → 저장소 선택 → Local Path를 C:\AI-Work\... 아래로 지정 → Clone.
README에 한 줄 추가 → GitHub Desktop의 Changes 확인 → Summary 입력 → Commit to main.
완료: History에 첫 변경 기록Push origin을 실행하고 GitHub 웹에서 변경된 README를 확인합니다.
완료: PC와 GitHub 내용 일치04OpenAI 구축 | CHATGPT · WORK · CODEX
2026년 기준 ChatGPT는 Chat·Work·Codex의 역할이 다릅니다. Chat은 대화, Work는 장시간 다단계 업무와 결과물 제작, Codex는 로컬 파일·저장소·터미널·개발도구를 사용하는 소프트웨어 작업에 적합합니다.
질문·분석·초안·일반 작업. 파일을 직접 운영체계로 관리하는 주체로 보지 않습니다.
조사·분석·문서·스프레드시트·프레젠테이션·Sites 등 긴 작업을 하나의 업무 흐름으로 수행합니다.
코드 작성·검토·테스트·배포와 로컬 파일·Repository 작업을 담당합니다. Desktop·CLI·IDE·Web 클라이언트가 있습니다.
사용할 OpenAI 계정으로 로그인합니다. Codex는 현재 여러 ChatGPT 플랜에 포함되지만 사용량 한도는 플랜별로 다릅니다.
완료: ChatGPT 계정 정상 사용Windows/macOS용 최신 ChatGPT Desktop을 설치하고 같은 계정으로 로그인합니다. 상단 전환에서 Chat/Work/Codex 제공 여부를 확인합니다.
완료: Desktop에서 Codex 진입 가능GitHub Desktop으로 Clone한 로컬 프로젝트 폴더를 Codex에서 엽니다. 처음에는 읽기·수정 범위를 해당 저장소 폴더로 제한합니다.
완료: Codex가 파일 목록 설명 가능“README 한 줄만 수정하고 다른 파일은 건드리지 마”처럼 범위를 제한한 작업을 시킵니다. diff를 확인한 뒤 Commit합니다.
완료: 변경 파일이 지시 범위와 일치터미널 방식이 필요하면 npm install -g @openai/codex 후 로그인 흐름을 사용합니다. Windows에서는 최신 공식 안내의 Codex Doctor/WSL 지원 여부를 확인합니다.
codex 실행Codex에서 /init으로 AGENTS.md 초안을 만들고 “기존 파일 우선·새 파일 최소·수정 전 확인·수정 후 테스트” 같은 프로젝트 규칙을 적습니다.
05Plugins · Apps · Skills 연결 | WORKFLOW CAPABILITIES
현재 OpenAI 구조에서 Plugin은 워크플로 묶음이고, 그 안에 Skill·App·App Template이 들어갈 수 있습니다. App은 외부 서비스와 데이터·작업을 연결하고, Skill은 반복 가능한 지침·예제·코드·절차를 제공합니다.
특정 업무를 위한 설치형 묶음. 필요한 Skills와 Apps를 함께 제공할 수 있습니다.
Google Drive·Gmail·GitHub·Notion 같은 외부 서비스와 연결합니다. OAuth와 원 서비스의 권한을 그대로 따릅니다.
반복 업무 지침·예시·스크립트를 재사용합니다. 계정/워크스페이스에 따라 생성·설치 가능 여부가 다릅니다.
ChatGPT 또는 Codex의 Plugins 영역에서 필요한 워크플로를 찾습니다. 상세 페이지에서 포함된 App·Skill·설정요건을 먼저 읽습니다.
완료: 필요한 권한을 설치 전에 파악Connect가 필요한 App은 OAuth를 진행하고 반드시 의도한 계정인지 확인합니다. 설치만으로 외부 데이터 권한이 자동 부여되지는 않습니다.
완료: 연결 계정이 정확계정에 Personal Skills 기능이 없으면 프로젝트 지침·AGENTS.md·반복 프롬프트 템플릿으로 같은 운영규칙을 관리합니다.
완료: 제품 기능 유무와 무관하게 규칙 재사용06Google 업무앱 연결 | GMAIL · DRIVE · CALENDAR
Google Drive는 현재 ChatGPT에서 Docs·Sheets·Slides 작업까지 통합하는 중심 앱입니다. Gmail과 Calendar는 별도 앱·권한 범위를 가질 수 있습니다. 개인 계정은 OAuth로 연결하고, 조직형 Google Workspace는 관리자 승인 범위를 확인합니다.
Drive 파일 검색·참조와 지원되는 생성·수정·공유 작업. Docs·Sheets·Slides가 Drive 경로로 통합됩니다.
메일 검색·요약·초안·지원되는 작업. 쓰기 작업은 읽기보다 넓은 OAuth 권한이 필요할 수 있습니다.
일정 검색·이벤트 작업과 지원되는 Meet 정보. 개인 캘린더와 공유 캘린더 권한을 구분합니다.
조직형 계정은 Google Admin Console의 API Controls에서 ChatGPT/OpenAI OAuth 앱과 요청 범위를 승인해야 할 수 있습니다.
브라우저에서 Gmail·Drive·Calendar를 각각 열어 올바른 Google 계정인지 확인합니다.
완료: 대상 데이터가 보임Plugins/Apps에서 Google 관련 연결을 선택 → Connect → Google OAuth → 권한 검토 → 허용.
완료: 연결 상태 표시특정 파일명을 검색하거나 테스트 문서를 참조합니다. 쓰기 기능을 사용할 경우 작은 테스트 파일로 먼저 생성·수정합니다.
완료: 대상 Drive 범위에서만 작동자기 자신에게 테스트 메일을 보내고 검색·요약부터 확인합니다. 실제 발송·이동·라벨 변경은 별도 승인 흐름을 확인합니다.
완료: 읽기/쓰기 가능 범위 파악테스트 일정 1개를 조회하고, 생성 권한이 있다면 임시 일정을 만든 뒤 삭제까지 확인합니다.
완료: 생성·수정·삭제 범위 확인07Notion 연결 | NOTION MCP · AI CONNECTORS
Notion은 방향이 두 가지입니다. AI 도구가 Notion을 읽고 쓰는 경로는 Notion MCP, Notion AI가 외부 Gmail·Drive·Calendar·GitHub 등을 검색하는 경로는 Notion AI Connectors입니다. 둘을 같은 기능으로 보지 않습니다.
Claude·ChatGPT·Cursor 등 MCP를 지원하는 AI 클라이언트에서 Notion 페이지를 읽고 쓰는 연결. 연결한 사용자의 Notion 권한을 따릅니다.
Notion AI Connectors에서 Google Drive·Gmail·Google Calendar·GitHub·Slack 등을 연결. 일부는 Business/Enterprise 요건과 관리자 권한이 필요합니다.
업무 DB·문서·프로젝트 페이지의 이름과 권한을 먼저 정리합니다. AI 연결 전에 사람이 볼 수 있는 구조를 만듭니다.
완료: 접근 대상이 명확Notion MCP Gallery 또는 AI 도구의 Integrations/MCP 메뉴에서 Notion을 연결 → OAuth → 접근 권한 확인.
완료: 테스트 페이지 읽기 가능Notion의 Settings → Notion AI에서 필요한 외부 Connector를 연결합니다. Workspace owner 및 외부 서비스 admin 권한 요건을 확인합니다.
완료: 외부 자료 검색 가능08Claude Code 구축 | CLAUDE WORKFLOW
Claude 일반 채팅과 Claude Code를 분리해서 봅니다. Claude Code는 로컬 프로젝트와 터미널에서 파일을 읽고 수정하는 코딩 에이전트입니다.
지원 OS·셸·런타임을 현재 Anthropic 문서에서 확인합니다. Windows는 공식 지원방식이 바뀔 수 있으므로 설치 전 최신 안내를 우선합니다.
완료: 로컬 셸에서 설치 준비공식 설치 방법을 사용합니다. 기존 npm 설치를 쓰는 경우 npm install -g @anthropic-ai/claude-code 방식이 안내되어 왔으며 최신 문서를 우선합니다.
claude 실행GitHub에서 Clone한 프로젝트 루트로 이동해 Claude Code를 실행하고 “파일 구조만 설명” 같은 읽기 작업부터 시작합니다.
완료: 파일을 수정하지 않고 구조 설명작은 수정 1개 → git diff 또는 GitHub Desktop Changes 확인 → 테스트 → Commit → Push.
09Gemini CLI 구축 | GEMINI WORKFLOW
Gemini CLI는 터미널에서 로컬 프로젝트 문맥을 사용합니다. 2026년 공식 문서는 Node.js 20+와 PowerShell/Bash/Zsh 환경을 권장하며, Google 계정 로그인 또는 조직형 인증을 제공합니다.
node --version을 실행하고 현재 Gemini CLI 요구 버전 이상인지 확인합니다.
일반 설치: npm install -g @google/gemini-cli. 영구 설치가 싫으면 공식 문서의 npx 방식도 선택할 수 있습니다.
gemini 실행gemini 실행 → Sign in with Google 선택 → 브라우저 인증. 조직형 Google Workspace 계정은 Google Cloud project가 필요할 수 있습니다.
Clone한 저장소에서 구조 설명 → 한 파일 수정 → diff 확인 → Commit → Push 순서로 검증합니다.
완료: GitHub 변경이력과 연결10Grok · Manus · Genspark 구축 | WEB & AGENT PLATFORMS
세 서비스는 같은 방식으로 설치하지 않습니다. Grok은 일반 대화와 API 개발 경로를 구분하고, Manus와 Genspark는 웹·클라우드 에이전트에서 Connector·Skill·Code 기능을 연결하는 경로가 중심입니다.
일반 Grok 사용과 개발 자동화를 분리합니다. API 자동화는 xAI Console 계정 → 크레딧 → API Key → 환경변수 → SDK/HTTP 호출 순서로 구축합니다.
Integrations에서 Gmail·Google Calendar·GitHub·DB 등을 + Connect → OAuth로 연결합니다. Skills는 파일 업로드 또는 공개 GitHub 저장소의 SKILL.md로 가져올 수 있습니다.
Super Agent·Genspark Code·Skills·Connectors·SecondBrain을 구분합니다. Gmail·Calendar·Drive·Notion·GitHub 등은 Connector에서 OAuth 연결 후 재사용합니다.
로컬 코드 수정이 필요한지, 클라우드에서 결과물만 만들지, 외부 Gmail/GitHub를 연결할지 먼저 결정합니다.
완료: 플랫폼 선택 이유가 명확Manus/Genspark에서 필요한 서비스만 연결하고 OAuth 권한을 확인합니다. 여러 계정이 있을 경우 대상 계정을 반드시 확인합니다.
완료: 테스트 데이터 1건 접근반복 업무를 Skill로 저장하되, 실행 코드·외부 Skill은 설치 전 내용을 검토합니다. GitHub 기반 Skill은 버전 관리가 가능하도록 원본 저장소를 명확히 합니다.
완료: 같은 업무를 새 프롬프트 없이 재실행11배포 구축 | GITHUB → CLOUDFLARE PAGES
가장 단순한 웹 배포 기준은 “로컬 파일 → Git Commit → GitHub Push → Cloudflare Pages 자동 배포”입니다. 배포 플랫폼은 바뀔 수 있지만 Git 저장소를 기준 원본으로 두는 구조는 유지합니다.
Cloudflare에 로그인하고 Pages에서 Git 연동 프로젝트 생성을 시작합니다.
완료: Git provider 연결 화면Cloudflare GitHub App이 접근할 Repository 범위를 선택합니다. 가능하면 필요한 저장소만 허용합니다.
완료: 대상 repo 선택 가능Production branch를 확인하고 정적 HTML이면 불필요한 build command를 넣지 않습니다. 프레임워크는 공식 preset을 따릅니다.
완료: 첫 배포 성공README가 아닌 실제 표시 텍스트 1개를 수정 → Commit → Push → Pages 배포 상태 확인 → 사이트 새로고침.
완료: Push가 실제 화면으로 연결12Skills · 규칙 · 자동화 | REUSABLE WORKFLOW
AI가 매번 같은 실수를 하지 않게 하려면 “무엇을 하라”보다 “어떻게 작업하고 무엇을 건드리지 말아야 하는가”를 규칙으로 고정합니다. 규칙의 원본은 하나만 두고 플랫폼별 Skill·AGENTS.md·Project Instruction으로 변환합니다.
기존 파일 우선 · 새 파일 최소 · 수정 전 원본 확인 · 동일 권한 중복 금지 · 변경 범위 제한 · 수정 후 diff/test · 비밀정보 커밋 금지.
OpenAI Skill 또는 AGENTS.md, Manus Skill, Genspark Skill, Claude 프로젝트 규칙, Gemini 프로젝트 문맥 등으로 옮기되 원칙 자체는 중복 소유하지 않습니다.
13실전 구축 코스 | PRACTICAL BUILD TRACKS
처음부터 모든 플랫폼을 한꺼번에 연결하지 않습니다. 아래 순서로 하나씩 완성하고 다음 단계로 넘어갑니다.
GitHub 계정 → GitHub Desktop → Repository → Clone → Commit → Push.
ChatGPT Desktop → Codex → 로컬 Repository → 파일 수정 → diff → Commit → Push.
Google 계정 → Drive/Gmail/Calendar → ChatGPT App 연결 → 읽기 테스트 → 쓰기 테스트.
GitHub → Cloudflare Pages → Production branch → Push → 자동 배포.
Notion 구조 → MCP → AI 읽기·쓰기 → 필요 시 AI Connector로 외부 지식 연결.
Claude Code → Gemini CLI → Manus/Genspark Connector·Skill → 필요 시 Grok API.
14최종 점검·복구 | AUDIT & RECOVERY
REF공식 확인 자료 | OFFICIAL REFERENCES
제품 UI와 권한정책은 자주 바뀌므로 설치 직전 아래 공식 문서의 최신 상태를 확인합니다. 이 매뉴얼은 2026년 9월 1일 기준으로 정리했습니다.