코드는 바뀌었는데 어떤 파일이 달라졌는지 모르겠고, 작업 완료 메시지만 보입니다.
이번 주에는 원본 상태를 남긴 뒤 실제 변경 내용을 확인하고, 수업에서 요구한 테스트와 프로그램 동작을 대조한 다음 제출하세요. Xcode 검수가 과제 조건에 있을 때만 맥 환경에서 그 부분을 확인하면 됩니다.
이 글은 Codex CLI로 처음 과제를 수정하는 학생, Git diff와 테스트 결과를 읽는 데 익숙하지 않은 초보자, 윈도우만 사용하지만 Xcode 검수가 필요한 학생을 위한 안내입니다.
최종 업데이트: 2026년 10월 13일. Codex CLI 관련 설명은 공식 시작 안내와 공식 코드 저장소 문서를 기준으로 확인했습니다. 실제 과제의 명령과 제출 기준은 수업 안내와 프로젝트 문서를 우선으로 삼으세요.
SECTION 01 수정 전: 원본과 과제 기준을 먼저 남기세요
먼저 작업 중인 폴더가 과제 프로젝트가 맞는지 확인합니다. 비슷한 이름의 폴더가 여러 개라면 파일을 열어 과제 이름과 실행 파일을 확인하세요. Codex CLI에 일을 맡길 때도 “프로젝트를 고쳐 주세요”처럼 넓게 말하기보다, 과제에서 요구한 한 가지 수정 사항을 구체적으로 정하는 편이 확인하기 쉽습니다.
그다음 현재 코드를 되돌릴 방법을 준비합니다. Git을 이미 쓰고 있다면 수정 전에 현재 상태를 확인하고, 변경을 기록하거나 별도 사본을 보관하세요. 아직 Git을 배우는 중이라면 과제 폴더를 복사해 원본으로 남기는 방법도 있습니다. 중요한 점은 AI가 수정한 뒤 무엇이 달라졌는지 비교할 기준이 있어야 한다는 것입니다.
과제 설명에서 확인 항목도 추려 두세요. 예를 들어 입력값, 화면 구성, 출력 결과처럼 요구 사항을 짧은 목록으로 옮깁니다. 이후 테스트와 코드 변경을 이 목록에 대조하면, 작동은 하지만 과제 의도와 다른 결과를 놓칠 가능성이 줄어듭니다.
SECTION 02 수정 직후: Codex CLI가 어떤 파일을 바꿨는지 확인하세요
변경 파일을 찾을 때는 도구가 작업을 설명한 문장만 읽고 끝내지 마세요. 실제 프로젝트의 파일 상태와 수정 내용을 직접 확인해야 합니다. Git을 사용하는 프로젝트라면 git status --short로 변경된 파일을 살펴보고, git diff로 기존 코드와 새 코드의 차이를 읽을 수 있습니다. Git 공식 설명서는 git diff가 변경 내용을 비교하는 명령임을 설명합니다.
Git diff는 답안 채점표가 아니라 변경을 찾아보는 돋보기입니다. 삭제된 줄과 새로 추가된 줄을 함께 보고, 그 변화가 요청한 작업과 연결되는지 확인하세요. 과제와 관계없는 문서, 설정 파일, 다른 기능까지 바뀌었다면 이유를 확인하기 전에는 제출 준비가 끝난 것으로 보지 않는 편이 안전합니다.
Codex CLI의 사용 방법이나 작업 권한과 같은 세부 사항은 버전과 현재 설정에 따라 다를 수 있습니다. 실제 화면과 동작을 확인할 때는 공식 시작 안내와 공식 저장소 문서를 기준으로 삼으세요. 도구가 “완료”라고 알려도 실제 파일 검토를 대신하지는 않습니다.
SECTION 03 설명할 수 없는 변경은 멈추고 물어보세요
수정 내용에서 낯선 라이브러리, 설정, 새 파일을 발견했다면 어떤 목적으로 추가됐는지 먼저 확인하세요. 수업에서 배우지 않은 구조가 들어갔다는 사실만으로 오류라고 단정할 수는 없지만, 네가 그 이유와 동작을 설명할 수 없다면 그대로 제출하지 않는 것이 좋습니다.
자기 말로 설명할 수 있는지 확인하는 방법은 간단합니다. 바뀐 파일마다 “이 수정은 어떤 요구를 해결하는가?”, “이 부분이 없으면 과제 결과가 어떻게 달라지는가?”를 답해 보세요. 답이 막히면 Codex CLI에 변경 이유와 관련 파일을 다시 물어보고, 과제 범위를 벗어난 수정인지 확인합니다. 설명이 해결되지 않거나 변경이 불필요해 보이면 원본으로 돌아가 다시 검토하세요.
변경 내용을 설명하지 못하는데 테스트만 통과했다면 제출을 잠시 미루세요. 테스트는 확인한 조건만 살펴볼 뿐, 과제의 모든 요구 사항을 자동으로 판정하지는 않습니다.
SECTION 04 테스트 단계: 수업에서 안내한 방법으로 실행하세요
테스트는 프로그램이 특정 조건에서 기대한 대로 동작하는지 확인하는 과정입니다. 수업 예제, 프로젝트 안내 파일, 교사의 제출 지침에 명령이나 실행 순서가 적혀 있다면 그 내용을 우선하세요. 프로젝트 종류에 따라 실행 방법이 달라지므로, 익숙하지 않은 명령을 임의로 복사해 실행하기보다는 문서에서 필요한 절차를 먼저 찾으세요.
Python 과제라면 프로젝트에서 unittest를 사용하도록 안내했는지 확인할 수 있습니다. Python 공식 문서는 이 테스트 도구의 사용 방법을 설명합니다. 하지만 모든 Python 프로젝트가 같은 방식으로 실행되는 것은 아니므로, 문서에 적힌 실행 명령과 수업에서 지정한 검사를 기준으로 삼아야 합니다.
테스트 결과에는 실행한 조건과 실제로 확인하지 않은 조건을 함께 기록하세요. 예를 들어 예제 입력은 통과했지만 빈 입력이나 잘못된 형식의 입력은 시험하지 않았다면, “모든 상황에서 정상 작동한다”고 결론 내릴 수 없습니다. 실패가 나오면 코드 오류인지, 실행 환경 문제인지, 과제 내용을 다르게 이해한 것인지 구분한 뒤 다음 조치를 정하세요.
SECTION 05 제출 직전: 통과 표시와 과제 요구를 함께 대조하세요
테스트가 통과해도 바로 제출하지 마세요. 제출할 파일이 맞는지, 프로그램이 안내된 방식으로 다시 실행되는지, 결과가 요구 사항과 일치하는지 마지막으로 확인해야 합니다. 여러 파일로 이뤄진 과제라면 코드뿐 아니라 필요한 자료와 설정 파일이 빠지지 않았는지도 살펴보세요.
| 확인 상황 | 다음 행동 |
|---|---|
| 변경 파일이 요청한 작업과 맞고, 바뀐 이유를 설명할 수 있습니다 | 수업에서 안내한 테스트와 제출 조건을 이어서 확인합니다 |
| 과제와 무관한 파일이나 설정이 바뀌었습니다 | 이유를 확인하고, 불필요한 변경은 되돌린 뒤 다시 검사합니다 |
| 테스트가 실패합니다 | 코드, 환경, 과제 해석 중 어디에서 문제가 생겼는지 나눠 확인합니다 |
| 테스트는 통과했지만 일부 요구를 실행해 보지 않았습니다 | 빠진 조건을 추가로 점검하고, 확인하지 않은 범위를 기록합니다 |
아래 조건에 맞춰 제출 여부를 결정하세요.
- 과제 요구에 맞는 변경이고 주요 수정 내용을 설명할 수 있다면, 수업에서 지정한 테스트를 실행한 뒤 제출 절차로 넘어가세요.
- 변경 이유를 모르거나 관계없는 파일이 수정됐다면, 제출을 보류하고 설명을 확인하거나 원본 상태로 되돌려 검토하세요.
- 테스트가 실패했다면, 결과를 그대로 Codex CLI에 넘겨 원인을 좁히되 추가 수정이 과제 범위를 벗어나지 않는지 다시 확인하세요.
- 일부 요구 사항을 테스트하지 못했다면, 통과한 검사만으로 전체 과제가 완성됐다고 판단하지 마세요.
SECTION 06 Xcode 과제: 맥에서만 확인할 항목을 구분하세요
일반적인 코드 변경 확인과 Xcode 프로젝트 검수는 같은 작업이 아닙니다. 코드를 읽고 Git diff를 확인하는 일은 현재 사용할 수 있는 개발 환경에서 진행할 수 있습니다. 반면 과제에서 Xcode로 앱을 빌드하거나 iOS 시뮬레이터 또는 실제 기기에서 실행하라고 요구한다면, 해당 조건을 수행할 수 있는 맥 환경이 필요합니다. Apple의 Xcode 안내는 Xcode 관련 개발 문서를 제공합니다. 시뮬레이터와 실제 기기에서 앱을 실행하는 조건은 Apple의 실행 안내를 확인하세요.
테스트 실행 결과를 읽을 때도 과제 기준과 도구가 표시한 결과를 함께 보세요. Apple의 테스트 실행 및 결과 해석 안내는 Xcode에서 테스트를 실행하고 결과를 확인하는 방법을 설명합니다. 테스트 성공 여부만 확인하지 말고, 과제에서 요구한 실행 대상과 기능이 실제로 포함됐는지 대조해야 합니다.
| 과제의 검수 조건 | 현재 환경에서 할 일 | 맥 환경이 필요한 경우 |
|---|---|---|
| 코드 변경과 수정 파일 확인 | 프로젝트 파일과 Git diff를 읽습니다 | 맥이 반드시 필요한 것은 아닙니다 |
| Python 등 수업에서 지정한 일반 테스트 | 과제 문서에 맞춰 실행하고 결과를 기록합니다 | 프로젝트가 맥 전용 도구를 요구할 때만 확인합니다 |
| Xcode 빌드 또는 iOS 시뮬레이터 실행 | 요구 사항과 필요한 제출 자료를 정리합니다 | 호환되는 맥 환경에서 지정된 빌드와 실행을 확인합니다 |
윈도우만 사용할 수 있어도 코드 차이와 과제 문서 검토를 먼저 진행할 수 있습니다. 다만 수업에서 Xcode 빌드나 시뮬레이터 결과를 제출하라고 했다면, 윈도우에서 확인한 코드만으로 해당 검수까지 완료했다고 볼 수는 없습니다. 그때는 과제의 Xcode 요구 사항, 제출 방식, 사용할 수 있는 맥 환경을 먼저 확인하세요. 원격 맥을 이용할 때 필요한 접속 절차나 이용 조건은 VPSNIX 도움말 센터에서 확인할 수 있습니다.
일반 코드 과제라면 지금 쓰는 컴퓨터에서 수업 테스트를 실행하는 것이 가장 단순합니다. 반대로 Xcode가 필수인 과제에서 윈도우만 쓰면, 최종 빌드와 시뮬레이터 검수를 다른 환경에서 해야 하는 번거로움이 남습니다. 맥을 직접 마련하는 선택은 초기 지출이 부담일 수 있습니다. 과제 기간에만 맥이 필요하다면 VPSNIX의 맥 이용 요금과 제공 조건을 확인해 대여가 과제의 Xcode 요구와 맞는지 비교해 보세요. 원격 맥을 선택하더라도 코드 검토와 수업 테스트는 별도로 해야 하며, 실제 이용 조건은 신청 전에 확인해야 합니다.
제출 전에 바뀐 파일과 수정 이유를 확인하고, 수업 테스트 결과를 과제 요구와 대조하세요. Codex CLI 과제 코드 검수에서 확인하지 않은 조건은 통과한 것으로 간주하지 않는 것이 안전합니다.