휴대폰으로 원격 개발 작업 관리하기

ChatGPT 모바일 앱의 원격 기능은 언뜻 보면 활용 범위가 좁아 보입니다.

처음에는 휴대폰에서 코딩 채팅의 진행 상황을 확인하는 기능처럼 보입니다. 그것만으로도 유용하지만, 실제로 할 수 있는 일은 훨씬 많습니다. iPhone을 작은 터미널처럼 쓰지 않고도 개발 머신에서 작업을 시작하고, 방향을 잡고, 결과를 검토하고, 여러 작업을 정리할 수 있습니다.

지난 두 달 동안 이 과정에서 할 수 있는 일이 크게 늘었습니다. 원격 호스트 연결, 작업 트리, 목표, 사이드 채팅, 인라인 코드 리뷰를 추가했습니다. 프롬프트를 대기열에 넣거나 진행 중인 작업의 방향을 조정할 수 있고, 첨부 파일과 스킬, 플러그인을 사용할 수 있습니다. 채팅 보관 기능과 보안 설정을 비롯해 실제 개발에 도움이 되는 세세한 기능도 여럿 추가했습니다.

원격 기능을 본격적으로 쓰기 시작하는 분들을 위해, 제가 처음부터 알았으면 했던 활용법을 정리했습니다.

휴대폰은 개발 작업을 제어하는 곳입니다

코드는 여전히 Mac이나 Windows 머신, 개발 박스 또는 연결된 다른 호스트에서 실행됩니다. ChatGPT 모바일 앱의 원격 기능은 그 작업을 제어할 수 있는 네이티브 인터페이스를 제공합니다.

이 구분은 중요합니다. 작은 화면에 터미널의 모든 조작 방식을 재현할 필요는 없습니다. 에이전트가 다음 단계로 나아가는 데 필요한 결정을 어디서든 쉽게 내릴 수 있으면 됩니다.

• 에이전트가 어떤 리포지터리와 워크스페이스를 사용해야 할까?
• 현재 브랜치에서 실행할까, 새 작업 트리에서 실행할까?
• 다음 메시지는 대기열에 넣을까, 지금 진행 중인 턴의 방향을 바꿀까?
• 이 명령어는 승인해도 안전할까?
• 무엇이 바뀌었고, 그 변경에 동의하는가?
• 여러 턴에 걸쳐 추진할 목표로 삼을까, 별도 채팅을 열까, 사이드 채팅에서 간단히 물어볼까?

이렇게 사용하다 보면 앱이 원격 데스크톱 소프트웨어라기보다 개발 작업 전반을 제어하는 곳처럼 느껴집니다.

1. 작업 범위를 정하고 채팅 시작하기

에이전트가 제대로 작업하려면 먼저 작업 범위에 맞는 환경을 골라야 합니다. 원격 기능에서는 첫 프롬프트를 보내기 전에 연결된 호스트와 워크스페이스를 선택할 수 있습니다. 새 채팅을 시작할 때는 브랜치를 선택하고, 별도 작업 트리를 만들고, 해당 작업 트리의 환경 설정 절차를 실행할 수도 있습니다.

상황에 따라 다음과 같이 시작할 수 있습니다.

• 빠르게 조사할 때는 현재 체크아웃한 코드를 사용하세요.
• 다른 작업과 분리해야 하는 변경이라면 새 작업 트리를 만드세요.
• 나중에 Git 상태를 바로잡을 필요가 없도록 처음부터 원하는 기준 브랜치에서 시작하세요.
• Codex에 빌드나 테스트를 요청하기 전에 환경 설정 절차를 실행하세요.

원격 기능을 자주 쓴다면 이 습관부터 들이세요. 실행 환경을 고르는 데 10초를 쓰면 나중에 정리하는 데 드는 10분을 아낄 수 있습니다.

Composer에서는 텍스트 외에도 여러 형태로 컨텍스트를 전달할 수 있습니다. 파일이나 사진을 첨부하거나 카메라로 바로 찍어 넣을 수 있습니다. 스킬과 플러그인도 프롬프트 안에 표시되므로 의도한 기능을 호출하는지 쉽게 확인할 수 있습니다.

제 기준은 간단합니다. 스크린샷이나 파일을 보여 주거나 스킬 이름을 명시하면 요청이 더 분명해지는 경우, 첫 턴을 시작하기 전에 첨부하거나 언급합니다.

2. 대기열에 넣기와 방향 조정의 차이 이해하기

원격 기능에서 눈에 잘 띄지 않지만 작업 방식에 큰 영향을 주는 설정입니다.

Codex가 이미 작업 중일 때 후속 메시지를 보내는 방법은 두 가지입니다.

• 대기열에 넣기를 선택하면 현재 응답이 끝난 뒤 프롬프트를 다음 턴으로 보냅니다.
• 방향 조정을 선택하면 이미 진행 중인 작업에 지시를 전달합니다.

기본으로 쓰기에는 대기열에 넣기가 안전합니다. 두 번째 작업이나 추가 테스트처럼 현재 작업이 끝난 뒤에 처리할 요청에 사용하세요.

잘못된 방향으로 계속 진행할수록 수정에 드는 비용이 커진다면, 다음과 같이 방향을 조정하세요.

수정 범위는 모바일 패키지로 한정하세요. 공용 렌더러는 리팩터링하지 마세요.

문제는 다시 연결한 뒤에만 재현됩니다. 연결이 유지될 때의 경로 말고, 다시 연결한 뒤 작업을 재개하는 경로를 테스트하세요.

UI 조사는 중단하세요. 작업을 재개하는 동안 서버가 해당 항목을 삭제했는지 확인하세요.

이렇게 하면 휴대폰으로 상태를 확인하는 데서 한 걸음 더 나아갈 수 있습니다. 작업에 사람의 판단이 필요한 바로 그 순간에 개입할 수 있습니다.

설정에서 후속 메시지의 기본 동작을 선택할 수 있습니다. 저는 기본값으로 대기열에 넣기를 사용하고, 방향을 바꿔야 할 때만 직접 방향 조정을 선택합니다. 실수로 턴 도중에 작업 방향을 바꾸면 대개 기다리는 것보다 손이 더 많이 갑니다.

3. 곁가지 질문은 사이드 채팅에서 다루기

오래 이어지는 코딩 채팅에는 유용한 컨텍스트가 쌓입니다. 궁금한 점이 생길 때마다 본래 작업을 끊고 질문하면 채팅 기록에서 핵심을 찾기 어려워지고, 에이전트가 목표에서 벗어날 수 있습니다.

이럴 때 사이드 채팅이 유용합니다.

/side를 사용하면 현재 채팅에 연결된 간단한 대화를 열 수 있습니다. 질문이 이미 준비되어 있다면 /side <prompt>로 질문과 함께 시작하세요. 더 간편한 방법은 채팅 기록에서 텍스트를 선택하고 사이드 채팅에서 질문하기를 선택하는 것입니다. 선택한 구절이 새 대화의 시작 컨텍스트가 됩니다.

저는 이런 질문에 사이드 채팅을 사용합니다.

• Codex가 이 아키텍처를 선택한 이유는 무엇인가요?
• 이 오류는 정확히 무엇을 의미하나요?
• 이 동작은 데스크톱 앱과 일치하나요?
• 이 구현 내용을 릴리스 노트에 넣을 문구로 정리해 주세요.
• 이 명령어를 승인하기 전에 무엇을 확인해야 하나요?

메인 채팅에서는 작업을 진행하고, 사이드 채팅에서는 그 작업을 이해하는 데 필요한 질문을 합니다.

4. 계획으로 접근 방식을 정하고 목표로 완료 조건 정하기

계획 수립 모드와 목표는 용도가 다릅니다.

계획 수립 모드에서는 Codex가 코드를 변경하기 전에 구현 방안을 제안합니다. 요구 사항이 충분히 구체적이지 않거나, 변경 위험이 크거나, 여러 시스템에 손을 대야 할 가능성이 있을 때 유용합니다.

목표는 여러 턴에 걸쳐 유지됩니다. Codex가 어떤 결과를 향해 계속 작업해야 하는지 지정하는 것입니다. 모바일에서는 /goal로 목표를 만들고 관리할 수 있으며, 작업이 진행되는 동안 진척 상황을 확인할 수 있습니다.

실제로는 다음과 같이 활용할 수 있습니다.

1. 위험이 큰 변경은 계획 수립 모드에서 시작하세요.
2. 제안된 작업 범위를 검토하세요.
3. 여러 차례 작업해야 한다면 합의한 결과를 목표로 설정하세요.
4. 목표를 매번 다시 설명할 필요 없이 Codex가 구현, 테스트, 리뷰 피드백 반영, 마무리까지 이어서 진행하도록 하세요.

계획은 “어떻게 접근할까?”에 답합니다. 목표는 “어떤 조건을 충족해야 작업을 마쳤다고 할 수 있을까?”에 답합니다.

5. 대화 안에서 코드 리뷰하기

코드를 리뷰할 때 원격 기능의 가치가 특히 잘 드러납니다. 단순히 휴대폰으로 볼 수 있어 편리한 수준을 넘어 실제 개발 작업을 진행할 수 있기 때문입니다.

턴이 끝나면 변경된 파일의 요약이 표시될 수 있습니다. 여기서 diff를 열고 개별 파일을 살펴보거나, 구간을 펼치고 접거나, 긴 줄을 화면 너비에 맞춰 볼 수 있습니다. 구문 강조가 적용된 소스 파일을 열 수도 있습니다. 해당 줄에 인라인 댓글을 달아 리뷰 컨텍스트를 Codex에 다시 전달하세요.

필요한 검토 수준에 따라 다음 기능을 사용하세요.

• 변경된 파일 요약을 열어 예상한 파일이 바뀌었는지 빠르게 확인하세요.
• diff만으로 주변 코드를 파악하기 어렵다면 탭해서 전체 소스를 여세요.
• 정확한 수정 위치를 알려 주려면 인라인 댓글을 다세요.
• 리뷰 명령어로 로컬 변경 사항을 검토하거나 브랜치와 비교하세요.
• Codex가 특정 파일을 살펴보고 판단하도록 하려면 해당 파일을 채팅에 링크하세요.

저는 휴대폰에서 다음과 같이 리뷰를 이어갑니다.

1. Codex가 구현을 마칩니다.
2. 휴대폰에서 diff를 확인합니다.
3. 인라인 댓글을 두 개 남깁니다.
4. Codex가 같은 채팅에서 댓글 내용을 반영합니다.
5. 수정한 부분만 담긴 더 작은 diff를 검토합니다.

코드를 깊이 읽어야 할 때 휴대폰이 대형 모니터를 대신할 수는 없습니다. 하지만 한두 가지 결정만 내리면 리뷰를 마칠 수 있는 경우도 많습니다. 이제 그런 결정은 책상으로 돌아갈 때까지 미룰 필요가 없습니다.

6. 권한 설정을 워크플로우에 포함하기

원격 작업이 유용하려면 무엇을 허용할지 명확하게 제어할 수 있어야 합니다.

원격 기능은 명령어 실행, 파일 변경, 네트워크 접근, 연결된 도구 사용에 대한 승인 요청을 표시합니다. 요청과 호스트 설정에 따라 한 번만 승인하거나, 현재 채팅 전체에 대해 승인하거나, 더 넓은 범위에 승인을 적용할 수 있습니다.

모든 요청을 승인하기보다는 작업을 계속하는 데 필요한 최소 범위의 권한을 선택하세요.

신뢰하는 채팅에서 동작을 잘 아는 명령어를 실행한다면 채팅 단위로 승인해 반복되는 요청을 줄일 수 있습니다. 익숙하지 않은 명령어이거나 민감한 리포지터리에서 작업 중이거나 요청을 승인했을 때의 영향이 불분명하다면 한 번만 승인하세요. 또는 요청을 거부하고 Codex에 설명을 요구하거나 더 안전한 방법을 쓰도록 하세요.

작업을 시작할 때 채팅 전반에 적용할 승인 방식도 선택할 수 있습니다. 호스트, 워크스페이스, 브랜치, 모델과 함께 채팅을 시작할 때 정할 항목으로 생각하세요.

7. 컨텍스트가 너무 커지기 전에 관리하기

에이전트 채팅은 이전 작업 상태를 유지합니다. 채팅이 길어져 컨텍스트가 많이 쌓이면 응답이 느려지거나 에이전트가 작업에 집중하기 어려워질 수 있습니다.

원격 기능에는 채팅이 이어지는 동안 컨텍스트를 관리할 수 있는 도구가 몇 가지 있습니다.

• /status는 세션 세부 정보, 워크스페이스, 컨텍스트 사용량과 확인 가능한 요청 한도 정보를 표시합니다.
• 컨텍스트 표시기를 켜면 Composer에서 남은 컨텍스트를 계속 확인할 수 있습니다.
• /compact는 작업에 필요한 상태를 유지하면서 지나치게 길어진 채팅의 컨텍스트를 압축합니다.
• /fork는 지금까지의 기록을 공유하면서 다른 방향으로 진행하고 싶을 때 현재 채팅에서 새 채팅을 만듭니다.

먼저 상태를 확인하세요. 목표가 그대로라면 컨텍스트를 압축하고, 목표가 달라졌다면 채팅을 포크하세요.

사이드 채팅과 포크는 구분해서 사용하세요. 사이드 채팅에서는 현재 작업에 대해 간단히 질문합니다. 포크하면 원래 채팅의 기록을 이어받는 새 메인 채팅이 생깁니다.

8. 채팅 목록 정리하기

제가 Codex로 일하는 방식은 점점 여러 작업을 한곳에서 관리하는 작은 운영실을 닮아 갑니다.

실제로 진행 중인 채팅 몇 개를 고정하고, 달성하려는 결과가 드러나게 이름을 바꿉니다. 작업이 끝나면 바로 보관합니다. 보관한 채팅도 나중에 다시 찾아볼 수 있습니다. 보관하면 삭제되지 않고 활성 목록만 정리됩니다.

알림도 이 방식의 일부입니다. 완료 알림을 누르면 해당 Codex 채팅이 바로 열리므로 에이전트가 끝낸 작업을 탭 한 번으로 검토할 수 있습니다.

Spotlight와 단축어에서 원격 기능을 바로 열 수 있습니다. iPad에서는 키보드 단축키 덕분에 앱을 훨씬 효율적으로 사용할 수 있습니다. 화면의 버튼을 일일이 누르지 않고도 새 채팅 만들기, 채팅 간 이동, 변경된 파일 열기, 채팅 고정, 이름 변경, 보관이 가능합니다.

이럴 때 원격 기능은 비서실장 역할을 합니다. 저는 앱에서 프롬프트를 보낼 뿐 아니라 어떤 개발 작업이 진행 중인지, 어디서 막혔는지, 무엇이 리뷰를 기다리고 있고 무엇이 끝났는지도 파악합니다.

9. 숨겨진 명령어 팔레트

/를 입력하면 앱의 여러 고급 기능을 빠르게 실행할 수 있는 명령어가 나타납니다. 사용할 수 있는 명령어는 연결된 호스트, 앱 버전, 계정 설정에 따라 달라질 수 있습니다.

명령어 팔레트를 익히다 보면 제품의 기본 작업 방식도 자연스럽게 이해할 수 있습니다. 계획을 세우고 목표를 추진하다가 필요하면 채팅을 나누고, 결과를 검토하고, 상태를 점검하고, 다시 작업을 이어가는 방식입니다.

10. 모바일에서 특히 유용한 다섯 가지 워크플로우

릴리스 관리

릴리스나 pull request 하나를 전담하는 채팅을 시작하세요. Codex에 현재 브랜치, CI 상태, 아직 처리하지 않은 리뷰 피드백, 해당 변경의 릴리스 포함 여부를 확인하도록 요청하세요. 채팅을 고정하세요. 새 정보로 인해 진행 중인 조사의 전제가 더 이상 성립하지 않을 때만 방향을 조정하고, 그 외에는 대기열에 넣으세요. 휴대폰에서 최종 diff나 릴리스 노트를 검토하고 릴리스가 배포되면 채팅을 보관하세요.

갑자기 들어온 버그 수정 요청 처리

스크린샷, 로그 또는 캡처한 파일을 첨부하세요. Codex에 코드를 수정하기 전에 원인을 진단하도록 요청하세요. 의심스러운 오류 하나를 더 파고들고 싶다면 메인 조사가 다른 방향으로 흐르지 않도록 사이드 채팅을 사용하세요. 원인이 분명해지면 메인 채팅으로 돌아와 필요한 범위의 수정만 승인하세요.

모바일 코드 리뷰

원하는 브랜치를 기준으로 리뷰를 실행하고 변경된 파일 요약을 확인하세요. 중요한 파일을 열어 인라인 댓글을 다세요. Codex에 해당 댓글만 반영해 달라고 요청한 뒤 후속 diff를 검토하세요.

장기 목표 추진

테스트 전체 통과, 리뷰 피드백 반영 완료, 반복 측정으로 확인할 수 있는 성능 기준 충족처럼 구체적인 완료 조건을 정해 목표를 만드세요. “끝났나요?”라고 거듭 묻는 대신 알림과 상태 정보로 진행 상황을 확인하세요. 추가 작업은 프롬프트를 대기열에 넣고, 진행 방향을 바로잡아야 할 때만 방향 조정을 사용하세요.

여러 머신에서 작업 관리

호스트는 이름만 보고도 구별할 수 있게 지정하고 작업은 머신과 워크스페이스별로 정리하세요. 휴대폰에서 필요한 코드가 체크아웃되어 있거나 적절한 자격 증명, 시뮬레이터 또는 운영 체제를 갖춘 머신을 선택해 채팅을 시작하세요. 한 채팅에는 Mac이 필요하고 다른 채팅에는 Windows 호스트가 필요할 때 특히 유용합니다.

작지만 효과가 큰 기능

제가 즐겨 쓰는 기능 중에는 크게 주목받지 않은 것들도 있습니다.

• 정정하려고 턴을 추가하는 대신 가장 최근에 보낸 프롬프트를 수정하세요.
• 채팅에서 렌더링된 이미지를 저장하거나 복사하세요.
• Codex가 작업 중일 때도 대기열에 있는 프롬프트를 확인하세요.
• 완료 알림에서 해당 채팅을 바로 여세요.
• 활성 목록에 채팅을 쌓아 두지 말고 보관한 채팅에서 찾아보세요.
• 좁은 화면에서 diff를 읽을 때는 긴 줄을 화면 너비에 맞춰 줄바꿈하세요.
• Face ID나 기기 암호로 ChatGPT 모바일 앱을 보호하세요.
• 프롬프트를 보내기 전에 Composer에서 스킬과 플러그인이 제대로 들어갔는지 확인하세요.
• 눈앞의 사물이 작업 컨텍스트라면 사진을 찍어 프롬프트에 바로 넣으세요.
• 질문의 배경을 다시 설명하는 대신 채팅 기록에서 텍스트를 선택해 사이드 채팅을 시작하세요.

이 기능들이 에이전트의 기본 동작 방식을 바꾸지는 않습니다. 다만 하나씩 모여 원격으로 일할 때 작업 흐름을 끊던 작은 불편들을 해소합니다.

모바일에서 중요한 것

좋은 모바일 소프트웨어는 데스크톱 인터페이스를 그대로 축소하지 않습니다. 책상을 떠나 있을 때 어떤 결정을 내려야 하는지 파악하고, 상황을 한눈에 이해해 빠르고 안전하게 결정할 수 있게 합니다.

이제 저는 원격 기능을 그런 도구로 봅니다. 적절한 환경을 선택하고, 목표를 정하고, 진행 중인 작업의 방향을 바꾸고, 승인 요청에 응답하고, 결과를 확인합니다. 대기 중인 개발 작업까지 한곳에서 관리할 수 있습니다.

작업은 여전히 컴퓨터에서 실행됩니다. 저는 휴대폰으로 그 작업을 제어합니다.