읽는 법
아래 표는 코드의 설정 모델에서 검증한 키만 담습니다. 각 키는 환경 변수GEODE_ 접두사로도 설정할 수 있습니다. 예를 들어 model은GEODE_MODEL입니다. 일부 키는 config.toml의 점 표기 경로로만 매핑됩니다. 그 경로는 별도로 적었습니다. 우선순위와 로드 방식은 설정 기초를 먼저 보세요.
실험 단계로 표시된 키는 동작이 바뀔 수 있습니다. 빈 문자열 기본값은 대개 다른 값으로 폴백한다는 뜻입니다. 표의 설명에 폴백 대상을 적었습니다.
LLM과 모델
config.toml 경로: [llm] 테이블.
| 키 | 하는 일 | 기본값 |
|---|
model (llm.primary_model) | 주 모델. REPL과 agentic 루프가 씁니다. | claude-opus-4-7 |
default_secondary_model (llm.secondary_model) | Cross-LLM 검증의 2차 모델. | gpt-5.4 |
router_model (llm.router_model) | 라우팅 결정을 내리는 모델. | claude-opus-4-7 |
plan_model (llm.plan_model) | 계획 단계 모델. 빈 값이면 model로 폴백합니다. | 빈 문자열 |
act_model (llm.act_model) | 행동 루프 모델. 빈 값이면 model로 폴백합니다. | 빈 문자열 |
judge_model (llm.judge_model) | 턴별 verify 판정 모델. 빈 값이면 model로 폴백합니다. | 빈 문자열 |
learning_extract_model (llm.learning_extract_model) | 학습 추출 훅이 쓰는 저비용 모델. | glm-4.7-flash |
agreement_threshold | Cross-LLM 합의 통과 임계값. | 0.67 |
forced_login_method | 프로바이더별 인증 모드 강제. 예: {"openai":"apikey"}. | 빈 dict |
LLM 연결
httpx 풀과 재시도. 기본값으로 충분한 고급 키입니다.
| 키 | 하는 일 | 기본값 |
|---|
llm_max_connections | 풀의 최대 연결 수. | 20 |
llm_read_timeout | 응답 읽기 타임아웃(초). 1M 컨텍스트를 위해 큽니다. | 300.0 |
llm_connect_timeout | TCP 연결 타임아웃(초). | 5.0 |
llm_max_retries | 모델별 최대 재시도 횟수. | 3 |
llm_max_fallback_cost_ratio | 폴백 비용 비율 상한. 0은 무제한. | 0.0 |
예산과 비용
| 키 | 하는 일 | 기본값 |
|---|
cost_limit_usd | 세션 비용 상한(USD). 80%에서 경고, 100%에서 초과 이벤트. 0은 무제한. | 0.0 |
agentic_loop_time_budget (agentic.time_budget) | agentic 루프 벽시계 예산(초). 0은 무제한. | 0.0 |
agentic_effort (agentic.effort) | thinking depth. low / medium / high / max / xhigh. | high |
max_tool_result_tokens | 도구 결과 절단 임계 토큰. 0은 무제한. | 25000 |
tool_offload_threshold | 큰 결과를 디스크로 내리는 토큰 임계값. 0은 비활성. | 15000 |
pipeline_timeout_s | 파이프라인 타임아웃(초). 0은 무제한. | 600.0 |
파이프라인과 오케스트레이션
config.toml 경로: [pipeline] 테이블 (앞 두 키).
| 키 | 하는 일 | 기본값 |
|---|
confidence_threshold (pipeline.confidence_threshold) | 이 값 아래면 루프백. | 0.7 |
max_iterations (pipeline.max_iterations) | 최대 파이프라인 반복. | 5 |
max_subagent_depth | 서브에이전트 최대 재귀 깊이. | 1 |
max_total_subagents | 세션 내 최대 서브에이전트 수. | 15 |
subagent_max_tokens | 서브에이전트 출력 토큰 제한. | 32768 |
ensemble_mode | single 또는 cross(다중 LLM). | single |
게이트웨이와 바인딩
config.toml 경로: [gateway] 테이블과 [[gateway.bindings.rules]] 배열.
| 키 | 하는 일 | 기본값 |
|---|
gateway_enabled | 인바운드 메시지 게이트웨이 활성. GEODE_GATEWAY_ENABLED=true. | false |
gateway_poll_interval_s | 게이트웨이 폴링 간격(초). | 3.0 |
gateway_max_concurrent | 동시에 처리하는 게이트웨이 메시지 수. | 4 |
gateway.time_budget_s | 바인딩이 상속하는 게이트웨이 기본 시간 예산. | 해당 없음 |
gateway.max_turns | 게이트웨이 세션 턴 상한. 0은 무제한. | 0 |
[[gateway.bindings.rules]] 규칙 하나의 필드:
| 필드 | 하는 일 | 기본값 |
|---|
channel | 메신저 종류. 예: slack. 필수. | 해당 없음 |
channel_id | 채널 식별자. 비면 그 규칙은 건너뜁니다. | 해당 없음 |
auto_respond | 자동 응답 여부. | true |
require_mention | 멘션이 있을 때만 응답. | false |
allowed_tools | 이 바인딩에서 허용할 도구 목록. | 빈 목록 |
time_budget_s | 이 바인딩의 시간 예산(초). 없으면 게이트웨이 기본값. | 게이트웨이 기본값 |
스케줄러와 자동화
| 키 | 하는 일 | 기본값 |
|---|
scheduler_auto_start | 부트 시 스케줄러 자동 시작. | true |
scheduler_interval_s | 스케줄러 체크 간격(초). | 1.0 |
scheduler_jitter_enabled | 잡별 결정적 jitter 적용. | true |
scheduler_max_jitter_ms | jitter 상한(밀리초). | 900000.0 |
outcome_tracking_enabled | 결과 추적 활성 (실험). | true |
drift_scan_cron | drift 스캔 cron 식 (실험). | 0 */6 * * * |
메모리와 세션
| 키 | 하는 일 | 기본값 |
|---|
session_ttl_hours | 세션 idle TTL(시간). | 4.0 |
session_storage_dir | 파일 백업 디렉터리. 비면 메모리만 사용. | 빈 문자열 |
compact_keep_recent | 압축 시 보존할 최근 메시지 수. | 10 |
checkpoint_db | 체크포인트 DB 파일. | geode_checkpoints.db |
샌드박스 (파일 도구 가드)
config.toml 경로: [sandbox] 테이블.
| 키 | 하는 일 | 기본값 |
|---|
sandbox_max_file_size_bytes (sandbox.max_file_size_bytes) | 읽기 전 파일 크기 가드(바이트). | 262144 |
sandbox_max_read_tokens (sandbox.max_read_tokens) | 읽은 뒤 토큰 추정 가드. | 25000 |
sandbox_max_glob_results (sandbox.max_glob_results) | Glob 도구 최대 결과. | 100 |
sandbox_max_grep_results (sandbox.max_grep_results) | Grep 도구 최대 파일 수. | 50 |
승인과 알림
| 키 | 하는 일 | 기본값 |
|---|
hitl_level | 휴먼 인 더 루프 단계. 0 자율, 1 쓰기만 확인, 2 전부 확인. | 2 |
plan_auto_execute | 계획 자동 실행. GEODE_PLAN_AUTO_EXECUTE=true. | false |
computer_use_enabled | 데스크탑 자동화 활성. | true |
notification_channel | 기본 알림 채널. | slack |
notification_on_pipeline_error | 파이프라인 오류 시 알림. | true |
webhook_enabled | 웹훅 엔드포인트 활성. GEODE_WEBHOOK_ENABLED=true. | false |
자격 증명 소스
| 키 | 하는 일 | 기본값 |
|---|
anthropic_credential_source | Anthropic 자격 증명 소스. auto / api_key / claude-cli / oauth / none. | auto |
openai_credential_source | OpenAI 자격 증명 소스. 같은 집합. | auto |
anthropic_api_key | Anthropic 키. ANTHROPIC_API_KEY 별칭 가능. | 빈 문자열 |
openai_api_key | OpenAI 키. OPENAI_API_KEY 별칭 가능. | 빈 문자열 |
zai_api_key | ZhipuAI(GLM) 키. ZAI_API_KEY 별칭 가능. | 빈 문자열 |
참고
이 목록은 코드의 설정 모델에서 직접 검증한 키만 담습니다. 모델 기본값과 폴백 체인은 routing.toml이라는 별도 매니페스트에서 오므로 여기 표에 없습니다. 모델별 라우팅을 바꾸려면 LLM 라우팅을 보세요. 자격 증명 흐름은 인증과 OAuth에 있습니다.