Codex 연결 가이드
Codex를 설치하고 API 키를 설정한 뒤 Starsg를 통해 대화를 시작하세요.
중요시작하기 전에 콘솔에서 만든 API 키를 준비하세요. 아직 없다면 링크를 열어 생성하세요.
1. 환경점검
아래 npm 명령으로 설치한다면 먼저 터미널에서 node --version 명령을 실행하세요. 명령을 찾을 수 없다면 Node.js 다운로드 페이지에서 설치하세요. 새 터미널을 열고 아래의 두 확인 명령을 실행하세요.
node --version npm --version
공식 설치 가이드: Codex CLI
사용할 도구만 설치하세요. 이미 설치했다면 건너뛰어도 됩니다. npm 명령:
npm i -g @openai/codex@latest
중요: 설치한 도구의 --version 명령만 실행해 설치 여부를 확인하세요.
codex --version
버전 번호가 표시되면 설치된 것입니다. 명령을 찾을 수 없다면 터미널을 다시 열어 시도하세요.
2. Codex 설정
설정 파일 ~/.codex/config.toml을 편집하세요. 게이트웨이 주소, 기본 모델 및 추론 강도를 설정하는 파일입니다.
disable_response_storage = true model = "gpt-5.5" model_provider = "novamaas" model_reasoning_effort = "high" model_verbosity = "high" [features] web_search_request = true [model_providers.novamaas] base_url = "https://api.starsg.ai/v1" name = "novamaas" requires_openai_auth = true wire_api = "responses"
다음으로 ~/.codex/auth.json에 API 키를 입력하세요.
{
"OPENAI_API_KEY": "sk-abc...xyz"
}참고: 설정 파일이나 폴더가 없다면 위 예시를 붙여넣기 전에 직접 만드세요. Windows의 사용자 폴더는 %USERPROFILE%입니다.
3. 확인
터미널에서 codex 명령을 실행해 응답을 받으면 연결된 것입니다.