Configuration

command-line flag  >  config.toml  >  built-in default


`model`
`base_url`
`api_key`
`provider`
`protocol`
`output_format`
`thinking_level`
`approve`
`no_tools`
`no_skills`
`system_prompt`
`prompts`

1. --provider <name>      # 显式指定，最高优先级
2. --protocol openai|openai/chat|openai/resp_api|anthropic
3. 预置目录 (preset catalog) 中的已知模型 id
4. ollama/ 或 nvidia/ 前缀，或端口 11434 → 本地 / NVIDIA
5. 按模型名前缀推断 (claude-* → anthropic, gpt-* → openai …)
6. 兜底 → OpenRouter

--base-url  >  <provider> 专属 env  >  <PROVIDER>_BASE_URL  >  内置默认值


`anthropic`	`ANTHROPIC_API_KEY`	`api.anthropic.com/v1`	anthropic
`openai`	`OPENAI_API_KEY`	`api.openai.com/v1`	openai
`openrouter`	`OPENROUTER_API_KEY`	`openrouter.ai/api/v1`	openai
`deepseek`	`DEEPSEEK_API_KEY`	`api.deepseek.com`	openai
`google`	`GEMINI_API_KEY`	`generativelanguage.googleapis.com`	openai
`groq`	`GROQ_API_KEY`	`api.groq.com/openai/v1`	openai
`xai`	`XAI_API_KEY`	`api.x.ai/v1`	openai
`nvidia`	`NVIDIA_API_KEY`	`integrate.api.nvidia.com/v1`	openai
`mistral`	`MISTRAL_API_KEY`	`api.mistral.ai`	openai
`moonshotai`	`MOONSHOT_API_KEY`	`api.moonshot.ai/v1`	openai
`zai`	`ZAI_API_KEY`	`api.z.ai/api/coding/paas/v4`	openai
`minimax`	`MINIMAX_API_KEY`	`api.minimax.io/anthropic`	anthropic
`dashscope`	`DASHSCOPE_API_KEY`	`dashscope.aliyuncs.com/…/v1`	openai
`qianfan`	`QIANFAN_API_KEY`	`qianfan.baidubce.com/v2`	openai
`volcengine`	`ARK_API_KEY`	`ark.cn-beijing.volces.com/api/v3`	openai
`hunyuan`	`HUNYUAN_API_KEY`	`api.hunyuan.cloud.tencent.com/v1`	openai
`xiaomi`	`XIAOMI_API_KEY`	`api.xiaomimimo.com/v1`	openai
`amazon-bedrock`	`AWS_BEARER_TOKEN_BEDROCK`	`bedrock-runtime.{region}.amazonaws.com`	anthropic
`azure-openai-responses`	`AZURE_OPENAI_API_KEY`		openai

# 按模型名自动路由
pigo -m claude-opus-4-7          # → anthropic
pigo -m gpt-5                    # → openai
pigo -m deepseek-v4-pro          # → deepseek（V4 Pro / V4 Flash）

# 强制指定 provider 与协议
pigo --provider groq -m llama-3.3-70b
pigo --protocol anthropic -m my-custom-model

# 指向任意 OpenAI 兼容端点（本地 Ollama）
pigo -u http://localhost:11434/v1 -m qwen3


`openai`
`openai/chat`
`openai/resp_api`

# Chat Completions（默认 OpenAI 变体）
pigo --protocol openai -u https://my-gateway/v1 -m my-model

# Responses API（官方 SDK，需端点支持 /responses）
pigo --protocol openai/resp_api -u https://my-gateway/v1 -m my-model

), reserved (int tokens or a percent string), and a nested [checkpoint.push_caps] of per-section token caps." data-zh="[checkpoint] —— thresholds（百分比字符串，如 \"80%\"）、reserved（整数 token 或百分比字符串），以及嵌套的 [checkpoint.push_caps] 分区 token 上限。">

export OPENROUTER_API_KEY=sk-or-...
export ANTHROPIC_API_KEY=sk-ant-...

model = "gpt-5"
base_url = "https://openrouter.ai/api/v1"
output_format = "text"
approve = false
prompts = ["~/.config/pigo/prompts"]

[memory]
enabled = true
search_score_floor = 0.15

[checkpoint]
thresholds = ["80%", "90%"]
reserved = "10%"

[checkpoint.push_caps]
memory = 800
recall = 1200

[compaction]
max_context = "60%"

[dream]
enabled = true
interval_days = 7
recent_sessions = 20