跳转至
Cody 3.0 · Open-source Agent Runtime

让 Agent 从能运行,走向可恢复、可治理

Cody 把一次 Agent 任务建模为持久化 Run,把 Workflow、模型、工具、审批、 Quality Gate、Sandbox 与多 Agent 协作收束到同一条执行主链。你可以直接使用 CLI / TUI / Web,也可以通过 Python SDK 嵌入自己的产品。

30内置工具
4统一产品表面
15任务式教程
3.10–3.13支持的 Python

首页

先选一条路线

教程和指南承担不同任务:教程带你完成真实闭环,指南用于准确查阅能力、配置和边界。

一条权威执行主链

Run身份、预算、权限与持久化生命周期
Workflow顺序、并行、条件、Join、Fallback 与嵌套
ExecutionAgent、工具、审批、Quality Gate 与 Sandbox
RunEventTimeline、Checkpoint、Artifact、Audit 与恢复

CLI、TUI、Web 与 SDK 不各自维护运行状态;它们都是 Canonical Runtime 的不同入口和视图。

生产能力,不只是接口占位

60 秒开始

pip install cody-ai
export CODY_MODEL='your-model-id'
export CODY_MODEL_BASE_URL='https://your-provider.example/v1'
export CODY_MODEL_API_KEY='your-api-key'
import asyncio
from cody import AsyncCodyClient

async def main() -> None:
    async with AsyncCodyClient(workdir="/path/to/project") as client:
        result = await client.run("修复失败的测试,并说明验证结果")
        print(result.output)

asyncio.run(main())
pip install 'cody-ai[cli,tui]'
cody config setup
cody run "修复失败的测试,并说明验证结果"
# 或进入全屏终端
cody tui
pip install 'cody-ai[web]'
cody-web run --port 8000
# 打开 http://localhost:8000

模型接入

Cody 使用 OpenAI-compatible Chat Completions 接口。模型 ID 和 Base URL 必须以你所用端点的当前文档为准;API Key 只通过环境变量或 secret manager 注入。

当前边界

我们会明确区分“已实现”与“需要部署方提供”的能力:

  • Remote Sandbox 是 transport/handle 适配层,不是 Cody 托管的远程沙箱服务。
  • PostgreSQL、S3/MinIO、Docker/Podman 和 Bubblewrap 需要对应外部服务或系统依赖。
  • local-policy 提供路径、命令和环境策略,但不是 OS 级隔离。
  • 自定义 Python 扩展运行在可信宿主中,不受 guest Sandbox 隔离。
  • 企业 OAuth/SSO 不是内置产品能力;Web 内置鉴权是 API Key,可通过 Auth extension 接入外部身份系统。

查看完整功能与边界 开始系统教程