Codex를 설치했는데 이제 무엇을 입력해야 할까요? ‘코딩을 도와준다’는 설명만으로는 내 파일을 보여주고 무슨 일을 부탁할지 막막할 수 있습니다. 이번에는 간단한 할 일 목록을 예제로, 코드 설명부터 기능 추가와 오류 수정까지 어떤 요청을 할 수 있는지 살펴보겠습니다.
아직 앱을 설치하지 않았다면 Codex 설치 방법부터 확인하면 됩니다. 아래 화면은 이 글을 위해 만든 가상 웹페이지를 Codex에서 수정하고 Edge에서 실행한 결과입니다. 오류 수정 과정을 보여주기 위해, 완료한 일을 체크해도 남은 개수가 바뀌지 않도록 예제에 오류를 넣었습니다.
목차
코드를 몰라도 설명부터 부탁할 수 있을까?
웹페이지 파일을 받았는데 어디를 고쳐야 할지 모르겠다면, 먼저 파일이 무슨 역할을 하는지 물어볼 수 있습니다. Codex에서 작업할 폴더를 열고 파일 이름과 궁금한 동작을 적습니다. 공식 시작 안내에서도 선택한 폴더의 파일을 읽고 수정하는 방식으로 설명합니다.
참조: OpenAI의 작업 폴더 선택·Codex 시작 안내
이번 예제는 index.html, style.css, app.js 세 파일로 되어 있습니다. 다음처럼 요청할 수 있습니다.
index.html과 app.js를 읽고 할 일 목록이 화면에 표시되는 과정과 완료 체크가 처리되는 부분을 초보자도 이해하도록 설명해 줘. 아직 파일은 수정하지 마.
실제 파일을 읽어 보면 index.html에는 할 일 세 개와 체크박스가 들어 있습니다. style.css는 색상과 간격을 정하고, app.js는 체크할 때 완료한 문구에 취소선을 표시합니다. 화면에 보이는 목록과 체크 동작을 각각 어느 파일에서 다루는지 구분할 수 있습니다.
이 설명을 먼저 받으면 다음에 무엇을 바꿀지 구체적으로 이야기할 수 있습니다. 예를 들어 완료한 일을 잠시 안 보이게 하고 싶다면, 목록 자체를 지우는 대신 체크 상태에 따라 표시를 바꾸도록 요청하면 됩니다.
Codex에는 파일을 바로 고치게 하기 전에, 파일의 역할과 특정 동작이 처리되는 위치를 설명해 달라고 요청할 수 있습니다. 이번처럼 파일 이름과 알고 싶은 동작을 함께 적으면 설명할 대상이 분명해집니다.
원하는 기능은 어떻게 추가해 달라고 할까?
할 일을 완료해도 목록에 계속 남아 있으면 아직 하지 않은 일만 골라 보기 어렵습니다. 이때 필요한 것은 완료 항목을 숨겼다가 다시 보여주는 기능입니다. 새로 필요한 동작과 유지할 내용을 함께 적어 봅니다.
완료한 일을 목록에서 숨기는 버튼을 추가해 줘. 다시 누르면 전체 목록을 보여 줘. 할 일 문구와 체크 상태는 유지하고 두 동작을 확인해 줘.
예제에 버튼을 추가한 뒤 ‘자료 정리하기’를 완료로 체크하고 ‘완료한 일 숨기기’를 눌렀습니다. 화면에는 아직 완료하지 않은 두 항목이 남았습니다. 이어 ‘전체 보기’를 누르자 세 항목이 다시 나타났고, 첫 항목의 체크도 유지됐습니다.

항목을 삭제하지 않고 표시만 바꿨기 때문에 전체 목록으로 돌아왔을 때 완료한 기록이 남았습니다. ‘숨겨 줘’에 더해 ‘다시 보여 줘’와 ‘체크 상태를 유지해 줘’를 적은 이유입니다.
기능을 추가할 때는 원하는 새 동작, 그대로 남겨야 할 내용, 확인할 결과를 함께 요청하세요. 이 예제에서는 완료 항목 숨기기와 전체 목록 복원까지를 한 가지 기능으로 확인했습니다.
잘못된 동작은 어떻게 고쳐 달라고 할까?
숨기기 버튼은 작동하지만 남은 개수는 틀립니다. 원래 화면에서도 할 일 하나를 완료했는데 ‘남은 할 일 3개’가 그대로 표시됐습니다. 오류를 알려줄 때는 어떤 행동을 했고, 무엇이 나왔으며, 원래 어떻게 나와야 하는지를 적습니다.

할 일 하나를 완료해도 남은 할 일이 3개로 표시돼. 완료하면 2개, 체크를 취소하면 3개가 되도록 원인을 찾아 수정해 줘. 완료 항목 숨기기 기능도 유지해 줘.
예제의 원인은 숫자를 갱신하는 코드가 없다는 것이었습니다. 화면에는 처음부터 ‘3개’라고 적혀 있었고, 체크할 때는 취소선만 바뀌었습니다. 체크되지 않은 항목을 다시 세어 숫자에 반영하도록 수정했습니다.

같은 행동을 다시 실행해 확인한 결과, 처음에는 3개, 하나를 완료하면 2개, 체크를 취소하면 다시 3개가 표시됐습니다. 세 항목을 모두 완료했을 때는 0개였습니다. 앞서 추가한 숨기기와 전체 보기 기능도 유지됐습니다.
‘숫자가 이상해’라고만 쓰면 어떤 상황을 고쳐야 하는지 알기 어렵습니다. 완료와 취소 때 기대하는 값을 알려주면, 수정한 뒤에도 같은 조건으로 결과를 확인할 수 있습니다. OpenAI의 Codex 요청 안내도 오류를 재현하는 순서와 수정 후 확인 방법을 함께 전달하도록 설명합니다.
참조: OpenAI의 Codex 오류 재현·수정 후 확인 안내
오류 수정은 문제를 일으킨 행동, 실제 결과, 기대한 결과를 적고 같은 행동으로 다시 확인해 달라고 요청하면 됩니다. 이번 예제에서는 완료 체크에 따라 남은 개수가 바뀌도록 고치고, 먼저 추가한 버튼도 계속 작동하는지 확인했습니다.
Codex에 처음 맡길 일은 무엇이 좋을까?
이번에는 같은 할 일 목록으로 세 작업을 진행했습니다. 파일을 읽을 때는 각 파일의 역할을 설명했고, 기능을 추가할 때는 완료 항목을 숨기는 버튼을 만들었습니다. 오류를 수정할 때는 남은 개수가 바뀌지 않는 원인을 찾고 실제 숫자가 달라지는지 확인했습니다.
처음부터 큰 프로그램 전체를 바꾸기보다는, 갖고 있는 작은 예제의 동작을 설명해 달라고 요청하는 것부터 권합니다. 어떤 파일이 무엇을 하는지 파악한 다음 한 가지 기능을 추가하면, 바뀐 부분을 화면에서 비교하기도 쉽습니다. 이번 시험은 가상 예제 한 건이며, 다른 프로그램도 같은 결과로 완성된다는 보장은 아닙니다.
Codex를 처음 쓸 때는 코드 설명, 필요한 기능 추가, 재현할 수 있는 오류 수정을 맡겨볼 수 있습니다. 먼저 파일의 역할을 설명받고, 그다음 원하는 변경 한 가지를 요청하세요. 사용할 파일과 원하는 결과, 유지할 내용, 확인 방법을 함께 적으면 이번 예제처럼 요청과 결과를 연결해 살펴볼 수 있습니다.

답글 남기기