무료로 시작하기

OpenAI Codex 사용자용

Codex로 만든 앱을 팀에만 배포하기

Codex로 사내 툴을 만들었죠. TeamOnly는 그 툴을 동료만 열 수 있는 비공개 링크로 올려요. 동료들은 회사 Google 또는 Microsoft 계정이나 회사 이메일로 받은 코드로 들어와요. 설정과 배포는 Codex가 터미널이나 에디터에서 해요.

Codex~/stock-counter
이거 TeamOnly에 배포해 줘Codex가 npx teamonly deploy를 실행하려고 해요. 네트워크가 필요해요. 승인할까요?Live at https://stock.acme.teamonly.appOnly @acme.com accounts can sign in.

01짧은 답

Codex는 AGENTS.md를 읽어요. TeamOnly가 그 파일을 써요.

프로젝트에서 npx teamonly init을 실행하세요. TeamOnly 규칙이 담긴 AGENTS.md가 추가되는데, OpenAI 문서에 따르면 Codex는 작업을 시작하기 전에 AGENTS.md를 읽어요.

그다음 Codex에게 툴을 만들고 배포해 달라고 하세요. Codex가 npx teamonly deploy를 실행하고 stock.acme.teamonly.app 같은 링크를 줘요. 회사 밖 사람은 아무도 열 수 없어요.

02단계

내 노트북의 폴더에서 팀이 로그인하는 링크까지

  1. 규칙 추가하기

    앱 폴더에서 npx teamonly init을 실행하세요. 빈 폴더라면 시작용 앱을 만들고, 이미 있는 앱이라면 TeamOnly 파일만 추가하고 내 코드는 건드리지 않아요.

  2. Codex에서 열기

    그 폴더에서 codex를 시작하거나, Codex 확장 프로그램이 있는 에디터에서 폴더를 여세요. 둘 다 같은 AGENTS.md를 읽어요.

  3. 툴 요청하기

    “현장에 있는 누구나 휴대폰으로 수량을 기록하는 재고 집계 툴.” Codex는 TeamOnly에서 돌아가는 단 하나의 형태, 즉 React 화면과 작은 API로 만들어요.

  4. 배포하기

    “이거 TeamOnly에 배포해 줘”라고 말하세요. Codex가 npx teamonly deploy를 실행해요. 처음에는 회사 이메일과 저희가 보내는 6자리 코드를 묻고, 회사가 처음이라면 14일 무료 체험을 제안해요.

  5. 링크 공유하기

    팀에 보내세요. 나중에 앱을 고치고 다시 배포해도 링크는 그대로예요.

터미널~/stock-counter
npx teamonly initAdded the TeamOnly instructions for Claude Code, Cursor and other AI tools npx teamonly deployLive at https://stock.acme.teamonly.app

03Codex가 읽는 것

이 프로젝트에서 Codex가 따르는 규칙

init은 프로젝트 최상위의 AGENTS.md에 표시된 블록을 써요. 이미 AGENTS.md가 있다면 나머지 내용은 그대로 둬요. 이 블록은 앱 형태, 로그인한 사람을 가져오는 방법, 데이터베이스와 파일, 배포 방법을 설명해요.

OpenAI 문서에 따르면 Codex는 ~/.codex에 있는 선택적 전역 파일을 먼저 읽고, 그다음 프로젝트 루트부터 작업 중인 폴더까지 내려가며 AGENTS.md 파일로 지시 사항을 만들어요. 그래서 이 프로젝트의 모든 Codex 세션에 TeamOnly 규칙이 들어가 있고, 따로 켤 것도 없어요.

그래서 Codex가 Express, Next.js, Supabase나 로그인 페이지를 추가하지 않아요. 이런 것들은 TeamOnly에서 돌아가지 않고, 규칙에도 그렇게 적혀 있어요.

04명령어 실행

Codex는 온라인에 접속하기 전에 물어봐요

내 컴퓨터에서 Codex는 샌드박스 안에서 명령어를 실행해요. OpenAI 문서에 따르면 CLI와 에디터 확장 프로그램에서는 네트워크 접근이 기본적으로 꺼져 있고, 네트워크가 필요한 명령어는 실행하기 전에 승인을 요청해요. 배포는 앱을 TeamOnly로 보내는 일이라 이 확인 창이 떠요. 승인하면 배포가 끝나요.

Codex Cloud는 달라요. 클라우드 작업은 OpenAI의 컨테이너에서 기본적으로 오프라인으로 실행되고, 내 TeamOnly 로그인 정보가 없어요. 원한다면 Codex Cloud로 코드를 쓰고, 변경 사항을 가져와서 내 컴퓨터에서 배포하세요.

05MCP 옵션

Codex에 TeamOnly를 툴로 추가하기

teamonly 패키지는 MCP 서버이기도 해서, Codex가 명령어 대신 툴로 배포하고, 로그를 읽고, 앱을 열 수 있는 사람을 바꿀 수 있어요. 한 번만 추가하세요:

codex mcp add teamonly -- npx -y teamonly mcp

아니면 ~/.codex/config.toml에 직접 추가하세요. OpenAI 문서에 따르면 Codex CLI, 에디터 확장 프로그램, ChatGPT 데스크톱 앱이 이 파일을 함께 쓰기 때문에 한 번만 설정하면 돼요:

[mcp_servers.teamonly]
command = "npx"
args = ["-y", "teamonly", "mcp"]

TeamOnly MCP 서버

06동료에게 보이는 화면

로그인 화면, 그다음 내 앱

동료들은 Codex도, ChatGPT 계정도 필요 없고 아무것도 설치하지 않아도 돼요.

링크를 열고 회사 Google 또는 Microsoft 계정이나 회사 이메일로 받은 코드로 로그인해요. TeamOnly가 내 코드가 실행되기 전에 이걸 확인하고, 앱은 그 사람의 이름과 이메일을 받아요. 회사 밖 사람은 로그인 화면에서 멈춰요. 앱을 쓰기만 하는 사람은 무료예요. 회사 로그인 작동 방식.

@acme.com 계정이 있는 동료는 들어와요. 그 외의 사람은 문 앞에서 멈춰요.

FAQ

자주 묻는 질문

모든 질문과 답변

Codex는 AGENTS.md를 읽나요?

네. OpenAI의 Codex 문서에 따르면 Codex는 작업을 시작하기 전에 AGENTS.md 파일을 읽어요. npx teamonly init이 AGENTS.md에 TeamOnly 규칙을 추가하므로, 따로 설정하지 않아도 Codex가 그 규칙을 따라요.

Codex가 npx teamonly deploy를 대신 실행할 수 있나요?

네, Codex CLI와 에디터 확장 프로그램에서요. 배포에는 네트워크가 필요해서, Codex 설정에서 네트워크 접근을 켜 두지 않았다면 Codex가 먼저 명령어 승인을 요청해요.

Codex Cloud에서 배포할 수 있나요?

직접은 안 돼요. 클라우드 작업은 기본적으로 오프라인으로 실행되고 내 TeamOnly 로그인 정보가 없는데, TeamOnly 규칙은 AI에게 로그인을 우회하지 말라고 해요. Codex Cloud가 변경 사항을 쓰게 하고, 그걸 가져와서 내 컴퓨터에서 npx teamonly deploy를 실행하세요.

MCP 서버가 꼭 필요한가요?

아니요. Codex는 터미널에서 명령어를 실행할 수 있어요. MCP 서버는 Codex가 툴을 쓰는 쪽이 좋을 때를 위한 거예요. 예를 들어 운영 중인 앱의 로그를 읽거나 앱을 열 수 있는 사람을 바꿀 때요.

Codex가 Python이나 Next.js로 코드를 쓰나요?

이 프로젝트에서는 그러면 안 돼요. AGENTS.md의 규칙은 단 하나의 앱 형태, 즉 TypeScript로 된 React와 Vite 화면, Hono API를 설명해요. TeamOnly는 Python, 컨테이너, Next.js 서버 기능을 실행하지 않아요.

비용은 얼마인가요?

처음 14일은 무료이고 카드도 필요 없어요. 그다음 Builder는 제작자 1명, 앱 3개에 월 $19, Team은 모든 제작자와 앱에 월 $249예요. 앱을 쓰기만 하는 동료는 무료예요. Codex는 평소처럼 OpenAI가 청구해요.

출처

Codex에 관한 내용은 2026년 10월 26일에 OpenAI 문서에서 확인했어요: AGENTS.md, 승인, 샌드박스, 네트워크 접근, MCP 서버. Codex는 자주 바뀌니, 다르게 보이는 게 있으면 Codex 문서를 확인하세요.

더 읽어 보기

얼리 액세스

이번 주에 첫 툴을 올려 보세요.

TeamOnly는 얼리 액세스 중이고, 지금 모든 요금제에 가입할 수 있어요. 카드 없이 14일 동안 무료로 써 보거나, 구독하세요. 어느 쪽이든 회사 설정이 바로 끝나고, 명령어 세 개면 첫 앱이 온라인에 올라가요.

14일 무료 체험하기아니면 지금 구독하기

무료 체험에는 카드가 필요 없어요. 그 뒤로 월 $19부터, 언제든 해지할 수 있어요.

아직 준비가 안 됐나요? 소식 받기

회사 이메일을 써 주세요. 메일은 가끔, 보낼 만한 소식이 있을 때만 보내요.

질문은 hello@teamonly.dev로 보내 주세요. 사람이 직접 답해요.