跳转到内容

API 与密钥

配置 入口 用途
Agent 自身的登录 对应 CLI 普通任务默认沿用。
Claude Code API 配置 Agent 程序 → Claude Code API 配置 为 Claude 任务选择不同的服务与模型。
AI 服务 设置偏好 → AI 服务 Prompt 优化、工作流生成、Skill 帮写、标题与任务监管。

点击「添加 API」进入配置页面,填写名称、Base URL、API Key 和鉴权方式。编辑已有配置也使用同一个页面,切换页面后返回可继续填写。

默认模型和 Haiku / Sonnet / Opus / Fable 映射都可以手动输入。点击「获取模型列表」后,可搜索服务返回的模型并填入对应字段;不会覆盖已填写的模型。列表接口不可用时仍可手动保存。

在「连接测试」中选择具体模型,或已填写映射的模型别名,再点击测试。测试会发送一条简短 Anthropic Messages 请求,可能产生少量用量;列表页也提供测试入口。模型列表可用不代表所有模型都能调用,测试结果以所选模型为准。

保存后,在新建任务或发送后续消息时选择这套 API 配置。

服务须兼容 Anthropic Messages。所选配置通过子进程环境和临时 --settings 文件传入对话与终端,覆盖本机、项目和额外设置中的同名环境变量;其他设置保留,原文件不改写。临时文件在进程结束后删除。组织管理策略仍遵循 Claude Code 的配置优先级。Fable 使用 ANTHROPIC_DEFAULT_FABLE_MODEL,本机 CLI 也需要支持该别名。

远程 API 使用 HTTPS,本机服务允许 HTTP。Base URL 可包含网关路径前缀,模型列表与测试分别访问其下的 v1/models 和 v1/messages;地址已以 /v1 结尾时不会重复拼接。测试不跟随重定向。修改服务地址或鉴权方式后,需要重新填写密钥,不会将旧密钥发送给新地址。

在 设置 → AI 服务 选择 LLM API 或已安装的 Agent。

选择 Agent 时,可指定程序、模型和 Claude Code API 配置,然后保存来源。所有辅助生成共用该来源,通过现有 CLI 适配器执行只读文本请求。程序需要已安装并完成登录,或具备可用的 API 配置。需要额外交互的请求会显示错误,不自动审批辅助任务。

使用兼容 Chat Completions 的服务。Base URL 包含服务商 API 前缀,例如 https://provider.example/v1,再填写模型 ID 和密钥。

远程服务须使用 HTTPS,localhost 允许 HTTP。连接测试会向所配置服务发送一条简短请求。

LLM 配置和密钥使用 AES-256-GCM 加密保存在应用数据目录的 secrets/llm.enc,重启后自动读取,不访问系统钥匙串。加密密钥位于 secrets/llm.key,备份时需一并保留。相同 LLM API 地址下留空 Key 会保留旧密钥;更换地址不会自动携带原密钥。点击「移除配置」可以删除保存的配置。

从使用钥匙串的旧版本更新后,需重新填写并保存一次 LLM API Key。旧钥匙串记录不会自动读取或移除。

Claude Code API 密钥使用同一套本地加密存储,按配置分别保存在 secrets/provider-*.enc,加密密钥共用 secrets/llm.key。启动、运行任务、获取模型和测试连接不会访问系统凭据库。备份时一并保留应用数据目录中的 state.json 和 secrets 目录。

旧 Claude 配置的地址和模型保留。在 API 编辑页点击「转存本地」可读取一次旧系统密钥,系统可能要求解锁;也可直接重新填写 Key 并保存。转存完成后不再读取旧凭据,旧系统记录不会自动删除。更换服务地址或鉴权方式时需重新填写 Key。

任务的高级环境变量是另一项功能,仅保存在本次应用内存中;不要将它与 API Key 的持久保存混淆。