Your privacy choices

Allow optional cookies for referral attribution and anonymous visit measurement.

Codex 배포 가이드

CLI 도구 설치, API 연동 및 개발 환경 설정 방법을 안내합니다.

📋 사전 요구 사항(첫 번째 단계) 먼저 Node.js 환경 설치를 완료하여 Node.js 18+가 올바르게 설치되었는지 확인하십시오. 설정할 때 ccs의 고급 옵션을 활성화하면 모델 추가 후 바로 채팅할 수 있습니다.


🎯 빠른 탐색

CodeX는 GPT-5 아키텍처를 기반으로 하는 차세대 지능형 프로그래밍 도우미로, 개발자에게 뛰어난 코드 생성 및 최적화 기능을 제공합니다.

배포 경로: 시스템 환경 설정 ➜ CLI 도구 설치 ➜ API 통합 ➜ 개발 환경 준비 완료

🚀 CC-Switch를 사용한 빠른 설정(권장)

⚠️ 사전 조건

CC-Switch로 CodeX를 설정하기 전에 npm을 통해 CodeX 도구를 전역으로 설치했는지 확인하십시오.

npm install -g @openai/codex@latest
下载压缩包 下载压缩包

설치 검증: codex --version

명령줄 작업 없이 간편하고 빠르게 그래픽 화면에서 설정할 수 있는 CC-Switch 빠른 설정 도구 사용을 권장합니다.

설정 단계

  1. CC-Switch를 실행하고 Codex 탭으로 전환합니다.

CC-Switch 앱 화면입니다. 위쪽의 여러 탭 중 빨간색 화살표가 ‘Codex’ 탭을 가리켜 강조합니다. ‘CC-Switch를 사용한 빠른 설정(권장)’의 설정 단계에 해당하며, CC-Switch 실행 후 위쪽의 ‘Codex’ 탭을 클릭하여 이후 설정 작업으로 이동해야 하는 핵심 단계를 보여 줍니다.CC-Switch 앱 화면입니다. 위쪽의 여러 탭 중 빨간색 화살표가 ‘Codex’ 탭을 가리켜 강조합니다. ‘CC-Switch를…

  1. CC-Switch 앱을 엽니다.
  2. 위쪽의 ‘Codex’ 탭을 클릭합니다.
  3. 오른쪽 위의 주황색 ‘+’ 버튼을 클릭하여 새 설정을 추가합니다.
  4. CodeX 제공자 설정을 입력합니다.
  5. 제공자 이름: 사용자 지정 이름(예: ‘gpt-agent’)
  6. Base URL: https://api.llm-token.cn/v1 입력
  7. API Key: 본인의 APIkey 붙여넣기
  8. Model: gpt-5.4 선택(문서 작성 당시 최신 모델은 5.4)
  9. 기타 설정: 필요에 따라 추론 강도, 네트워크 접근 등의 매개변수를 조정합니다.
  10. ‘저장’ 버튼을 클릭합니다.

CC-Switch 앱에서 새 설정을 추가하는 화면입니다. 위쪽에는 ‘Codex 공급업체’와 ‘통합 공급업체’ 탭이 있으며 현재 ‘Codex 공급업체’가 선택되어 있습니다. 아래에는 ‘사용자 지정 설정’과 OpenAI Official, Shengsuan Cloud 등의 사전 설정 공급업체 옵션이 있습니다. 화면 아래쪽에는 ‘공급업체 이름’과 ‘비고’ 입력란, ‘취소’ 및 ‘추가’ 버튼이 있습니다. 오른쪽 위의 주황색 ‘+’ 버튼으로 새 설정을 추가한 뒤 사용자 지정 설정을 진행하는 화면입니다.CC-Switch 앱에서 새 설정을 추가하는 화면입니다. 위쪽에는 ‘Codex 공급업체’와 ‘통합 공급업체’ 탭이 있으며 현재 ‘…

CC-Switch의 공급업체 설정 편집 화면입니다. 위쪽에 해당 도구 표시가 있고 여러 설정 입력 항목이 있습니다. 공급업체 이름에는 ‘Guizhou 클라우드 컴퓨팅 파워’가 입력되어 있고, 공식 웹사이트 링크 입력란에는 ‘https:///’의 일부가 표시됩니다. API Key에는 마스킹된 키가 붙여 넣어져 있으며 API 요청 주소에는 ‘https://api.llm-token.cn/v1’이 입력되어 있습니다. 아래의 노란색 안내에는 OpenAI Response 형식과 호환되는 서버 엔드포인트 주소를 입력해야 한다고 표시되며 오른쪽 아래에는 파란색 ‘저장’ 버튼이 있습니다. Codex 배포 가이드의 제공자 설정 입력 요건에 해당합니다.CC-Switch의 공급업체 설정 편집 화면입니다. 위쪽에 해당 도구 표시가 있고 여러 설정 입력 항목이 있습니다. 공급업체 이름…

💡 팁

  • CC-Switch는 ~/.codex/config.tomlauth.json 파일을 자동으로 생성합니다.
  • 여러 제공자 설정을 추가하고 언제든 전환할 수 있습니다.
  • 설정을 전환한 뒤 CodeX를 종료하고 다시 시작하면 적용됩니다.
  1. 설정을 활성화하여 사용합니다.
  2. 설정 목록에서 방금 만든 설정을 찾습니다.
  3. 설정 오른쪽의 ‘현재 사용’ 버튼을 클릭합니다.
  4. 설정이 ‘현재 사용’ 상태로 표시됩니다(녹색 태그).
  5. CodeX를 다시 시작하면 새 설정이 적용됩니다.
  6. 시스템 트레이에서 빠르게 전환합니다.

CC-Switch는 시스템 트레이를 통한 빠른 CodeX 설정 전환을 지원합니다.

  • 시스템 트레이의 CC-Switch 아이콘을 마우스 오른쪽 버튼으로 클릭합니다.
  • 메뉴에서 Codex 분류를 선택합니다.
  • 전환할 설정을 바로 선택합니다.
  • 기본 화면을 열지 않아도 설정이 즉시 적용됩니다.

⚠️ 주의 사항

  • 설정을 전환한 뒤 CodeX를 재시작해야 적용됩니다.
  • CC-Switch에서 API 엔드포인트 속도를 테스트할 수 있습니다.

⌨️ 수동 명령줄 설정

CC-Switch를 사용하지 않는 경우 다음 단계에 따라 CodeX를 수동으로 설정할 수 있습니다.

🖥️ Windows 플랫폼

첫 번째 단계: CodeX 명령줄 도구 배포

명령 프롬프트 또는 PowerShell을 관리자 권한으로 실행하고 다음을 입력합니다.

npm install -g @openai/codex@latestcodex --version

설정 파일 작성: config.toml

model_provider = "gpt-agent"model = "gpt-5.4"model_reasoning_effort = "xhigh"disable_response_storage = trueapproval_policy = "on-request"sandbox_mode = "danger-full-access"model_supports_reasoning_summaries = true[model_providers.gpt-agent]name = "ikun"base_url = "https://api.llm-token.cn/v1"wire_api = "responses"requires_openai_auth = true

인증 파일 작성: auth.json

{  "OPENAI_API_KEY": "此处粘贴您的 CodeX 专用令牌"}

세 번째 단계: 작업 공간 초기화

mkdir my-codex-projectcd my-codex-projectcodex

🍏 macOS 플랫폼

CodeX 도구 배포

npm install -g @openai/codex@latestcodex --version

API 서비스 통합

설정 디렉터리를 만듭니다.

mkdir -p ~/.codexcd ~/.codex

config.toml 설정 작성:

cat > config.toml << 'EOF'model_provider = "gpt-agent"model = "gpt-5.4"model_reasoning_effort = "xhigh"disable_response_storage = trueapproval_policy = "on-request"sandbox_mode = "danger-full-access"model_supports_reasoning_summaries = true[model_providers.gpt-agent]name = "ikun"base_url = "https://api.llm-token.cn/v1"wire_api = "responses"requires_openai_auth = trueEOF

auth.json 인증 설정 작성:

cat > auth.json << 'EOF'{  "OPENAI_API_KEY": "此处粘贴您的 CodeX 专用令牌"}EOF

작업 공간 초기화

mkdir my-codex-projectcd my-codex-projectcodex

🐧 Linux 플랫폼

CodeX 도구 배포

sudo npm install -g @openai/codex@latestcodex --version

1 2

API 서비스 통합

설정 디렉터리를 만듭니다.

mkdir -p ~/.codexcd ~/.codex

config.toml 설정 작성:

cat > config.toml << 'EOF'model_provider = "gpt-agent"model = "gpt-5.4"model_reasoning_effort = "xhigh"disable_response_storage = trueapproval_policy = "on-request"sandbox_mode = "danger-full-access"model_supports_reasoning_summaries = true[model_providers.gpt-agent]name = "ikun"base_url = "https://api.llm-token.cn/v1"wire_api = "responses"requires_openai_auth = trueEOF

auth.json 인증 설정 작성:

cat > auth.json << 'EOF'{  "OPENAI_API_KEY": "此处粘贴您的 CodeX 专用令牌"}EOF

작업 공간 초기화

mkdir my-codex-projectcd my-codex-projectcodex

설정 파일 위치

  • Windows: %USERPROFILE%\.codex\
  • macOS/Linux: ~/.codex/

설정 후 채팅할 수 없나요?

다음 방법을 시도하고, 그래도 해결되지 않으면 고객 지원에 문의하십시오.

CC Switch 화면입니다. 위쪽에 ‘CC Switch’ 제목과 여러 아이콘이 있습니다. ‘Guizhou 클라우드 컴퓨팅 파워’ 행이 녹색 배경으로 표시되고 왼쪽에는 점 세 개 아이콘, 오른쪽에는 ‘조회 실패’ 표시가 있습니다. 빨간색 화살표가 왼쪽의 톱니바퀴 아이콘을 가리킵니다. ‘설정 후 채팅할 수 없나요?’에서 관련 설정 작업을 진행하기 위해 클릭할 위치를 안내합니다.CC Switch 화면입니다. 위쪽에 ‘CC Switch’ 제목과 여러 아이콘이 있습니다. ‘Guizhou 클라우드 컴퓨팅 파워’…

CC Switch 설정 화면입니다. 빨간색 화살표가 위쪽의 ‘프록시’ 탭과 ‘로컬 프록시’ 영역의 ‘실행 중’ 상태를 각각 가리킵니다. ‘로컬 프록시’ 모듈에서는 프록시 서비스 스위치를 제어하고 상태와 포트 정보를 확인할 수 있으며, ‘실행 중’은 프로그램의 프록시 서비스가 정상적으로 동작하고 있음을 뜻합니다.CC Switch 설정 화면입니다. 빨간색 화살표가 위쪽의 ‘프록시’ 탭과 ‘로컬 프록시’ 영역의 ‘실행 중’ 상태를 각각 가리킵…

Codex 배포 가이드 설정 페이지의 프록시 관련 화면입니다. 위쪽에는 ‘일반’, ‘프록시’, ‘로그’ 탭이 있고 현재 ‘프록시’가 선택되어 있습니다. 프록시 기본 스위치와 활성화 상태가 표시되며, 활성화 시 아래에 Codex와 Gemini 옵션이 나타나고 빨간색 화살표가 Codex를 가리킵니다. 프록시 서버 주소, 포트, 유형, 기능, 앱 로그 기록 및 앱 로그 기록 스위치 등의 설정도 있습니다. 설정 후 채팅할 수 없는 문제를 해결하기 위한 프록시 설정을 보여 줍니다.Codex 배포 가이드 설정 페이지의 프록시 관련 화면입니다. 위쪽에는 ‘일반’, ‘프록시’, ‘로그’ 탭이 있고 현재 ‘프록시’…