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

​
订阅账户登录

  • 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 模式模型：切换到计划模式时自动使用的模型，可以为方案设计单独指定推理更强的模型，见计划模式。
  • 子代理模型：Agent 派生子任务时各类子代理使用的模型覆盖，未设置时继承当前会话模型。子任务通常更机械，用更快的模型可以明显降低成本。

​
隐私边界

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