installation.mdx

```bash
export ANTHROPIC_API_KEY=sk-ant-...
# or, for Anthropic-compatible gateways that expect a different header:
export ANTHROPIC_AUTH_TOKEN=<token>
```

To use a custom proxy or Anthropic-compatible endpoint, set `ANTHROPIC_BASE_URL`:

```bash
export ANTHROPIC_API_KEY=sk-ant-...
export ANTHROPIC_BASE_URL=https://proxy.example.com
```

**Zero-export shortcut.** If you already have Claude Code configured, llmwiki falls back to reading `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, `ANTHROPIC_BASE_URL`, and `ANTHROPIC_MODEL` from `~/.claude/settings.json` (the `env` block). If those values are present there, you can run `llmwiki compile` with no exports at all.

**Configuration precedence:**
1. Shell environment / local `.env`
2. Claude Code settings fallback (`~/.claude/settings.json` → `env` block)
3. Built-in provider defaults

```bash
export LLMWIKI_PROVIDER=claude-agent
export LLMWIKI_MODEL=claude-sonnet-4-6  # optional; this is the default
llmwiki compile
```

**Notes:**
- Compile and structured extraction work off the local login with no extra credentials.
- `llmwiki query` uses semantic embeddings, which the Claude Agent SDK does not provide. Set `VOYAGE_API_KEY` to enable embeddings; otherwise `query` falls back to lexical ranking.
- Set `LLMWIKI_DEBUG=1` for a concise per-message trace, or `LLMWIKI_DEBUG=verbose` for the SDK's full verbose logging.

<Warning>
  The `claude-agent` provider drives your Claude Code / Agent SDK session programmatically. Before using it, review Anthropic's current [Claude Code](https://www.anthropic.com/legal/consumer-terms) and Agent SDK terms to ensure your intended use complies with them.
</Warning>

```bash
export LLMWIKI_PROVIDER=openai
export OPENAI_API_KEY=sk-...
# For a custom or local endpoint:
export OPENAI_BASE_URL=http://localhost:8080/v1
```

To use a separate endpoint for embeddings (optional - defaults to the same base URL as chat):

```bash
export LLMWIKI_PROVIDER=openai
export LLMWIKI_MODEL=qwen3.6-35b
export LLMWIKI_EMBEDDING_MODEL=text-embedding-model
export OPENAI_API_KEY=sk-local   # any non-empty value works for local servers
export OPENAI_BASE_URL=http://host_url:port/v1
export OPENAI_EMBEDDINGS_BASE_URL=http://host_url:port/v1
```

<Note>
  `OPENAI_API_KEY` is required by the OpenAI SDK even for local servers that don't check authentication. Use any non-empty dummy value (e.g. `sk-local`) in that case.
</Note>

```bash
export LLMWIKI_PROVIDER=ollama
export LLMWIKI_MODEL=llama3.1
export LLMWIKI_EMBEDDING_MODEL=nomic-embed-text
export OLLAMA_HOST=http://localhost:11434/v1
# Optional: separate embeddings endpoint
export OLLAMA_EMBEDDINGS_HOST=http://localhost:11435/v1
```

<Note>
  Local models often need more than the default 10-minute request timeout. Override with `OLLAMA_TIMEOUT_MS` (Ollama-specific, wins over `LLMWIKI_REQUEST_TIMEOUT_MS`) or set `LLMWIKI_REQUEST_TIMEOUT_MS` for a provider-agnostic override. Ollama's built-in default is 30 minutes.
</Note>

First, refresh your `gh` CLI token to include the required scope:

```bash
gh auth refresh --scopes copilot
```

Then configure the provider:

```bash
export LLMWIKI_PROVIDER=copilot
export GITHUB_TOKEN=$(gh auth token)   # OAuth token required; PATs will not work
export LLMWIKI_MODEL=gpt-4o            # optional; gpt-4o is the default
```

Available models (use dots, not dashes in names): `gpt-4o`, `gpt-4o-mini`, `claude-sonnet-4.5`, `claude-sonnet-4.6`, `claude-opus-4.5`, `gemini-2.5-pro`, and others - availability depends on your Copilot plan.

<Note>
  The GitHub Copilot API does not expose an embeddings endpoint. `llmwiki query` will fall back to full-index lexical selection without semantic ranking. For embedding-dependent workflows, switch to the `openai` provider and supply `OPENAI_API_KEY`.
</Note>