AI 해결 노트
This category is published in Korean only.
Codex CLI·Claude Code·MCP 서버를 이 PC(윈도우 11·WSL 우분투)에서 직접 돌려 보고 적었습니다. 명령어와 출력은 실행한 그대로 옮겼고, 돌려 보지 않은 부분은 글마다 따로 밝혔습니다.
2026-09-17 · 실측 2026-09-17
Claude Code 로컬 플러그인 만들고 불러오기 — claude plugin validate와 --plugin-dir 윈도우 실측
공식 문서의 빠른 시작대로 plugin.json과 SKILL.md 두 파일만 만들면 claude plugin validate가 ✔ Validation passed를 냈습니다.
2026-09-17 · 실측 2026-09-17
윈도우에서 Claude Code에 MCP 서버 붙이기 — claude mcp add --scope project 최소 구성과 Pending approval 풀기
윈도우 PowerShell에서 claude mcp add 이름 --scope project -- npx -y 패키지 인자를 치면 프로젝트 폴더에 .mcp.json이 생깁니다.
2026-09-17 · 실측 2026-09-17
Claude Code settings.json은 어디에 있고 어느 파일이 이기나 — 사용자·프로젝트·로컬·관리형 범위 윈도우 실측
Claude Code 설정 파일은 사용자·공유 프로젝트·프로젝트 로컬·관리형 네 범위에 있고, 같은 키가 겹치면 관리형 → 명령줄 → 로컬 → 공유 → 사용자 순으로 위쪽 값이 쓰입니다(공식 문서 기준). 윈도우에서 ~/.claude는 %USERPROFILE%\.claude입니다.
2026-09-17 · 실측 2026-09-17
Claude Code 윈도우 네이티브 설치, 제대로 깔렸는지 5분 만에 확인하기 — claude doctor·PATH·versions 폴더 실측
Claude Code 윈도우 네이티브 설치본은 버전, 실행 파일 위치, claude doctor, PATH, versions 폴더 순으로 점검하면 됩니다. 저희 PC에서는 실행 경로가 한 곳뿐이었고, doctor가 No installation issues found.를 출력했습니다.
2026-09-17 · 실측 2026-09-17
Codex CLI 로그인 상태 확인하기 — codex login status와 사용량 보는 곳(/status, /usage)
로그인 여부는 codex login status 한 줄로 확인됩니다. 저희 PC에서는 Logged in using ChatGPT가 나왔습니다. 사용량은 대화 화면 안의 /status, /usage로 보도록 공식 문서에 적혀 있고, 확인한 도움말에는 사용량 명령이 없었습니다.
2026-09-17 · 실측 2026-09-17
Codex CLI 버전 확인과 업데이트 — npm update로는 0.153에서 0.154로 안 넘어간 실측
지금 버전은 codex --version, 최신 버전은 npm view @openai/codex version으로 봅니다. 올릴 때는 @latest를 붙여 설치하세요.
2026-09-17 · 실측 2026-09-17
윈도우에 Codex CLI(@openai/codex)를 npm으로 설치하고 첫 실행까지 — 임시 폴더 실측
윈도우에서 Codex CLI는 npm 패키지 @openai/codex 하나로 설치됩니다. 저희 PC에서는 7초 만에 끝났고, 실제 실행 파일은 codex-win32-x64라는 별도 패키지 안의 codex.exe였습니다.
2026-09-17 · 실측 2026-09-17
WSL(Ubuntu)에 Codex CLI 설치하기 — 윈도우 codex가 먼저 잡히는 함정까지, 로그인 전 단계 실측
윈도우에 Codex CLI를 깔아 둔 저희 PC에서는 WSL Ubuntu에서도 윈도우 쪽 codex가 잡혔고, codex --version이 Missing optional dependency @openai/codex-linux-x64 오류로 끝났습니다.
2026-09-17 · 실측 2026-09-17
Codex CLI config.toml에 MCP 서버 넣기 — codex mcp add가 파일에 쓰는 모양 (윈도우, 임시 CODEX_HOME 실측)
codex mcp add 이름 -- 명령 인자...를 치면 config.toml에 [mcp_servers.이름] 표가 생깁니다. 이번에 넣은 윈도우 경로는 작은따옴표로 저장됐고, 같은 경로를 큰따옴표 안에 역슬래시 그대로 적자 codex mcp list가 TOML 오류로 실패했습니다.
2026-09-17 · 실측 2026-09-17
Codex CLI codex doctor 진단 결과 읽는 법 — ✓·⚠·✗와 --summary·--json 윈도우 실측
codex doctor는 설치·설정·로그인·네트워크 상태를 한 번에 점검하는 명령입니다. 저희 PC(0.153.4)에서는 마지막 줄 23 ok · 1 idle · 2 notes · 0 warn · 0 fail ok와 종료 코드 0이 나왔습니다.
2026-09-17 · 실측 2026-09-17
codex exec 결과를 파일로 받기 — -o와 --json 윈도우 실측 (Codex CLI)
codex exec의 마지막 답만 필요하면 -o 파일, 진행 과정까지 기계로 읽으려면 --json > 파일을 씁니다. 둘은 같이 쓸 수 있습니다. 이번 실험에서는 -o에 없는 폴더를 주자 파일 저장에 실패했는데 종료 코드는 0이었으니, 저장 결과를 따로 확인하는 편이 좋습니다.
2026-09-17 · 실측 2026-09-17
Codex CLI codex exec가 "Reading additional input from stdin..."에서 안 끝날 때 — 윈도우 실측
codex exec "질문"을 스크립트나 AI 에이전트의 백그라운드 셸에서 돌리면 Reading additional input from stdin...만 찍히고 끝나지 않을 수 있습니다. 표준입력(stdin)이 파이프로 열려 있으면 codex가 그 입력이 끝나기를 기다리기 때문입니다.
2026-09-17 · 실측 2026-09-17
codex mcp-server를 Claude Code에 MCP 서버로 붙이기 — 윈도우 project 범위 실측과 사용 중단 예고 경고
claude mcp add codex-temp --scope project -- codex mcp-server로 프로젝트 설정에 Codex를 MCP 서버로 등록했습니다.
2026-09-17 · 실측 2026-09-17
설정 파일 안 건드리고 Codex CLI 모델 바꾸기 — codex exec -m, -c model= 윈도우 실측
한 번만 다른 모델로 돌리려면 codex exec -m <모델>을 씁니다. -c model="<모델>"도 같은 결과를 냈고, 둘을 함께 준 실행에서는 -m 값이 머리말에 찍혔습니다.
2026-09-17 · 실측 2026-09-17
커밋 전에 Codex CLI로 코드 리뷰 받기 — codex review --uncommitted 윈도우 실측
codex review --uncommitted는 스테이징 여부와 상관없이 아직 커밋하지 않은 변경과 추적 안 되는 새 파일까지 묶어 리뷰합니다. 일부러 버그 둘을 넣은 임시 저장소에서 돌려 보니 지적 3건이 모두 실제 테스트 실패와 맞았습니다.
2026-09-17 · 실측 2026-09-17
Codex CLI 샌드박스 read-only와 workspace-write 차이 — 윈도우에서 파일 쓰기로 비교
같은 「hello.txt를 만들어 달라」 요청을 codex exec -s read-only와 -s workspace-write로 돌렸습니다. read-only에서는 쓰기가 막혀 파일이 생기지 않았고, workspace-write에서는 파일이 생겼습니다.
2026-09-17 · 실측 2026-09-17
Node로 최소 MCP 서버 만들기 — @modelcontextprotocol/sdk 도구 1개짜리 stdio 서버를 Claude Code에 붙이기까지
빈 폴더에 npm install @modelcontextprotocol/sdk zod를 하고 20줄짜리 server.mjs를 쓰면 두 수를 더하는 도구 하나를 가진 stdio MCP 서버가 됩니다. 저희 윈도우 환경에서는 JSON-RPC를 직접 보내 5를 돌려받았습니다.
2026-09-17 · 실측 2026-09-17
MCP 서버가 ✘ Failed to connect일 때 — 잘못된 실행 경로(CONNECTION_CLOSED)와 stdout 오염(connection timed out) 구분하기
저희 재현(Claude Code 2.1.274, 윈도우)에서 없는 파일을 등록하면 claude mcp list에 ✘ Failed to connect — CONNECTION_CLOSED: Connection closed가 나왔습니다.
2026-09-17 · 실측 2026-09-17
Playwright "Executable doesn't exist" 오류 — 브라우저 실행 파일이 없을 때 윈도우에서 재현하고 푼 기록
Playwright는 설치된 버전에 맞는 브라우저 번호 폴더(예: chromium_headless_shell-1243)를 찾습니다. 그 폴더가 없으면 Executable doesn't exist로 멈춥니다.
2026-09-17 · 실측 2026-09-17
윈도우에서 Playwright MCP를 Claude Code에 붙이기 — @playwright/mcp project 범위 설정과 첫 연결 확인
윈도우 PowerShell 7에서 claude mcp add playwright --scope project -- npx -y @playwright/mcp@latest --headless --isolated로 붙이고 승인하자 ✔ Connected가 나왔습니다.