最近给 Nexus 的 Agent Runtime 做了 Python 封装，叫 nexus-agent-sdk-python。
Python 侧负责接入，实际调用模型、执行工具和管理上下文的是 Go 写的 nxs 。可以用它给自己的程序接一个能读文件、改代码、跑命令的 Agent ，也可以接自定义工具。
支持单次任务和多轮会话，提供 MCP 、Hooks 和工具权限配置。模型可以通过 Anthropic 兼容接口接入，也支持 OpenAI Chat Completions / Responses 。平台 wheel 带了 nxs 和 rg ，覆盖 macOS 、Linux 、Windows 的 x86_64 和 ARM64 。
项目在这里。
Python 3.11+，先安装并配置模型 Key 。
pip install nexus-agent-sdk-python
export ANTHROPIC_API_KEY="你的 API Key"
下面这个例子读取当前目录的 README ，不开放写文件或执行命令的权限。
import asyncio
from nexus_agent_sdk import NexusAgentOptions, query
async def main():
options = NexusAgentOptions(
cwd=".",
tools=["Read", "Glob", "Grep"],
allowed_tools=["Read", "Glob", "Grep"],
)
async for message in query(
prompt="找到并阅读当前项目的 README ，用中文介绍这个项目。",
options=options,
):
print(message)
asyncio.run(main())
我们还做了一轮本地对照，看看两套 SDK 在相同模型服务下的开销。
设备是 M1 Pro 、16 GiB 内存、macOS 。两边都走智谱 Coding Plan 的 glm-5.3-flash，使用同一 Key 和 Anthropic 兼容接口，thinking 开启、high effort 、最大输出 16,384 Token 。这里的 Claude 指 Claude Agent SDK ，底层模型同样是 GLM 。
Nexus 用 Python SDK 0.1.0 ； Claude 用 Python SDK 0.2.152 、内置 Claude Code 2.1.259 。
六道 Python 标准库工程题，包括退款对账、依赖图、SSE 解析、容量冲突、迷宫和异步请求合并。每题每侧三次，共 36 次。单次最多 10 分钟、24 个 SDK 回合，开放相同的六种工具并全部允许权限。双方使用相同系统提示、任务文字和初始文件。串行运行，交替先后顺序，每次新建会话。
几个结果列在下面，前一个数是 Nexus ，后一个是 Claude 。
- 代码通过检查均为 18/18。
- 代码通过且会话正常结束为 17/18 、11/18。
- 峰值内存中位数为 125.9 、315.2 MiB，Nexus 低约 60.1%。统计包含 Python 宿主、Runtime 和工具进程。
- 模型请求总数为 249 、301。
正常结束少于代码通过数，是因为有些运行已经写出了正确代码，却继续执行，最后耗尽轮次或超时。Nexus 有 1 次耗尽轮次，Claude 有 6 次耗尽轮次、1 次超时。下面保留了全部运行结果。
这 11 组的完整用量，按 2026 年 9 月 12 日核对的 GLM-5.3-Flash API 单价折算，Nexus 为 0.9224 元，Claude 为 1.1075 元，低约 16.7%。
欢迎拿自己的任务试试。有不顺手的 API ，或者能复现的问题，可以在仓库提 issue 。
Select Language