> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zerone.run/llms.txt
> Use this file to discover all available pages before exploring further.

# Model

> 配置 Anthropic、OpenAI-compatible 或自定义模型服务。

## 配置模型

SDK 内建 Anthropic Messages 与 OpenAI Completions 两类 Provider，`apiType` 默认自动检测，可根据模型名判断常见 OpenAI-compatible 模型。

### OpenAI-compatible 模型

适用于 OpenAI、DeepSeek、Qwen、Mistral 或任何 OpenAI-compatible 端点：

```bash theme={null}
export ZERONE_AGENT_API_TYPE=openai-completions
export ZERONE_AGENT_API_KEY=sk-...
export ZERONE_AGENT_BASE_URL=https://api.openai.com/v1
export ZERONE_AGENT_MODEL=gpt-4o
```

### 第三方 Anthropic-compatible 服务

```bash theme={null}
export ZERONE_AGENT_BASE_URL=https://openrouter.ai/api
export ZERONE_AGENT_API_KEY=sk-or-...
export ZERONE_AGENT_MODEL=anthropic/claude-sonnet-4
```

### 代码选项

也可以在 `createAgent()` 中传入 `apiType`、`apiKey`、`baseURL` 和 `model`。代码选项优先适合单实例配置；环境变量适合部署注入。

| 选项        | 类型       | 默认值                         | 说明                                              |
| --------- | -------- | --------------------------- | ----------------------------------------------- |
| `apiType` | `string` | 自动检测                        | `'anthropic-messages'` 或 `'openai-completions'` |
| `model`   | `string` | `claude-sonnet-4-6`         | LLM 模型 ID                                       |
| `apiKey`  | `string` | `ZERONE_AGENT_API_KEY` 环境变量 | API key                                         |
| `baseURL` | `string` | —                           | 自定义 API 端点                                      |

## 环境变量

| 变量                          | 说明                                             |
| --------------------------- | ---------------------------------------------- |
| `ZERONE_AGENT_API_KEY`      | API key（首选）                                    |
| `ZERONE_AGENT_AUTH_TOKEN`   | 备选认证 token                                     |
| `ZERONE_AGENT_API_TYPE`     | `anthropic-messages`（默认）或 `openai-completions` |
| `ZERONE_AGENT_MODEL`        | 默认模型覆盖                                         |
| `ZERONE_AGENT_BASE_URL`     | 自定义 API 端点                                     |
| `ZERONE_AGENT_MCP_GRACE_MS` | MCP server 关闭宽限期（毫秒，默认 30000）                  |

## 自定义 Provider

自定义 Provider 需要实现 `LLMProvider` 接口；也可以用 `createProvider(apiType, opts)` 直接创建 Provider 实例。代理、企业网关或兼容端点上线前，应验证流式事件、Tool call、错误码和 token 用量字段，而不仅是普通文本响应。