Codex 설치 및 구성 튜토리얼
Windows 버전 튜토리얼
시스템 요구 사항
Windows 10 또는 Windows 11
Node.js 22+
npm 10+
네트워크 연결
설치 단계
전제 단계!!!Git Bash를 설치하려면 다음 링크를 방문하세요: Git - Downloads 해당 컴퓨터 시스템에 맞는 버전을 다운로드한 후, 계속해서 “다음 단계”를 클릭하면 설치가 완료됩니다.1. Node.js 설치하기
접속 Node.js 공식 웹사이트 최신 LTS 버전을 다운로드하고 설치하세요.2. 코덱스 설치
명령 프롬프트(CMD) 또는 PowerShell을 열고 다음을 실행하세요:
npm install -g @openai/codex
명령 프롬프트(CMD) 또는 PowerShell을 열고 다음을 실행하세요:
codex --version
API 설정 API 구성
1. 인증 토큰(Auth Token) 획득접속 api.airai.cc 사이트 페이지에서 다음 작업을 수행하세요:
클릭 콘솔 → API 토큰 페이지
클릭 토큰을 추가하세요
토큰 그룹을 선택하십시오:codex 전용(이 그룹을 반드시 선택해야 합니다. 그렇지 않으면 사용할 수 없습니다.)
Token 이름은 임의입니다.
권장 한도: 다음과 같이 설정하십시오. 무제한 사용량
다른 옵션은 기본값으로 유지하세요
중요한 안내: api.airai.cc에서 생성한 실제 API 키로 `sk-xxx`를 대체해 주세요!
중요한 안내: 아래의sk-xxx를 api.airai.cc에서 생성한 실제 API 키로 바꿔주세요!
중요한 안내: api.airai.cc에서 생성한 실제 API 키로 `sk-xxx`를 대체해 주세요!
1.
현재 사용자의 사용자 디렉터리 내에 있는
（주의만약 해당 디렉터리가 보이지 않는다면, Windows의 “숨겨진 항목 표시” 기능이 켜져 있지 않은 것입니다. 먼저 파일 탐색기에서 이 기능을 활성화해 주세요.)
.codex 폴더로 이동하세요. 예를 들어, C:\Users\testuser\.codex와 같은 폴더입니다.（주의만약 해당 디렉터리가 보이지 않는다면, Windows의 “숨겨진 항목 표시” 기능이 켜져 있지 않은 것입니다. 먼저 파일 탐색기에서 이 기능을 활성화해 주세요.)
2.
.codex 폴더가 없다면, 해당 폴더를 수동으로 생성한 다음 그 안에 config.toml와 auth.json라는 두 개의 파일을 만들어 주세요.3. 구성 정보를 입력하세요. (You need to replace
sk-xxx with the actual SK you have created.)a. auth.json 내의 구성:{"OPENAI_API_KEY": "sk-xxx"}config.toml의 설정 (아래 내용을 그대로 붙여넣기만 하면 됩니다):model_reasoning_effort의 옵션 값은 high, medium, low로, 각각 모델의 사고 노력 정도(높음, 중간, 낮음)를 나타냅니다.model_provider = "api111" model = "gpt-5-codex" model_reasoning_effort = "high" disable_response_storage = true preferred_auth_method = "apikey" [model_providers.api111] name = "api111" base_url = "https://api.airai.cc/v1" wire_api = "responses"
코덱스 시작
터미널을 재시작하세요! 터미널을 재시작하세요! 터미널을 재시작하세요!그런 다음 여러분의 프로젝트 디렉터리로 이동하세요:
cd your-project-folder
codex
VSCode 플러그인 코드베이스
위 설정을 완료한 후, VSCode 확장 스토어에서 `codex`를 검색하여 설치하시면 됩니다.설치가 완료되면 사이드바에 나타납니다.
Mac 버전 튜토리얼
시스템 요구 사항
macOS 12 이상 버전
Node.js 22+
npm 10+
네트워크 연결
설치 단계
1. Node.js 설치하기방법 1직접 접근 Node.js 공식 웹사이트 최신 LTS 버전을 다운로드하고 설치하세요.
방법 두：Homebrew를 사용하는 것을 추천합니다.
# 如果尚未安装 Homebrew，请先运行此命令/bin/bash -c "$(curl -fsSL [https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh](https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh))"# 安装 Node.jsbrew install node
터미널(Terminal)을 열고 다음 명령을 실행하세요 (
sudo가 필요할 수 있습니다):npm install -g @openai/codex
터미널(Terminal)을 열고 다음 명령을 실행하세요:
codex --version
API 설정 API 구성
1. 인증 토큰(Auth Token) 획득접속 api.airai.cc 사이트 페이지에서 다음 작업을 수행하세요:
클릭 콘솔 → API 토큰 페이지
클릭 토큰을 추가하세요
토큰 그룹을 선택하십시오:Codex 전용(이 그룹을 반드시 선택해야 합니다. 그렇지 않으면 사용할 수 없습니다.)
Token 이름은 임의입니다.
권장 한도: 다음과 같이 설정하십시오. 무제한 사용량
다른 옵션은 기본값으로 유지하세요
중요한 안내: api.airai.cc에서 생성한 실제 API 키로 `sk-xxx`를 대체해 주세요!
중요한 안내:请将下方的 `sk-xxx` 替换为您在 api.airai.cc 生成的实际 API 密钥！
중요한 안내: api.airai.cc에서 생성한 실제 API 키로 `sk-xxx`를 대체해 주세요!
1.
디렉터리와 파일을 생성합니다:
mkdir -p ~/.codextouch ~/.codex/auth.jsontouch ~/.codex/config.toml
2.
auth.json 파일을 편집합니다:vi ~/.codex/auth.json
i를 눌러 삽입 모드로 들어가서 아래 내용을 붙여넣으세요(sk-xxx를 자신의 비밀 키로 바꾸세요). 그런 다음 ESC를 누르고, :wq를 입력한 후 엔터를 눌러 저장하고 종료하세요.{"OPENAI_API_KEY": "sk-xxx"}3.
config.toml 파일을 편집합니다:vi ~/.codex/config.toml
i를 눌러 삽입 모드로 들어가서 아래 내용을 붙여넣은 다음, ESC를 누르고 :wq를 입력한 후 엔터를 눌러 저장하고 종료하세요.model_provider = "api111" model = "gpt-5-codex" model_reasoning_effort = "high" disable_response_storage = true preferred_auth_method = "apikey" [model_providers.api111] name = "api111" base_url = "https://api.airai.cc/v1" wire_api = "responses"
코덱스 시작
터미널을 재시작하세요! 터미널을 재시작하세요! 터미널을 재시작하세요!그런 다음 여러분의 프로젝트 디렉터리로 이동하세요:
cd your-project-folder
codex
VSCode 플러그인 코드베이스
위 설정을 완료한 후, VSCode 확장 스토어에서 `codex`를 검색하여 설치하시면 됩니다.[이미지]설치가 완료되면 사이드바에 나타납니다.
[이미지]
리눅스 버전 튜토리얼
시스템 요구 사항
주요 리눅스 배포판 (Ubuntu 20.04+, Debian 10+, CentOS 7+, 등)
Node.js 22+
npm 10+
네트워크 연결
설치 단계
1. Node.js 설치하기Ubuntu/Debian
sudo apt update curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -sudo apt-get install -y nodejs
CentOS/RHEL/Fedora
# 使用 dnf (Fedora) 或 yum (CentOS/RHEL)sudo dnf install nodejs npm# 或sudo yum install nodejs npm
Arch Linux
sudo pacman -S nodejs npm
터미널(Terminal)을 열고 다음 명령을 실행하세요:
sudo npm install -g @openai/codex
터미널(Terminal)을 열고 다음 명령을 실행하세요:
codex --version
API 설정 API 구성
1. 인증 토큰(Auth Token) 획득접속 api.airai.cc 사이트 페이지에서 다음 작업을 수행하세요:
클릭 콘솔 → API 토큰 페이지
클릭 토큰을 추가하세요
토큰 그룹을 선택하십시오:codex 채널-GPT(이 그룹을 반드시 선택해야 합니다. 그렇지 않으면 사용할 수 없습니다.)
Token 이름은 임의입니다.
권장 한도: 다음과 같이 설정하십시오. 무제한 사용량
다른 옵션은 기본값으로 유지하세요
[이미지]
[이미지]
중요한 안내:제발 아래의sk-xxx를 api.airai.cc에서 생성한 실제 API 키로 바꿔주세요!
중요한 안내: 아래의sk-xxx를 api.airai.cc에서 생성한 실제 API 키로 바꿔주세요!
중요한 안내: 아래의sk-xxx를 api.airai.cc에서 생성한 실제 API 키로 바꿔주세요!
1.
디렉터리와 파일을 생성합니다:
mkdir -p ~/.codextouch ~/.codex/auth.jsontouch ~/.codex/config.toml
2.
auth.json 파일을 편집합니다:vi ~/.codex/auth.json
i를 눌러 삽입 모드로 들어가서 아래 내용을 붙여넣으세요(sk-xxx를 자신의 비밀번호로 바꾸세요). 그런 다음 ESC를 누르고, :wq를 입력한 후 엔터를 눌러 저장하고 종료하세요.{"OPENAI_API_KEY": "sk-xxx"}3.
config.toml 파일을 편집합니다:vi ~/.codex/config.toml
i를 눌러 삽입 모드로 들어가서 아래 내용을 붙여넣은 다음, ESC를 누르고, :wq를 입력한 후 엔터를 눌러 저장하고 종료하세요.model_provider = "api111" model = "gpt-5-codex" model_reasoning_effort = "high" disable_response_storage = true preferred_auth_method = "apikey" [model_providers.api111] name = "api111" base_url = "https://api.airai.cc/v1" wire_api = "responses"
코덱스 시작
터미널을 재시작하세요! 터미널을 재시작하세요! 터미널을 재시작하세요!그런 다음 여러분의 프로젝트 디렉터리로 이동하세요:
cd your-project-folder
codex
VSCode 플러그인 코드베이스
위 설정을 완료한 후, VSCode 확장 스토어에서 ‘codex’를 검색하여 설치하시면 됩니다.설치가 완료되면 사이드바에 나타납니다.
흔한 질문들
오류가 발생하면 다음 단계에 따라 문제를 조사하십시오:1.
API 키 생성이 올바르게 이루어졌는지 확인하세요: 사용량 범위를 선택하세요.무제한 사용량，모델을 제한하지 말고, 그룹으로 선택하세요. codex 채널-GPT。
도움이 되었나요?