비개발자를 위한 코딩 에이전트 첫 과제 다섯 가지

🤔 코딩 에이전트를 설치했는데 무엇부터 시킬지 모를 때

클로드 코드나 코덱스를 설치하고 나면 빈 입력창 앞에서 멈추는 경우가 많습니다. 소개 글에는 앱을 만들고 버그를 고치는 예시가 가득한데, 코드를 쓰지 않는 사람에게는 당장 맡길 일이 떠오르지 않기 때문입니다.

코딩 에이전트가 하는 일은 결국 폴더 안의 파일을 읽고, 만들고, 고치고, 명령을 실행하는 것이라서 코드가 아니어도 파일로 끝나는 일이면 맡길 수 있습니다. 지금부터 비개발자가 처음 맡기기 좋은 과제 다섯 가지를 쉬운 것부터 정리하고, 과제마다 요청 문장과 확인할 점을 붙입니다. 요청 문장은 가상의 예시입니다.

🔑 첫 과제를 고르는 기준

비개발자가 코딩 에이전트에게 처음 맡기기 좋은 과제는 결과를 눈으로 확인할 수 있고, 원본을 되돌릴 수 있으며, 결과가 밖으로 나가지 않는 일입니다.

• 눈으로 확인할 수 있는 일: 결과 파일을 열어 보면 맞는지 틀리는지 바로 압니다
• 되돌릴 수 있는 일: 원본이 남아 있거나 Git 기록이 있어서 틀리면 처음으로 돌아갑니다
• 밖으로 나가지 않는 일: 메일 발송, 결제, 배포처럼 다른 사람에게 닿는 일은 뒤로 미룹니다

처음 몇 번은 결과물보다 에이전트가 요청을 어떻게 이해하는지 보는 것이 목적입니다. 그래서 아래 다섯 가지는 결과가 밖으로 나가는 정도가 작은 순서로 놓았습니다. 어떤 도구를 쓰든 권한은 좁게 시작하는 편이 안전하고, 그 이유는 코딩 에이전트 권한과 안전에 정리했습니다.

1️⃣ 다운로드 폴더 정리

가장 먼저 해 볼 만한 일은 어지러운 폴더를 정리하는 것입니다. 파일을 옮기기만 하고 지우지 않으면 잘못돼도 다시 옮기면 됩니다.

• 확인할 것: 에이전트가 보여 준 계획 표를 먼저 읽고, 옮긴 뒤 파일 개수가 그대로인지 봅니다
• 요청의 요점: "계획을 먼저 보여 줘"와 "지우지 마"를 함께 적습니다

2️⃣ 여러 파일을 합친 표 만들기

달마다 내려받은 매출 파일이나 설문 결과처럼 같은 형식의 파일 여러 개를 하나의 표로 합치는 일입니다. 원본은 그대로 두고 새 파일을 만들게 하면 되돌릴 걱정이 없습니다.

• 확인할 것: 에이전트가 알려 준 행 수가 원본 파일들의 행 수 합과 맞는지, 월별 합계 몇 개를 원본과 직접 대조합니다
• 요청의 요점: 검산할 숫자를 함께 달라고 하면 확인이 쉬워집니다

3️⃣ 폴더 속 문서 읽고 요약 표 만들기

회의록이나 보고서 여러 개를 읽고 핵심만 표로 정리하는 일입니다. 에이전트는 폴더 안의 파일을 직접 열어 읽으므로 대화창에 내용을 하나씩 붙여 넣을 필요가 없습니다.

• 확인할 것: 표의 항목 몇 개를 골라 원래 회의록에서 그 문장을 찾아봅니다
• 요청의 요점: "추측하지 말고 빈칸으로"를 적어 두면 없는 내용을 지어내는 일이 줄어듭니다

4️⃣ 간단한 웹 페이지 만들기

이제 코드가 등장합니다. 자기소개나 행사 안내처럼 한 장짜리 웹 페이지를 만들어 달라고 하면, 에이전트는 HTML 파일을 만들고 필요하면 스타일 파일도 붙입니다. 결과는 내 컴퓨터 브라우저에서 열어 보면 되고, 아직 인터넷에 올린 것이 아니라 밖으로 나가지 않습니다.

• 확인할 것: 브라우저에서 열고 창 크기를 줄여 휴대폰 화면처럼 보이는지 봅니다
• 요청의 요점: 고칠 점은 "제목을 더 크게"처럼 눈에 보이는 말로 요청합니다. 코드를 몰라도 됩니다

5️⃣ 블로그 글 배포

마지막은 결과가 인터넷에 올라가는 일입니다. 마크다운 파일로 글을 관리하는 블로그라면, 에이전트에게 글 파일을 만들게 하고 Git에 기록한 뒤 저장소에 올리는 데까지 맡길 수 있습니다. 저장소에 올리면 자동으로 사이트에 반영되도록 설정된 블로그라면 여기서 배포가 일어납니다.

• 확인할 것: 미리 보기 화면에서 글이 제대로 보이는지, 바뀐 파일 목록에 의도하지 않은 파일이 없는지 봅니다
• 요청의 요점: 배포로 이어지는 git push는 마지막에 사람이 확인하고 허락합니다

블로그를 처음부터 만들고 운영한 전 과정은 준이아빠블로그의 클로드 코드로 블로그 만들기, 쉽게 풀어쓴 버전에 있습니다.

✍️ 다섯 가지 과제에 공통으로 넣는 네 가지

위 요청 문장들은 모두 같은 뼈대를 따릅니다.

1. 대상: 어느 폴더, 어떤 파일인지
2. 결과물: 무엇을 만들지, 어떤 열과 항목이 필요한지
3. 저장 위치: 새 파일 이름과 위치
4. 하지 말 것: 원본 수정, 삭제, 발송, 배포처럼 멈춰야 할 일

네 가지 가운데 하나라도 빠지면 에이전트는 빈 곳을 스스로 채웁니다. 그 추측이 맞을 때도 있지만, 처음에는 틀린 추측이 어디서 나오는지 보기 위해서라도 네 가지를 다 적는 편이 낫습니다.

🔁 결과가 틀렸을 때 다시 요청하는 방법

처음 몇 번은 결과가 기대와 다르게 나오는 것이 자연스럽고, 요청 문장을 몇 번 고쳐 쓰다 보면 에이전트가 어디서 잘못 이해하는지 감이 옵니다. 이때 "다시 해 줘"라고만 하면 에이전트는 무엇이 틀렸는지 몰라 같은 실수를 되풀이하기 쉽습니다.

• 틀린 곳을 정확히 적습니다: "summary.csv의 3월 합계가 원본과 12,000원 다릅니다. 3월 파일을 다시 읽고 원인을 알려 줘"처럼 어느 파일의 어느 값인지 적습니다
• 원인부터 묻습니다: 바로 고치게 하기 전에 왜 그렇게 됐는지 설명을 먼저 들으면, 요청 문장에서 빠진 조건이 보입니다
• 처음으로 돌립니다: 결과가 많이 어긋났다면 Git 기록이나 원본 사본으로 되돌린 뒤 요청 문장을 고쳐 새로 시킵니다
• 대화를 새로 엽니다: 다른 과제로 넘어갈 때는 새 대화에서 시작합니다. 앞 과제의 내용이 섞이지 않고 사용량도 덜 듭니다

틀린 결과에서 빠진 조건을 찾아 요청 문장에 더해 두면, 다음에 비슷한 일을 시킬 때 그 문장을 그대로 다시 쓸 수 있습니다. 자주 쓰는 요청은 파일로 모아 두면 편합니다.

⚠️ 자주 하는 실수

• 홈 폴더 전체에서 에이전트를 시작합니다: 작업할 폴더 하나만 열어야 에이전트가 다른 파일을 건드리지 않습니다
• 한 번에 여러 과제를 섞어 요청합니다: "정리하고 표도 만들고 배포도 해 줘"보다 하나씩 끝내고 확인하는 편이 틀린 곳을 찾기 쉽습니다
• 결과를 열어 보지 않고 다음으로 넘어갑니다: 에이전트의 "완료했습니다"는 결과가 맞다는 뜻이 아닙니다
• 개인정보가 든 파일을 그대로 맡깁니다: 에이전트가 읽은 내용은 모델 제공 회사로 전송됩니다. 고객 명단 같은 파일은 이름과 연락처를 지운 사본으로 연습합니다

❓ 자주 묻는 질문

어떤 코딩 에이전트로 해도 같은 결과가 나오나요?

다섯 가지 과제는 클로드 코드, 코덱스 CLI, 안티그래비티 어느 쪽으로도 할 수 있습니다. 다만 같은 요청이라도 도구와 모델에 따라 결과가 조금씩 다르므로, 한 도구로 익숙해진 뒤 다른 도구와 비교해 보는 순서가 편합니다. 도구 고르는 법은 코딩 에이전트 고르는 기준에 있습니다.

엑셀 파일도 읽을 수 있나요?

읽을 수 있는 경우가 많습니다. 코딩 에이전트는 엑셀 파일을 읽는 데 필요한 프로그램을 설치하자고 제안하거나 CSV로 바꿔서 처리하곤 합니다. 설치 명령을 실행해도 되는지 물어보면 무엇을 설치하려는지 확인한 뒤 허락합니다.

이런 과제를 하루에 몇 번이나 시킬 수 있나요?

요금제의 한도에 따라 다릅니다. 파일 정리나 표 만들기는 짧게 끝나는 편이지만, 웹 페이지를 여러 번 고치는 일은 대화가 길어져 사용량이 빨리 늘어납니다. 요금제별 한도 방식은 코딩 에이전트 요금과 한도 비교에 정리했습니다.

요청을 영어로 해야 결과가 좋나요?

한국어로 요청해도 됩니다. 파일 이름과 폴더 이름은 영문으로 두면 명령을 실행할 때 오류가 덜 납니다.

📋 3줄 요약

1. 비개발자가 코딩 에이전트에게 처음 맡기기 좋은 과제는 결과를 눈으로 확인할 수 있고, 원본을 되돌릴 수 있으며, 밖으로 나가지 않는 일입니다.

2. 파일 정리와 여러 파일을 합친 표 만들기, 문서 요약, 웹 페이지 만들기, 블로그 글 배포 순으로 결과가 밖으로 나가는 정도가 커집니다.

3. 요청에는 대상 폴더와 만들 결과물, 저장 위치, 하지 말아야 할 일을 적고 원본 삭제와 배포 전에는 확인을 받도록 합니다.