Codex 앱 입문

먼저 전체 모습

무엇을 할 수 있고, 어디에서 어떻게 나눠 쓰면 되는지. 처음에는 이것만 알아도 겁먹지 않고 시작할 수 있습니다. Codex(작업을 맡기는 도구)는 질문에 답만 하는 도구가 아닙니다. 손에 있는 자료나 파일을 보여주면서, "이 초안을 고쳐줘" "이 자료를 읽고 핵심만 정리해줘" "이 페이지의 보이는 모습을 확인해줘"처럼, 실제 일의 일부를 맡기기 위한 도구입니다.

다만 처음부터 큰일을 통째로 맡기면 잘되지 않을 때가 있습니다. 새로 들어온 사람에게 갑자기 모든 일을 말로만 한꺼번에 부탁하면 어긋나기 쉬운 것과 같습니다. 먼저 작은 일을 하나씩 나눠서, 어디까지 맡기면 편해지는지 보는 것이 실패하지 않는 시작 방법입니다.

처음 보는 방법

이 도구의 역할

Codex는 작업을 맡기는 상자

여기서 말하는 "상자"는, 일을 넣고 중간의 주고받음과 결과를 남겨 두는 곳이라고 생각하면 됩니다. 질문과 답만 오가는 자리가 아니라, "이 건에서, 이 일을, 이런 조건으로 진행한다"는 한 묶음을 두는 장소입니다.

중요한 점은, Codex가 처음부터 사정을 전부 알고 있는 것은 아니라는 것입니다. 사내 규칙, 늘 쓰는 방식, 건드리면 안 되는 곳은 먼저 알려주지 않으면 알 수 없습니다. 그래서 뒤에 나오는 "건 나누는 법" "대화 나누는 법" "부탁하는 틀"이 도움이 됩니다.

• 이 도구의 역할은, 작업 전 확인, 초안 만들기, 다시 보기, 확인을 돕게 하는 것입니다.

쓰는 방법은 4가지

들어가는 길은 하나가 아니다

Codex는 들어가는 곳이 하나만 있는 것이 아닙니다. 어디서 쓰든 하고 있는 일은 "작업을 맡기는 것"입니다. 다른 점은, 어느 화면에서 진행하면 더 편한가입니다. 처음이라면 먼저 Codex 앱부터 들어가는 것이 가장 이해하기 쉽습니다.

• Codex 앱

  화면에서 정리해 가며 사용합니다. 건이나 대화를 놓치기 어렵고, 처음 쓰는 사람에게 잘 맞습니다. "지금 어떤 일을 하고 있는지"를 눈으로 따라가기 쉬운 점이 장점입니다.

• VS Code 확장

  VS Code(파일을 열고 고치기 위한 도구) 안에서 사용합니다. 평소 그 화면에서 작업하는 사람에게는 편리하지만, 아직 익숙하지 않은 사람은 먼저 앱부터 써도 충분합니다.

• 명령어 조작

  글자 입력만으로 빠르게 사용합니다. 속도는 있지만 보이는 정보가 적어서, 첫걸음으로는 잘 맞지 않습니다. 익숙한 사람이 재빨리 진행할 때 쓰는 입구입니다.

• 클라우드

  내 손안이 아닌 바깥 작업 장소에서 이어서 움직입니다. 내 컴퓨터를 닫아도 계속 진행하고 싶을 때 편리하지만, 먼저 "내 자리에서 어떻게 움직이는지"를 알고 나서 쓰는 편이 안심됩니다.

앱 안은 3가지 방식

먼저 작업 장소를 고른다

앱을 열면, 처음에 생각할 것은 "어디에서 작업하게 할까"입니다. 이 부분을 어쩐지 대충 고르면, 봐야 할 것이 보이지 않거나, 반대로 건드리지 않았으면 하는 것까지 건드릴 수 있는 상태가 되기도 합니다. 일을 시작하기 전에 책상을 고르는 것이라고 생각하면 됩니다.

로컬

지금 쓰는 컴퓨터에서 그대로 작업합니다. 손에 있는 자료나 지금 열어 둔 건을 쓰고 싶을 때 알맞습니다. 처음에는 여기서 시작하면 이해하기 쉽습니다.

다만 손에 있는 것이 그대로 보이는 만큼, 어떤 건을 열어 두고 있는지는 스스로도 확인해야 합니다. 다른 건의 폴더를 열어 둔 채 시작하면, 기본 생각이 어긋납니다.

클라우드

바깥 작업 장소에서, 내 자리와 따로 진행합니다. 내 컴퓨터를 닫아도 이어서 하기 쉬운 점이 장점입니다. 시간이 걸리는 확인이나, 나중에 다시 보고 싶은 작업에 잘 맞습니다.

한편으로는 내 자리와 다른 곳이기 때문에, "지금 वहाँ에 무엇이 놓여 있는가"를 의식하지 않으면 헷갈리기 쉬워집니다. 처음에는 로컬에 익숙해진 뒤 사용하면 혼란이 덜합니다.

워크트리

같은 건의 작업용 복사본을 나눠서, 나란히 진행합니다. 예를 들어, 실제로 쓰고 있는 것을 건드리지 않고 다른 안을 시험해 보고 싶을 때 도움이 됩니다.

가깝게 말하면, 원래 자료를 남겨 둔 채로 "수정본 1" "수정본 2"를 나눠 만드는 느낌입니다. 여러 수정안을 비교하고 싶을 때 편리하지만, 처음에는 "다른 작업 복사본"이라고 기억하면 충분합니다.

건은 목록에서 연다

왼쪽 목록이 출발점

먼저 건을 고른 뒤 대화를 시작한다

왼쪽 목록에는 지금까지 다룬 건들이 나옵니다. 이곳을 건너뛰고 갑자기 말을 시작하면, 어떤 일 이야기인지 흐려지기 쉽습니다. 먼저 건을 고르고, 그 건 안에서 대화를 시작합니다. 이 순서가 기본입니다.

새로 시작하는 일이라면, 새 건을 만들어 나누는 편이 안전합니다. 이전 건의 자료나 대화가 섞이면, Codex도 사람과 마찬가지로 착각하기 쉬워집니다. 조금 번거로워도 출발점을 맞춰 두는 편이 나중에 더 편합니다.

• 왼쪽 목록이 출발점입니다. 헷갈리면 지금 열려 있는 건 이름을 다시 확인해 보세요.

대화 나누는 법

긴 주고받음을 막는다

하나의 대화에 하나의 일

여기는 아주 중요합니다. 하나의 대화 안에 다른 일을 계속 넣지 마세요. 처음에는 "제목을 고치는 이야기"를 하고 있었는데, 중간에 "다른 페이지 확인"이나 "설명문 고쳐 쓰기"까지 섞으면, 앞의 조건과 새 조건이 얽히게 됩니다.

예를 들어, "안내문 초안"과 "견적 안내 문구 고치기"는 둘 다 글 작업이지만, 목적도 읽는 사람도 다릅니다. 그래서 대화도 나눕니다. 새로 들어온 사람에게 일을 부탁할 때도, 한 번에 다른 일을 섞으면 헷갈리기 쉬운 것과 같습니다.

• 일마다 대화를 나누면, 이야기가 섞이지 않습니다.
• 앱을 닫아도 대화가 남기 쉬워서, 나중에 이어 하기 쉽습니다.

부탁하는 틀

결과가 흔들리지 않게 하는 4가지 점입니다. 여기서 말하는 결과란, 돌아오는 초안이나 제안, 수정 내용 같은 것을 뜻합니다. 부탁하는 말은 길다고 좋은 것이 아닙니다. 중요한 것은, 필요한 점만 빠지지 않게 전하는 것입니다.

잘되지 않는 부탁은, "알아서 보기 좋게 정리해 둬"처럼 목적도 조건도 끝나는 모양도 흐린 경우가 많습니다. 반대로 짧아도 핵심이 갖춰져 있으면 꽤 안정적입니다.

요청문은 4가지만

어렵게 쓰지 않는다

부탁하는 문장은 긴 글로 쓰지 않아도 괜찮습니다. 다음 4가지를 순서대로 두면 충분합니다. 사내에서 일을 넘길 때 적는 메모와 비슷한 형태입니다.

• 목적

  무엇을 만들지 먼저 말합니다. 예를 들어 "안내문 초안을 만든다" "지금 있는 설명을 쉽게 고친다"처럼, 도착할 지점을 먼저 보여 줍니다.

• 실마리

  봐야 할 자료나 장소를 알려 줍니다. "이 폴더의 자료를 본다" "지난번 문안을 참고한다" 같은 정보입니다. 실마리가 없으면 엉뚱한 곳을 보러 갑니다.

• 지켜야 할 조건

  빼면 안 되는 규칙이나 기본 조건을 적습니다. "단정하는 말은 피한다" "어려운 말을 쓰지 않는다" "삭제는 하지 않는다" 같은 것입니다. 이 부분을 빼면, 결과가 좋아 보여도 쓸 수 없을 때가 있습니다.

• 끝나는 모습

  무엇이 되면 끝인지 미리 정합니다. "제목과 본문을 고친 안을 1개 낸다" "바뀐 점을 글머리표로 덧붙인다" 같은 것입니다. 끝나는 방식이 정해져 있으면 쓸데없는 작업이 줄어듭니다.

먼저 계획만

Plan 모드

먼저 순서를 내보내게 한다

조금 큰 일은, 갑자기 만들기 시작하게 하지 않는 편이 안전합니다. 먼저 "무엇을 어떤 순서로 진행할지"만 내보내 달라고 합니다. 이것이 Plan 모드입니다. 요리로 말하면, 갑자기 불을 켜기 전에 재료와 순서를 늘어놓는 단계입니다.

계획만 먼저 보면, 착각을 이른 단계에서 찾을 수 있습니다. "그 자료는 볼 필요 없다" "먼저 보이는 모습이 아니라 문장을 고쳐 줬으면 한다" 같은 방향 수정이, 아직 가벼울 때 가능합니다. 큰 일일수록 이 한 번이 도움이 됩니다.

• 갑자기 만들게 하지 말고, 먼저 순서를 늘어놓게 하면 안심됩니다.
• 큰 일일수록, 이 한 번으로 실패가 줄어듭니다.

작게 시험해 본다

Codex를 한 번 움직여 보기

먼저 작은 부탁으로 움직이는 모습을 본다

실제 일을 시작하기 전에, 한 번만 작게 시험해 보세요. 예를 들어 "이 자료의 핵심을 세 가지로 정리해 줘" "이 한 문단만 쉽게 고쳐 줘" 같은 짧은 부탁입니다. 여기서 보는 것은, 똑똑함 겨루기가 아니라 당신의 일과 잘 맞는지입니다.

시험할 때는, 답의 내용뿐 아니라 어디를 보고 어떤 확인을 하는지도 봅니다. 필요한 자료가 부족할 때 질문해 오는지. 제멋대로 단정하고 진행하지는 않는지. 그런 버릇을 알면, 다음 부탁하는 방식을 조정하기 쉬워집니다.

• Codex를 한 번 움직여 보고, 움직이는 방식과 답하는 방식을 먼저 확인해 둡니다.

생각하게 하는 정도는 너무 세지 않게

먼저 중간 정도

생각하는 힘을 늘 최대로 하면 된다는 뜻은 아닙니다. 작은 수정을 하는데 무거운 생각 방식을 쓰면, 시간이 걸리거나 필요 이상으로 이야기가 커질 수 있습니다. 먼저 중간 정도를 기본으로 해 주세요.

• 평소에는 중간 정도

  가벼운 수정이나 확인이라면, 이것으로 충분한 경우가 많습니다. 헷갈릴 때의 기준입니다.

• 깊게 생각하게 하기

  복잡한 문제나 큰 변경일 때만 사용합니다. 따져야 할 조건이 많은 일일수록 잘 맞습니다.

• 속도를 우선하기

  급한 작은 일을 할 때 나눠 씁니다. 다만 놓치기 쉬워지므로, 마지막 다시 보기는 직접 합니다.

정리해서 더 단단하게

매번 설명을 줄이고, 안전하게 쓰기 위한 이야기입니다. 처음 쓸 때의 실패는, 많은 경우 "같은 말을 매번 입력한다" "건드려도 되는 범위가 흐리다" 두 가지에서 생깁니다. 이 부분을 정리해 두면, 부탁할 때마다 더 편해집니다.

사람에게 일을 맡길 때도, 처음에 공통 규칙을 적은 인수인계 문서가 있으면 편합니다. 같은 생각입니다.

같은 주의점은 미리 적어 둔다

agents.md

매번 말할 것은 먼저 두기

agents.md(매번의 주의점을 적어 두는 메모)는 공통 규칙을 두는 곳입니다. 쓰는 방식의 규칙, 피하고 싶은 말투, 마음대로 삭제하지 않았으면 하는 것처럼, 여러 번 전하게 되는 내용을 먼저 모아 둡니다.

예를 들어, "어려운 말은 쓰지 않는다" "원래 뜻을 바꾸지 않는다" "새 안을 내기 전에 지금 내용을 먼저 요약한다" 같은 방침입니다. 이것이 있으면, 대화할 때마다 같은 설명을 입력하지 않아도 됩니다. 다만 그 일에만 있는 특별한 조건은, 대화 안에서 한 번 더 전하는 편이 안전합니다.

• 만드는 규칙이나, 하지 않았으면 하는 일을 적습니다.
• 같은 지시를 매번 입력하지 않아도 됩니다.

안전 설정은 3단계

처음에는 세게 열지 않는다

처음에는, "무엇이든 자유롭게 해도 된다"는 상태로 두지 마세요. 익숙하지 않을수록, 확인하는 수고보다 안전을 먼저 생각합니다. 먼저 보여 주기만 하고, 어떻게 고치는지 본 뒤에 조금씩 맡기는 범위를 넓힙니다.

• 보기만

  먼저 내용 확인에 사용합니다. 읽고 제안만 하게 하는 단계입니다. 처음은 여기서 시작하는 것이 안심됩니다.

• 쓰기 가능

  수정까지 맡기고 싶을 때 사용합니다. 제안이 안정되기 시작하면, 이 단계로 넘어갑니다.

• 전체 허용

  할 수 있는 일이 늘어나는 만큼, 뜻밖의 변경도 생기기 쉬워집니다. 익숙해지기 전까지는 자주 쓰지 않는 편이 안전합니다.

보이는 모습은 그 자리에서 확인한다

내장 브라우저

글뿐 아니라, 보이는 모습도 그 자리에서 확인한다

글을 고치는 일은, 글만 읽어서는 부족합니다. 제목이 너무 길어서 줄이 바뀌지 않는지, 버튼 위치가 어긋나지 않는지, 읽기 쉬움이 유지되고 있는지는 실제 보이는 모습으로 확인해야 합니다. 내장 브라우저는 그 확인을 그 자리에서 쉽게 하기 위한 화면입니다.

특히 화면에 나오는 안내문이나 설명문은, 문장 자체는 맞아도 보이는 모습으로는 읽기 어려울 수 있습니다. 글자만 보고 만족하지 말고, 반드시 한 번은 화면에서 확인해 보세요.

• 내장 브라우저로, 고친 뒤 어떻게 보이는지까지 확인합니다.

수정은 차이로 본다

GitHub

GitHub(바뀐 점을 비교해 보기 쉬운 곳)에서는, 어디가 고쳐졌는지 차이로 봅니다. 차이란, 바뀐 부분만 뽑아서 비교하는 방식입니다. 전체를 다시 읽는 것보다, 어디를 건드렸는지 알아보기 쉬워집니다.

이 화면에서는, 늘어난 줄뿐 아니라 사라진 줄에도 눈을 두세요. 부탁하지 않은 곳까지 바뀌지 않았는지, 관계없는 삭제가 들어가 있지 않은지 보기 위해서입니다.

그림에서는, 변경된 곳의 묶음과 파일 목록을 봐 주세요. 고쳐 달라고 했던 곳만 바뀌었는지, 불필요한 변경이 섞이지 않았는지 확인하는 것이 중요합니다.

자동화는 나중으로

n8n

n8n(작업을 이어 붙여 자동으로 돌리는 도구) 같은 자동화는 편리해 보입니다. 하지만 처음부터 거기로 가면, 왜 잘되지 않는지 이유를 알기 어려워지기 쉽습니다. 먼저 손으로 한 번씩 돌려 보면서, "어떻게 부탁하면 좋은지" "어디에서 확인이 필요한지"를 먼저 굳히는 편이 좋습니다.

자동화는, 매번 하는 흐름이 안정된 뒤면 충분합니다. 일의 모양이 아직 정해지지 않았는데 자동화하면, 잘못된 흐름을 그대로 반복하게 됩니다.

그림에서는, 작업이 화살표로 이어지는 모습을 봐 주세요. 보기에는 이해하기 쉬워도, 중간 확인을 건너뛰기 쉬우므로 처음에는 "구조를 만든다"보다 "올바른 순서를 정한다"를 먼저 생각합니다.

정리

처음의 실패를 줄이는 사용법은, 어려운 설정보다 작업을 나누는 방식에서 결정됩니다. 내일 할 일은 많지 않습니다. 먼저 작게 시작하고, 확인하면서 넓혀 가면 괜찮습니다.

• 처음에 작업 장소를 고른다
• 대화는 일 하나마다 나눈다
• 요청문은 4가지로 맞춘다
• 큰 일은 Plan부터 시작한다
• 안전 설정과 다시 보기를 먼저 정리한다

마지막으로

AI図書館

팔로우와 좋아요 부탁드립니다

AI를 일에 쓰는 이야기를, 쉽게 하나씩 올리고 있습니다. 어려운 말을 외우는 것보다, 내일 어떻게 움직일지가 보이는 것을 더 중요하게 생각합니다.

• AI를 일에 쓰는 이야기를, 쉽게 하나씩 올리고 있습니다.
• 다음 편도 여기서 만나요.