https://api.acedata.cloud/v1로 전송합니다.
신청 절차
Codex CLI를 사용하려면 먼저 Ace Data Cloud 콘솔에서 API 토큰을 받아 두세요.
로그인 또는 회원가입하지 않은 경우 자동으로 로그인 페이지로 이동하며, 로그인 후 현재 페이지로 자동 복귀합니다.
초기 신청 시 무료 할당량이 제공되어 Codex CLI 서비스를 무료로 체험할 수 있습니다.
Codex CLI 설치
Codex CLI는 macOS, Linux, Windows, WSL을 지원합니다. npm을 통해 설치하거나 macOS에서는 Homebrew를 사용할 수 있습니다.npm 설치 (추천)
Node.js가 설치되어 있다면 npm으로 직접 설치할 수 있습니다. Node.js 18 이상 버전이 필요합니다.Homebrew 설치 (macOS)
macOS 사용자는 Homebrew로도 설치 가능합니다:설치 확인
설치 후 터미널을 다시 열고 명령어가 작동하는지 확인하세요:command not found 오류가 발생하면 현재 터미널에 새 PATH가 적용되지 않은 경우가 많습니다. 터미널을 닫았다가 다시 열거나 설치 스크립트 출력에 안내된 PATH 설정을 확인하세요.
Codex CLI 설정
설치 후 Codex CLI는 기본적으로 OpenAI 공식 서비스에 연결을 시도합니다. Ace Data Cloud를 사용하려면 Codex 설정 파일에 사용자 지정model_provider를 선언하고 API 토큰을 해당 환경 변수에 넣어야 합니다.
1단계: 환경 변수 설정
API 토큰을 Shell 설정 파일(~/.zshrc, ~/.bashrc, ~/.bash_profile 등)에 작성하는 것을 권장합니다:
{token}은 Ace Data Cloud 콘솔에서 복사한 API 토큰으로 교체하세요.
설정 후 터미널을 다시 열거나 다음 명령어로 즉시 적용할 수 있습니다:
2단계: Codex 설정 파일 편집
Codex CLI는~/.codex/config.toml을 전역 설정 파일로 사용합니다. 파일이 없으면 새로 만드세요:
~/.codex/config.toml에 작성하세요:
이전 OpenAI 로그인 캐시 정리
이전에 OpenAI 공식 계정으로 Codex CLI에 로그인한 적이 있다면, 로컬에 공식 로그인 상태가 캐시되어 있을 수 있습니다(~/.codex/auth.json에 보통 저장됨). Ace Data Cloud 프록시로 전환하기 전에 이전 로그인을 정리하는 것이 좋습니다:
codex logout 명령이 없으면 수동으로 캐시 파일을 삭제할 수 있습니다:
세션 시작
프로젝트 디렉터리로 이동한 후 Codex CLI를 실행하세요:설정 확인
Codex CLI 진입 후 현재 모델과 공급자를 확인하려면:acedatacloud 공급자에서 왔는지 확인할 수 있습니다:
acedatacloud가 아니면 설정이 적용되지 않은 것입니다. ~/.codex/config.toml 저장 여부와 현재 터미널에서 ACEDATACLOUD_API_KEY가 읽히는지 확인하세요:
작동 원리
Codex CLI는 기본적으로 OpenAI Responses API 프로토콜을 사용합니다. Ace Data Cloud는https://api.acedata.cloud/v1/responses에서 OpenAI Responses API 호환 프록시 서비스를 제공하므로, Codex CLI는 별도의 로컬 프록시나 추가 플러그인이 필요 없습니다.
작동 과정:
- Codex CLI가
~/.codex/config.toml에서model_provider를 읽고[model_providers.acedatacloud]설정을 로드합니다. env_key에 지정된 환경 변수(ACEDATACLOUD_API_KEY)에서 API 토큰을 읽습니다.wire_api = "responses"프로토콜을 통해 요청을base_url + /responses즉,https://api.acedata.cloud/v1/responses로 전송합니다.- Ace Data Cloud가 API 토큰으로 인증, 할당량 확인 후 요청을 적절한 상위 모델 채널로 전달합니다.
- 요청 완료 후 실제 사용량에 따라 플랫폼이 사용량을 기록하고 할당량을 차감합니다.
codex 명령과 Codex CLI의 기본 인터랙션 경험을 유지하면서, 하위 모델 서비스만 Ace Data Cloud로 전환하는 것입니다.
모델 설정
~/.codex/config.toml의 model 필드가 Codex 기본 모델을 결정합니다. Ace Data Cloud OpenAI Responses 서비스는 여러 모델을 지원하며, 주요 모델은 다음과 같습니다:
임시로 모델을 바꾸려면 Codex 실행 시 명령행 인자를 사용할 수 있습니다:
~/.codex/config.toml의 model 필드를 수정한 후 재시작하세요. 전체 모델 목록은 Ace Data Cloud OpenAI 서비스 문서를 참고하세요.
프로젝트 신뢰 수준
Codex CLI는 프로젝트별로 신뢰 수준을 설정하여 에이전트가 수행할 작업을 제어할 수 있습니다.~/.codex/config.toml 파일 끝에 다음을 추가하세요:
trusted: 에이전트가 전체 권한을 가지고 명령 실행, 파일 수정 가능untrusted: 제한된 권한만 부여, 익숙하지 않은 프로젝트에 적합