---
title: 凭据与连接
description: API Key 和账号怎么保存,AI 与 Gem 怎么在拿不到明文的前提下使用它们。
section: guide
order: 60
updated: 2026-11-12
---
# 凭据与连接
凭据是你交给 Notochord 保管的密钥:模型服务商的 API key、外部服务的令牌、邮箱的登录信息。它们统一放在「设置 › 账号」里,一个账号就是一个连接。
## 怎么保存
- 凭据加密存放在这台电脑上,不会上传到任何云端服务器。
- 加密用的钥匙放在系统钥匙串里(首次设置时选了「不加密」的组织则放在组织文件夹里)。见[五分钟上手](/zh/guide/quickstart.md#要不要加密保存这台电脑上的数据)和[组织](/zh/guide/organizations.md)。
- 每个[组织](/zh/guide/organizations.md)有自己的一套凭据,互不相通。
## AI 和 gem 怎么用它们
**它们都看不到密钥本身。** AI 或 gem 想调用某个外部服务时,拿到的只是「通过这个连接发一次请求」的许可,请求由 Notochord 发出,密钥在发出的那一刻才加到请求里。所以:
- AI 的对话记录、工具调用记录里不会出现密钥。
- 就算一个 gem 的代码有问题,它也拿不到密钥,只能请求已经授权给它的连接。
- 连接只能发往它登记过的网站,不能把密钥带到别处。
## 授权给谁
默认谁都不能用。你在 gem 的页面上选一个账号,这个 gem 才能用它;在项目的设置里勾选,在这个项目里工作的 gem 才能用对应的账号。没有授权的账号,请求会被拒绝。见 [Gem:安装与使用](/zh/guide/gems.md) 和[用项目组织工作](/zh/guide/projects.md)。
## 删除
在「设置 › 账号」里删掉一个账号,保存的密钥一起删除,用到它的 gem 会失效,直到你给它选别的账号。