适合谁
- 需要进程内 Agent 循环的 TypeScript 项目
- 希望同时支持 Anthropic 和 OpenAI 兼容模型的开发者
- 需要精细控制工具和权限的应用
- 希望在云、无服务器或 Docker 环境中运行的 Agent
O
Open Agent SDK (TypeScript)
社区
开源 TypeScript Agent SDK，进程内运行完整 Agent 循环，支持 Anthropic 与 OpenAI 兼容 API。
GitHub 源仓库 ↗
30FMRS · D
Open Agent SDK (TypeScript) 是一个功能丰富的开源 SDK，提供进程内 Agent 循环、多模型支持、丰富工具和技能系统。但它是第三方实现，非官方维护，使用时需注意安全配置。
Open Agent SDK (TypeScript) 是一个开源 SDK，让开发者能在自己的应用中直接运行 Agent 循环，无需依赖 CLI 子进程。它支持 Anthropic 消息 API 和 OpenAI 兼容 API（如 OpenAI、DeepSeek、Qwen、Mistral 等），并提供了丰富的内置工具、技能系统、生命周期钩子、子代理、权限控制、会话持久化等功能。该 SDK 可在云端、无服务器、Docker、CI/CD 等环境中部署。
工具能力
Bash
执行 shell 命令
Read
读取文件并显示行号
Write
创建或覆盖文件
Edit
精确字符串替换，编辑文件
Glob
按模式查找文件
Grep
用正则搜索文件内容
WebFetch
获取并解析网页内容
WebSearch
搜索网络
NotebookEdit
编辑 Jupyter notebook 单元格
Agent
生成子代理以并行工作
Skill
调用已注册的技能
TaskCreate
创建任务
TaskList
列出任务
TaskUpdate
更新任务
TaskGet
获取任务详情
TaskStop
停止任务
TaskOutput
获取任务输出
TeamCreate
创建多代理团队
TeamDelete
删除多代理团队
SendMessage
代理间发送消息
EnterWorktree
进入 Git worktree 隔离环境
ExitWorktree
退出 Git worktree 隔离环境
EnterPlanMode
进入结构化规划模式
ExitPlanMode
退出结构化规划模式
AskUserQuestion
向用户提问获取输入
ToolSearch
发现懒加载工具
ListMcpResources
列出 MCP 资源
ReadMcpResource
读取 MCP 资源
CronCreate
创建定时任务
CronDelete
删除定时任务
CronList
列出定时任务
RemoteTrigger
远程代理触发
LSP
语言服务器协议（代码智能）
Config
动态配置
TodoWrite
会话待办列表
安装接入
- 安装 npm 包：
npm install @codeany/open-agent-sdk - 设置 API 密钥环境变量：
export CODEANY_API_KEY=your-api-key - 根据需要配置其他环境变量（如
CODEANY_API_TYPE、CODEANY_BASE_URL、CODEANY_MODEL）。 - 在你的代码中导入 SDK 并使用
query或createAgent开始交互。
选型与风险
不适合谁
- 需要官方 Claude Agent SDK 维护支持的场景
- 需要 CLI 功能的用户（SDK 旨在移除该依赖）
- 希望零代码使用 MCP 服务器的用户
所需权限
- API 密钥访问（如 CODEANY_API_KEY）
- 文件系统读写（取决于配置的工具）
- 网络访问（用于 API 调用和 WebFetch/WebSearch）
- 环境变量配置
风险与副作用
- 工具可能执行破坏性操作（如 Bash、Write 等），需谨慎配置权限
- API 密钥泄露风险
- 模型可能产生不准确或有害输出
- 依赖第三方 API 的可用性和成本
常见排障
- 检查 API 密钥是否正确设置
- 确认 API 类型和基础 URL 配置正确
- 确保 Node.js 版本 >= 18
- 检查模型名称是否支持自动检测
- 查看网络连接和代理设置
- 检查会话持久化的磁盘空间
使用场景
构建自主 Agent 应用
执行多步工具调用任务
集成 MCP 服务器
开发自定义技能和工具
实现聊天界面或自动化工作流
支持客户端
Claude Desktop完整支持