PC 앞에 없어도 개발할 수 있을까? 스마트폰으로 Codex에 지시하여 GitHub를 통해 반영하는 방법

저는 기계지능 연구실에 소속되어 CV(Computer Vision) 분야의 연구를 수행하고 있습니다. 기계지능 연구실에서는 로봇의 시각 기능이나, 자율적으로 행동하기 위한 지능 시스템에 관한 연구가 진행되고 있습니다.

연구실에 대한 자세한 내용은 아래를 참조해 주세요.

또한, 이전에 논문 조사부터 집필, 연구 관리까지 사용할 수 있는 AI 도구를 정리한 기사도 게시했습니다.

연구 활동에서의 AI 활용 및 효율화에 관심이 있는 분들은 함께 확인해 주시기 바랍니다.

최근 ChatGPT나 Codex를 이용한 개발 지원이 진전되면서, PC 앞에 없는 시간에도 스마트폰으로 개발 태스크를 확인하고 지시할 수 있는 환경이 갖춰지고 있습니다.

한편, 스마트폰에서 PC를 직접 조작하는 듯한 「리모트 컨트롤형」 방식은 편리한 반면, PC의 부팅 상태나 OS, 권한 관리에 의존하게 됩니다. 따라서 본 기사에서는 스마트폰에서 Codex에 지시를 내리고, GitHub를 중계점으로 삼아 PC 측에 변경 사항을 반영하는 워크플로우를 소개합니다.

이 방법에서는 스마트폰을 「사령탑」으로 사용하면서 실제 코드 변경은 GitHub 상에서 관리하고, PC 측에서는 git pull을 통해 안전하게 반영할 수 있습니다.

※ git pull은 스마트폰에서 원격으로 수행하지 않습니다.

본 워크플로우에서는 스마트폰과 PC를 직접 연결하는 것이 아니라, GitHub를 공유 작업 공간으로 이용합니다.

스마트폰 (지시·확인)
↓
Codex (조사·수정안 작성)
...

이 구성의 장점은 AI에게 PC 환경을 직접 조작하게 하는 것이 아니라, GitHub 상의 차이점(diff)을 확인한 후 PC에 도입할 수 있다는 점입니다. 그렇기 때문에 의도하지 않은 변경을 그대로 PC 환경에 반영해 버리는 리스크를 억제할 수 있습니다.

위 그림과 같이, 스마트폰에서 Codex로 지시를 내리고, Codex가 GitHub 상의 리포지토리(Repository)를 확인·수정하며, 마지막에 PC 측에서 git pull을 하여 반영하는 흐름이 됩니다.

본 기사의 워크플로우에 필요한 것은 다음과 같습니다.

• Codex를 이용할 수 있는 ChatGPT 계정
• ChatGPT 모바일 앱
• GitHub 계정
• GitHub 리포지토리
• PC 측 환경
• Git을 사용할 수 있는 상태
• VS Code 등의 에디터
• 필요에 따라 Python이나 Node.js 등의 실행 환경

특히 중요한 것은 작업 대상 코드를 GitHub 리포지토리에 두는 것입니다. Codex가 리포지토리를 읽도록 함으로써, 스마트폰에서도 코드베이스 전체를 고려한 지시를 내리기 쉬워집니다.

먼저, PC 측에서 작성 중인 프로젝트를 GitHub에 push합니다. Codex는 PC 내의 로컬 파일을 직접 보는 것이 아니라, GitHub 상의 리포지토리를 참조하여 작업하기 때문입니다.

git add .
git commit -m "mobile codex workflow setup"
git push

이 시점에서 작업 대상 코드가 GitHub 상에 배치되어, Codex가 참조할 수 있는 준비가 완료됩니다.

다음으로, ChatGPT 또는 Codex 화면에서 GitHub 계정을 연결하고 대상 리포지토리에 대한 액세스 권한을 허용합니다.

Codex 화면에서는 작업 대상으로 삼을 GitHub 리포지토리나 브랜치(Branch)를 선택할 수 있습니다.

GitHub 연동이 완료되면, 스마트폰의 ChatGPT 앱에서 Codex에 지시를 내립니다.

처음에는 갑자기 파일을 수정하게 하기보다, 프로젝트 구성 확인부터 시작하는 것이 안전합니다.

이 리포지토리 전체를 확인하고, 프로젝트 개요, 주요 파일, 실행 절차를 일본어로 정리해 주세요.
이 단계에서는 아직 파일을 변경하지 마세요.

이렇게 지시함으로써 Codex가 리포지토리 구성을 파악하고, 어떤 파일을 변경해야 할지 정리할 수 있습니다.

프로젝트 구성을 확인했다면, 실제로 수정을 의뢰합니다.

예를 들어, README를 정비하고 싶다면 다음과 같이 의뢰할 수 있습니다.

README.md를 초보자도 이해하기 쉬운 구성으로 수정해 주세요.
구체적으로는 개요, 환경 구축, 실행 방법, 디렉토리 구성을 추가해 주세요.
변경 후에는 차이점(diff)을 확인할 수 있는 형태로 제시해 주세요.

버그 수정을 의뢰할 경우에는 다음과 같이 작성하면 좋습니다.

이 프로젝트 실행 시 발생할 법한 에러를 확인하고, 필요한 수정안을 제시해 주세요.
수정할 경우에는 변경 이유도 함께 설명해 주세요.

포인트는 무엇을 해주길 원하는지뿐만 아니라, 어떻게 확인하고 싶은지까지 지정하는 것입니다. 이를 통해 Codex의 출력을 확인하기 쉬워집니다.

스마트폰에서도 이와 같이 구체적인 수정 지시를 내림으로써, PC를 켜지 않고도 개발 태스크 (Task)를 진행할 수 있습니다.

Codex가 수정안을 작성하면, 변경된 파일이나 차분 (Diff)을 확인할 수 있습니다.

이 단계에서 확인해야 할 포인트는 다음과 같습니다.

• 의도한 파일만 변경되었는가
• 불필요한 파일이 추가 또는 삭제되지 않았는가
• 실행 절차나 README의 내용에 오류가 없는가
• API 키나 개인 정보 등이 포함되어 있지 않은가
• 변경 이유가 납득 가능한가

문제가 없다면 GitHub 측에 반영합니다. 불안한 경우에는 그대로 승인하지 말고, 추가로 수정 지시를 내리는 것이 안전합니다.

Codex의 출력을 확인할 때는 변경 내용 그 자체뿐만 아니라, 왜 그 변경이 필요한지도 함께 확인하면 안심할 수 있습니다.

GitHub 상에 변경 사항이 반영되면, PC 측에서 리포지토리 (Repository)를 업데이트합니다.

git pull

이를 통해 스마트폰에서 Codex에 요청한 변경 사항이 PC 측의 로컬 환경 (Local Environment)에 반영됩니다.

반영 후에는 반드시 동작 확인을 수행합니다.

# 예: Python 프로젝트의 경우
python main.py

또한, 테스트 코드 (Test Code)가 준비되어 있는 경우에는 프로젝트에 맞춰 테스트도 실행해 두면 안심할 수 있습니다.

# pytest를 사용하는 경우
pytest
# test.py를 준비한 경우
...

스마트폰에서 Codex에 지시할 수 있기 때문에, 이동 중이나 외출 중에도 README 수정, 코드 조사, 경미한 버그 수정 등을 진행할 수 있습니다.

AI가 생성한 변경 사항을 PC 환경에 직접 반영하는 것이 아니라, GitHub 상에서 차분을 확인한 후 가져올 수 있습니다. 따라서 변경 내용을 파악하기 쉽고 안전하게 운용할 수 있습니다.

PC를 직접 조작하는 방식은 PC의 기동 상태나 OS, 접속 상태에 의존합니다. 반면, GitHub를 경유하는 워크플로 (Workflow)에서는 PC 측은 마지막에 git pull을 할 뿐이므로, 환경 의존성을 비교적 억제할 수 있습니다.

연구 코드나 개인 개발에서는 README 정리, 실험 스크립트 수정, 코드 리팩터링 (Refactoring) 등 세세한 개선 작업이 많이 발생합니다. 이러한 작업을 스마트폰으로 지시할 수 있게 되면, PC 앞에 없는 시간도 유효하게 활용할 수 있습니다.

스마트폰에서 PC를 직접 조작하는 리모트 컨트롤 (Remote Control)형 워크플로는 로컬 환경의 파일이나 실행 환경을 그대로 사용할 수 있다는 점이 강력합니다.

GitHub 경유 워크플로와 직접 조작형 워크플로는 다음과 같은 점에서 차이가 있습니다.

항목	GitHub 경유	리모트 컨트롤형
PC 기동 상태	마지막 반영 시에만 필요	기본적으로 작업 중에도 필요
...	PC 환경에 직접 반영

어느 쪽이 더 뛰어나다기보다는, 작업 내용에 따라 나누어 사용하는 것이 좋다고 느꼈습니다.

.env나 API 키, 비밀번호 등의 비밀 정보는 절대로 GitHub에 push하지 않도록 주의합니다.

.gitignore를 설정하여 환경 변수 파일이나 비밀 키 파일을 관리 대상에서 제외해 둡니다.

.env
.env.local
*.pem
...

Codex가 생성한 코드는 편리하지만 반드시 옳다고 할 수는 없습니다. 특히 연구 코드나 실험 코드에서는 약간의 변경만으로도 결과가 달라질 가능성이 있습니다.

따라서 다음과 같은 확인을 수행하는 것이 중요합니다.

• 변경된 파일을 확인한다
• 실행 결과를 확인한다
• 불필요한 변경이 들어가지 않았는지 확인한다
• 실험 조건이 바뀌지 않았는지 확인한다

갑자기 대규모 수정을 맡기기보다는, 우선 다음과 같은 작은 태스크부터 시작하는 것을 추천합니다.

• README 정리
• 주석 추가
• 실행 절차 정리
• 경미한 버그 수정
• 디렉터리 구조 설명 작성

작은 태스크로 동작을 확인한 후, 점진적으로 큰 수정을 의뢰하는 것이 안전합니다.

본 기사에서는 스마트폰에서 Codex에 개발 지시를 내리고, GitHub를 경유하여 PC에 반영하는 워크플로를 소개했습니다.

흐름을 정리하면 다음과 같습니다.

스마트폰으로 Codex에 지시
↓
Codex가 GitHub 상의 리포지토리를 확인·수정
...

이 방법을 사용함으로써 PC 앞에 없는 시간에도 코드 조사나 README 수정, 경미한 개선 작업을 진행할 수 있습니다.

특히 연구나 개인 개발에서는 사소한 수정이나 정리 작업이 많이 발생합니다. 그러한 작업을 스마트폰으로 진행할 수 있게 되면 개발의 자유도가 크게 확장된다고 느꼈습니다.

우선은 README의 정비나 작은 버그 수정부터, 스마트폰과 Codex를 사용한 GitHub 경유 개발 플로우 (Development Flow)를 시도해 보는 것을 추천합니다.