빠른 조회
키 및 할당량
잘못되거나 잘린 키
가장 흔한 문제는 망가진 키가 아니라 마우스로 텍스트를 선택하는 동안 몇 글자가 손실된 것입니다. 항상 교환 페이지의 Copy 버튼을 사용하세요. 확인 페이지에 키를 붙여넣으세요: 유효하다고 표시되면 키는 문제없고 문제는 앱 설정에 있습니다.키 만료
모든 패키지는 교환 시점부터 계산되는 유효 기간이 있습니다(제품에 명시됨). 만료 후에는 할당량이 남아 있어도 모든 요청이 401을 반환합니다. 확인 페이지에서 만료일을 확인할 수 있습니다. 미사용 토큰은 새 코드로 이전되지 않습니다.할당량 소진
모든 것이 작동하다가 갑자기 모든 요청이 insufficient quota로 실패합니다. 확인 페이지에서 남은 양을 확인하세요. 할당량이 비정상적으로 빨리 줄어드는 것은 보통 에이전트가 전체 저장소를 읽거나, 매 턴마다 매우 긴 대화가 재전송되기 때문입니다.키 분실
redeem.teamsoclo.site에서 같은 CDK 코드를 다시 교환하면 페이지에 원래 키가 표시됩니다. 코드는 새 키로 재발급되지 않습니다.키당 몇 대의 기기
기기 제한은 없지만 분당 요청 한도는 해당 키를 사용하는 모든 기기가 공유합니다. 키를 공유하면 사용자들이 같은 한도를 두고 경쟁하여 더 빨리 429에 도달합니다.연결
/v1 누락
올바른 Base URL은https://gpt.teamsoclo.site/v1입니다. /v1 없이는 요청이 API 대신 웹사이트에 도달하여 앱이 404 또는 “연결할 수 없습니다”를 보고합니다.
다른 패키지의 모델 호출
No available channel for model gpt-astra under group default는 GPT 키가 Astra 모델을 호출(또는 그 반대)하고 있다는 의미입니다. 각 키는 자체 패키지의 모델만 호출할 수 있습니다. 다음으로 확인하세요:
429 Too Many Requests
각 키에는 패키지에서 설정한 분당 최대 성공 요청 수가 있습니다. 초과하면 “request limit reached” 메시지와 함께 429가 반환됩니다. 다음 분을 기다리세요. 배치 스크립트의 경우 호출 사이에 딜레이를 추가하거나, 부하를 분산하기 위해 다른 코드를 구매하세요.응답이 중간에 잘림
긴 사고가 필요한 질문에서는 비스트리밍 요청이 첫 번째 토큰 전에 끊길 수 있습니다.stream: true를 활성화하세요. 대부분의 채팅 앱은 이미 그렇게 하며, 코드에서 호출할 때 추가하세요.
Unsupported parameter: reasoning_effort
Chat Completions만 최상위 reasoning_effort를 받습니다. Responses API에서는 "reasoning": {"effort": "high"}를 사용하세요. Codex는 이것을 스스로 처리합니다.
Codex
설치 후 codex: command not found
npm이 완료되었지만 현재 터미널이 PATH를 다시 로드하지 않았습니다. 새 터미널을 여세요. 그래도 실패한다면, npm의 bin 폴더가 PATH에 있는지 확인하세요:
/bin을 더한 것이 $PATH에 있어야 합니다.
Codex가 여전히 OpenAI 로그인을 요청함
TEAMSOCLO_API_KEY 변수가 Codex 프로세스에 전달되지 않았습니다:
- 터미널: 새 탭을 열고
echo $TEAMSOCLO_API_KEY를 확인하세요. - macOS의 VS Code:
Cmd + Q로 종료하고 다시 여세요. 설치 명령이launchctl을 통해 GUI 앱에 변수를 설정했습니다. - Linux의 VS Code: 터미널에서 VS Code를 시작하세요(
code .), 또는 로그아웃 후 다시 로그인하세요. - Windows:
setx후 새 PowerShell 또는 VS Code를 여세요.
config.toml에 requires_openai_auth = false와 env_key = "TEAMSOCLO_API_KEY"가 있는지 확인하세요.
config.toml을 편집했지만 Codex가 변경되지 않음
설정은 프로세스 시작 시에만 읽힙니다. Reload Window로는 충분하지 않습니다; VS Code를 완전히 종료하세요(macOSCmd + Q, Windows는 모든 창과 백그라운드 프로세스를 닫으세요). 이것이 가장 많이 묻는 Codex 질문입니다.
npm 설치 시 EACCES: permission denied
Node가 시스템 권한으로 설치되었으며, Linux에서 흔합니다. npm의 접두사를 변경하세요:
export 줄을 ~/.bashrc 또는 ~/.zshrc에 추가하세요. 장기적으로는 nvm을 통해 Node를 설치하세요, 시작하기 참조.
Windows: running scripts is disabled on this system
PowerShell은 .ps1 파일을 차단하며, PowerShell에서 입력한 codex / npm은 npm의 .ps1 심을 통해 실행됩니다. 한 번 실행하세요:
codex.cmd, npm.cmd를 입력하세요.
Windows: EBUSY: resource busy or locked
Codex가 실행 중(CLI, 확장 또는 앱)이어서 npm이 codex.exe를 덮어쓸 수 없습니다. Codex를 실행하는 모든 것을 닫고 설치 명령을 다시 실행하세요. 설정은 이미 이 단계 전에 작성되었으며, CLI 업그레이드만 건너뛰어졌습니다.
Windows: 설정 파일 인코딩 오류
PowerShell 5.1로Set-Content -Encoding UTF8로 편집하면 Codex가 읽을 수 없는 BOM이 추가됩니다. 설치 명령을 다시 사용하거나(BOM 없는 UTF-8로 작성), VS Code에서 파일을 UTF-8(UTF-8 with BOM 아님)로 저장하세요.
이전 설정 복원
설치 명령 실행마다 이전 설정이 새 것 옆에 백업됩니다:자주 묻는 질문
키를 어떻게 변경하나요
새 키로 Codex 설치 명령을 다시 실행하거나, 도구를 다시 실행하세요. Cursor, Cline 및 Chatbox의 경우 설정의 API Key 필드를 편집하세요.설치 명령을 여러 번 실행해도 안전한가요
네. 재실행을 위해 설계되었습니다: 이전 설정이.bak.<timestamp>로 저장되고, CLI가 업그레이드되며, 쉘 rc의 이전 키 줄이 교체됩니다.
명령이 내 키를 어딘가에 전송하나요
아니요. 자신의 기기에서 명령에 키를 붙여넣습니다; 환경 변수와 로컬 설정 파일만 작성됩니다. 전체 명령이 페이지에 표시되어 있으니 실행하기 전에 모든 줄을 읽어보세요.모두 제거
Codex 페이지의 Uninstall 참조. 다른 앱은 앱의 설정에서 키를 삭제하세요.여전히 작동하지 않는 경우
1
키가 활성 상태인지 확인
확인 페이지에 붙여넣으세요. 여기서 오류가 발생하면 키(잘못됨, 만료됨, 할당량 소진)가 문제이지 앱이 아닙니다.
2
cURL로 API 직접 호출
3
앱에서 세 가지 재확인
Base URL이
/v1로 끝나는지, 키가 완전한지, 모델이 패키지와 일치하는지. 이것이 거의 모든 문제의 원인입니다.4
지원 문의
오류 스크린샷과 키의 마지막 4자리를 t.me/teamsoclo에 보내세요. 전체 키는 절대 보내지 마세요.