업무 자동화를 위한
Claude Code·Codex 환경 설정

전체 순서 — 왜 이 순서인가

PC 점검

계정과 요금 — 무엇을 결제해야 «폴더 작업»이 열리나

두 회사 모두 채팅은 무료지만, 내 PC 폴더를 직접 다루는 기능은 요금제에 따라 다릅니다. 2026년 9월 11일 공식 요금 페이지 기준이며 달러 표시 금액입니다. 국내 결제 시 부가세가 붙고 카드사 환율이 적용되니 최종 금액은 결제 화면에서 확인하십시오.

1. 🔗 링크 Claude 계정: claude.ai에서 Google 계정 또는 이메일로 가입 → 설정(Settings) → Billing → Pro 결제.
2. 🔗 링크 ChatGPT 계정: chatgpt.com에서 가입 → 왼쪽 아래 «업그레이드» → Plus 결제.
3. 두 사이트 모두 브라우저에 로그인된 상태로 두십시오. 3·4·5·6단계에서 앱과 CLI가 «브라우저로 로그인»을 띄우는데, 이미 로그인돼 있으면 클릭 한 번으로 끝납니다.

여는 법 — 두 가지 중 편한 것

1. 방법 1 · 시작 메뉴 검색. 화면 왼쪽 아래 시작 버튼(Windows 로고)을 누르고, 그대로 키보드로 powershell이라고 칩니다. 검색 결과에 Windows PowerShell이 나오면 클릭합니다. («Windows PowerShell ISE»나 «(x86)»이 붙은 것은 고르지 마십시오. 이름에 아무것도 안 붙은 것이 맞습니다)
2. 방법 2 · 단축키. 키보드에서 Win+X를 누르면 메뉴가 뜹니다. 거기서 Windows PowerShell 또는 터미널을 클릭합니다. 터미널이 다른 셸로 열리면 탭 옆 아래쪽 화살표에서 Windows PowerShell을 선택합니다.
3. 맞게 열렸는지 확인. 창 안 글자가 PS C:\Users\이름>로 시작하면 맞습니다. 맨 앞에 PS가 있으면 PowerShell, 없이 C:\Users\이름>만 있으면 CMD입니다. CMD면 창을 닫고 방법 1로 다시 여십시오.
4. «관리자 권한으로 실행»은 필요 없습니다. 이 자료의 모든 명령은 일반 창에서 됩니다. 설치 중에 «이 앱이 디바이스를 변경하도록 허용하시겠습니까?»(사용자 계정 컨트롤) 창이 뜨면 예를 누르면 됩니다.
5. 앞으로 자주 쓰니 작업 표시줄의 PowerShell 아이콘을 오른쪽 클릭 → 작업 표시줄에 고정해 두십시오.

붙여넣고 실행하는 법

1. 이 자료의 파란 상자 오른쪽 위 복사 버튼을 누릅니다. («복사됨»으로 바뀌면 성공)
2. PowerShell 창을 한 번 클릭한 뒤 Ctrl+V로 붙여 넣습니다. (안 되면 창 안에서 마우스 오른쪽 클릭만 해도 붙여 넣어집니다)
3. Enter를 누릅니다. 상자에 줄이 여러 개면 줄마다 차례로 실행되는데, 마지막 줄은 Enter를 한 번 더 눌러야 실행될 때가 있습니다.
4. 글자가 흘러가는 동안은 실행 중입니다. 다시 PS C:\...>가 나오고 커서가 깜빡이면 끝난 것입니다. 1분 넘게 아무 변화가 없으면 «(Y/N)» 같은 질문이 떠 있는지 위로 올려 보십시오.
5. 빨간 글씨가 나오면 오류입니다. 첫 줄의 영어 문장을 13단계 표에서 찾으십시오. 대부분 «창을 새로 열지 않음» 아니면 «CMD에 넣음»입니다.

Get-Date

"Windows: " + [System.Environment]::OSVersion.Version.ToString(); "64비트: " + [System.Environment]::Is64BitOperatingSystem; "RAM(GB): " + [math]::Round((Get-CimInstance Win32_ComputerSystem).TotalPhysicalMemory/1GB,1); "winget: " + (winget --version)

앞으로 계속 쓰는 규칙 세 가지

• 무언가를 설치한 뒤에는 PowerShell 창을 닫고 새로 엽니다. 새 프로그램의 위치는 «새 창»에서만 인식됩니다. 새 창에서도 실패하면 13단계에서 PATH와 설치 위치를 확인하십시오.
• 특정 폴더에서 열기. 파일 탐색기에서 그 폴더를 연 다음, 위쪽 주소 표시줄을 클릭하고 powershell이라고 친 뒤 Enter. 그 폴더 위치에서 PowerShell이 열립니다. 7-B단계부터 이 방법을 씁니다.
• 끝내기. 창을 그냥 닫으면 됩니다. AI 대화 화면(5·6단계) 안에 있을 때는 /exit를 치고 Enter.

방법 A · 링크로 내려받아 설치 (권장)

1. 🔗 링크 git-scm.com/downloads/win을 열고 Click here to download(64-bit Git for Windows Setup)를 누릅니다.
2. 내려받은 파일(Git-2.xx-64-bit.exe)을 실행합니다. 설치 화면이 열 장 넘게 나오는데 전부 Next만 누르십시오. 기본값이 두 앱과 맞습니다. (에디터 선택 화면에서 «Vim»이 기본인데 그냥 두어도 되고, «Notepad»로 바꿔도 됩니다. «Adjusting your PATH environment» 화면은 가운데 «Git from the command line and also from 3rd-party software»가 이미 선택돼 있으니 그대로 Next)
3. «Finish»를 누른 뒤 열려 있던 PowerShell 창을 닫고 새로 엽니다.

winget install --id Git.Git -e --source winget

git --version

git config --global user.name "홍길동"
git config --global user.email "hong@example.com"

1. 🔗 링크 claude.com/download에서 Windows를 누릅니다. 일반 노트북은 x64, Snapdragon 계열 ARM 노트북만 arm64입니다. (0단계 «시스템 종류»에 «ARM 기반»이라고 적혀 있을 때만 arm64)
2. 내려받은 설치 파일(Claude-Setup-x64.exe)을 실행합니다. 관리자 권한 없이 사용자 계정에 설치되고, 끝나면 자동으로 열리거나 시작 메뉴에 Claude가 생깁니다.
3. «Sign in»(로그인) → 브라우저가 열리면 0단계에서 만든 Claude 계정으로 로그인 → 브라우저가 «Claude 앱을 여시겠습니까?» 하면 열기. 앱으로 돌아오면 로그인 완료입니다.
4. 화면 위 가운데 탭에서 Code를 누릅니다. «업그레이드» 안내가 뜨면 Pro 결제가 안 된 것이고, «Git이 필요합니다»류가 뜨면 2단계로 돌아가 설치한 뒤 앱을 완전히 종료(작업 표시줄 오른쪽 아래 트레이 아이콘까지)하고 다시 여십시오.
5. 입력창 주변 설정 네 가지를 봅니다. Environment는 Local(내 PC), Project folder는 Select folder, Model은 기본값, Permission mode는 Manual로 시작합니다. (권한 모드는 아래 표)
6. Select folder에서 연습 폴더를 고릅니다. 아직 없으면 파일 탐색기에서 문서 폴더 아래 JJ-AI-Practice라는 새 폴더를 만들고 그것을 선택합니다. 실제 업무 원본이 든 폴더는 고르지 마십시오.
7. 아래 P-01 프롬프트를 입력창에 붙여 넣고 Enter. Manual 모드라 파일을 만들기 전에 «승인하시겠습니까?»를 묻습니다. 경로와 파일명을 읽고 Accept를 누르십시오.

지금 선택된 작업 폴더의 전체 경로를 먼저 알려줘.
그 폴더 안에 첫실행확인.txt 를 만들고 «업무 자동화 연습을 시작합니다. (오늘 날짜와 시각)»을 UTF-8로 저장한 다음, 파일을 다시 읽어서 내용과 실제 저장 경로를 알려줘.
같은 이름의 파일이 이미 있으면 덮어쓰지 말고 새 이름을 써. 다른 폴더의 파일은 건드리지 마.

권한 모드 — 입력창 옆 선택기

1. 🔗 링크 Microsoft Store의 ChatGPT에서 설치(또는 «Store 앱에서 열기» → 설치)를 누릅니다. 게시자가 OpenAI인지 확인하십시오. Store 사용이 금지된 회사 PC는 IT 부서에 아래 기업 배포 문서를 전달하십시오. PS-06은 Store 차단을 우회하지 않습니다.
2. 설치가 끝나면 시작 메뉴에서 ChatGPT를 엽니다.
3. «Sign in»(로그인) → 브라우저에서 ChatGPT 계정으로 로그인 → «앱으로 돌아가기» 허용.
4. 앱에서 Codex를 선택하고 New chat으로 시작합니다. ChatGPT의 Chat/Work 토글과 구분하십시오. Work도 파일 업무에 쓸 수 있지만 이 자료의 CLI·개발 도구 실습은 Codex 기준입니다. 선택 항목이 안 보이면 앱을 업데이트하고 공식 화면 안내와 비교하십시오. 현재 계정에서 보이지 않는 기능은 설치 실패로 단정하지 마십시오
5. Add new project 또는 Ctrl+O → 3단계에서 만든 연습 폴더 JJ-AI-Practice를 선택합니다. (두 앱이 같은 폴더를 쓰면 같은 프롬프트로 결과를 비교할 수 있습니다)
6. 입력창 아래 승인 설정에서 Ask for approval을 고릅니다. 이 설정이 «작업 폴더 밖은 건드리지 않는» 샌드박스 보호를 켭니다. Full access는 폴더 제한이 풀려 실수로 다른 파일을 지울 수 있으니 고르지 마십시오.
7. 실행 환경은 기본값 Windows native(PowerShell) 그대로 둡니다. WSL은 필요 없습니다.
8. 3단계의 P-01 프롬프트를 그대로 붙여 넣고 Enter. 파일 생성 승인이 뜨면 경로를 읽고 승인합니다. 이미 3단계에서 만든 «첫실행확인.txt»가 있으니 AI가 «새 이름으로» 만드는지 보십시오.

winget install --id 9PLM9XGG6VKS -s msstore

Node.js (LTS)

1. 🔗 링크 nodejs.org/en/download를 엽니다. 위쪽에서 LTS(v24 계열, «Long Term Support»)가 선택돼 있는지 보고, Windows Installer (.msi) 64-bit(x64)를 내려받습니다. ARM 노트북만 ARM64.
2. 내려받은 node-v24.x.x-x64.msi를 실행하고 전부 Next. «Tools for Native Modules» 체크박스는 체크하지 않고 넘어갑니다(개발자용). Install → 사용자 계정 컨트롤 «예» → Finish.
3. PowerShell 창을 닫고 새로 엽니다.

winget install --id OpenJS.NodeJS.LTS -e --source winget

node --version
npm.cmd --version

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

Python

1. 🔗 링크 python.org/downloads/windows를 엽니다. 맨 위 «Latest Python 3 Release» 아래에서 Windows installer (64-bit)를 내려받습니다. (2026년 9월 기준 3.14.x. ARM 노트북은 ARM64)
2. 내려받은 python-3.14.x-amd64.exe를 실행합니다. 첫 화면 맨 아래 «Add python.exe to PATH» 체크박스를 반드시 체크한 뒤 Install Now를 누릅니다. 이 체크를 빼먹으면 PowerShell이 python을 찾지 못합니다(빼먹었다면 다시 설치 파일을 실행 → Modify → Next → «Add Python to environment variables» 체크).
3. 마지막 화면에 «Disable path length limit»가 보이면 눌러 주고(안 눌러도 됩니다) Close.
4. PowerShell 창을 닫고 새로 엽니다.

winget install --id Python.Python.3.14 -e --source winget

python --version
python -m pip --version

지금 선택된 작업 폴더의 전체 경로를 먼저 알려줘.
그 폴더 안에 다음 구조를 만들어줘. 이미 있는 것은 건드리지 마.

- input/   (원본 자료를 넣는 곳)
- output/  (결과물을 저장하는 곳)
- CLAUDE.md 와 AGENTS.md (두 파일 내용 동일)

CLAUDE.md / AGENTS.md 에는 아래 규칙을 그대로 넣어줘.

---
# 이 폴더에서 일할 때의 규칙
- 나는 개발 경험이 없는 기업교육 담당자다. 설명은 한국어로, 전문용어는 한 줄 풀이를 붙인다.
- input/ 은 절대 수정·삭제하지 않는다. 결과는 output/ 에 날짜(YYYY-MM-DD_)를 붙여 저장한다.
- 이 폴더 바깥의 파일은 읽지도 쓰지도 않는다.
- 파일을 삭제·덮어쓰기 전에 무엇을 왜 지우는지 먼저 말하고 확인을 받는다. 같은 이름이 있으면 _v2, _v3 를 붙인다.
- 이름·이메일·전화번호·사번 등 개인정보는 결과물에서 제외하거나 «A팀장» 식으로 바꾼다.
- 메일 발송·외부 업로드·인터넷 게시는 명시적으로 시키기 전에는 하지 않는다.
- 브라우저(Playwright)나 커넥터를 쓸 때 로그인 정보는 프롬프트로 받지 않는다. 로그인이 필요하면 멈추고 알린다.
- 숫자를 계산하면 «입력 N건 → 사용 N건 → 제외 N건과 이유»를 항상 함께 보고한다.
- 추가 프로그램 설치나 시스템 설정 변경이 필요하면 이유와 공식 링크를 알려주고 멈춘다.
- 결과 보고는 맨 위에 «무엇을 만들었는지» 한 줄, 그 아래 결과 파일의 실제 경로, 마지막에 «내가 직접 확인해야 할 것».
---

만든 뒤 폴더 구조를 트리 형태로 보여주고, CLAUDE.md 를 다시 읽어서 규칙이 그대로 저장됐는지 확인해줘.

직접 만드시려면 아래 파일을 받아 연습 폴더 최상단에 두십시오. 위 프롬프트의 원본 보존·승인·개인정보 처리 원칙을 담은 파일입니다.

git init
git add .
git commit -m "연습 폴더 시작"

8-A. Playwright MCP — Claude Code CLI·Codex CLI에 등록 (공식: github.com/microsoft/playwright-mcp)

등록은 PowerShell에서 한 줄입니다. 등록하면 CLI뿐 아니라 앱에서도 같이 보입니다(Claude 앱 Code 탭은 CLI의 사용자 설정을 그대로 읽고, ChatGPT 앱과 Codex CLI는 같은 설정 파일 ~/.codex/config.toml을 공유합니다). MCP 연결과 브라우저 준비는 별개입니다. 이 실습은 Windows의 Microsoft Edge를 명시해 사용합니다. 먼저 시작 메뉴에서 Edge가 열리는지 확인하십시오. Python 실습의 Chromium 다운로드와 혼동하지 마십시오.

claude mcp add --scope user playwright -- npx.cmd -y @playwright/mcp@latest --browser msedge
claude mcp get playwright

codex mcp add playwright -- npx.cmd -y @playwright/mcp@latest --browser msedge
codex mcp list

{
  "mcpServers": {
    "playwright": {
      "command": "npx.cmd",
      "args": ["-y", "@playwright/mcp@latest", "--browser", "msedge"]
    }
  }
}

Playwright 도구(브라우저)를 써서 https://jjcreative.co.kr/lounge 를 열어줘.
페이지에 있는 자료 제목(001, 002, 003 …)을 모두 읽어서 output/라운지목록_(오늘날짜).md 에 번호·제목·링크 표로 저장하고, 페이지 전체 캡처를 output/라운지_(오늘날짜).png 로 저장해줘.
로그인·폼 입력·다른 사이트 접속·파일 다운로드는 하지 마. 끝나면 저장한 두 파일의 실제 경로와, 브라우저에서 어떤 동작을 했는지 순서대로 알려줘.

8-B. Playwright Python — 스크립트로 반복 실행 (공식: playwright.dev/python)

MCP는 «대화로 그때그때 시키는» 방식이고, 이쪽은 «한 번 만든 스크립트를 매번 똑같이 돌리는» 방식입니다. 4편의 예약 실행이 이것을 씁니다. 공식 요건이 Windows 11(또는 Server 2019 이상)이니 Windows 10이면 건너뛰어도 됩니다.

python -m pip install --upgrade pip
python -m pip install playwright
python -m playwright install chromium

python -c "import playwright; print('playwright ok')"

이 폴더에 screenshot.py 라는 파이썬 스크립트를 만들어줘.
- Playwright(sync API)로 Chromium을 headless로 열고 https://jjcreative.co.kr/lounge 에 접속해서, 전체 페이지 캡처를 output/lounge_(오늘날짜).png 로 저장하고, 페이지의 h2 제목들을 output/lounge_titles_(오늘날짜).txt 에 한 줄씩 저장해.
- output 폴더가 없으면 만들어. 같은 이름 파일이 있으면 _v2, _v3처럼 비어 있는 이름을 찾아. 기존 파일을 덮어쓰지 마.
- 이 PC에는 playwright 와 chromium 이 이미 설치돼 있으니 추가 설치는 하지 마.
만든 뒤 python screenshot.py 로 한 번 실행해서 두 파일이 생겼는지 확인하고 실제 경로를 알려줘. 로그인·폼 입력·다른 사이트 접속은 하지 마.

python .\screenshot.py
Get-ChildItem .\output

따라 해 보기 — Claude 앱에 Google Drive 커넥터 연결 (원격 MCP의 대표 예)

1. ⚙ 앱 설정 Claude 앱 → 설정(Ctrl+,) → 왼쪽 Connectors. 목록에서 Google Drive 옆 Connect.
2. 브라우저가 열리면 회사 또는 개인 Google 계정으로 로그인 → «Claude가 Drive 파일을 보도록 허용» → 허용. 앱으로 돌아오면 «Connected»로 바뀝니다. 비밀번호는 Google 화면에만 입력하고, Claude 입력창에는 절대 넣지 않습니다.
3. Connectors 목록에서 Google Drive를 클릭해 도구 목록(검색·읽기 등)을 보고, 지금 필요 없는 도구는 끕니다. «쓰기·삭제»가 있는 커넥터는 처음엔 «읽기»만 켜 두는 것이 안전합니다.
4. 새 대화에서 입력창 왼쪽 아래 + → Connectors → Google Drive가 켜져 있는지 확인. 아래 P-09를 넣어 «실제로 연결됐는지» 확인합니다.
5. 같은 방식이 Gmail·Google Calendar·Slack·Notion에 적용됩니다. 사용자 지정 커넥터(회사 시스템의 MCP 서버 URL)는 «Add custom connector» → URL 입력 → 인증. 공식: Claude 사용자 지정 커넥터.

지금 이 대화에서 쓸 수 있는 커넥터와 도구 이름을 목록으로 보여줘.
그다음 Google Drive 커넥터로 «교육» 또는 «만족도»라는 단어가 들어간 파일을 검색해서 제목·수정일·소유자만 표로 보여줘. 파일 내용은 열지 말고, 아무것도 만들거나 수정하거나 보내지 마.
연결이 안 돼 있으면 어떤 설정 화면에서 무엇을 눌러야 하는지 알려줘.