본문 바로가기
일반IT

💻 터미널에서 ChatGPT를? chatgpt-codex-cli 설치 및 완벽 세팅 가이드!

by gasbugs 2025. 9. 16.

개발자 여러분! 코딩하다가, 혹은 터미널에서 작업하다가 궁금한 점이 생겼을 때 매번 브라우저를 열어 ChatGPT에 물어보기 번거롭지 않으셨나요? 😩 이제 그럴 필요 없습니다! 여러분의 터미널에 강력한 AI 비서, ChatGPT를 직접 설치할 수 있으니까요.

 

오늘 소개해드릴 chatgpt-codex-cli는 터미널에서 바로 ChatGPT와 대화하고, 코드 생성까지 요청할 수 있는 아주 유용한 도구입니다. 🛠️ 지금부터 저와 함께 설치부터 실제 사용까지 차근차근 알아보겠습니다. 팔로우 미! 🚀

 

 

1. 사전 준비물: Node.js와 npm 📦

chatgpt-codex-cli는 npm(Node Package Manager)을 통해 설치됩니다. npm은 Node.js를 설치하면 자동으로 함께 설치되므로, 먼저 내 컴퓨터에 Node.js가 설치되어 있는지 확인해야 합니다.

  1. 설치 확인: 터미널(Windows의 경우 Command Prompt 또는 PowerShell, macOS의 경우 Terminal)을 열고 아래 명령어를 입력해 보세요.만약 버전 번호가 정상적으로 출력된다면 이미 설치되어 있는 것입니다. 🎉 "command not found"와 같은 에러가 발생한다면 다음 단계로 설치를 진행해주세요.
    node -v
    npm -v
    
  2. Node.js 설치: Node.js 공식 웹사이트에 접속하여 LTS(Long Term Support) 버전을 다운로드하여 설치합니다. 설치는 특별한 설정 없이 'Next' 버튼만 눌러도 충분합니다.

2. OpenAI API 키 발급받기 🔑

이 도구는 OpenAI의 공식 API를 사용하여 작동합니다. 따라서 API를 호출할 수 있는 "열쇠", 즉 API 키가 반드시 필요합니다.

  1. OpenAI 가입 및 로그인: OpenAI 플랫폼에 접속하여 회원가입 또는 로그인을 합니다.
  2. API Key 메뉴 이동: 로그인 후, 왼쪽 메뉴에서 'API keys'를 찾아 클릭합니다.
  3. 새로운 키 생성: 'Create new secret key' 버튼을 클릭하여 새로운 키를 생성합니다.
  4. 키 복사 및 보관: 생성된 API 키는 반드시 안전한 곳에 복사해두세요. 보안 정책상 이 키는 다시 확인할 수 없으므로, 잃어버리면 새로 생성해야 합니다. 🤫

3. chatgpt-codex-cli 설치하기 (feat. npm) 📥

자, 이제 주인공을 설치할 시간입니다. npm을 이용하면 명령어 한 줄로 간단하게 설치할 수 있습니다.

터미널에 아래 명령어를 입력해주세요. -g 옵션은 이 패키지를 컴퓨터의 어느 위치에서든 사용할 수 있도록 전역(Global)으로 설치하겠다는 의미입니다.

npm install -g @openai/codex

 

설치가 진행되고, 잠시 후 완료되면 이제 터미널에서 codex 또는 chatgpt 명령어를 사용할 수 있게 됩니다!

4. API 키 설정하기 ⚙️

설치된 chatgpt-codex-cli가 여러분의 OpenAI 계정을 인식할 수 있도록, 아까 발급받은 API 키를 설정해주어야 합니다.

터미널에 다음 명령어를 입력하고, 복사해 둔 API 키를 붙여넣은 후 엔터를 누르세요.

codex -s

 

Enter your openaikey: 라는 메시지가 나타나면 키를 입력하면 됩니다.

> Enter your openaikey: sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
# API 키 입력 후 엔터

> openai key saved

'openai key saved' 메시지가 보이면 성공적으로 키가 저장된 것입니다! 👍

5. 터미널에서 ChatGPT 사용해보기! 💬

모든 설정이 끝났습니다. 이제 마음껏 터미널에서 ChatGPT를 사용해볼까요?

 

기본적인 질문:

codex "what is javascript?"

 

코딩 질문 (가장 강력한 기능!):

프롬프트에 코드 블록을 포함하여 질문하면 훨씬 더 정확한 답변을 얻을 수 있습니다.

codex "how to make a button in react? \`\`\`js \`\`\`"

 

대화 모드 (Interactive Mode):

매번 codex를 입력하기 귀찮다면, 대화 모드를 사용해보세요.

codex -i

 

You: 라는 프롬프트가 나타나면, 채팅하듯이 자유롭게 질문을 이어갈 수 있습니다. 종료하려면 exit을 입력하세요.

정말 편리하죠? 이제 개발의 흐름을 끊지 않고도, 터미널 안에서 모든 것을 해결할 수 있습니다.


 

오늘은 npm을 이용해 chatgpt-codex-cli를 설치하고 사용하는 방법을 알아보았습니다. 이 도구를 통해 여러분의 개발 생산성이 한층 더 향상되기를 바랍니다! 터미널을 떠나지 않는 스마트한 개발 라이프, 지금 바로 시작해보세요! 😎

 

태그: npm, chatgpt, codex, cli, 터미널, 개발자 도구, Node.js, OpenAI, API, 생산성 향상