Google Gemini 2.5 Pro와 Open Codex CLI 사용 방법 (Open Codex CLI)

Young-jae

Young-jae

18 April 2025

Google Gemini 2.5 Pro와 Open Codex CLI 사용 방법 (Open Codex CLI)

Open Codex CLI는 대형 언어 모델(LLM)의 힘을 직접 여러분의 터미널 워크플로우에 가져다주는 오픈 소스 도구입니다. 이 가이드는 Open Codex CLI 환경 내에서 오늘날 사용 가능한 가장 진보된 모델 중 하나인 구글의 Gemini 2.5 Pro를 활용하는 데 중점을 둡니다.

Open Codex CLI는 원래 OpenAI Codex CLI의 포크로, 핵심 기능은 유지하면서 구글 Gemini를 포함한 여러 AI 제공업체 지원을 추가하여 기능을 대폭 확장합니다. 이를 통해 개발자는 익숙한 터미널 인터페이스 내에서 작업에 가장 적합한 모델을 선택할 수 있습니다. 복잡한 코딩 질문을 하거나, 보일러플레이트 코드를 생성하거나, 기존 기능을 리팩토링하거나, 복잡한 스크립트를 설명하거나, 심지어 빌드 명령을 조정하는 등 모든 작업을 Gemini의 지능에 따라 명령줄을 떠나지 않고 수행할 수 있습니다.

이 기사에서는 구글 Gemini 2.5 Pro와 함께 Open Codex CLI를 설치하고 구성하며 사용하는 방법에 대한 포괄적이고 단계별 가이드를 제공합니다(작성 당시 Open Codex CLI 구성에서 지정된 gemini-2.5-pro-preview-03-25 모델 버전을 참조) 및 gemini-2.0-flash와 같은 형제 모델. 워크플로우를 최적화하려는 경험 많은 개발자이든 AI 코딩 어시스턴트에 처음 접하는 사람이든 이 강력한 조합을 활용하는 방법을 배울 수 있습니다.

💡
아름다운 API 문서를 생성하는 훌륭한 API 테스트 도구가 필요하신가요?

개발 팀이 최대 생산성으로 함께 작업할 수 있는 통합된 올인원 플랫폼이 필요한가요?

Apidog는 모든 요구를 충족하며, Postman을 훨씬 더 저렴한 가격에 대체합니다!
button

왜 Gemini와 함께 Open Codex CLI인가요?

Open Codex CLI와 Gemini 2.5 Pro의 결합은 여러 가지 유익한 이점을 제공합니다:

사전 요구 사항

시작하기 전에 다음 사항을 확인하십시오:

  1. 운영 체제: macOS 12 이상, 최신 리눅스 배포판(예: Ubuntu 20.04+, Debian 10+), 또는 Windows 10/11에서 Windows Subsystem for Linux(WSL2)를 사용하는 경우. 직접적인 Windows 지원은 제공되지 않습니다.
  2. Node.js: 버전 22 이상이 필요합니다. LTS(장기 지원) 버전이 일반적으로 권장됩니다. 터미널에서 node -v를 실행하여 버전을 확인할 수 있습니다. nodejs.org에서 Node.js를 다운로드하십시오.
  3. 구글 클라우드 계정 및 Gemini API 키: Gemini 모델에 대한 요청을 인증하기 위해 API 키가 필요합니다. Google AI Studio 또는 Google Cloud Console를 통해 얻을 수 있습니다. 이 키는 계정과 연결되어 있으므로 안전하게 보관하십시오.
  4. 터미널 친숙도: 시스템의 명령줄 인터페이스(터미널, iTerm, Bash, Zsh 등)를 사용하는 기본적인 지식이 필요합니다.

1단계: Open Codex CLI 설치하기

Open Codex CLI를 설치하는 권장 방법은 Node.js에 포함된 npm(노드 패키지 관리자)을 통해 전역적으로 설치하는 것입니다. 터미널을 열고 다음을 실행하십시오:

npm install -g open-codex

또는 패키지 관리자로 Yarn을 사용하는 경우, 다음을 실행할 수 있습니다:

yarn global add open-codex

이 명령은 open-codex 패키지를 다운로드하고 터미널 어디에서나 open-codex 명령을 사용할 수 있게 만듭니다. 전역 npm 설치에 sudo를 사용하지 마십시오. 권한 문제가 발생하면 npm 권한 수정하기가 더 좋습니다.

open-codex --version 또는 open-codex --help를 실행하여 설치를 확인할 수 있습니다.

2단계: Gemini 접근 설정하기

Gemini 모델을 사용하려면 Open Codex CLI에 API 키를 제공해야 하며 gemini 제공자를 사용하겠다고 알려야 합니다. 이를 구성하는 두 가지 주요 방법이 있습니다:

방법 1: 환경 변수 (빠른 시작/테스트에 권장)

API 키를 제공하는 가장 간단한 방법은 환경 변수를 사용하는 것입니다. Open Codex CLI는 gemini 제공자가 선택되었을 때 GOOGLE_GENERATIVE_AI_API_KEY를 특별히 찾습니다.

터미널에서 다음 명령을 실행하되, "YOUR_API_KEY_HERE"를 실제 Gemini API 키로 교체하세요:

export GOOGLE_GENERATIVE_AI_API_KEY="YOUR_API_KEY_HERE"

중요: 이 명령은 현재 터미널 세션에 대해서만 환경 변수를 설정합니다. 터미널을 닫거나 새로 열면 명령을 다시 실행해야 합니다.

API 키를 영구적으로 사용할 수 있게 하려면 export 행을 셸 구성 파일에 추가해야 합니다. 일반 파일로는 다음이 있습니다:

적절한 파일에 export GOOGLE_GENERATIVE_AI_API_KEY="YOUR_API_KEY_HERE" 행을 추가하고, 이를 저장한 후 터미널을 다시 시작하거나 source ~/.zshrc (또는 해당 파일 경로)를 실행하여 변경 사항을 적용하세요.

그런 다음 각 호출에서 --provider 플래그를 사용하여 Gemini를 제공자로 지정할 수 있습니다:

open-codex --provider gemini "프랑스의 수도는 어디인가요?"

방법 2: 구성 파일 (지속적인 설정에 권장)

특히 Gemini를 지속적으로 사용할 계획이라면 Open Codex CLI 구성 파일을 사용할 수 있습니다. CLI는 ~/.codex/config.json에 있는 구성 파일을 찾습니다.

존재하지 않는 경우 디렉토리를 생성하세요: mkdir -p ~/.codex

구성 파일을 생성하고 엽니다: nano ~/.codex/config.json (또는 선호하는 텍스트 편집기를 사용하세요).

다음 JSON 내용을 추가하여 Gemini를 기본 제공자로 설정합니다:

{
  "provider": "gemini"
}

기본 Gemini 모델도 선택적으로 설정할 수 있습니다. Open Codex CLI는 gemini-2.5-pro-preview-03-25를 기본 "에이전틱" 모델로, gemini-2.0-flash를 기본 "전체 컨텍스트" 모델로 정의합니다. 대부분의 상호 작용에 대해 강력한 2.5 Pro 모델을 기본값으로 설정하려면 다음을 사용하세요:

{
  "provider": "gemini",
  "model": "gemini-2.5-pro-preview-03-25"
}

파일을 저장하고 편집기를 종료합니다.

중요하게도, 제공자 및 모델을 설정하기 위해 구성 파일을 사용하는 경우에도 GOOGLE_GENERATIVE_AI_API_KEY 환경 변수를 여전히 설정해야 합니다 방법 1에서 설명한 대로. 구성 파일은 CLI에게 어떤 제공자를 사용할지 알려주고, 환경 변수는 해당 제공자에 대한 자격 증명을 제공합니다.

구성 파일이 설정되면 이제 간단히 open-codex를 실행하면 지정된 Gemini 제공자를 기본값으로 사용합니다:

open-codex "프랑스의 수도는 어디인가요?"

3단계: Gemini와 기본 사용법

이제 Open Codex CLI가 설치되고 Gemini에 대해 구성되었으니, 상호작용하는 방법을 살펴보겠습니다.

인터랙티브 모드 (REPL)

채팅 같은 경험을 위해 특정 프롬프트 없이 CLI를 실행하세요:

open-codex
# 또는 config.json에서 기본 제공자를 설정하지 않았다면:
# open-codex --provider gemini

이 명령은 Read-Eval-Print Loop(REPL)를 시작하며, 여기에서 프롬프트를 입력하고 응답을 받아 Gemini와 지속적인 대화를 나눌 수 있습니다.

❯ open-codex --provider gemini
Open Codex CLI에 오신 것을 환영합니다! 요청을 입력한 후 Enter 키를 두 번 눌러 전송하세요.
> Gemini 2.5 Pro 모델에 대해 설명해 주세요.

프롬프트를 보내려면 Enter를 두 번 눌러야 합니다. Gemini는 터미널 내에서 응답할 것입니다. 후속 질문을 입력하여 대화를 이어갈 수 있습니다.

직접 프롬프트 입력

단발성 요청의 경우 프롬프트를 인수로 직접 전달할 수 있습니다. config.json에서 기본값을 설정하지 않은 경우 제공자 플래그가 필요합니다. --model 또는 -m 플래그를 사용하여 정확한 모델을 지정할 수도 있습니다:

open-codex "Python에서 클로저 개념을 설명해 주세요."
open-codex --provider gemini --model gemini-2.5-pro-preview-03-25 "현재 디렉터리와 하위 디렉터리에서 크기가 10MB 이상인 모든 파일을 찾는 bash 스크립트를 작성하세요."
open-codex --provider gemini --model gemini-2.0-flash "React 훅 문서의 주요 사안을 요약해 주세요."

CLI는 Gemini를 통해 요청을 처리하고 응답을 표준 출력으로 직접 인쇄합니다.

4단계: Gemini와 함께 Open Codex 기능 활용하기

Open Codex CLI의 진정한 힘은 Gemini의 안내에 따라 로컬 개발 환경과 상호작용할 수 있는 능력에 있습니다.

파일 시스템 상호작용

Open Codex CLI를 통해 Gemini는 현재 프로젝트의 파일을 읽어 요청에 대한 컨텍스트를 얻을 수 있습니다. 또한 파일에 대한 변경 사항(쓰기 또는 패치)을 제안할 수도 있습니다.

# 'calculate.js'라는 파일이 있다고 가정
open-codex --provider gemini "calculate.js를 읽고 가독성을 향상시킬 수 있는 개선점을 제안해주세요."
open-codex --provider gemini "두 개의 인수를 받아 그 차이를 반환하는 'subtract'라는 새 기능을 'calculate.js'에 추가하세요."

CLI는 제안된 변경 사항을 출력하고 승인 대화 상자를 표시합니다: 패치 적용하시겠습니까? [y/N]. y를 눌러 수락하거나 n을 눌러 거부합니다.

명령 실행

Open Codex CLI는 Gemini가 제안한 셸 명령을 실행할 수 있습니다. 이는 강력하지만 주의가 필요합니다.

open-codex --provider gemini "pip을 사용하여 'requests' 라이브러리를 설치합니다."

Gemini는 pip install requests 명령을 제안할 수 있습니다. CLI는 명령을 보여주고 질문합니다: 명령을 실행하시겠습니까? [y/N].

프로젝트 컨텍스트 (codex.md)

지속적인 지침이나 프로젝트에 대한 컨텍스트를 Gemini에 제공하기 위해 codex.md 파일을 생성할 수 있습니다. CLI는 다음 순서로 이러한 파일을 읽습니다:

  1. ~/.codex/instructions.md (전역 및 개인 지침)
  2. codex.md (저장소 루트에 있는 프로젝트 전반의 노트)
  3. codex.md (현재 작업 디렉터리에 있는 하위 디렉터리 전용 노트)

이를 통해 매 프롬프트에서 반복하지 않고도 Gemini의 동작을 안내하거나 프로젝트 표준, 사용되는 라이브러리 등에 대한 정보를 제공할 수 있습니다.

문제 해결 및 팁

결론

Open Codex CLI는 구글의 Gemini 2.5 Pro에 의해 강화되어 여러분의 터미널을 지능형 코딩 어시스턴트로 변형시킵니다. 이 가이드에서 설명한 단계를 따르면 고급 AI 기능을 일상 개발 워크플로우에 매끄럽게 통합할 수 있습니다, 직접 명령줄에서.

빠른 코드 스니펫 및 설명부터 복잡한 리팩토링 및 스크립트 실행까지, 이 조합은 생산성을 높이고 작업을 간소화할 수 있는 상당한 잠재력을 제공합니다. 도구는 보안을 위해 샌드박스화 및 사용자 승인을 중시하며, 다중 제공자 지원의 유연성과 오픈 소스 특성을 결합하여 터미널 내에서 AI를 활용하려는 개발자에게 매력적인 선택입니다.

다양한 프롬프트를 실험하고, 다양한 승인 모드를 탐색하며(신중하게!), Gemini와 Open Codex CLI가 여러분의 코딩 경험을 어떻게 개선할 수 있는지 발견하세요.

💡
아름다운 API 문서를 생성하는 훌륭한 API 테스트 도구가 필요하신가요?

개발 팀이 최대 생산성으로 함께 작업할 수 있는 통합된 올인원 플랫폼이 필요한가요?

Apidog는 모든 요구를 충족하며, Postman을 훨씬 더 저렴한 가격에 대체합니다!
button

Apidog에서 API 설계-첫 번째 연습

API를 더 쉽게 구축하고 사용하는 방법을 발견하세요