OpenAI의 Codex는 AGENTS.md를 읽어 프로젝트의 작동 방식을 배웁니다. 짧은 "배포" 섹션을 추가하면 명령어 하나로 사이트를 공개하고 주소와 사이트를 유지할 링크를 전달합니다. 먼저 해결할 것은 샌드박스입니다. 배포에는 네트워크가 필요합니다.
작동 방식
- 아래 섹션을 AGENTS.md에 추가하면 Codex가 명령어와 이후 전달할 내용을 알게 됩니다.
- 명령어가 네트워크에 접근하도록 허용하세요. Codex는 샌드박스에서 명령을 실행하며, 배포는 lobsite.com과 통신해야 합니다(네트워크 접근 참고).
- Codex에게 배포를 요청하세요. 빌드하고
npx -y lobsite --yes를 실행한 다음 URL과 가져오기 링크를 전달합니다. 링크를 열고 로그인하지 않으면 사이트는 6시간 동안만 유지됩니다.
AGENTS.md 섹션
다음을 프로젝트의 AGENTS.md에 붙여 넣으세요. 이 파일을 읽는 다른 에이전트(Cursor, Gemini CLI, Copilot 등)도 사용합니다.
## Deploying
This site deploys with [Lobsite](https://lobsite.com). Build it, then from the project folder run:
```bash
npx -y lobsite --yes
```
- Tell the user the URL, and relay the "Tell the user:" line from the output word for word.
- Sites deployed without logging in are removed after 6 hours. The claim link in the output keeps the site; the user opens it and signs in.
- `lobsite.toml` remembers the site, so the same command updates it. Use `--preview` to deploy without changing the live site, and `--json` for machine-readable output.
- If a deploy fails, follow the fix in the error message. Never pass `--include-secrets`.
CLI는 CODEX_SANDBOX 변수로 Codex 아래에서 실행됨을 알고, 질문 없이 일반 텍스트 줄을 출력합니다.
네트워크 접근
Codex의 샌드박스는 명령의 네트워크 접근을 차단할 수 있으며, 그러면 배포가 Lobsite 오류가 아닌 연결 오류로 실패합니다. Codex CLI는 ~/.codex/config.toml에서 워크스페이스의 명령에 네트워크를 허용하세요.
[sandbox_workspace_write]
network_access = true
또는 Codex가 샌드박스 밖에서 실행하겠다고 요청할 때 명령을 승인하세요. Codex 클라우드 작업에서 에이전트의 인터넷 접근은 환경 설정입니다. lobsite.com과 upload.lobsite.app(npx를 위해 npm 레지스트리도)을 허용하세요.
MCP 서버 또는 curl
Codex CLI는 Lobsite의 MCP 서버도 시작할 수 있으며, deploy, list_sites, list_deploys, rollback, promote, whoami를 도구로 제공합니다. ~/.codex/config.toml에 추가하세요.
[mcp_servers.lobsite]
command = "npx"
args = ["-y", "lobsite@latest", "mcp"]
Node가 설치되지 않은 곳에서는 페이지 하나(또는 파일 몇 개)를 curl로 배포할 수 있으며, URL과 가져오기 링크로 답합니다.
curl --data-binary @index.html https://lobsite.com/api/v1/drop
에이전트에서 실행하면 질문하지 않으며, URL과 가져오기 링크가 담긴 Tell the user: 줄을 출력합니다.
Node가 없나요? curl --data-binary @index.html lobsite.com/api/v1/drop이 URL을 반환합니다.
코딩 에이전트에는 npx lobsite mcp, 채팅 어시스턴트에는 lobsite.com/api/mcp.
파일은 해시로 저장됩니다. 변경되지 않은 사이트를 다시 배포하면 0바이트가 업로드됩니다.
공개 전에 미리 보세요. 리디렉션까지 포함해 클릭 한 번으로 롤백합니다.
모든 한도가 공개되어 있고, 모든 오류는 다음에 할 일을 알려 줍니다.
명령어, MCP 서버, curl
npx -y lobsite --yes |
MCP 서버 | curl | |
|---|---|---|---|
| 필요한 것 | Node와 네트워크 | Node와 네트워크 | 네트워크만 |
| 업로드 내용 | 빌드된 폴더, 변경된 파일만 | 빌드된 폴더, 변경된 파일만 | 지정한 파일, 25MB까지 |
| 같은 사이트 업데이트 | 예, lobsite.toml이 기억 |
예 | 예, ?site=와 가져오기 토큰으로 |
| 롤백, 배포 나열 | 추가 명령어로 | 도구로 | 아니요 |
| 설정 | AGENTS.md 섹션 | config.toml 항목 |
없음 |
명령어로 시작하고, Codex가 배포를 관리하게 하려면 MCP 서버를 추가하고, Node가 없는 샌드박스에는 curl을 사용하세요.
자주 묻는 질문
배포가 네트워크 오류로 실패하는 이유는 무엇인가요?
샌드박스가 명령의 lobsite.com 접근을 막았습니다. 워크스페이스의 네트워크 접근을 켜거나, 샌드박스 밖에서 명령을 승인하거나, Codex 클라우드 환경에서 도메인을 허용하세요.
Codex에 내 Lobsite 계정이 필요한가요?
아니요. 계정이 없으면 사이트는 6시간 동안 유지되고 Codex가 가져오기 링크를 줍니다. 내 계정으로 배포하려면 직접 npx lobsite login을 한 번 실행하세요. 로그인은 브라우저에서 이루어집니다.
Codex가 먼저 미리보기를 배포할 수 있나요?
네. npx -y lobsite --yes --preview는 배포에 자체 URL을 주고 공개 사이트를 그대로 둡니다. npx lobsite promote <id>로 공개합니다.
프로젝트에 .env 파일이 있으면 어떻게 되나요?
시크릿 파일은 업로드되지 않습니다. 제외 방법(.lobsiteignore)을 알려 주는 오류로 배포가 중단됩니다. Codex는 절대 --include-secrets를 전달하면 안 됩니다.
IDE의 Codex에서도 작동하나요?
네. 확장 프로그램은 같은 에이전트를 실행하므로 같은 AGENTS.md를 읽고, 명령어도 같게 동작합니다.