GEODE . 문서
GitHub
시작하기
How-to

경로 선택

구독 OAuth, API 키, 저비용 경로. 자격 경로를 고르는 결정 표입니다.

GEODE를 돌리려면 프로바이더 자격이 하나 필요합니다. 이 페이지는 네 가지 자격 경로를 비교하고, 본인 상황에 맞는 가장 빠른 길을 안내합니다.

네 가지 경로

경로자격등록 방법적합한 상황
1. ChatGPT 구독 OAuthChatGPT Plus 구독 (Codex CLI 토큰)geode setup이 ~/.codex/auth.json을 자동 감지합니다. 없으면 /login openai로 device-code 로그인.이미 ChatGPT를 결제 중이고 API 키를 따로 만들기 싫을 때. gpt-5.5는 이 경로로만 라우팅됩니다.
2. Anthropic 구독 OAuthClaude 구독 (claude CLI 자격)/login anthropic. macOS keychain의 Claude Code 자격을 읽습니다.Claude 구독이 있고 claude-opus-4-8 계열을 기본으로 쓰고 싶을 때.
3. PAYG API 키ANTHROPIC_API_KEY, OPENAI_API_KEY, ZAI_API_KEY~/.geode/.env에 키만 적습니다. geode setup 또는 /login add가 대신 적어줍니다.토큰 단위로 비용을 직접 통제하고 싶을 때. 팀 계정과 CI에도 맞습니다.
4. 저비용 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 키를 묻기 전에 먼저 잡습니다.
Claude 구독으로 쓰고 싶습니다geode 안에서 /login anthropic을 실행합니다.
API 키로 비용을 직접 통제하고 싶습니다~/.geode/.env에 키를 넣고 비용 모니터링으로 예산을 겁니다.
거의 무료로 먼저 체험하고 싶습니다GLM 키(ZAI_API_KEY)를 등록하고 /model에서 glm-4.7-flash를 고릅니다.
특정 프로바이더를 OAuth 대신 키로 강제하고 싶습니다/login source <provider> api_key. 선택은 config.toml에만 저장됩니다.
지금 뭐가 잡혀 있는지 확인하고 싶습니다geode about. 실효 모델, 프로바이더, 자격 프로파일 수를 한 화면에 보여줍니다.

자격 소스 값

프로바이더별 자격 소스는 core/config/credential_source.py의 네 값 중 하나입니다.

값의미
auto기본값. OAuth를 먼저 시도하고, PAYG 전환은 설정으로 게이트됩니다.
api_keyPAYG API 키만 사용합니다.
claude-cliclaude CLI의 Anthropic 구독 OAuth를 사용합니다.
openai-codexCodex CLI의 ChatGPT 구독 OAuth를 사용합니다.

예시

geode setup              # 자격 감지 + 등록 마법사
geode                    # 대화 시작

> /login                 # 자격 대시보드
> /login openai          # ChatGPT 구독 OAuth 로그인
> /login anthropic       # Claude 구독 OAuth 로그인
> /login source openai api_key   # OpenAI를 키 경로로 고정

geode about              # 실효 모델 + 자격 상태 확인

실패 모드

증상원인해법
setup이 ChatGPT OAuth를 못 찾음~/.codex/auth.json 없음Codex CLI로 먼저 로그인하거나 /login openai의 device-code 플로우를 씁니다. 후자는 ~/.geode/auth.toml에 저장됩니다.
키를 넣었는데 모델이 안 바뀜.env는 시크릿 전용, 모델은 별개 설정/model로 고릅니다. 안 먹으면 geode config explain model로 어느 레이어가 이기는지 봅니다.
GLM 구독인데 미터링 과금Coding Plan 키가 PAYG 엔드포인트로 나감GLM은 Coding Plan과 PAYG 엔드포인트가 다릅니다. 프로바이더 설정의 GLM 절을 확인합니다.
응답이 비거나 401OAuth 만료 또는 무효 키geode doctor로 점검하고 /login으로 갱신합니다.

다음 단계

이전
Google Workspace 연결
다음
프로바이더 설정