【Codex】다운로드 불필요. 브라우저만으로 AI 코딩 에이전트를 시작하는 방법

「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」 버튼을 클릭합니다.

이번에는 다음과 같은 이름으로 생성했습니다.

test-codex

설정 포인트:

항목	설정값	이유
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 화면으로 돌아갑시다.

Codex 메인 화면으로 돌아오면 리포지토리를 선택할 수 있게 되어 있습니다.

⚠️ 표시되지 않을 경우

생성한 리포지토리 이름을 검색창에 입력하여 확인해 보세요.

방금 생성한 test-codex를 선택합니다.

이로써 Codex에 실제로 태스크를 던질 수 있는 상태가 되었습니다🎉

단계	내용
Step 1	ChatGPT 사이드바에서 Codex 열기
...
다운로드 불필요, 약 10분, GitHub 계정만 있으면 됩니다.

AI 시대의 코딩은 터미널(Terminal)을 열지 않아도 브라우저만으로 시작할 수 있습니다.

다음 시간에는 이 Codex 환경을 사용하여 실제로 사내 출퇴근 시스템을 만들어 보겠습니다.

• Google Apps Script (GAS)로 API 만들기
• Google Sites에 버튼 삽입하기
• Google 계정으로 타임스탬프(打刻)자를 자동 식별하기
• Google Spreadsheet에 기록하기

설치 불필요, 전부 무료, 사내 Google 계정만 있으면 작동하는 실용적인 시스템입니다.

기대해 주세요!