1. 什么是 Agent
Agent（智能体）不是某个单独的模型，而是一个以模型为决策核心，围绕目标持续感知环境、采取行动并根据结果调整下一步行为的运行系统。更具体地说，Agent 是模型与执行框架（Harness）组合后形成的行动单元，也是用户实际委派任务的对象。这里只是简单介绍，具体可以看 这里。
可以将其抽象为：
Note
Agent = Model + Context + Tools + Harness + Feedback Loop
其中：
- Model（模型）：理解任务、推理并决定下一步行动，例如选择调用哪个工具以及生成哪些参数。下面是常用的 API 平台。
- Context（上下文）：保存当前任务、对话历史、文件内容和工具结果等工作信息。
- Tools（工具）：让 Agent 能够读取文件、执行命令、访问浏览器、调用 API 或操作数据库，从而影响外部环境。
- Harness（执行框架）：负责组装提示词、管理上下文、调度工具、控制权限，并维护 Agent 的运行生命周期。狭义 Harness 只强调这套运行时能力；完整 Agent 产品还会在其外部集成 IDE、工作台、账号和执行环境。
- Feedback Loop（反馈循环）：将每次行动的结果重新送回模型，使 Agent 能够继续判断、修正和验证，直到完成目标或触发停止条件。
模型请求既可以由 Harness 直接发送给模型厂商，也可以经过模型聚合或路由平台。后者属于可选的模型访问层，不负责 Agent 的决策与工具循环：
2. 本地部署步骤
这里的「本地部署 Agent」通常是指：Harness 运行在本地电脑上，模型通过网络调用云端服务。代码读取、命令执行和权限控制发生在本地，但模型推理仍发生在服务商的服务器上。
2.1 获取模型使用权限
模型服务主要有两种付费方式：API 按量计费和订阅制。
| 方式 | 计费逻辑 | 适用场景 | 主要限制 |
|---|---|---|---|
| API 按量计费 | 根据输入/输出 token 或请求量计费 | 第三方 Harness、自动化任务、多模型切换 | 成本随使用量变化，需要管理 API Key 和预算 |
| 订阅制 | 按月或按年支付固定费用 | 官方 Harness、个人日常交互 | 通常存在用量上限，且未必能被第三方 Harness 使用 |
需要特别注意：网页端或客户端订阅通常不等于 API 额度。例如，购买某个聊天产品的订阅，并不意味着同时获得该厂商 API 的免费调用额度。只有当 Harness 明确支持该订阅账号的登录方式时，才能直接使用订阅；否则仍需单独创建 API Key 并充值。
下面汇总了一些常用模型的官方定价入口。价格、模型和额度会频繁调整，具体应以下单时的官方页面为准。
| 模型/平台 | API 按量计费 | 订阅制 | 订阅与 Agent 产品/Harness 的关系 |
|---|---|---|---|
| DeepSeek | API 模型与价格 | 暂无独立的固定月费 API 套餐 | 第三方 Harness 通常使用单独充值的 API Key |
| Kimi | Kimi API 定价 | Kimi 会员套餐 | 会员额度主要用于 Kimi、Kimi Code 等官方产品，不等同于开放平台 API 余额 |
| GLM（智谱） | GLM API 定价 | GLM Coding Plan | Coding Plan 可用于官方支持的 ZCode、Claude Code、OpenCode 等 Agent 产品，但需使用套餐专用端点和 Key |
| Qwen（阿里云百炼） | 模型列表与定价入口 | Coding Plan、Token Plan | 套餐 Key、Base URL 与普通按量 API 不互通，应按所选 Harness 的接入文档配置 |
| MiniMax | API 按量计费 | Token Plan | Token Plan 可直接用于 MiniMax Code；Subscription Key 与按量 API Key 不互通 |
| Doubao Seed（火山方舟） | 模型与 API 定价 | 豆包工作 | 火山方舟 API 余额与豆包/豆包工作的产品订阅相互独立 |
| GPT（OpenAI） | OpenAI API 定价 | ChatGPT 套餐 | ChatGPT 套餐可登录 Codex；不包含 OpenAI API 额度，也不能直接供其他 Harness 按 API 调用 |
| Claude（Anthropic） | Claude API 定价 | Claude 套餐 | Claude Pro/Max 等套餐可登录 Claude Code；第三方 Harness 通常仍需 Anthropic API Key |
| Gemini（Google） | Gemini Developer API 定价 | Google AI 套餐 | Google AI 订阅主要提高 Gemini、Antigravity、Jules 等官方产品额度，不等同于 Gemini Developer API 余额 |
Tip
如果目标是使用官方 Agent 产品，先检查账号订阅是否已包含该产品，例如 ChatGPT 套餐与 Codex、Claude 套餐与 Claude Code。如果目标是接入 OpenCode 等第三方 Agent 产品，则应优先查看 API 或明确支持第三方工具的 Coding Plan，而不是只购买网页会员。
Warning
API Key 属于凭证，不应写入 Markdown、源码或 Git 仓库。通常应存放在环境变量、系统钥匙串或 Harness 支持的凭证存储中。
2.2 选择 Agent 的运行形态
「Harness」描述的是架构角色，不是所有产品都应使用的统一品类名。为了避免把框架、编程工具和通用助手混在一起，可以按以下层级理解：
| 层级 | 核心职责 | 是否运行 Agent 循环 | 是否负责模型推理 |
|---|---|---|---|
| 狭义 Harness | 管理上下文、工具调用、权限和循环，可被扩展或嵌入 | 是 | 否 |
| 编程 Agent 产品 | 面向软件开发，集成 Harness、模型接入、开发工具和交互界面 | 是 | 通常否 |
| 通用 Agent 平台 | 面向办公、个人助理或跨应用任务，增加消息渠道、记忆和自动化 | 是 | 通常否 |
| Model Gateway | 统一模型协议、认证、计费、路由、负载均衡和故障转移 | 否 | 否，只转发请求 |
| Model Provider | 托管模型权重并执行推理 | 否 | 是 |
2.2.1 狭义 Harness
狭义 Harness 关注 Agent 运行时本身，通常强调可扩展、可嵌入和可替换模型，而不是提供完整 IDE 或办公产品。
| Harness | 定位 | 定价/成本 | 官方文档 | 常见认证方式 |
|---|---|---|---|---|
| DeepSeek Harness | 开源、插件化的 Agent Harness，提供 Web UI 和 CLI | 开源免费；模型调用按所接入 Provider 的价格计费 | 开发者快速入门 | API Key、自定义 Model Provider |
| Pi | 极简、可扩展、可嵌入的终端 Coding Harness，支持 CLI、RPC 和 SDK | 开源免费；模型调用按所接入 Provider 的价格计费 | Pi 文档 | 多厂商 API Key、部分 Provider 订阅登录 |
2.2.2 编程 Agent 产品
编程 Agent 产品内部包含 Harness，但又增加了代码库索引、IDE/CLI、Git、终端、测试和账号系统。它们是开发者直接使用的完整产品，不等于狭义 Harness。
| 产品 | 产品形态 | 主要作用范围 | 定价/套餐 | 官方入口 |
|---|---|---|---|---|
| OpenCode | 开源 CLI/桌面端/IDE 编程 Agent | 多模型接入、代码编辑、终端、会话和工具扩展 | 开源免费；可选 OpenCode Zen 按量计费 | OpenCode 文档 |
| Codex | OpenAI 官方 CLI/IDE/桌面端/云端编程 Agent | 代码理解、编辑、命令执行、任务委派和云端执行 | ChatGPT 套餐与 Codex 费率 | Codex 文档 |
| Claude Code | Anthropic 官方 CLI/IDE 编程 Agent | 代码库理解、文件编辑、终端、工具调用和任务循环 | Claude Code 套餐 | Claude Code 文档 |
它自杀了 | ||||
| MiniMax Code | MiniMax 官方桌面端/网页版编程 Agent | 代码库理解、文件编辑、终端和 Agent 任务执行；使用 MiniMax 模型 | Token Plan | MiniMax Code |
| Cursor | AI 原生 IDE/编程 Agent 平台 | 代码库上下文、文件编辑、终端、浏览器、规则和多 Agent 调度 | Cursor 定价 | Cursor 文档 |
| TraeCode | AI IDE/编程 Agent 平台 | 代码库理解、任务规划、文件与终端工具、MCP、权限和沙箱 | TRAE 定价 | TraeCode 文档 |
| CodeBuddy | IDE + CLI 编程 Agent 平台 | 代码编辑、Shell、测试、Git、MCP 和开发任务编排 | CodeBuddy 定价 | CodeBuddy 文档 |
| Qoder | IDE + CLI 编程 Agent 平台 | 代码库检索、文件编辑、终端、任务规划和开发流程自动化 | Qoder 定价 | Qoder 文档 |
2.2.3 通用 Agent 平台
通用 Agent 平台不局限于软件开发，通常面向个人助理、办公自动化、跨应用操作或长期运行任务。
| 产品 | 产品形态 | 主要作用范围 | 定价/套餐 | 官方入口 |
|---|---|---|---|---|
| OpenClaw | 自托管个人/团队 Agent 平台 | 通过 Gateway 连接模型、消息渠道、会话、记忆、工具和多 Agent 路由 | 开源免费；需承担模型 API、主机和运维成本 | OpenClaw 文档 |
| Hermes Agent | 自托管个人 Agent 平台 | 在 CLI、桌面端和消息渠道间提供工具调用、长期记忆、技能学习及任务调度 | 开源免费；需承担模型 API、主机和运维成本 | Hermes Agent 文档 |
| 豆包 | 通用 AI 助手 | 提供对话、搜索、内容创作等能力，并在桌面端内置可执行复杂任务的工作模式 | 豆包订阅权益 | 豆包官网 |
| 豆包工作 | 办公 Agent 平台 | 生成和编辑文档、表格、PPT、网页及多媒体，操作电脑/浏览器并连接飞书企业知识 | 豆包工作订阅权益 | 豆包工作官网 |
| 千问办公 | 一站式办公 Agent 平台 | 融合桌面、云端和企业协作 Agent，支持 Office 产物、浏览器自动化及定时任务 | 千问办公套餐说明 | 千问办公官网 |
| WorkBuddy | 通用办公多 Agent 工作台 | 调度专家 Agent、Skills 和连接器，生成文档、设计与代码等产物 | Buddy AI 定价 | WorkBuddy 官网 |
| TraeWork | 通用工作 Agent 平台 | 在 Work、Code 和 Design 模式中拆解任务、调用 Skills/工具并管理本地或云端执行 | TRAE 定价 | TraeWork 官网 |
| Marvis | 操作系统级多 Agent 助手 | 调度预置 Agent，操作本地文件、应用、系统设置以及跨设备任务 | 以 Marvis 官网 展示的当前套餐为准 | Marvis 官网 |
这些品牌跨越多个技术层，名称相近但不是同一种产品：
| 品牌体系 | 模型层 | 模型服务/API 平台 | 通用助手产品 | 办公 Agent 产品 |
|---|---|---|---|---|
| 字节跳动 | Doubao Seed 系列 | 火山方舟 | 豆包 | 豆包工作 |
| 阿里巴巴 | Qwen 系列 | 阿里云百炼 | 千问 | 千问办公（QwenWork） |
例如，购买豆包工作的订阅，不会自动获得火山方舟的 API 余额；同理，千问办公的订阅也不等于阿里云百炼的 API 额度。前者购买的是完整 Agent 产品的使用权，后者购买的是程序调用模型的推理资源。
2.2.4 如何选择
- 需要搭建自己的 Agent、定制循环或嵌入其他应用：选择狭义 Harness。
- 主要完成编码、调试、测试和 Git 工作流：选择编程 Agent 产品。
- 需要处理文档、消息、日程、浏览器或跨应用任务：选择通用 Agent 平台。
- 需要频繁切换模型：优先选择支持多 Provider 的产品，必要时再增加 Model Gateway。
- 追求厂商模型的最新能力和最佳适配：优先考虑官方编程 Agent 产品，例如 GPT 配合 Codex、Claude 配合 Claude Code。
同一个模型在不同 Harness 或 Agent 产品中的表现可能不同，因为 System Prompt、上下文压缩、工具定义、权限控制和任务循环方式并不相同。因此，“支持某个模型”只表示能够调用，不代表已经针对该模型做了最佳适配。
选择前至少确认以下事项：
// 可以将下面这些发给 AI，让 AI 帮你选
1. 是否支持目标模型及其认证方式。
2. 是否支持当前操作系统和终端环境。
3. 是否具备文件读写、Shell、搜索和浏览器等所需工具。
4. 是否支持权限确认、沙箱和命令白名单。
5. 是否能够配置项目级规则，例如 AGENTS.md、CLAUDE.md 或 Harness 自己的规则文件。
6. 是否支持恢复会话、压缩上下文和限制 token 费用。其中，权限确认与沙箱的行为边界可分别参考 Permission request 和 Sandbox。
2.3 选择模型访问方式
Harness 或 Agent 产品最终需要访问模型。常见方式分为三类：
2.3.1 什么是模型 Gateway
模型 Gateway 位于 Harness 与 模型厂商 之间，常见能力包括：
- 将不同厂商的 API 统一为 OpenAI-compatible 等协议。
- 使用一个入口管理多个模型、API Key 和 Base URL。
- 根据价格、延迟、可用性或策略选择模型与推理 Provider。
- 在上游限流或故障时执行重试、负载均衡和 Fallback。
- 统一记录 Token 用量、费用、限额和审计日志。
模型 Gateway 不负责拆解任务、调用本地工具或维护 Agent 的 Feedback Loop，因此它不是 Harness，也不是 Agent。
2.3.2 常见平台
| 平台 | 类型 | 核心能力 | 定价/成本 | 凭证关系 | 官方入口 |
|---|---|---|---|---|---|
| OpenRouter | 托管模型聚合与路由平台 | 使用统一 API 访问多个模型和推理 Provider，并支持路由、Fallback、统一计费与用量统计 | OpenRouter 定价与费用 | 使用 OpenRouter Key；也支持 BYOK | OpenRouter 文档 |
| ModelHub | 第三方 API 中转服务 | 提供 OpenAI-compatible 接口，以统一 Key 和 Base URL 转发多个模型 | ModelHub 模型定价 | 使用平台签发的 Key 并向平台充值 | ModelHub 文档 |
| LiteLLM | 可自建的开源 LLM Gateway | 统一多厂商协议，提供虚拟 Key、预算、成本追踪、路由、重试和 Fallback | 开源免费；需承担上游模型 API 与自建基础设施成本 | 上游 Key 由自己持有和部署 | LiteLLM 文档 |
Note
「Model Hub」也可以泛指 Hugging Face Hub 一类的模型仓库，用于发现、下载或部署模型；这与这里作为 API 中转服务的 ModelHub 不是同一概念。本文中的 ModelHub 特指
modelhub.lat。
2.3.3 是否应该使用中转站
「中转站」通常指第三方代收费用并转发模型请求的服务，是模型 Gateway 的一种商业形态。它降低了开户、支付和多模型接入成本，但所有 Prompt、代码片段、文件内容和模型输出都会经过该平台。
选择前至少确认：
- 平台运营主体、服务条款和上游模型来源是否透明。
- 是否记录 Prompt/Completion，以及数据保留和训练策略。
- 是否支持 Zero Data Retention（ZDR）或指定上游 Provider。
- 模型名称是否对应真实上游模型，是否可能被降级或替换。
- 价格是否包含倍率、充值手续费、缓存 Token 和失败请求费用。
- 是否提供可用性承诺、用量明细、限流规则和退款机制。
- Harness 的工具调用、Prompt Caching、长上下文和多模态参数是否能完整透传。
Warning
不要因为价格低或充值方便，就默认第三方中转站具备与官方服务相同的数据边界和模型真实性。例如，某些中转站可能标注
gpt-6-astra，但实际提供的是gpt-5.5。
2.4 配置项目上下文
Harness 提供的是通用能力，它并不知道当前项目的特殊约束。项目中无法从代码直接推导出的信息，应写入 Harness 能自动加载的规则文件，例如：
- 项目的构建、测试和格式化命令。
- 必须从哪个目录执行命令。
- 不允许修改的生成文件或第三方代码。
- 代码风格、架构边界和提交规范。
- 完成任务前必须执行的验证步骤。
常见的项目上下文文件如下：
| 文件 | 主要用途 | 常见加载方 | 建议内容 |
|---|---|---|---|
AGENTS.md | 跨 Agent 的通用项目说明 | 支持 AI_Terminology > Skill 或通用约定的 Harness/Agent 产品，例如 Pi | 构建与测试命令、目录约束、代码规范、验证要求和禁止项 |
CLAUDE.md | Claude Code 的项目指令文件 | Claude Code；部分其他 Agent 也会兼容读取 | 与 AGENTS.md 相同的项目约束，以及 Claude Code 特有工作流 |
SOUL.md | 定义 Agent 的长期角色、风格、偏好和价值边界 | OpenClaw、Hermes Agent 等支持人格/长期记忆的通用 Agent 平台 | 角色定位、沟通方式、长期原则、授权边界和不可逾越的限制 |
agent.md 不是跨生态统一标准。若目标是让多个 Agent 都能读取项目规则，应优先使用全大写的 AGENTS.md；只有某个产品的官方文档明确要求 agent.md 时，才按其约定创建。SOUL.md 也不应堆放构建命令等项目事实，它更适合保存稳定的人格和行为边界。
建议在仓库根目录维护一份 AGENTS.md 作为项目规则的单一事实来源；如果同时使用 Claude Code，可让 CLAUDE.md 只包含指向 AGENTS.md 的说明和 Claude Code 专属补充，避免同一规则在两处漂移。对于个人通用 Agent，再在用户级或项目级 SOUL.md 中维护长期偏好。
规则文件应简短、明确并且可执行。大段背景资料更适合放在独立文档中，再从规则文件提供 Context pointer，避免每次 会话 都占用大量 上下文窗口。