Codex App은 macOS 및 Windows용 OpenAI의 데스크톱 코딩 에이전트입니다. Ollama는 앱이 Ollama의 OpenAI 호환 엔드포인트를 사용하도록 구성하여, 데스크톱 앱에서 로컬 모델과 Ollama Cloud 모델로 Codex가 작동할 수 있게 합니다.

설치

macOS 또는 Windows용 Codex App를 설치하세요.

참고

Codex App 지원은 Ollama v0.24.0 이상 버전에서 사용할 수 있습니다.

빠른 설정

ollama launch codex-app

Codex App이 열리면 평소처럼 작업을 시작하거나 리포지토리를 열 수 있습니다.

내장 브라우저

Codex App은 내장 브라우저에서 로컬 서버와 사이트를 열 수 있습니다. 페이지에 직접 주석을 달아 변경을 요청할 수 있습니다.

검토 모드

검토 모드를 사용하여 앱을 나가지 않고 코드 변경 사항을 검토하고, 댓글을 남기고, 수정 사항을 반복할 수 있습니다.

모델로 직접 실행

ollama launch codex-app --model kimi-k2.6:cloud

모델 이름을 전달하여 로컬 모델을 사용하세요:

ollama launch codex-app --model gemma4:31b

ollama launch codex-app을 실행하면 설정이 유지되어 다음에 Codex를 열 때 선택한 모델이 그대로 적용됩니다.

Codex App 복원

ollama launch codex-app을 실행하기 전에 사용하던 프로필로 Codex App을 다시 전환하려면 다음을 실행하세요:

ollama launch codex-app --restore

Ollama가 Codex App의 설정과 구성을 복원합니다. Codex App이 열려 있는 경우 Ollama는 재시작하기 전에 확인을 요청합니다.

ollama launch codex로 관리되는 Codex CLI 프로필은 Codex App 프로필과 별도로 유지됩니다.

Codex App 설정 파일을 덮어쓰기 전에 Ollama Launch는 ~/.ollama/backup/codex-app/ 아래에 백업을 저장합니다. Windows에서 ~는 사용자 프로필 디렉토리로 해석됩니다.

문제 해결

설정 후 Codex App이 열리지 않는 경우, Codex를 수동으로 한 번 열었다가 ollama launch codex-app을 다시 실행하세요.

Codex App이 이미 실행 중인데 모델이 전환되지 않는 경우, 프롬프트가 표시되면 Ollama가 재시작하도록 허용하거나 Codex App을 종료한 후 ollama launch codex-app을 다시 실행하세요.