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

# 模型配置

> 订阅登录、自定义端点与默认模型

Locus 须配置远程 AI 服务作为其推理引擎，远程大模型的性能将直接影响 Locus 的工作效果。「设置」左侧`模型`分组下有两个标签：`模型管理`负责接入供应商，`默认模型`负责按场景指定模型。

<img src="https://mintcdn.com/farlocus/OfAb3Fo_I43YNcC0/images/overview/page-tour/settings.png?fit=max&auto=format&n=OfAb3Fo_I43YNcC0&q=85&s=321a6bd1ce4c62759748bb54ce2fc7c2" alt="img" width="1505" height="1001" data-path="images/overview/page-tour/settings.png" />

## 订阅账户登录

* **`Claude 订阅账户`**：点击`登录`后在浏览器中登录 Claude 账号，授权后复制页面上显示的授权码并粘贴回 Locus。已安装 Claude Code 时可选择`从 Claude Code 导入`直接复用登录态。登录后显示`剩余额度`（`5 小时`与`1 周`两档限额）。
* **`ChatGPT 订阅账户（设备授权）`**：点击`使用 ChatGPT 账户登录`，在浏览器中访问链接并输入验证码完成授权，兼容 ChatGPT Pro / Plus 订阅。也支持`从 Codex CLI 导入`。登录后显示`短窗口`与`长窗口`的剩余额度。
* **`Claude Code CLI`**：Locus 只调用系统 `claude` 命令，登录状态由 Claude Code 自身管理。检测到未登录时，请在终端运行 `claude` 并完成 `/login`。`测试连接`会通过 CLI 发送一个单词探针，按真实运行的方式验证端点、凭据与代理是否可用。该来源的模型默认不出现在模型列表中，需在`默认模型`标签开启`启用 Claude Code CLI 模型`（实验性）。
* **`OpenRouter`**：填入 API Key 即可，统一网关聚合 Claude / GPT / Gemini 等主流模型。

## 自定义模型端点

`自定义模型端点`用于接入任意兼容的 API 服务，包括本地部署的模型。支持三种消息格式：

* **`Anthropic Messages`**：Claude 系 API 及其兼容服务。
* **`OpenAI Chat Completions`**：最广泛兼容的格式，多数第三方与本地推理服务可用。
* **`OpenAI Responses`**：OpenAI 新一代接口格式。

点击`添加自定义端点`填写：

1. `显示名称`：在模型列表中展示的名字。
2. `API 模型代号`：发送给 API 的 model 字段值，如 `gpt-4o`。
3. `请求端点`：含 `/v1` 的 base URL，程序会自动拼接 `/chat/completions` 等路径。
4. `API 格式`与 `API Key`（可选，部分本地模型无需 Key）。

高级选项包括`上下文窗口`（超过此 token 数触发上下文压缩）、`推理强度`（在模型选择器中显示 effort 档位）、`图像理解`（端点可接收截图和图片附件时启用）等。保存后可用`测试`验证连通性；端点支持多个，随时`编辑`或`删除`。

## 默认模型

`默认模型`标签为不同使用场景指定模型，未设置时跟随当前手动选择：

* **`主对话模型`**：主会话默认使用的模型。
* **`Plan 模式模型`**：切换到计划模式时自动使用的模型，可以为方案设计单独指定推理更强的模型，见[计划模式](/sessions/plan-mode)。
* **`子代理模型`**：Agent 派生子任务时各类子代理使用的模型覆盖，未设置时继承当前会话模型。子任务通常更机械，用更快的模型可以明显降低成本。

## 隐私边界

除所配置的远程模型服务调用外，Locus 为纯客户端软件，其余任何信息均不会上传至互联网。会话记录、知识库与配置全部保存在本地，存放位置见[通用设置](/settings/general)中的`本地数据存储`。
