v2.0.2 · MIT 开源

构建你自己的
AI Agent

Cody 是开源 AI Agent 框架,提供 30 个内置工具、Agent Skills 开放标准、多模型支持和完整安全体系。用 SDK 嵌入任何 Python 应用,或通过 CLI / Web 开箱即用。

30+
内置工具
673+
测试用例
26+
Skills 兼容平台
7
支持的模型提供商

一个框架,覆盖 AI Agent 全栈需求

从工具调用到安全审计,从多模型切换到跨任务记忆,Cody 提供 AI Agent 所需的完整基础设施。

🔧

30 个内置工具

文件 I/O、正则搜索(grep/glob)、Shell 执行、LSP 代码智能、Web 抓取、任务管理——覆盖日常编码任务的完整工具链,开箱即用。

🧩

Agent Skills 开放标准

兼容 agentskills.io 开放标准,Skills 可跨 Claude Code、Cursor、GitHub Copilot 等 26+ 平台复用。YAML frontmatter + Markdown,按需加载。

🤖

多模型支持

原生支持 Claude、OpenAI GPT、Google Gemini、DeepSeek、智谱 GLM、阿里通义千问,以及任何 OpenAI 兼容 API,一行代码切换模型。

🛡️

完整安全体系

工具级权限控制(allow/deny/confirm)、路径遍历保护、危险命令检测、SQLite 审计日志、速率限制、文件修改 undo/redo 全面守护。

熔断器 + 跨任务记忆

Token/成本上限 + 死循环检测自动终止失控 Agent。ProjectMemory 跨任务积累项目经验(conventions/patterns/decisions),自动注入后续会话。

🏗️

四种接入方式

SDK 嵌入(pip install cody-ai,仅 4 个核心依赖)、CLI 命令行、TUI 全屏终端、Web 浏览器界面,共享同一个核心引擎。

从安装到运行,不到 5 行代码

选择你的接入方式,Cody 的核心引擎始终一致。

# 安装(仅 4 个核心依赖)
$ pip install cody-ai

# 配置 API Key
$ export CODY_MODEL=qwen3.5-plus
$ export CODY_MODEL_API_KEY=sk-xxx
$ export CODY_MODEL_BASE_URL=https://coding.dashscope.aliyuncs.com/v1
from cody import AsyncCodyClient
import asyncio

async def main():
    async with AsyncCodyClient(workdir="/path/to/project") as client:
        # 执行单次任务
        result = await client.run("为 utils.py 添加类型注解")
        print(result.output)

        # 多轮对话(自动 session 管理)
        r1 = await client.run("创建 Flask 应用")
        await client.run("添加 /health 端点", session_id=r1.session_id)

        # 流式输出
        async for chunk in client.run_stream("解释这段代码"):
            print(chunk.content, end="")

asyncio.run(main())
# 安装 CLI
$ pip install cody-ai[cli]

# 首次配置(交互式向导)
$ cody config setup

# 执行编码任务
$ cody run "创建一个 FastAPI hello world 应用"

# 多模态:附带截图
$ cody run --image screenshot.png "修复这个 bug"

# 交互式对话
$ cody chat

# 全屏终端 UI
$ cody tui
# 安装 Web
$ pip install cody-ai[web]

# 开发模式启动(含 Vite HMR)
$ cody-web --dev

# 生产模式
$ cody-web --port 8000

# 浏览器访问
$ open http://localhost:8000
# 一次安装全部(SDK + CLI + TUI + Web)
$ pip install cody-ai[all]

# 或从源码安装(开发模式)
$ git clone https://github.com/CodyCodeAgent/cody.git
$ cd cody
$ pip install -e ".[dev]"

一行代码切换任何模型

不绑定单一厂商,支持 Claude、OpenAI、Google、DeepSeek 等,任何 OpenAI 兼容 API 均可接入。

Claude (Anthropic)
OpenAI GPT
Google Gemini
DeepSeek
智谱 GLM
阿里通义千问
阿里百炼
任意 OpenAI 兼容 API
# 通义千问 qwen3.5-plus(阿里云 Coding 专属端点)
export CODY_MODEL=qwen3.5-plus
export CODY_MODEL_BASE_URL=https://coding.dashscope.aliyuncs.com/v1
export CODY_MODEL_API_KEY=sk-xxx

# 切换到 DeepSeek
export CODY_MODEL=deepseek-chat
export CODY_MODEL_BASE_URL=https://api.deepseek.com/v1
export CODY_MODEL_API_KEY=sk-xxx

# 切换到智谱 GLM
export CODY_MODEL=glm-4
export CODY_MODEL_BASE_URL=https://open.bigmodel.cn/api/paas/v4/
export CODY_MODEL_API_KEY=sk-xxx

30 个内置工具,覆盖全部编码场景

工具注册是声明式的,添加自定义工具只需追加到列表,或通过 SDK Builder 动态注册。

文件 I/O
read_file
write_file
edit_file
list_directory
搜索
grep
glob
search_files
patch
执行 / 代理
exec_command
spawn_agent
get_agent_status
kill_agent
代码智能 (LSP)
lsp_diagnostics
lsp_definition
lsp_references
lsp_hover
Web / MCP
webfetch
websearch
mcp_call
mcp_list_tools
记忆 / 管理
save_memory
todo_write / todo_read
undo_file / redo_file
question

准备好构建你的 AI Agent 了吗?

MIT 开源,代码在你手里。可审计、可定制、可离线私有部署。