Codex

샌드박스에서 Codex의 인증, 설정, 사용법을 설명해 드릴게요.

출처: 문서

본문

이 페이지는 로컬 샌드박스를 설명해요. 클라우드 동작과 제한 사항은 로컬과 클라우드 샌드박스 비교 문서를 보세요.

이 가이드는 샌드박스 환경에서 Codex의 인증, 설정, 사용법을 다뤄요.

공식 문서: Codex CLI

프로젝트 디렉터리용 샌드박스를 만들고 Codex를 실행해요:

$ sbx run codex ~/my-project

sbx run은 워크스페이스를 현재 디렉터리로 기본 설정해요:

$ cd ~/my-project
$ sbx run codex

마운트 없는 샌드박스(mountless sandbox)를 만들려면 워크스페이스 경로 없이 sbx create를 쓰고, 이름으로 붙여서 사용하세요.

기본 OpenAI 모델을 쓸 때, sbx run codex는 OpenAI 자격 증명을 저장하지 않았다면 호스트에서 인증을 요청해요. 인증은 샌드박스를 실행하기 전에 일어나므로 자격 증명이 샌드박스 안에 노출되지 않아요.

인증을 미리 설정하려면 다음 방법 중 하나를 선택하세요.

$ sbx secret set openai --oauth

이 명령은 인증용 브라우저 창을 열고, 생성된 토큰을 OS 키체인에 저장해요. OAuth 흐름은 샌드박스가 아니라 호스트에서 실행되므로 별도 설정 없이 브라우저 기반 인증이 동작해요.

$ sbx secret set openai

자세한 내용은 Credentials 문서를 보세요.

Codex를 로컬 모델이나 다른 추론 제공 업체와 함께 쓰려면 로컬/호스팅 모델 사용하기 문서를 보세요.

샌드박스는 호스트의 사용자 수준 설정(예: ~/.codex)을 가져오지 않아요. 샌드박스 안에서는 작업 디렉터리의 프로젝트 수준 설정만 쓸 수 있어요. 해결 방법은 "샌드박스가 내 사용자 수준 에이전트 설정을 안 쓰는 이유는?" 문서를 참고하세요.

추가 인자 없이 샌드박스는 다음을 실행해요:

codex --dangerously-bypass-approvals-and-sandbox

-- 뒤의 인자는 첫 인자가 플래그(-로 시작)일 때 기본 플래그 뒤에 추가돼요. 프롬프트 같은 일반 단어는 기본 값을 대체하므로, 우회(bypass) 모드를 유지하려면 플래그를 앞에 두세요:

$ sbx run --name <sandbox-name> -- --dangerously-bypass-approvals-and-sandbox "fix the build"

템플릿: docker/sandbox-templates:codex

도구를 미리 설치하거나 이 환경을 커스터마이즈하려면 Customize 문서를 보세요.

관련 문서와 심화 내용은 원문을 참고해 주세요.