AI 提供商、模型与密钥
PocketCode 的 AI 采用自带密钥（BYOK）模式：你连接自己的 OpenAI、Google Gemini、Anthropic Claude、GitHub Copilot 账户，或任何兼容 OpenAI 的服务器，应用直接从你的手机与它通信。PocketCode 不收取任何 AI 费用，也没有 AI 配额。本页涵盖所有 AI 设置：密钥与登录、模型、调参、MCP 服务器、工具权限、密钥保管与隐私。AI 的使用方式（聊天、Swarmcode、Cortex、AI Office）另有专门的页面。
它是什么，以及如何打开
所有 AI 配置都集中在一处：打开 设置，进入 AI 分组。这里的任何内容都不需要订阅套餐，也都不是 PocketCode 的 AI 订阅：你连接自己的账户，应用直接与它们通信。下面按应用中的显示顺序列出各行。
| 行 | 作用 |
|---|---|
| 按任务选择模型 | 为每个后台任务（SQL、代码分析、工作流与设计生成、片段）固定提供商和模型，或交给应用自动选择。 |
| 可见模型 | 选择哪些模型出现在聊天的模型选择器中。 |
| API 密钥 | 添加、验证、替换和移除你的提供商密钥与登录。会先要求验证指纹、面部或屏幕锁定。 |
| 按服务商调参 | 温度、输出上限和推理强度，每个提供商一套。不需要指纹验证：这些值不是机密。 |
| AI 工具权限 | 限制每个提供商或模型可以调用哪些工具。 |
| MCP 服务器 | 连接你自己的工具服务器（Model Context Protocol）。 |
| 密钥 | 助手可以使用、却永远看不到的令牌和密钥。 |
| 自动建议 | 输入时显示 AI 建议。默认开启；依赖 代码补全。 |
| AI 标题 | 用模型为对话命名。默认关闭；该行会显示每个标题预计消耗的 token 数。 |
| 代码补全 | 用 AI 自动补全代码。默认开启。 |
| Cortex：同时进行几件事 | Cortex 最多可同时运行多少个智能体：1 到 4，默认 2。 |
| 上下文帮助 | 解释选中的代码。默认开启；关闭后，编辑器中的“解释”操作会回复「Contextual explanations are disabled」。 |
| 零外发（无网络 AI） | 阻止所有离开设备的 AI 调用。参见「隐私与安全」。 |
| Swarmcode | 多智能体模式的设置。打开设置面板免费；运行 Swarmcode 需要 Pro，另有 2 次免费运行。 |
聊天中的快捷入口
- 在尚未配置提供商的空聊天里，尚未配置 AI 服务 卡片带有一个 设置 AI 服务 按钮，点按后打开密钥列表。
- 在聊天的模型选择器里，没有密钥的提供商会显示 缺少密钥 和 点按添加；点按即可打开该提供商的那一行。
- 这两个快捷入口都会直接打开密钥面板，不会 弹出指纹验证。指纹验证只保护设置中的 API 密钥 这一行。
界面一览
AI 设置中的每个界面、面板和对话框，以及进入方式：
| 界面 | 如何进入 | 你可以做什么 |
|---|---|---|
| 设置 → AI | 打开 设置，选择 AI 分组。 | 十四行：下面各个面板、自动建议、AI 标题、代码补全、上下文帮助 和 零外发（无网络 AI） 的开关，以及 Cortex：同时进行几件事 选择器。 |
| API 密钥 | API 密钥 行（先验证指纹、面部或屏幕锁定），或从聊天进入。 | 查看五个 AI 提供商和 GitHub (git ops) 令牌的状态（已配置、未配置），打开其中一个，或在已配置的行上点按 用量和设置。 |
| OpenAI、Google Gemini、Anthropic Claude 的密钥视图 | 点按该提供商的行。 | 两个步骤：获取密钥 和 粘贴到这里，然后 验证并保存。之后是 你的密钥：立即验证、替换密钥、从此设备移除密钥。 |
| ChatGPT 登录 | OpenAI 行的第二个标签页。 | 接受 OpenAI 的条款，在浏览器中登录你的 ChatGPT 账户，退出登录。需要付费的 ChatGPT 套餐。 |
| GitHub 设备流程 | GitHub Copilot 行。 | 用一个短代码 使用 GitHub 登录、打开验证页面、取消登录、退出登录。需要付费的 Copilot 套餐。 |
| 自定义端点 | 自定义端点 行（或它已保存的端点）。 | 选择 OpenRouter、Groq、DeepSeek 等，或你电脑上的 LM Studio、Ollama 和 Tailscale；粘贴密钥、编辑 基础 URL、测试连接、保存多个端点。 |
| 用量和设置 | 密钥列表中已配置行上的按钮。 | 一个可滚动的面板：提供商配额、已记录的用量、诊断 和 设置。 |
| 按服务商调参 | 按服务商调参 行（无需指纹验证）。 | 与上面相同的 设置 区块，每个提供商一个标签。 |
| 按任务选择模型 | 按任务选择模型 行。 | 自动 或 手动，并为五个后台任务固定提供商和模型。 |
| 可见模型 | 可见模型 行。 | 在聊天选择器中隐藏模型，按提供商 全选 / 全不选，重新加载模型，重新全部显示。 |
| 聊天的模型选择器 | 点按聊天顶栏中的模型名称。 | 最近、收藏、全部 标签页，全局搜索，推理强度。使用方式见「AI 聊天」；模型列表的来源在本页说明。 |
| AI 工具权限 | AI 工具权限 行。 | 按提供商或按模型允许或拒绝工具，自动批准 各类别，在本机之外操作前先询问。 |
| MCP 服务器 | MCP 服务器 行；添加 打开表单。 | 添加、开关和删除服务器；查看每个服务器的状态和最近一次错误；新服务器运行前先确认。 |
| 密钥 | 密钥 行。 | 添加、编辑和删除命名的密钥，以及它们可以发送到的主机。值不会再次显示。 |
| Swarmcode | Swarmcode 行。 | 选择一个任务预设，开关 验证 和 应用更改，打开 精细调整。 |
| 发送给 …？ | 你第一次向某个提供商发送内容时。 | 允许或取消向该提供商发送你的消息、代码和附件。 |
| 任何数据都不会离开本机 | 零外发（无网络 AI） 开启时，空聊天里的一张卡片。 | 查看该设置 并将其关闭。 |
提供商与登录方式
PocketCode 有五类提供商。其中四个是有名字的服务；第五个 自定义端点 是任何支持 OpenAI API 的服务器。API 密钥 面板按这个顺序列出它们，并在 Git 操作 下多出第六行 GitHub (git ops)。这一行不属于 AI：它保存应用的 Git 客户端用来 push、pull 和 clone 的令牌，AI 聊天从不使用它。每一行都会显示 已配置 或 未配置。
| 提供商 | 登录方式 | 你需要什么 |
|---|---|---|
| OpenAI | 粘贴 API 密钥（API 密钥 标签页，推荐）或用你的 ChatGPT 账户登录（ChatGPT 登录 标签页）。 | 一个有余额的 OpenAI API 密钥，由 OpenAI 按 token 计费；或一个包含 Codex 的付费 ChatGPT 套餐（Plus、Pro、Team 或 Enterprise），通过应用内置的 Codex CLI 使用。ChatGPT 登录只能在 64 位 ARM 手机上运行。 |
| Google Gemini | 粘贴 API 密钥。没有登录方式。 | 来自 Google AI Studio 的密钥（aistudio.google.com/apikey）。AI Studio 有免费额度，限额由 Google 设定。 |
| Anthropic Claude | 粘贴 API 密钥。没有登录方式。 | 来自 console.anthropic.com/settings/keys 的密钥，以 sk-ant- 开头。Anthropic 按 token 向你的账户计费。 |
| GitHub Copilot | 使用 GitHub 登录（GitHub 设备流程）。 | 付费的 GitHub Copilot 订阅（Pro、Business 或 Enterprise）。你可以使用所在套餐包含的模型，由 GitHub 计费。 |
| 自定义端点 | 从列表中选择一个提供商，或输入 URL，并粘贴它的密钥。 | 任何支持 OpenAI API 的服务器：OpenRouter、Groq、DeepSeek 等 170 多家，或你自己电脑上的 Ollama 和 LM Studio。只有本地服务器可以不填密钥。 |
添加密钥（OpenAI、Gemini、Claude）
- 1打开 设置 → AI → API 密钥，点按该提供商的行。对 OpenAI，停留在 API 密钥 标签页。
- 2第 1 步，获取密钥。 应用会告诉你去哪里创建，以及它以什么开头（OpenAI：
platform.openai.com/api-keys，Gemini：aistudio.google.com/apikey，Claude：console.anthropic.com/settings/keys）。下面的链接会打开该页面。 - 3第 2 步，粘贴到这里。 把密钥粘贴到输入框，或使用 从剪贴板粘贴。应用会清理你粘贴的内容（空格、引号、
Bearer、NAME=value、JSON），并在格式看起来不对时立即提示，比如把 Claude 的密钥粘到了 OpenAI 的输入框。 - 4点按 验证并保存。应用向提供商发送一个很小的请求来验证密钥，然后保存。被提供商拒绝的密钥永远不会被保存。
「验证并保存」会发生什么
| 提供商…… | 结果 |
|---|---|
| 接受密钥 | 密钥被保存，面板标注 有效，并显示验证时间和请求耗时。 |
| 拒绝密钥 | 不会 保存。你会留在表单上，看到「OpenAI 拒绝了这个密钥。请检查后重试。」（带提供商名称）。 |
| 无法连接 | 没有网络、超时，或 零外发 已开启：密钥 会 被保存，标记为 尚未验证，并提示「无法验证 OpenAI 的密钥；仍会照常使用。」 |
你的密钥：验证、替换、移除
保存密钥后，点按该行会显示 你的密钥：密钥的指纹（只含开头几个字符和最后四位，绝不显示全文）、上次验证的时间和结果。
你可以
- 立即验证 会重新验证一次。被拒绝的密钥会显示「OpenAI 拒绝了这个密钥。请替换它以继续使用 OpenAI。」
- 替换密钥 会带你回到那两个步骤。
- 从此设备移除密钥 会把它从手机上删除：「在你重新添加密钥之前，聊天将不再使用 OpenAI。」提供商网站的链接让你可以在那边真正吊销这个密钥。
- 在任何已配置的行上，用量和设置 都会打开配额、用量、诊断和调参。
- 保存新密钥后，模型选择器会重新向提供商请求模型列表。
你不能，以及原因
- 保存被提供商拒绝的密钥，或格式明显不对的密钥（例如 Anthropic 的管理密钥
sk-ant-admin…：「这是管理密钥；聊天需要普通的 API 密钥。」）。有意为之 - 再次查看已保存的密钥：只显示它的指纹。有意为之
- 对密钥面板截屏，或在最近任务预览中看到它：该面板会阻止这两者。有意为之
- 在密钥验证过程中关闭面板。有意为之
- 把密钥同步到 PocketCode 服务器：根本没有这样的服务器。应用会说「密钥留在本机 — 不会同步到我们的后端」。有意为之
用 ChatGPT 账户使用 OpenAI
OpenAI 行有两个标签页：API 密钥（推荐，任何账户都能用）和 ChatGPT 登录。后者会登录你自己的 ChatGPT 账户，消耗的是你的 ChatGPT 订阅额度，而不是 API 账单。底层由应用内置的 OpenAI Codex CLI 运行：每一轮 OpenAI 对话都经过它，模型列表就是 Codex 为你的账户接受的那些。选择器把这一部分标为 OpenAI · 通过 Codex。
你可以
- 点按 开始 ChatGPT 登录。首先会出现条款对话框（使用 ChatGPT 登录）：阅读 OpenAI 的条款，勾选复选框，点按 接受并继续。只会询问一次。
- 在打开的浏览器中授权（「正在等待你在 ChatGPT 上授权…」），然后回到应用。需要时可以使用 再次打开登录页面 和 取消登录。
- 连接后，该行显示 已配置，点按 退出 ChatGPT 会从手机上移除会话。
- 用量和设置 会显示你的 ChatGPT 套餐、账户，以及该账户报告的 Codex 额度。
你不能，以及原因
- 用免费的 ChatGPT 账户，或不含 Codex 的账户使用它：「你的 ChatGPT 账户不包含 Codex。需要付费套餐（Plus、Pro、Team 或 Enterprise）才能使用 Codex。」第三方
- 在非 64 位 ARM 的手机上使用（模拟器、Chromebook）：Codex 二进制文件只为 arm64-v8a 打包。请在那里改用 OpenAI API 密钥。设备
- 运行 Codex 对你的账户拒绝的模型：选择器仍会列出它们并标注 当前套餐不可用，选择其中之一会回复「Codex 无法在你的 ChatGPT 账户下运行 …」第三方
- 让 Codex 自行编辑文件或运行命令：它自带的写入和 shell 工具已关闭，只有 PocketCode 的工具会运行，并且经过同一道权限关卡。有意为之
- 附加图片：使用 ChatGPT 登录时，对话会以纯文本形式发给 Codex。有意为之
GitHub Copilot
GitHub Copilot 行只有一种方式：GitHub 设备流程。你需要一个有效的付费 Copilot 订阅：你可以使用所在套餐包含的模型，由 GitHub 计费。应用通过内置的 Copilot 语言服务器与 Copilot 通信。
你可以
- 点按 使用 GitHub 登录：屏幕上会以大字显示一个短代码（点按即可复制）和倒计时「代码将在 … 后过期」。
- 点按 打开验证页面（
github.com/login/device），输入代码并授权。应用会等待（「等待你在 GitHub 上授权…」），并在你的手机上轮询结果，即使你离开应用去授权也一样。取消登录 会中止这个过程。 - 连接成功后，该行显示 已配置，退出 GitHub Copilot 会将其移除。
- 在聊天的模型选择器中选择模型：列表由 Copilot 语言服务器针对你的账户实时返回。首选类别（Fast、Balanced、Powerful）在调参面板中。
你不能，以及原因
- 没有付费的 GitHub Copilot 订阅就使用 Copilot。第三方
- 附加图片：Copilot 的对话只支持文本。有意为之
- 在 零外发（无网络 AI） 开启时使用它：语言服务器不会启动。有意为之
Gemini，以及已停用的 Google 登录
Gemini 只能使用 API 密钥。Google 已于 2026 年 6 月 18 日停止个人账号（免费版、AI Pro 和 AI Ultra）通过 Google 账号登录 Gemini CLI，所以入口只有 AI Studio 密钥，而 AI Studio 提供免费密钥，限额由 Google 设定。如果旧版 PocketCode 曾为你保存过 Google 登录，Gemini 行会显示 Google 登录已停用——请添加 API 密钥：打开它，阅读提示并点按 移除旧的 Google 登录，或者直接保存一个 Gemini 密钥，它会把旧登录一并清除。
你可以
- 在
aistudio.google.com/apikey获取密钥，并像其他密钥一样添加。 - 用 移除旧的 Google 登录 清除遗留的 Google 登录。
你不能，以及原因
- 为 Gemini 新建 Google 登录：「Google 已于 2026 年 6 月 18 日停止个人账号通过 Google 登录 Gemini CLI，因此它已无法使用。」第三方
费用、配额与自带密钥
PocketCode 没有 AI 套餐：你向提供商付费（用本地模型则无需付费），应用自身不收费、不提供额度，也不限制消息数量。
- 自带密钥。 本页的每个提供商在免费版上都可以免费连接，密钥和端点数量不受限制。
- 谁向你收费。 使用 API 密钥时，由提供商向你的账户计费（OpenAI 和 Claude 按 token；Gemini 的 AI Studio 有免费额度，限额由 Google 设定）。使用 ChatGPT 登录 时，用量从你的 ChatGPT 订阅额度中扣除。Copilot 使用你的 Copilot 套餐中的模型，由 GitHub 计费。本地服务器不花钱。
- 没有内置额度。 PocketCode 从不统计或限制你的 AI 消息。它显示的唯一数字，是提供商返回的那些：用量和设置 中的 提供商配额 和 已记录的用量。
- 限制由提供商决定。 速率限制、免费额度和价格都归各个提供商所有，可能在应用不变的情况下发生变化。
模型
你能使用哪些模型取决于你的密钥。你在聊天的模型选择器中选择模型；本页的设置决定选择器显示什么，以及后台任务使用哪个模型。
模型列表从哪里来
- 使用 API 密钥时， 应用会向提供商请求它自己的模型列表，所以新模型一经提供商发布就会出现。应用保留每个模型系列的最新版本，把较旧的折叠在 显示 N 个较旧版本 下；OpenAI 只显示聊天模型。
- 远程目录。 应用还会读取 PocketCode 托管的一个小型清单（
pocketcodeapp.com/models.json），其中包含名称、描述、输出上限，以及推理和视觉标记，这样无需发布新版本就能添加新模型。它每 6 小时刷新一次，离线时使用最近一份有效副本，内置列表是最后的兜底。 - ChatGPT 登录： Codex 为你的账户接受的模型。Copilot： Copilot 语言服务器针对你的账户实时返回的列表。自定义端点： 该端点自己的
/v1/models。 - 没有密钥的提供商会在选择器中显示 缺少密钥 · 点按添加。
聊天的模型选择器
点按聊天顶栏中的模型名称。如果有最近使用的模型，它默认停在 最近，否则停在 全部。
- 最近（你最近发送过对话的 5 个模型）、收藏（点按模型上的星标）和 全部（每个已连接的提供商一个分组，每个已保存的自定义端点一个分组）。
- 搜索所有模型 会同时搜索所有提供商。
- 每一行显示模型、它的 id 和上下文窗口，以及 视觉、推理、免费 标签。免费 只出现在以
:free结尾的 id 上，这是 OpenRouter 对无费用模型的约定：它并不表示在 PocketCode 中免费。 - 刷新模型 重新加载某个提供商的列表；已停用的模型会变暗并标注 （已停用）；支持推理的模型带有 思考强度 选择器（关闭、低、中、高）。
- 选择已保存自定义端点的模型，会把聊天切换到该端点。添加自定义端点（LM Studio、Ollama、OpenRouter…） 位于底部。
你不能，以及原因
- 把 免费 理解为在 PocketCode 中免费：它只是沿用 OpenRouter 的
:free后缀。有意为之 - 看到你在设置中隐藏的模型：被隐藏的模型会被跳过，正在使用的那个除外。有意为之
可见模型
设置 → AI → 可见模型（「整理对话的模型选择器」）按提供商分组列出模型。
你可以
- 关闭某个模型即可把它从选择器中隐藏；计数器显示「N / M」。
- 全选 和 全不选 一次性切换整个提供商。
- 在有 10 个或更多模型的提供商内可以搜索。
- 重新加载模型 重新加载列表；重新全部显示（已隐藏 N 个） 撤销所有隐藏。
你不能，以及原因
- 屏蔽模型：「隐藏不会屏蔽模型，只是整理列表。」固定在被隐藏模型上的后台任务仍然可以运行。要限制模型能做什么，请使用 AI 工具权限。有意为之
- 隐藏你正在使用的模型：它始终保留在选择器中。有意为之
按任务选择模型
后台 AI 任务（也就是不属于聊天的那些）自己选择模型。设置 → AI → 按任务选择模型 分两层：一个全局模式，以及每个任务的固定设置。
| 模式 | 应用做什么 |
|---|---|
| 自动 | 选择一个已连接的提供商（如果聊天所用的提供商已连接，就用它）和一个适合该任务的模型：SQL 或片段用速度快的，代码分析用擅长推理的。这是本地规则：不会额外调用 AI。这是默认模式。 |
| 手动 | 沿用聊天的提供商和模型。如果该提供商不可用，任务会以明确的提示失败，而不是在你不知情时切换提供商。 |
你可以
- 选择全局模式，自动 或 手动（见下表）。
- 为五个任务各固定一个提供商和模型：SQL 助手、代码分析、工作流生成、设计生成 和 片段生成。已固定的任务会显示它的提供商和模型；默认 则跟随全局模式。
- 只要所固定的提供商已连接，固定设置就优先于全局模式；如果没有连接，任务会退回到全局模式。
- 没有连接任何提供商时，面板会显示「请先连接一个 AI 提供商以固定模型。」
你不能，以及原因
- 在这里更改聊天使用的模型：聊天使用它自己的选择，本页只管理后台任务。有意为之
- 固定通用任务：它在应用中存在，但没有对应的行。有意为之
自定义端点
自定义端点 可连接任何支持 OpenAI API 的服务器；该行的说明文字是「OpenRouter、Groq、DeepSeek、Ollama 等 170 多家」。面板一次显示一个步骤：先 选择，再 配置。
- 1打开 设置 → AI → API 密钥 → 自定义端点。
- 2选择。 从 云服务提供商 中选一个提供商，或选 在你的电脑上 下的三个快捷项之一。搜索提供商 会列出公开的 models.dev 目录中所有提供了基础 URL 的 OpenAI 兼容提供商（170 多家，是实时列表，不是固定数字）。已连接的在 已连接 下。
- 3配置。 所选的提供商及其密钥：更改 返回上一步，然后是 API 密钥 输入框。高级设置 显示 基础 URL，它已填好，也可以为你自己的服务器修改。
- 4点按 测试连接 可在不保存任何内容的情况下试一下：它会向该端点请求模型列表并测量延迟。然后点按 连接（编辑时是 保存）。
在你的电脑上与云端
| 快捷项 | 连接方式 |
|---|---|
| LM Studio | http://127.0.0.1:1234/v1。用 USB 把手机连到电脑，并在电脑上运行 adb reverse tcp:1234 tcp:1234。 |
| Ollama | http://127.0.0.1:11434/v1。如果 Ollama 就运行在这台手机上，可直接使用。如果运行在你的电脑上，请在电脑上运行 adb reverse tcp:11434 tcp:11434。 |
| Tailscale (HTTPS) | 你自己的 https://….ts.net/v1 地址。在电脑上运行 tailscale serve --bg 1234（1234 是 LM Studio，11434 是 Ollama），然后粘贴它输出的地址，并在末尾加上 /v1。 |
云服务提供商 列出十个常用服务，网址已预先填好：OpenRouter、Groq、DeepSeek、Together AI、Mistral、xAI、Cerebras、Fireworks AI、DeepInfra 和 Perplexity。
密钥、多个端点与模型
只有本地服务器可以不填 API 密钥：localhost 和回环地址、0.0.0.0、私有网络地址、.local 名称，以及 Tailscale 网络（*.ts.net）。其他情况下，面板会提示「请输入 API 密钥」。
你可以
- 保存多个端点，并从聊天中在它们之间切换：每个已保存的端点在模型选择器中自成一个分组。一旦保存了一个，自定义端点 行就会被替换成每个端点各一行，外加 添加提供商。
- 编辑已保存的端点：密钥留空即保留当前密钥（「已保存密钥。留空即可保留。」）。
- 从此设备移除端点 会在确认后将其删除。
- 模型在聊天的模型选择器中选择，而不是在这个面板上。
你不能，以及原因
- 对
localhost、127.0.0.1或10.0.2.2（模拟器的地址）以外的任何地址使用明文http://：Android 会阻止未加密流量，这样你的密钥和代码就不会以明文经过共享 Wi-Fi。像http://192.168.1.50这样的局域网地址，在“密钥可选”的判断中算本地，但仍会被拦截。请使用 HTTPS（Tailscale Serve），或通过 USB 配合adb reverse。有意为之 - 添加没有公布基础 URL、或不支持 OpenAI 协议的提供商：它们不在列表中。第三方
- 在这个面板上选择模型。有意为之
用量、诊断与调参
有两个面板可以为提供商调参。用量和设置 是完整视图；按服务商调参 是直达它最后一个区块的快捷入口，不要求指纹验证。
用量和设置
| 区块 | 显示内容 |
|---|---|
| 顶部 | 提供商的名称和说明；使用 ChatGPT 登录时，还有你的 ChatGPT 套餐和账户邮箱，读取自手机上保存的登录信息。 |
| 提供商配额 | 提供商报告的每个限额窗口的进度条（「提供商报告的权威数据（我们不做任何估算）」）。没有报告任何数据的提供商会显示 尚无提供商数据 和「发送一条消息，让提供商返回其计数器。」 |
| 已记录的用量 | PocketCode 根据各提供商返回的 token 数在本设备上记录的内容：对话轮数、输入、输出、缓存读取与写入、缓存命中率和 热门模型。「我们只统计各提供商在其响应中返回的令牌数。如需查看真实配额，请查看提供商的仪表盘。」 |
| 诊断 | 「查明该服务商为何没有响应」，分三个级别（见下）。 |
| 设置 | 调参控件（见下）。更改从你下一次用该提供商发送的对话起生效。 |
已记录用量的统计周期
| 提供商 | 选项 |
|---|---|
| API 密钥（OpenAI、Gemini、Claude、自定义） | 今天、7 天、30 天、全部 |
| 使用 ChatGPT 登录的 OpenAI | 最近 3 小时、今天、本周、全部 |
| GitHub Copilot | 本月、全部 |
诊断
每个级别都包含前面的级别，并在第一个严重失败处停止，所以如果免费检查已经找到问题，就绝不会消耗 token。
| 级别 | 作用 |
|---|---|
| 免费 | 「不联网，也不使用密钥」：检查密钥的格式、是否选了模型，以及是否所有工具都被拒绝了。 |
| 测试密钥 | 「仅验证身份，不生成内容」：还会向提供商请求模型列表，并检查你选择的模型是否仍在其中。 |
| 完整测试 | 「一次真实回复，会消耗额度」：发送一个真实的聊天请求。 |
这个面板能做什么、不能做什么
它是一个可以滚动的面板，不是标签页。
你可以
- 查看提供商的配额进度（提供商有报告时），以及应用在本地记录的内容。
- 在提供商不再响应时运行诊断。
- 不离开面板就编辑该提供商的设置。
你不能，以及原因
- 查看提供商没有提供的配额：只有 ChatGPT 登录和 Copilot 会从这些服务未公开文档的账户端点读取（它们可能不经通知就改变），Claude 只有在响应中带有相关窗口时才会显示。Gemini、使用 API 密钥的 OpenAI 和自定义端点都没有。第三方
- 在免费 ChatGPT 套餐上查看 Codex 配额：「你的 ChatGPT 免费套餐不提供 Codex 用量额度——只有付费套餐（Plus、Pro、Team、Enterprise）才有。」第三方
- 把已记录的用量当作账单：它只统计提供商返回的 token，而且只限这台设备。有意为之
按服务商调参
设置 → AI → 按服务商调参 有一排五个标签（OpenAI、Gemini、Claude、Copilot、自定义）。你没动过的项都保持提供商的默认值，重置 可以让某个控件恢复默认。面板只提供每个提供商拥有的控件。
| 控件 | 作用 | 适用于 |
|---|---|---|
| 温度 | 从 0.00 到 2.00 的滑块（在你拖动之前显示 0.70）。 | 全部 |
| 最大令牌数 | 输出上限，以 512 为步长，从 512 到当前模型自身的上限。 | 全部 |
| 思考预算 | 关闭、低、中 或 高：0、1,024、4,096 和 16,384 个 token。 | Claude |
| 推理强度（o 系列） | low、medium 或 high。 | OpenAI、自定义 |
| 查看真实推理过程（Responses API） | 使用 OpenAI 的 Responses API 来显示模型的推理过程。自定义服务器不提供该项，因为它们很少实现这个接口。 | 使用密钥的 OpenAI |
| 频率惩罚、存在惩罚 | 从 −2.0 到 2.0。 | OpenAI、自定义 |
| Top-K、Top-P | Top-K 从 1 到 100（显示 40），Top-P 从 0 到 1（显示 0.95）。 | Gemini |
| 首选类别 | Fast、Balanced 或 Powerful。 | Copilot |
| MCP 工具 | 是否把你的 MCP 服务器的工具提供给这个提供商。默认开启。 | 全部 |
| 最大智能体轮次 | 一轮对话最多可以进行多少轮工具调用：以 5 为步长，最高 100；0 显示为 ∞，表示不设上限，这是默认值。 | 全部 |
- 把最大令牌数设得高于当前模型的上限，或调整该提供商没有的参数。有意为之
MCP 服务器
设置 → AI → MCP 服务器 通过 Model Context Protocol 连接外部工具服务器。它们的工具会与 PocketCode 自带的工具一起提供给模型，适用于 Claude、Gemini、OpenAI、自定义端点和 Copilot，命名为 <server id>__<tool>。服务器是运行在你手机上的程序，通过应用内置的 Node.js 运行时执行。
添加和管理服务器
面板一开始是空的：「还没有 MCP 服务器。点击“添加”来连接一个 — 例如 node /sdcard/mcp/server.js。」
你可以
- 点按 添加，填写 ID（小写字母、数字和
_，之后不能再改）、显示名称、命令（node）、参数（第一个是脚本路径）和 环境变量（每行一个KEY=value，加密保存）。 - 新服务器运行前，你会看到 这个服务器会在你的手机上运行：「我们将以与 PocketCode 相同的权限运行 …。如果你不认识它，请先取消并检查。」点按 运行；如果取消，则不会保存任何内容。服务器在你保存时运行，之后每次打开开关时也会再运行。
- 每个服务器都会显示它的状态：空闲、启动中…、运行中 · N 个工具、失败（附红色的最近一次错误）或 已禁用。开关可以将其启用或停用，垃圾桶图标会将其删除。
- 从 Marketplace 安装的服务器默认处于关闭状态并待确认：第一次打开开关时会显示同样的警告。
- 你保存并保持开启的服务器会在应用启动时自动启动，所以无需打开这个面板，聊天里就已经有它们的工具；待确认的服务器仍保持关闭。
- 如果服务器声明了没有被提供的工具，它的行会显示「该服务器声明了一些未被提供的工具：」以及最多三条原因。
- 在 按服务商调参 中用 MCP 工具 可以为某一个提供商关闭 MCP 工具。
你不能，以及原因
- 启动
npx、python、deno或任何其他命令：「这条命令不能在这里运行。仅支持node。」应用没有内置 npm，而且不允许下载并运行代码。Google Play - 连接远程 MCP 服务器（HTTP 或 SSE）：服务器是应用启动、并通过 stdio 通信的本地程序，没有网络传输方式。有意为之
- 使用服务器的资源或提示词：只开放它的工具。有意为之
- 在参数里传 shell 字符：分号、与号、管道符、反引号、
$(、>>或<<会被拒绝。请改用环境变量传值。有意为之
服务器的限制
| 限制 | 数值 |
|---|---|
| 每个服务器的工具数 | 128。超出的工具会被丢弃，该行会注明。 |
| 整个工具目录 | 64 KB；单个工具的 schema 为 32 KB；tools/list 最多 50 页。 |
| 等待时间 | 启动（initialize）15 秒，列出工具 10 秒，每次工具调用 30 秒；服务器每报告一次进度就延长一次（最多 20 次）。 |
| 协议 | 基于 stdio 的 MCP，版本 2024-11-05。当服务器声明工具列表有变化时，工具列表会重新加载。 |
工具权限
设置 → AI → AI 工具权限 决定每个提供商（或某个具体模型）可以调用哪些工具。「默认允许所有工具。」这里的任何内容都不需要订阅套餐或指纹验证。拒绝是真正生效的：每一轮 AI 对话都要经过同一道关卡，无论是走 CLI 和语言服务器路径（Copilot、ChatGPT 登录）还是直连 API 路径；如果读不到你的权限设置，工具会被拒绝，而不是被放行。
你可以
- 在标签栏上选一个提供商（OpenAI、Gemini、Claude、Copilot、自定义）和一个范围：整个提供商，或点按 更改 选定某个模型。提供的模型是应用为该提供商内置的那些。
- 允许 Copilot LSP 工具（仅 Copilot）：关闭时，Copilot 语言服务器只以文本回复；文件编辑和终端命令会被阻止。
- 在本机之外操作前先询问（默认开启）：推送、部署或调用外部服务器会先被搁置，等你批准；智能体会继续工作，从不原地等待。
- 允许 AI 自行工作（默认关闭）：允许 AI 在会话结束后运行审查、文档和记忆整理，仅在连接 Wi-Fi 充电时进行，绝不抢在你前面，并有每日上限。关闭则不会发出这些调用。
- 自动批准：在 默认 权限模式下，无需询问就运行整个类别的工具。
- 十五个类别（只读、提问、写入、终端、待办、Cortex 协同、记忆、设计、部署、数据库、API、SSH、Git、浏览器、工作流）：每个都可以折叠，显示「已允许 N / M」，带有 全部允许 和 全部拒绝，每个工具还有一个开关。仅限 Agent、仅限 Cortex 和 需要配置 标记并非在每种模式下都提供的工具。
你不能，以及原因
- 用开关解锁你没有购买的工具：套餐检查先于你的权限设置运行。有意为之
- 让拒绝在工具本来就没提供的地方起作用：在不提供该工具的模式下关闭它不会有任何变化。有意为之
- 把拒绝限定到应用不认识的模型：按模型的菜单列出的是应用内置的模型，而不是提供商返回的实时列表。整个提供商 始终生效。有意为之
密钥（Secrets）
设置 → AI → 密钥 保存助手可以在终端命令和请求中使用、却 永远看不到 的令牌和 API 密钥。助手需要时会在聊天里用一张卡片向你索取，你也可以在这里添加。
你可以
- 添加 一个密钥，需要 名称（大写字母、数字和
_，最多 64 个字符，以大写字母开头：GITHUB_TOKEN）、值（4 到 16,384 个字符，单行）以及 可发送到的主机（用逗号分隔，api.github.com或*.example.com；除 localhost 外只允许 HTTPS；最多 16 个）。不填主机时，该密钥只用于终端命令，而且每次都会先询问。 - 编辑 密钥：修改它的主机，或输入 新值（可选）；留空则保留当前值。
- 确认后 删除：「它将从本设备移除，助手将无法再使用。此操作无法撤销。如果令牌可能已泄露，请同时在其服务中吊销。」
- 助手会把值注入命令的环境变量或请求的请求头，并在输出中将其遮蔽，而且只会发往你批准的主机。
你不能，以及原因
- 查看或导出已保存的值，在这里也不行：「你输入的内容会在本设备上加密。助手永远看不到它，也不会再次显示。」有意为之
- 使用
PATH、HOME、NODE_OPTIONS这类保留名称，或以LD_、DYLD_、ANDROID_、BOOTCLASSPATH开头的名称：「此名称为保留名称：作为密钥它会改变每条终端命令的运行方式。」有意为之 - 通过明文
http://发送密钥：「…只允许 https://，发往 localhost 的除外。」有意为之
它们存放在哪里
- 使用 AES-256-GCM 加密，密钥来自 Android Keystore（手机支持时使用 StrongBox），保存在属于你账户的文件中。它们不会发送到 PocketCode 的服务器。
- 整个面板都会阻止截屏。
Swarmcode 与 Cortex 设置
设置 → AI → Swarmcode 用来设置聊天的多智能体模式：多个智能体并行处理你的请求，开启验证后，还会有一组评审在答案展示前进行核对。打开和编辑这个面板是免费的；运行 Swarmcode 需要 Pro，另有 2 次免费运行作为试用。使用方法见「AI 聊天」。
一键任务预设
| 任务 | 它设置了什么 |
|---|---|
| 深度审查 | 6 个智能体，3 名评审，2 票通过，2 轮。查找并交叉核对。从不改动文件。 |
| 缺陷排查 | 4 个智能体，3 名评审，2 票，2 轮。广度较小，验证更多。不会写入你的文件。 |
| 重构 | 4 个智能体，2 名评审，2 票，2 轮。把改动写入你的代码。 |
| 构建功能 | 6 个智能体，3 名评审，2 票，2 轮。兼顾广度与写入。 |
开关与精细调整
任务卡片会填入下面的各项值。如果你手动改了其中一项，该卡片就不再处于选中状态。
你可以
- 验证（默认开启）：一组评审在答案展示前进行核对。更可靠，但稍慢且成本更高。
- 应用更改（默认关闭）：验证之后，由一个智能体把答案写入你的文件，且只限项目内部。
- 精细调整（默认折叠）：最大子智能体 1 到 32（默认 8）、并发数 1 到 12（默认 4）、每轮 令牌预算 0 到 500k，以 10k 为步长（0 表示无限制，是默认值），以及 单代理上限 0 到 100k（0 表示引擎默认值）。
- 开启验证后，还有 评审数 1 到 5（默认 3）、通过所需票数 从 1 到评审数（默认 2），以及 复审轮数 1 到 4（默认 2）。
你不能，以及原因
- 在免费版上运行超过 2 次免费运行的 Swarmcode：你可以设置它，但免费运行用完后，在聊天中选择 Swarmcode 引擎会弹出 Pro 付费墙。Pro
- 要求票数多于评审数，或子智能体超过 32 个。有意为之
Cortex
| 设置 | 作用 |
|---|---|
| Cortex：同时进行几件事 | 在 AI 列表中：Cortex 最多可同时运行多少个智能体，1 到 4（默认 2）。「开得越多，一起回来找你的事情也越多。」 |
免费版与 Pro
连接 AI 对所有人免费。收费的部分是建立在它之上的多智能体工具。
| 功能 | 免费版 | Pro |
|---|---|---|
| 密钥、ChatGPT 登录、Copilot、自定义端点 | 可用。密钥和端点数量不限。ChatGPT 登录和 Copilot 需要它们各自的付费订阅。 | 可用 |
| 按服务商调参、按任务选择模型、可见模型 | 可用 | 可用 |
| 工具权限、MCP 服务器、密钥（Secrets） | 可用 | 可用 |
| Swarmcode（运行） | 试用 2 次已完成的运行。设置面板可以打开。 | 可用 |
| Cortex | 试用 3 个已完成的任务 | 可用 |
| AI Office | 不可用 | 可用 |
| 在可视化设计器的起始界面新建 AI 设计 | 不可用 | 可用 |
| 在聊天中创建和修改工作流 | 不可用。你仍然可以自己编写和运行工作流。 | 可用 |
隐私与安全
应用保存了什么、存在哪里，以及哪些内容会离开手机：
- 密钥在设备上加密。 使用 AES-256-GCM，密钥由 Android Keystore 保管（手机支持时使用 StrongBox）。它们按账户保存：退出登录不会删除任何内容，同一部手机上的其他账户也读不到它们。
- 密钥面板会保护屏幕。 截屏和最近任务预览都被阻止，已保存的密钥始终只显示为指纹。
- 指纹验证是一扇门，不是保险柜。 它只保护从设置打开 API 密钥。它不覆盖聊天中的快捷入口，而且 Keystore 密钥本身并不要求每次使用都验证，所以应用可以在后台使用你的密钥。
- 直达提供商。 请求从你的手机发往提供商的 API（Claude、OpenAI、Gemini）、你自己的服务器（自定义）、通过 Copilot 语言服务器发往 GitHub，或通过 Codex CLI 发往 OpenAI。PocketCode 没有 AI 代理，也没有你密钥的副本。
- 发往 PocketCode 服务器的内容： 只有模型目录（
pocketcodeapp.com/models.json；请求它会让我们的服务器知道应用已打开，并带有你的 IP 地址），以及你举报某条 AI 回答时的那份举报。自定义端点的提供商和价格列表来自第三方目录 models.dev。 - 已记录的用量 保存在设备上，只统计提供商返回的内容。密钥（Secrets） 按账户加密，永远不会显示，也不会发送给 PocketCode。
- 工具权限默认拒绝： 如果读不到权限设置，工具就会被拒绝。
零外发（无网络 AI）
设置 → AI → 零外发（无网络 AI）：「开启后，应用不会向 AI 发起任何网络调用——全部在设备本地运行。在线模型会被禁用，直到你关闭此项。」会有提示确认：「零外发已开启——已禁用云端 AI」。
你可以
- 默认关闭，并按账户记住。
- 开启它可以停止所有 AI 请求：聊天和其他 AI 功能、你保存密钥时的验证、模型目录和配额查询（应用会使用最近保存的副本）、Copilot 语言服务器、智能体从网上抓取的页面，以及 AI 内容举报。
- 开启期间，空聊天会显示 任何数据都不会离开本机，并带有 查看该设置 用于将其关闭。
你不能，以及原因
- 让本地模型继续工作：这个开关没有选择性。它会阻止所有提供商，包括你自己手机上的自定义端点（例如 Ollama），而且 PocketCode 自己没有可在设备上运行的模型。有意为之
- 把它当作操作系统级防火墙：它只会阻止应用自己的 AI 调用。有意为之
发送前的同意
你第一次向某个提供商发送内容时，聊天会询问 发送给 …？：「为了回答，PocketCode 会通过互联网将你的消息以及你附加的代码或文件发送给第三方 AI 提供商 …。请勿分享你不希望被其处理的密钥或个人数据。」你可以选择 发送 或 取消。
你可以
- 这个回答会按提供商和账户记住。
- 每个 AI 功能都会检查它，不只是聊天；没有它，就不会发送任何内容。
你不能，以及原因
- 向你没有同意的提供商发送任何内容：「PocketCode 没有发送任何内容：你还没有允许把你的消息和代码发送给 ….」如果读不到这项偏好，应用会再次询问。有意为之
限制
哪些功能不能用，免得你措手不及：
- Gemini 没有登录方式： Google 已于 2026 年 6 月 18 日停止个人账号通过 Google 登录 Gemini CLI，所以只有 API 密钥可用。第三方
- Claude 没有登录方式： 只有 API 密钥可用。有意为之
- ChatGPT 登录需要包含 Codex 的付费 ChatGPT 套餐， 而且只运行 Codex 为你的账户接受的模型。第三方
- ChatGPT 登录只能在 64 位 ARM 手机上使用。 在模拟器和 Chromebook 上请使用 OpenAI API 密钥。设备
- GitHub Copilot 需要付费的 Copilot 订阅， 它的模型列表就是你的套餐所包含的那些。第三方
- Codex CLI 和 Copilot 语言服务器只随应用一起更新： Google Play 之外没有更新渠道。Google Play
- Copilot 和 ChatGPT 登录只发送文本： 不会附加图片。Claude、Gemini、使用 API 密钥的 OpenAI 和自定义端点，可以向标有 视觉 的模型发送图片。有意为之
- MCP 服务器只能在手机上运行 node 脚本， 没有远程（HTTP 或 SSE）传输；而且服务器的目录有上限（128 个工具、64 KB）。Google Play
- 明文 http 只能访问少数几个地址：
localhost、127.0.0.1和10.0.2.2。对于你网络中的服务器，请使用 HTTPS 或 USB 隧道。有意为之 - 提供商配额只有在提供商有报告时才存在， 而 Codex 和 Copilot 的数据来源没有被其所有者公开文档，所以可能不经通知就停止工作。第三方
- 隐藏模型并不会屏蔽它： 请用工具权限来限制它能做什么。有意为之
- 零外发是全有或全无： 它也会阻止你自己手机上的自定义端点。有意为之
- 已保存的密钥（Secrets）或 API 密钥无法再次查看； 密钥（Secrets）只会发往 HTTPS 主机（仅 localhost 可用 HTTP），每个密钥最多 16 个主机。有意为之
故障排查
「OpenAI 拒绝了这个密钥。请检查后重试。」
提供商对验证请求回答了“不行”，密钥没有保存。请从提供商的页面重新复制密钥（空格和引号会被清理，但已吊销或被截断的密钥不行），确认它属于该提供商（OpenAI 是 sk-，Claude 是 sk-ant-，Gemini 是 AIza），必要时重新创建一个。
「无法验证 OpenAI 的密钥；仍会照常使用。」
应用无法连上提供商（没有网络、超时，或 零外发 已开启），所以密钥被保存为 尚未验证。联网之后，打开该提供商的行并点按 立即验证。
「这是管理密钥；聊天需要普通的 API 密钥。」
以 sk-ant-admin 开头的密钥用于 Anthropic 的管理 API。请在 console.anthropic.com/settings/keys 创建一个普通的 API 密钥。
「这看起来是 Anthropic 的密钥（sk-ant-）。OpenAI 的密钥以 sk- 开头。」
你把密钥粘到了错误提供商的行里。请打开正确的那一行，或更换密钥。
「代码在授权前已过期」
你在浏览器中批准得太慢了。点按 重试（或再次点按 使用 GitHub 登录），并尽快批准。
「未找到浏览器。请安装一个后再次点按按钮。」
ChatGPT 登录和 Copilot 需要浏览器来批准登录。请安装一个再试。
「你的 ChatGPT 账户不包含 Codex。需要付费套餐（Plus、Pro、Team 或 Enterprise）才能使用 Codex。」
ChatGPT 登录只适用于包含 Codex 的付费套餐。请改用 OpenAI API 密钥，或升级套餐。
「Codex 无法在你的 ChatGPT 账户下运行 …。请选择其他模型，或改用 OpenAI API 密钥或其他提供商。」
Codex 只接受每个账户中的部分模型。请在选择器中选择其他模型（不可用的会标注 当前套餐不可用）。
「你的 ChatGPT 账户已达到 Codex 用量上限。请稍后再试。」
这个上限属于你的 ChatGPT 套餐。请等待，或切换提供商。
「无法连接到 OpenAI。如果你在移动数据上使用私人 DNS（DoT），请将其关闭或改用 Wi-Fi 后重试。」
ChatGPT 登录这条路径在使用私人 DNS 的移动数据下可能失败。请关闭私人 DNS，或改用 Wi-Fi。
「Codex 会话已过期。请重新使用 ChatGPT 登录。」
打开 设置 → AI → API 密钥 → OpenAI，重新登录。
「无法连接到 …。服务器在运行吗？」
测试连接 没能连上你的自定义端点。请启动服务器，检查地址；如果服务器在电脑上，还要确认 adb reverse 或 Tailscale Serve 正在运行。
「… 有响应，但此地址下没有模型列表。请检查地址是否以 /v1 结尾。」
服务器有响应，但不在 OpenAI 的模型路径上。请让 基础 URL 以 /v1 结尾。
「已连接 · N ms · 没有已加载的模型。请在服务器上加载一个后再测试。」
端点可以访问，但没有加载任何模型。请在 LM Studio 或 Ollama 中加载一个模型，然后再次测试。
「Android 会阻止发往 … 的未加密 HTTP」
明文 http:// 只能访问 localhost、127.0.0.1 和 10.0.2.2。请使用 HTTPS（Tailscale Serve），或通过 USB 使用 adb reverse 和 http://127.0.0.1。
「这不是有效的地址。应以 http:// 或 https:// 开头。」
请修正 基础 URL。
模型选择器中出现 无法加载模型 或 密钥被拒绝
点按 重试 或 刷新模型。如果是密钥被拒绝，请在 API 密钥 中替换它。
聊天中出现 任何数据都不会离开本机
零外发（无网络 AI） 已开启。点按 查看该设置 并将其关闭。
「PocketCode 没有发送任何内容：你还没有允许把你的消息和代码发送给 …」
你还没有接受该提供商的共享提示。请打开 AI 聊天并接受，或换一个提供商。
「这条命令不能在这里运行。仅支持 node。」
MCP 服务器必须用 node 和手机上的脚本来启动（例如 node /sdcard/mcp/server.js）。
某个 MCP 服务器显示 失败
该行下方的红色文字就是最近一次错误。请检查脚本路径在手机上是否存在、命令是否为 node，然后把服务器关闭再重新打开。
「此名称为保留名称：作为密钥它会改变每条终端命令的运行方式。」
请给这个密钥换一个名称（不要用 PATH、HOME、NODE_OPTIONS，也不要以 LD_ 或 ANDROID_ 开头）。
智能体说某个工具「is denied by the user's tool permissions」
你为当前的提供商或模型关闭了该工具。打开 AI 工具权限，选择提供商（以及模型范围），再把它打开。