xiantong 文档
配置

API 提供商

连接 Anthropic、OpenRouter、Ollama、Vercel AI Gateway 或任何兼容端点

通过内置预设系统连接 Anthropic、OpenRouter、Ollama、Vercel AI Gateway 或任何兼容端点。

xiantong 通过 Anthropic 兼容的提供商提供多种 API 支持。您可以直接连接 Anthropic，使用 OpenRouter 等聚合平台，运行本地模型（Ollama），或指向任何与 Anthropic Messages 形式兼容的 API 端点。

本页涵盖Anthropic 兼容提供商。有关 Codex/OpenAI 连接以及多连接设置，请参阅 LLM Connections。

支持的提供商#

提供商基础 URL需要 API 密钥说明
Anthropichttps://api.anthropic.com是默认提供商，无需覆盖模型。
OpenRouterhttps://openrouter.ai/api是通过一个 API 访问多个 AI 提供商。
Vercel AI Gatewayhttps://ai-gateway.vercel.sh是用于 AI 模型路由的统一网关。
Ollamahttp://localhost:11434否本地运行模型。需要 Ollama 0.14+。
自定义任意 URL视提供商而定任何 Anthropic 兼容端点。

设置提供商#

首次启动时#

  1. 在设置向导中选择 API 密钥
  2. 输入您的 API 密钥
  3. 从下拉菜单选择 基础 URL 预设（Anthropic、OpenRouter、Vercel AI Gateway 或 自定义）
  4. 可选地指定一个 模型 名称（非 Anthropic 提供商必需）
  5. 保存前会自动测试连接

在设置中#

  1. 打开 设置（齿轮图标或 Cmd+,）
  2. 点击 API 连接 部分
  3. 按需更改 API 密钥、基础 URL 或模型

模型名称#

对于 Anthropic，无需覆盖模型 —— xiantong 会自动使用其内置模型路由（Sonnet、Opus、Haiku）。对于 OpenRouter 和 Vercel AI Gateway，模型使用 provider/model-name 格式：

anthropic/claude-sonnet-4
anthropic/claude-opus-4
openai/gpt-4o
google/gemini-2.5-pro
meta-llama/llama-4-maverick

对于 Ollama，直接使用本地模型名称：

llama3.2
qwen3-coder
deepseek-r1

如果非 Anthropic 提供商的模型字段留空，xiantong 会默认采用 Anthropic 模型名称格式。这适用于原生支持 Anthropic 模型名称的提供商，但并不适用于所有提供商。

提供商详情#

OpenRouter#

OpenRouter 通过单个 API 密钥让您访问数百个 AI 模型。它负责计费、速率限制和提供商之间的故障转移。

  1. 在 openrouter.ai/keys 获取 API 密钥
  2. 在基础 URL 下拉菜单中选择 OpenRouter 预设
  3. 设置模型（例如 anthropic/claude-sonnet-4）

在 openrouter.ai/models 浏览可用模型。

Ollama（本地模型）#

Ollama 在本地运行开源模型，不需要 API 密钥，数据永远不会离开您的计算机。要求：

  • Ollama 0.14 或更新版本（支持 Anthropic 兼容 API 格式）
  • 已拉取的模型
# 安装并拉取模型
ollama pull llama3.2

连接方法：

  1. 在基础 URL 下拉菜单中选择 自定义 预设
  2. 输入 http://localhost:11434 作为 URL
  3. 留空 API 密钥
  4. 设置模型名称（例如 llama3.2）

Ollama 需要 0.14+ 版本以兼容 xiantong。早期版本不支持 Anthropic Messages API 格式。如有需要，可使用 ollama update 更新。

Vercel AI Gateway#

Vercel AI Gateway 提供统一端点，将请求路由到多个 AI 提供商，并带有内建观测和缓存功能。

  1. 在 Vercel 仪表盘获取 API 密钥
  2. 选择 Vercel AI Gateway 预设
  3. 使用 provider/model-name 格式设置模型

在 Vercel 文档中查看 支持的模型。

自定义端点#

对于实现 Anthropic Messages 格式的任何 API：

  1. 选择 自定义 预设
  2. 输入完整的端点基础 URL
  3. 输入 API 密钥（如需）
  4. 指定端点需要的模型名称

适用于自托管代理、企业网关或实现 /v1/messages 端点的任何服务。

自定义端点的图像输入#

自定义端点默认仅支持文本。如果您的端点提供多模态模型 —— 例如通过 Ollama 提供的 Gemma 4 或其他兼容 OpenAI 的 Agent —— 必须在连接配置中显式启用图像支持。以下示例使用来自 LLM Connections 的低级 LLM 连接 模式，其中 customEndpoint.api 选择端点的线格式。

按模型逐一启用（推荐）#

{
"customEndpoint": { "api": "openai-completions" },
"models": [
{ "id": "gemma4", "supportsImages": true }
]
}

整个端点启用#

{
"customEndpoint": {
"api": "openai-completions",
"supportsImages": true
}
}

目前尚无自动能力检测机制。如果未设置 supportsImages，xiantong 会将端点视为仅文本。

有关完整配置架构，请参阅 LLM Connections。

工作原理#

当配置非默认提供商时，xiantong 会存储：

  • API 密钥 到加密凭证文件 (~/.xiantong/credentials.enc)
  • 基础 URL 和 默认模型 到 LLM 连接配置

在会话启动时，基础 URL 会通过 ANTHROPIC_BASE_URL 环境变量传递给底层 Claude Code SDK。

故障排查#

连接测试失败

请确认：

  • 基础 URL 正确且可从您的设备访问
  • API 密钥有效且具有足够权限
  • 端点支持 Anthropic Messages API 格式（/v1/messages）

模型未找到错误

请确保模型名称与提供商要求的完全匹配：

  • OpenRouter/Vercel：使用 provider/model-name 格式（例如 anthropic/claude-sonnet-4）
  • Ollama：使用本地模型名称（例如 llama3.2）
  • 自定义：查阅提供商文档获取有效模型标识符

认证错误

  • 确保 API 密钥正确且未过期
  • Ollama：不应设置 API 密钥（保持为空）
  • 检查密钥是否有可用额度/限额

Ollama 无法连接

  • 验证 Ollama 已运行：ollama list
  • 检查版本是否为 0.14+：ollama --version
  • 确保模型已拉取：ollama pull llama3.2
  • 确认 URL 为 http://localhost:11434（注意：HTTP，而非 HTTPS）

速率限制

若遇到速率限制，请检查提供商的使用限制，并考虑升级计划或更换提供商。

安全#

您的 API 密钥已安全存储在加密凭证文件中。有关凭证保护方式的详细信息，请参阅 Credentials。基础 URL 和模型名称存储在 LLM 连接配置中（不加密，因为它们并非敏感信息）。

上一页凭证