认证与模型
Codeg 不附带自己的任何模型。每个智能体都带来自己的凭据——你已经在付费的订阅、一个提供商 API 密钥，或一个兼容的端点——并与它自己的模型通信。本页讲的是让一个智能体完成认证以便它能运行，以及在它能运行之后选择它使用哪个模型。
你按智能体逐个进行，在设置 → 智能体中：打开一个智能体，它的详情面板会显示适用于它的登录选项。一个独立的模型提供商面板为支持它们的智能体保存可复用的凭据。启用一个智能体并确认它状态正常是第一步——参见使用智能体——而支持的智能体是这一切所适用的名单。
智能体如何认证
由于每个智能体都以自己的方式进行认证，它的详情面板只提供对它有意义的选项——通常是单个认证模式下拉菜单。在整个名单中，这些选项呈现为三种形态：
- 智能体自己的账户——用你已经拥有的订阅或套餐登录（Anthropic、ChatGPT、Google 等等）。Codeg 会复用智能体自己的登录；你无需交给它一个密钥。
- 一个提供商 API 密钥和端点——直接在智能体的卡片中输入一个 API URL 和密钥，以便通过某个 API 账户或兼容网关计费。这就是自定义端点选项。
- 一个已保存的模型提供商——把智能体指向一份你已存储一次的可复用凭据。适用于 Claude Code、Codex 和 Gemini。
这些是互斥的：一个智能体一次只使用一种，切换认证模式会在它们之间切换。接下来的三节将逐一讲解。
用订阅登录
最简单的路径是使用智能体自己的订阅——也就是你在它的 CLI 中会使用的套餐。对大多数智能体而言，这意味着在终端里通过智能体自己的工具登录一次；随后 Codeg 会复用那次登录，不会额外存储任何东西：
- Claude Code——选择官方订阅，Codeg 就会使用你现有的
claude登录。无需密钥。 - Gemini——选择 Google 登录，并先在终端中运行
gemini来完成 Google 的登录。 - Kimi Code、CodeBuddy、Grok——在终端中运行智能体自己的登录命令（
kimi login、codebuddy、grok login），Codeg 会自动识别它。
集成终端（⌘J）就在手边，供你完成这些一次性登录。
Codex 是例外——它在 Codeg 内部登录。选择官方订阅并点击使用 ChatGPT 登录：Codeg 会显示一个代码和一个验证链接，你在浏览器中批准它，面板便会以绿色的账户已登录予以确认。随时再次点击即可重新登录或切换账户。
用 API 密钥或自定义端点连接
更愿意按 API 调用付费，或通过一个 OpenAI/Anthropic/Gemini 兼容的网关来路由？在智能体的认证模式中选择自定义端点并填写：
- API URL——你的提供商或网关的基础 URL。
- API Key——你的密钥，带有一个显示/隐藏切换。
- Model——要请求的模型 id（在智能体需要时填写）。
Codeg 会在智能体启动时把这些交给它。大多数智能体都接受这条路径；实际显示的字段取决于该智能体所能理解的内容。
保存并复用模型提供商
如果你在多个端点之间切换，或希望一份凭据在多个会话之间共享，那就把它保存为一个模型提供商，而不必反复输入。此功能适用于 Claude Code、Codex 和 Gemini——这三者的 CLI 能够干净利落地接受基础 URL 和密钥的覆盖。
- 前往设置 → 模型提供商 → 添加提供商。
- 给它一个名称、一个 API URL、一个 API Key、它所面向的智能体类型，以及一个模型。
- 在设置 → 智能体中打开那个智能体，把它的认证模式设为模型提供商，然后选择你保存的那个。
一旦绑定，智能体的 API 字段会显示为只读，由该提供商填充。之后编辑某个提供商时，Codeg 会标记出任何需要重新连接才能采用该更改的运行中会话。
自定义端点与模型提供商的区别
它们配置的是同一样东西——一个基础 URL、一个密钥和一个模型——但作用范围不同。自定义端点是在单个智能体上内联输入的；而模型提供商是一条你设置一次并复用的具名记录。如果你只为一个智能体使用一个端点，自定义端点更简单；如果你要同时应付好几个，就把它们保存为提供商。（提供商一经创建，它的智能体类型就固定了。）
选择一个模型
你能选哪些模型，取决于智能体，而非 Codeg。一旦某个智能体连接上，composer 的模型下拉菜单会准确列出该智能体针对你的登录方式所提供的模型——因此选择会因智能体而异。在那里选一个，它就会对该对话生效。
- Codeg 会为每个智能体记住你上次的选择，并在你下次用该智能体开启会话时预选它。
- 没有按文件夹设置的模型默认值——模型是在会话层面选择的。（文件夹默认值设定的是智能体，而非模型。）
有几个智能体还提供一个推理强度控件——Claude Code、Codex、Grok 和 Pi。与模型不同，它位于智能体的设置面板中，而非 composer 里：一个从低到最高档的级别，每个智能体各以自己的方式命名（Codex 称为 Extra High，Grok 称为 Max）。Codeg 会把它写入智能体自己的配置。
Hermes：选择一个提供商
Hermes 是一个特例——它管理着自己旗下的一批模型提供商，因此它没有单个密钥，而是有自己的配置面板，带一个提供商下拉菜单，按三种方式分组：
- API 密钥提供商——输入你的密钥（如果该提供商需要，还有一个基础 URL）以及一个模型名称。密钥会保存到 Hermes 自己的
~/.hermes/.env中。 - OAuth 提供商（Nous、OpenAI Codex、Gemini、GitHub Copilot 等）——无需输入密钥；点击 Run Hermes setup，Hermes 会在终端中为你完成认证。
- AWS（Bedrock）——使用你环境中现有的 AWS 凭据。
对于面板未涵盖的任何内容，打开配置文件夹会显示 ~/.hermes，而一个高级部分让你直接编辑 Hermes 的 config.yaml。
凭据存储在何处
Codeg 把智能体凭据保存在智能体自己保存的地方——不会有任何内容上传到 Codeg：
- 智能体自己的原生配置。 由智能体的 CLI 处理的订阅登录或密钥会留在该智能体的文件中——
~/.codex/auth.json、~/.hermes/.env、~/.grok/auth.json等等——正是智能体自己的工具存放它的地方。 - Codeg 的本地数据库。 你输入到 Codeg UI 中的密钥——自定义端点密钥和已保存的模型提供商——由 Codeg 存储在本地，并在智能体启动时作为环境变量注入。与智能体自己的配置文件一样，它们在静态时并未加密，而遮蔽显示只是表面功夫——因此请把对你机器的访问权限视为安全边界。
这与 git 账户令牌是分开的，后者确实保存在你的系统密钥环中。→ git 账户