「Codex는 재미있어 보이는데, 설치가 번거로워…」
「CLI라고 해도, 엔지니어가 아니고…」
「브라우저만으로 AI가 코드를 작성해 줄 수는 없을까?」
사실, Codex는 다운로드하지 않아도 브라우저만으로 사용할 수 있습니다.
GitHub 계정이 있다면, 오늘부터 바로 시작할 수 있습니다.
이 기사에서는 ChatGPT의 사이드바에서 Codex를 웹(Web)상에서 사용할 수 있도록 하는 절차와, GitHub 리포지토리(Repository)를 Codex에 연결하여 실제로 태스크(Task)를 던질 수 있는 상태로 만드는 방법까지 스크린샷과 함께 친절하게 해설합니다.
- Codex란?
- Codex의 구조를 올바르게 이해하기
- 이번에 할 일
- 필요한 것
- Step 1. ChatGPT의 사이드바에서 Codex 열기
- Step 2. 「Cloud로 이동」으로 Web Codex 접속
- Step 3. GitHub에 연결하기
- Step 4. GitHub 로그인
- Step 5. Codex Web의 메인 화면 열기
- Step 6. GitHub 리포지토리 생성하기
- Step 7. Codex에 리포지토리 연결(Connect)하기
- 요약 및 다음 예고
Codex는 OpenAI가 제공하는 AI 코딩 에이전트(AI Coding Agent)입니다.
단순한 코드 보완(Code Completion)이 아니라,
- 리포지토리를 통째로 이해함
- 버그를 찾아 수정함
- PR(Pull Request) 수준의 코드 변경을 생성함
까지 자율적으로 수행합니다.
| 사용법 | 특징 |
|---|
| CLI | 터미널에서 사용하는 본격파 |
| 데스크톱 앱 | macOS용 앱 |
| Web (이번 방식) | 브라우저만 사용. 가장 간편함 |
| IDE 확장 | VSCode 등에 통합 |
이번에는 가장 간편한 Web 버전을 사용할 수 있게 하는 절차를 소개합니다.
이 부분을 처음에 알고 있으면 이해가 훨씬 깊어집니다.
❌ 「브라우저 안에서 VSCode처럼 코드를 작성하는 도구」
이것은 틀린 설명입니다.
✅ 「브ウザ는 '지시를 내리는 컨트롤 패널(Control Panel)'. 실제 작업은 Codex의 서버(Server) 위에서 동작함」
| 역할 | 실제 동작 |
|---|
| ChatGPT | 채팅만 수행 |
| Codex Cloud | 서버 위에서 AI가 실제로 작업 수행 |
| GitHub | 코드 저장소 |
| 브라우저 | 작업 지시를 내리는 컨트롤 패널 |
즉, 브라우저에서 「이 앱을 만들어줘」라고 지시하면, Codex의 서버가 코드를 작성하여 GitHub에 저장해 주는 이미지입니다.
로컬(Local) PC에는 아무것도 설치되지 않습니다. 그렇기 때문에 브라우저만으로 완결되는 것입니다.
- ✅ Codex를 다운로드하지 않고 사용할 수 있는 상태로 만들기
- ✅ GitHub 리포지토리 생성하기
- ✅ Codex에 리포지토리 연결(Connect)하기
- ✅ 브라우저만으로 AI에게 태스크를 던질 수 있는 상태로 만들기
소요 시간: 약 10분
| 필요한 것 | 비고 |
|---|
| ChatGPT 계정 | 무료 플랜도 가능 (기능 제한 있음) |
| ... | |
ChatGPT에 로그인하면, 왼쪽 사이드바에 **「Codex」**라는 항목이 표시되어 있습니다.
사이드바에 「Codex」가 표시되지 않는다면, 「더 보기」를 클릭해 보세요.
여기를 클릭하면, Codex의 홈페이지가 열립니다.
Codex의 홈페이지가 열리면, 오른쪽 상단의 「Cloud로 이동」 버튼을 클릭합니다.
이 버튼이 포인트입니다.
- 「macOS 버전 다운로드」 → 앱 버전 (설치가 필요함)
- 「Cloud로 이동」 → 브라우저에서 사용할 수 있는 Web 버전 (이번 방식)
다운로드 없이 사용하고 싶다면, 반드시 **「Cloud로 이동」**을 선택하세요.
「Cloud로 이동」을 클릭하면, Codex Cloud의 홈 화면이 열립니다.
여기서 「GitHub에 연결하기」 버튼을 클릭합니다.
태스크를 생성하기 위해서는 리포지토리를 연결해야 합니다.
연결 확인 다이얼로그가 표시됩니다.
내용을 확인합시다:
| 항목 | 내용 |
|---|
| 권한은 항상 존중됩니다 | 당신이 설정한 권한 이외에는 액세스하지 않음 |
| ... | |
문제가 없다면 **「GitHub로 이동」**을 클릭합니다.
GitHub의 로그인 화면이 표시됩니다.
GitHub의 사용자 이름(또는 이메일 주소)과 비밀번호를 입력하고 **「Sign in」**을 클릭합니다.
Google 계정이나 Apple 계정으로 로그인하는 것도 가능합니다.
⚠️ 주의할 점: 이미 GitHub에 로그인되어 있는 경우, 이 단계가 건너뛰어질 수 있습니다. 그럴 경우에는 그대로 다음 단계로 진행합니다.
GitHub와의 연동이 완료되면 Codex Web의 메인 화면이 표시됩니다.
이 화면이 나타나면 GitHub 연동은 완료되었습니다🎉
다만, 이 상태로는 리포지토리(Repository)가 연결되지 않았기 때문에 태스크(Task)를 던질 수 없습니다.
다음 단계에서 리포지토리를 생성하고 연결하겠습니다.
Codex에서 태스크를 실행하려면, 코드의 저장소 역할을 할 GitHub 리포지토리가 필요합니다.
GitHub에 로그인하여 리포지토리 목록 페이지를 엽니다.
우측의 「New」 버튼을 클릭합니다.
이번에는 다음과 같은 이름으로 생성했습니다.
설정 포인트:
| 항목 | 설정값 | 이유 |
|---|
| Repository name | test-codex (임의) | 반각 영숫자와 하이픈 사용 |
| Visibility | Private | 사내 도구이므로 비공개 권장 |
| Add README | Off | Codex가 나중에 자동으로 생성해 줌 |
입력을 마쳤다면 **「Create repository」**를 클릭합니다.
⚠️ Public으로 설정하면 누구나 코드를 볼 수 있습니다.
사내 도구나 개인 프로젝트는 Private을 권장합니다.
리포지토리가 생성되었다면, Codex의 웹 화면으로 돌아갑니다.
Codex 메인 화면 상단에 있는 「리포지토리 선택」 드롭다운을 클릭합니다.
방금 생성한 리포지토리가 바로 표시되지 않는 경우,
**「GitHub에서 리포지토리 구성하기」**를 클릭합니다.
「Install ChatGPT Codex Connector」라는 화면이 표시됩니다.
여기서 **Codex를 사용하고 싶은 계정(또는 조직/Organization)**을 선택합니다.
- 개인 계정이라면 자신의 계정을 선택
- 회사의 조직 리포지토리를 사용한다면 조직명을 선택
다음 화면에서 Codex에 액세스를 허용할 리포지토리를 선택합니다.
- 「All repositories」: 모든 리포지토리에 액세스 허용
- 「Only select repositories」: 특정 리포지토리만 허용 (권장)
이번에 생성한 test-codex만 선택하고 **「Install & Authorize」**를 클릭합니다.
GitHub 인증이 완료되면 잠시 ChatGPT 홈 화면으로 리다이렉트(Redirect)됩니다.
이는 정상적인 동작입니다. 이 탭은 닫고 Codex 화면으로 돌아갑시다.
gtp-home
Codex 메인 화면으로 돌아오면 리포지토리를 선택할 수 있게 되어 있습니다.
⚠️ 표시되지 않을 경우
생성한 리포지토리 이름을 검색창에 입력하여 확인해 보세요.
방금 생성한 test-codex를 선택합니다.
이로써 Codex에 실제로 태스크를 던질 수 있는 상태가 되었습니다🎉
| 단계 | 내용 |
|---|
| Step 1 | ChatGPT 사이드바에서 Codex 열기 |
| ... | |
| 다운로드 불필요, 약 10분, GitHub 계정만 있으면 됩니다. | |
AI 시대의 코딩은 터미널(Terminal)을 열지 않아도 브라우저만으로 시작할 수 있습니다.
다음 시간에는 이 Codex 환경을 사용하여 실제로 사내 출퇴근 시스템을 만들어 보겠습니다.
- Google Apps Script (GAS)로 API 만들기
- Google Sites에 버튼 삽입하기
- Google 계정으로 타임스탬프(打刻)자를 자동 식별하기
- Google Spreadsheet에 기록하기
설치 불필요, 전부 무료, 사내 Google 계정만 있으면 작동하는 실용적인 시스템입니다.
기대해 주세요!