GEODE를 돌리려면 프로바이더 자격이 하나 필요합니다. 이 페이지는 세 가지 자격 경로를 비교하고, 본인 상황에 맞는 가장 빠른 길을 안내합니다.
세 가지 경로
| 경로 | 자격 | 등록 방법 | 적합한 상황 |
|---|
| 1. ChatGPT 구독 OAuth | ChatGPT 구독 OAuth | /login openai로 device-code 로그인. 기존 ~/.codex/auth.json 자격도 가져올 수 있습니다. | 이미 ChatGPT를 결제 중이고 API 키를 따로 만들기 싫을 때. gpt-5.5는 이 경로로만 라우팅됩니다. |
| 2. PAYG API 키 | ANTHROPIC_API_KEY, OPENAI_API_KEY, ZAI_API_KEY | ~/.geode/.env에 키만 적습니다. geode setup 또는 /login add로 기록할 수도 있습니다. | 토큰 단위로 비용을 직접 통제하고 싶을 때. 팀 계정과 CI에도 맞습니다. |
| 3. 저비용 GLM 경로 | ZAI_API_KEY (GLM) | 같은 방식으로 ~/.geode/.env에 등록합니다. | 거의 무료로 먼저 체험할 때. glm-4.7-flash는 한시 무료 티어입니다. |
~/.geode/.env는 시크릿 전용 파일입니다. 모델 선택 같은 동작 설정은 ~/.geode/config.toml에 저장되며, .env에 모델을 적는 방식은 더 이상 쓰지 않습니다.
가장 빠른 길 찾기
| 원하는 것 | 이렇게 합니다 |
|---|
| 이미 ChatGPT Plus를 결제 중입니다 | geode setup. ~/.codex/auth.json이 있으면 API 키를 묻기 전에 먼저 잡습니다. |
| API 키로 비용을 직접 통제하고 싶습니다 | ~/.geode/.env에 키를 넣고 비용 모니터링으로 예산을 겁니다. |
| 거의 무료로 먼저 체험하고 싶습니다 | GLM 키(ZAI_API_KEY)를 등록하고 /model에서 glm-4.7-flash를 고릅니다. |
| 특정 프로바이더를 키 인증으로 강제하고 싶습니다 | /login source <provider> api_key. 선택은 config.toml에만 저장됩니다. |
| 지금 뭐가 잡혀 있는지 확인하고 싶습니다 | geode about. 실효 모델, 프로바이더, 자격 프로파일 수를 한 화면에 보여줍니다. |
자격 소스 값
프로바이더별 자격 소스는 core/config/credential_source.py의 네 값 중 하나입니다.
| 값 | 의미 |
|---|
auto | 기본값. OAuth를 먼저 시도하고, PAYG 전환은 설정으로 게이트됩니다. |
api_key | PAYG API 키만 사용합니다. |
claude-cli | 퇴역한 Anthropic 입력입니다. migration 오류만 내며 실행되지 않습니다. |
openai-codex | 프로세스 내부 codex-oauth 어댑터로 ChatGPT 구독 OAuth를 사용합니다. |
예시
geode setup # 자격 감지 + 등록 마법사
geode # 대화 시작
> /login # 자격 대시보드
> /login openai # ChatGPT 구독 OAuth 로그인
> /login anthropic # Anthropic API 키 등록
> /login source openai api_key # OpenAI를 키 경로로 고정
geode about # 실효 모델 + 자격 상태 확인
실패 모드
| 증상 | 원인 | 해법 |
|---|
| setup이 ChatGPT OAuth를 못 찾음 | ~/.codex/auth.json 없음 | /login openai의 device-code 플로우를 씁니다. 기존 Codex CLI 자격은 가져오기만 하며 추론 실행 경로가 아닙니다. |
| 키를 넣었는데 모델이 안 바뀜 | .env는 시크릿 전용, 모델은 별개 설정 | /model로 고릅니다. 안 먹으면 geode config explain model로 어느 레이어가 이기는지 봅니다. |
| GLM 구독인데 미터링 과금 | Coding Plan 키가 PAYG 엔드포인트로 나감 | GLM은 Coding Plan과 PAYG 엔드포인트가 다릅니다. 프로바이더 설정의 GLM 절을 확인합니다. |
| 응답이 비거나 401 | OAuth 만료 또는 무효 키 | geode doctor로 점검하고 /login으로 갱신합니다. |
다음 단계