Skip to main content
Codex는 OpenAI의 코딩 에이전트로 세 가지 형태로 제공됩니다: 터미널의 Codex CLI, VS Code의 Codex 확장, 그리고 Codex 앱. 세 가지 모두 같은 ~/.codex 폴더를 읽으므로 한 번 설정으로 모두 적용됩니다.

​
명령 하나로 설치

sk-xxx를 키로 교체하고 터미널을 열어 붙여넣고 Enter를 누르세요. 스크립트가 키를 확인하고, 키가 호출 가능한 모든 모델을 나열하여 선택하게 해줍니다(Enter = 권장: Astra는 gpt-astra, GPT는 gpt-5.6-sol, Claude는 claude-opus-5), Codex CLI를 설치하고 설정을 작성합니다.
스크립트는 먼저 언어를 묻습니다(1 = 베트남어, 2 = 영어; --lang en 또는 --lang vi로 건너뛸 수 있습니다). --key 없이는 키를 입력하라고 합니다. 모델을 강제하려면 --model gpt-astra 또는 --model gpt-5.6-sol을 추가하세요.
원하시면 실행 전에 소스를 읽어보세요: codex.sh, codex.ps1. 스크립트는 귀하의 기기에서만 실행되며 키는 확인을 위해 gpt.teamsoclo.site에만 전송됩니다.

​
스크립트가 하는 일

  1. 게이트웨이로 키를 확인하고 패키지에 맞는 모델을 선택합니다; 잘못된 키는 기기에 아무것도 변경하지 않고 여기서 중단됩니다.
  2. 기존 config.toml이 있으면 config.toml.bak.<timestamp>로 백업합니다.
  3. ~/.codex/config.toml 작성: 모델 gpt-5.6-sol, TeamSocLo 게이트웨이, Responses API.
  4. 환경 변수 TEAMSOCLO_API_KEY에 키를 저장합니다(~/.zshrc / ~/.bashrc, 또는 Windows 사용자 변수). 키는 설정 파일에 없으므로 유출 없이 config.toml을 공유할 수 있습니다.
  5. npm install -g @openai/codex로 Codex CLI를 설치하거나 업그레이드합니다.
키나 패키지를 변경할 때 언제든지 다시 실행하세요; 이전 설정은 항상 먼저 백업됩니다.
터미널을 사용하지 않으시겠어요? TeamSocLo Key Tool은 Windows 및 macOS용 앱입니다: 키를 한 번 붙여넣으면 Codex, Claude Code 및 20개 이상의 다른 도구가 설정됩니다.

​
설치 후

1

새 터미널을 열고 codex 실행

이전 터미널은 새 변수를 로드하지 않았습니다; 새 탭을 여세요. 확인을 위해 Codex에 무엇이든 물어보세요.
2

VS Code: 확장 설치, 완전히 종료, 다시 열기

VS Code → 확장 → Codex(OpenAI의 코딩 에이전트) 검색 → 설치. 그런 다음 VS Code를 완전히 종료하세요: macOS Cmd + Q, Windows는 모든 창을 닫으세요. Reload Window로는 충분하지 않습니다; 확장은 프로세스 시작 시에만 설정을 읽습니다.
3

Codex 앱

명령 실행 후 앱을 다시 여세요. macOS에서 명령은 launchctl을 통해 GUI 앱에 변수를 설정했습니다; Windows에서 setx는 이후 시작되는 앱에 적용됩니다.
OpenAI 로그인이 필요하지 않습니다. requires_openai_auth = false가 Codex에게 환경 변수의 게이트웨이 키를 사용하도록 지시합니다.

​
수동 설정

직접 편집하려면 ~/.codex/config.toml(Windows: %USERPROFILE%\.codex\config.toml)에 정확히 다음이 포함되어야 합니다:
그리고 환경 변수 TEAMSOCLO_API_KEY에 키가 있어야 합니다.
wire_api = "responses"를 유지하세요. Codex는 Responses API를 사용합니다; chat으로 전환하면 작동하지 않습니다.
설정 폴더를 빠르게 열기:

​
모델 변경

GPT Astra 패키지는 gpt-astra를 사용합니다. config.toml의 첫 번째 줄을 편집하고 Codex를 재시작하세요:
gpt-astra를 호출하는 GPT 키는 “no available channel”을 받으며, 반대도 마찬가지입니다. 모델은 구매한 패키지를 따릅니다, 모델 및 패키지 참조.

​
제거

Codex를 유지하고 이전 설정으로 돌아가려면 config.toml.bak.<timestamp>를 config.toml 위에 복사하세요.

​
작동하지 않는 경우

  • 설치 후 새 터미널을 열었거나 VS Code를 완전히 종료했는지 확인.
  • echo $TEAMSOCLO_API_KEY(Windows: cmd에서 echo %TEAMSOCLO_API_KEY%)가 전체 키를 출력합니다.
  • base_url이 /v1로 끝나고, wire_api가 responses입니다.
  • 키가 여전히 유효하고 할당량이 있습니다: 여기서 확인.
  • 그렇지 않으면 문제 해결을 참조하세요, Codex 섹션이 있습니다.