编码 Agent
编码 Agent 会从开发环境频繁发起模型和工具请求。当平台团队需要统一管理上游模型、服务提供方凭证和 MCP 工具的访问时，可以通过 AISIX 路由这些请求。
这些指南涵盖从本地编辑器、CLI、远程开发环境或自动化任务调用 AISIX 的编码工具。
为什么通过 AISIX 路由编码 Agent
一种常见的落地方式是由平台团队将 AISIX 作为开发者 AI 工具的统一网关。开发者为 Codex、Claude Code、Cline、Cursor 或其他客户端配置 AISIX 代理 URL、调用方 API Key 和自定义模型值，而不是直接配置服务提供方凭证。自定义模型值就是 AISIX 模型别名。
编码 Agent 继续使用原生配置和请求格式。AISIX 会在将模型请求或 MCP 工具调用转发到上游前执行访问控制、策略检查和遥测记录。
当团队需要以下能力时，这种方式很有用：
- 不在本地编辑器和 CLI 配置中保存服务提供方凭证。
- 使用调用方 API Key 验证每位开发者、项目、自动化任务或共享工具配置。
- 使用模型别名控制每个客户端可访问的上游模型。
- 对编码 Agent 流量应用预算、限流、安全护栏和用量上报。
- 在不要求每位开发者重新配置工具的前提下，更换别名背后的上游服务提供方或模型。
敏感代码和凭证
编码 Agent 可能会在任务中发送源代码、配置片段、堆栈信息或终端输出。这些上下文可能包含 API Key、客户数据、个人信息或内部标识符。
AISIX 位于编码 Agent 与上游模型或 MCP 服务器之间，团队可以在网关层检查和控制这些流量。敏感值需要脱敏或拦截时，请使用 PII 检测与脱敏；需要更广泛的请求与响应策略检查时，请使用安全护栏。
选择客户端指南
请从要通过 AISIX 路由的编码工具指南开始：
| 客户端 | 主要 AISIX 路径 | 指南 |
|---|---|---|
| Codex | OpenAI Responses API | Codex |
| Claude Code | Anthropic Messages | Claude Code |
| Cline | 兼容 OpenAI 的 API | Cline |
| Cursor Ask 模式 | 兼容 OpenAI 的 API | Cursor |
每份指南都假设 AISIX 网关已为客户端要使用的路由创建模型别名和调用方 API Key。在客户端 UI 或配置文件中，该别名可能称为自定义模型、模型 ID 或模型名称。如果尚未创建这些资源，请先完成开源 AISIX 网关快速入门或 AISIX Cloud 快速入门。
编码 Agent 如何使用 AISIX
编码 Agent 通常通过以下两种方式之一连接到 AISIX：
| 客户端路径 | AISIX 路由 | 适用场景 |
|---|---|---|
| 模型请求 | 兼容 OpenAI 的 Chat Completions 或 Responses API 路由，或 Anthropic Messages | Agent 需要使用 AISIX 调用方 API Key 和模型别名调用模型。 |
| 工具请求 | /mcp 上的 MCP 网关 | Agent 需要 通过 AISIX 的工具访问控制发现和调用上游 MCP 工具。 |
这两种方式都以 AISIX 作为编码工具与上游服务之间的边界。每个客户端保持原生请求格式，AISIX 则控制面向网关的 API Key、模型或工具授权、流量控制、安全护栏和可观测性。
有关 MCP 专项治理，请参阅 MCP 网关概览。有关可用的代理 API 类型，请参阅支持的端点。