DOCTOR AI ACADEMY · WINDOWS HANDS-ON
처음부터 따라 하는
Codex CLI 설치
코딩 경험이 없어도 괜찮습니다. Windows 컴퓨터에서 PowerShell을 열고 Codex를 설치한 뒤, 안전한 연습 폴더에서 첫 작업을 실행합니다.
각 단계의 명령어는 복사 버튼을 누르면 복사됩니다. 결과를 확인한 후 완료 체크를 하세요.
1PowerShell 열기
왜 하나요? 터미널은 컴퓨터에 글자로 명령을 내리는 창입니다.
어떻게 하나요? Windows 시작 버튼을 누르고 PowerShell을 검색해 Windows PowerShell 또는 PowerShell을 실행하세요. 관리자 권한은 필요하지 않습니다.
✓ 성공 기준: PS C:\Users\...> 와 비슷한 입력 줄이 보입니다.
⚠ 문제가 생겼나요?
창이 열리지 않으면 Windows Terminal을 열고 PowerShell 탭을 선택하세요.
2Node.js 설치 여부 확인
왜 하나요? Codex CLI 설치에 사용하는 npm이 Node.js에 포함됩니다.
어떻게 하나요? 두 줄을 차례로 입력하고 Enter를 누릅니다. 버전 숫자가 모두 나오면 다음 단계로 이동하세요.
node -v
npm -v✓ 성공 기준: 각각 v로 시작하는 Node 버전과 npm 버전이 표시됩니다.
⚠ 문제가 생겼나요?
명령을 찾을 수 없으면 다음 설치 명령을 실행한 뒤 PowerShell을 완전히 닫고 다시 여세요.
3Node.js가 없으면 설치
왜 하나요? Node.js와 npm을 한 번에 준비합니다.
어떻게 하나요? 2단계에서 버전이 모두 표시되었다면 건너뛰세요. 설치 중 동의 안내가 나오면 내용을 확인하고 진행하세요. 완료 후 PowerShell을 다시 열고 node -v 및 npm -v를 재확인하세요.
winget install OpenJS.NodeJS.LTS✓ 성공 기준: 두 버전이 모두 출력됩니다.
⚠ 문제가 생겼나요?
winget이 없으면 https://nodejs.org 에서 공식 LTS 설치 프로그램을 받으세요. 설치 후 새 터미널에서 확인합니다.
4Codex CLI 설치
왜 하나요? OpenAI Codex 명령어를 사용할 수 있도록 합니다.
어떻게 하나요? PowerShell에 복사해 붙여넣고 Enter를 누르세요. 네트워크 상황에 따라 잠시 기다립니다.
npm install -g @openai/codex✓ 성공 기준: npm 오류 없이 설치가 끝납니다.
⚠ 문제가 생겼나요?
npm.ps1 실행 정책 오류가 발생하면 보안 정책을 바꾸기보다 npm.cmd install -g @openai/codex 를 실행하세요.
5설치 확인
왜 하나요? Codex 명령어가 실제로 실행되는지 검사합니다.
어떻게 하나요? 새 PowerShell 창에서 실행합니다.
codex --version✓ 성공 기준: codex-cli 버전 문자열이 출력됩니다.
⚠ 문제가 생겼나요?
codex를 찾을 수 없으면 터미널을 다시 열고 npm.cmd list -g @openai/codex 를 확인하세요. PATH 설정 문제일 수 있습니다.
6로그인하고 Codex 실행
왜 하나요? 사용할 계정을 인증하고 첫 대화를 시작합니다.
어떻게 하나요? 로그인 화면이 나오면 제공되는 ChatGPT 계정 로그인 등 안내에 따라 인증하세요. 계정·조직 정책에 따라 이용 가능 여부가 달라질 수 있습니다.
codex✓ 성공 기준: Codex 대화 입력 화면이 나타납니다.
⚠ 문제가 생겼나요?
브라우저 인증이 막히면 로그인 안내의 대체 방법을 확인하고 조직 관리자에게 권한을 문의하세요.
7안전한 첫 실습
왜 하나요? 실제 업무 파일을 변경하지 않고 Codex의 작동을 경험합니다.
어떻게 하나요? 새 PowerShell에서 위 명령을 순서대로 실행하세요. Codex가 열리면 “이 폴더에 README.md를 만들기 전에 어떤 내용을 쓸지 설명해 줘”라고 입력하세요. 파일 변경을 요청할 때는 변경 내용을 확인한 뒤 승인하세요.
mkdir codex-practice
cd codex-practice
codex✓ 성공 기준: Codex가 폴더와 요청 내용을 이해하고 답변합니다.
⚠ 문제가 생겼나요?
mkdir에서 이미 존재한다고 나오면 cd codex-practice 만 실행하세요.
설치 후 무엇을 해 볼까요?
폴더 파일 목록 설명하기, 샘플 CSV 요약하기, 문서 초안 만들기, PC 용량 점검 명령 제안받기부터 시작하세요. 시스템 정리나 파일 삭제는 실행 전 별도 확인이 필요합니다.
공식 참고: OpenAI Codex CLI 문서 · Node.js