본문으로 건너뛰기

권한이 없다고 헤매긴 했지만 어쨌든 완수한 1주차..

한영지

2026.10.06

권한이 없다고 헤매긴 했지만 어쨌든 완수한 1주차.. 본문 이미지

# 코덱스와 깃허브로 생활 비서 마루의 첫 작업공간 만들기

코덱스(Codex)로 생활 비서 마루의 시작 파일 5개를 만들고 깃허브(GitHub)에 올렸습니다. 2026년 10월 6일, 처음 해본 작업에서 오류를 해결해 첫 커밋과 푸시까지 마쳤어요.

## 일정과 준비물부터 정하기

마루의 첫 기능은 메신저 공지에서 일정과 준비물을 짧게 정리하는 것입니다. 지피터스 24기 생활형 AI비서 멤버예요. AI를 막 배우는 중이라, 수업자료를 따라 생활 속 작은 불편 하나를 정하는 것부터 시작했습니다.

처음부터 큰 자동화를 만들려는 작업은 아니었습니다. 이번 주에 시험할 작은 기능을 정의하고, 코드를 잘 몰라도 읽고 고칠 수 있는 한국어 파일을 만드는 것이 목표였어요. 처음 보낸 요청의 첫 문장은 이렇습니다.

```text

먼저 짧은 인터뷰를 진행한 뒤, 내 생활에서 반복되는 불편 하나를 줄이는 AI비서의 첫 작업공간을 만들어줘.

```

요청에는 기존 파일 보존, 개인정보 저장 금지, 외부 서비스 연결 금지 같은 조건도 붙였습니다. 무엇을 만들지 묻는 인터뷰에서 저는 이렇게 답했습니다.

```text

일정과 준비물 정리하기. 나.

```

비서를 쓸 사람은 저 혼자입니다. 입력은 개인정보를 뺀 메신저 공지 글, 결과는 날짜·시간, 할 일, 준비물, 확인할 점의 짧은 목록으로 정했어요. 선택 버튼이 자꾸 사라져서 채팅으로 추천 설정을 확인하는 방식으로 바꿨습니다.

## 마루의 말투와 권한 정하기

비서 이름은 제가 직접 마루로 정했습니다. 생활 속 작은 일을 챙겨주는 다정한 비서이되, 친근하고 과장 없이 핵심만 짧게 알려주는 말투를 골랐어요.

예시 입력은 가상 공지입니다. “이번 토요일 오전 10시 모임입니다. 물과 필기구를 챙겨주세요.”라는 글을 주면 일정과 준비물을 나눠 정리하도록 했습니다. 공지 작성일이 없으면 ‘이번 토요일’을 임의의 날짜로 바꾸지 않고, 정확한 날짜는 확인이 필요하다고 표시하는 기준도 넣었습니다.

이것은 파일에 적은 응답 예시입니다. 실제 공지로 테스트해 얻은 결과는 아직 아닙니다. 입력에 없는 장소나 추가 준비물을 마음대로 채우지 않도록 하고, 최종 결과는 제가 원문과 비교해 확인하기로 했어요.

권한도 작게 정했습니다. 제공한 글만 정리하고, 일정 등록이나 알림 예약, 메시지 발송, 구매, 외부 전송은 맡기지 않습니다. 비밀번호와 인증값, 정확한 주소, 가족이나 고객의 실명, 원본 금융정보도 요청하거나 저장하지 않는 기준을 세웠습니다.

AI 채팅에 실제 공지를 붙여 넣는 행위 자체가 자료 전송이라는 설명도 문서에 남겼습니다. 그래서 첫 테스트는 가상 공지로 시작하고, 실제 공지를 쓸 때는 개인정보를 먼저 지우도록 했어요.

## 코덱스로 시작 파일 5개 만들기

마루의 시작 파일은 문서 4개와 Git 제외 목록 1개입니다. 처음 폴더에는 빈 작업 폴더만 있었고, 기존 문서나 AGENTS.md는 없다고 확인한 뒤 만들었습니다. 인터뷰 내용을 요약받고 제가 확인한 다음 파일 생성으로 넘어갔어요.

- README.md: 해결할 문제, 이번 주 성공 기준, 입력과 결과 예시, 다음 행동

- assistant-soul.md: 마루의 역할, 말투, 확인 기준, 하지 않을 일

- idea-seed.md: 첫 기능 후보와 가장 작은 테스트 방법

- privacy-boundaries.md: 자료 사용·보관·전송의 경계

- .gitignore: 인증 파일, 개인 원본 자료, 임시 작업 파일 등의 Git 제외 규칙

파일 수 5개는 실제 생성 목록과 첫 커밋 출력에서 확인했습니다. 이번 주의 작은 성공 기준은 개인정보를 뺀 공지 3개를 하나씩 넣고, 일정과 준비물을 빠뜨리거나 없는 사실을 추가하지 않는지 확인하는 것으로 정했어요.

여러 공지를 묶는 기능은 나중에 검토할 후보로만 남겼습니다. 첫 기능도 자동 프로그램으로 구현된 것은 아닙니다. 현재 가능한 일과 앞으로 할 일을 구분해 적은 점이 이 작업공간의 기준이 됐습니다.

## 첫 커밋에서 계속 막힌 이유

파일을 만든 다음에는 수업자료처럼 코덱스에 커밋과 푸시를 부탁했습니다. 그런데 실행 환경에서 Git 폴더에 임시 파일을 만드는 권한이 거부됐고, 깃허브 연결도 실패했습니다.

처음에는 앱에 포함된 Git에 HTTPS 전송 구성요소가 없다는 안내를 받았습니다. 정식 Git 설치 여부를 확인하자는 말도 나왔지만, 저는 이미 설치한 상태였어요. 설치된 Git이 확인된 뒤에도 권한 오류는 남았습니다.

그 과정에서 제가 보낸 말입니다.

```text

학습자료에는 powershell 이런 말 안나오는디

```

수업자료는 코덱스에 자연어로 부탁하라고 했는데, 실제 진행에서는 직접 명령을 입력하는 안내가 나왔기 때문입니다. 전체 액세스를 켜고 재시작한 뒤 다시 시도했지만 같은 오류가 이어졌습니다. 새 채팅을 권하는 안내도 받았으나, 그것으로 해결됐다는 확인은 없었습니다.

이후 확인받은 내용은 명령이 샌드박스 계정에서 실행되고, Git 폴더에는 그 계정의 쓰기를 거부하는 규칙이 있다는 것이었습니다. 이 작업에서는 해당 제한을 해제하는 데 성공하지 못했습니다. 대신 제 사용자 계정의 터미널에서 직접 진행하는 방법으로 옮겼어요.

## 깃허브에 첫 푸시 성공

윈도우 파워셸(Windows PowerShell)에서 첫 명령을 작업 폴더 밖에서 실행해 저장소를 찾지 못했습니다. 마루 파일이 있는 폴더로 이동한 다음에는 저장소 소유자와 실행 계정이 다르다는 오류가 나왔어요.

그 폴더 하나를 신뢰하는 저장소로 등록하고 파일을 다시 추가했습니다. 상태 확인 화면에는 파일 5개 앞에 A가 표시됐습니다. 이어서 커밋을 시도하자 이번에는 작성자 정보가 설정되지 않았다는 오류가 나왔습니다.

작성자 이름과 개인 이메일을 대신할 주소를 이 저장소에만 설정한 뒤, 첫 커밋을 다시 실행했습니다. 커밋 결과는 다음과 같았습니다.

```text

[master (root-commit) 33b44f1] 마루 생활 비서의 첫 작업공간 문서 추가

5 files changed, 185 insertions(+)

```

그다음 원격 저장소를 연결하고 푸시를 실행했습니다. 브라우저에서 직접 인증을 마친 뒤 터미널에 성공 출력이 나타났어요. 개인정보와 저장소 주소는 빼고 성공을 확인한 두 줄만 옮겼습니다.

```text

* [new branch] master -> master

branch 'master' set up to track 'origin/master'.

```

깃허브 파일 목록과 README를 열 수 있는지도 확인했습니다. 앱 안의 브라우저에서는 처음에 404가 보여 로그인 상태를 확인하라는 안내를 받았고, 이후 저장소 화면을 열었다고 확인했습니다. 저장소는 비공개로 보관했으며, 글에는 로그인해야 열리는 주소를 넣지 않았습니다.

## 완료한 것과 아직 남은 것

현재 결과물은 마루의 역할과 테스트 기준을 담은 시작 파일 5개, 첫 커밋, 비공개 깃허브 저장소입니다. README에서 입력 예시와 다음 행동을 읽을 수 있고, assistant-soul.md에는 일정과 준비물을 어떻게 정리할지, 어디까지 맡길지가 적혀 있습니다.

이번 작업에서 처음 해본 것은 파일 만들기부터 커밋과 푸시까지의 과정입니다. 작업 시간이나 비용은 따로 측정하지 않았습니다. 공지를 정리하는 시간이 얼마나 줄었는지도 아직 확인하지 않았어요.

헤르메스 데스크톱(Hermes Desktop)은 설치했다고 확인했습니다. 수업자료를 다시 보니 과제에는 저장소 화면 캡처, assistant-soul.md 초안, 해결할 생활 문제 한 가지, 헤르메스 설치 완료 화면 캡처가 포함되어 있었습니다. 실습 완료와 과제 제출 준비를 따로 확인해야 했습니다.

일정과 준비물을 자동으로 정리하는 프로그램, 알림, 일정 등록, 외부 서비스 연결은 아직 없습니다. 공지 3개로 정리 방식을 시험하는 일도 남아 있습니다. 이번에는 비서의 첫 작업공간을 만들고 기록을 저장하는 데까지 완료했습니다.

## 같은 작업을 시작할 때 보낼 말

작은 기능을 정하고 파일을 만들려면 생활 속 불편 하나와 권한 경계를 함께 말하면 됩니다. 아래는 이번 요청을 바탕으로 짧게 다듬은 시작 문장입니다.

```text

먼저 짧게 인터뷰하고, [반복되는 생활 불편]을 줄일 비서의 첫 작업공간을 만들어줘.

이번 주에 시험할 작은 기능 하나만 정해줘.

기존 파일은 보존하고, 개인정보나 인증값은 저장하지 마.

외부 연결이나 발송은 하지 말고, 사람이 확인할 일을 적어줘.

실제로 완료한 일과 앞으로 할 일을 구분해 쉬운 한국어로 작성해줘.

```

이번에는 오류 화면을 보내고, 다음 안내를 실행하고, 결과를 다시 확인하는 방식으로 첫 푸시까지 갔습니다. 다음 확인 대상은 가상 공지를 넣었을 때 마루가 일정과 준비물을 빠뜨리지 않고 정리하는지입니다.

1

함께 이야기해요 1

로그인하고 댓글을 남겨 주세요

Wonny 프로필 이미지
Wonny2026.10.07

영지님 안녕하세요-! 청강이시지만 잘 따라오신 것 같습니다-!

오류가 발생하면 발생한 화면을 캡쳐해서 코덱스에 던져주면 코덱스가 원인을 더 잘 파악할 수 있어요-!

오류가 발생했지만 계속 시도해서 커밋까지 성공하신 것 축하드립니다! ㅎㅎㅎㅎ

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기