Cody 是开源 AI Agent 框架,提供 30 个内置工具、Agent Skills 开放标准、多模型支持和完整安全体系。用 SDK 嵌入任何 Python 应用,或通过 CLI / Web 开箱即用。
从工具调用到安全审计,从多模型切换到跨任务记忆,Cody 提供 AI Agent 所需的完整基础设施。
文件 I/O、正则搜索(grep/glob)、Shell 执行、LSP 代码智能、Web 抓取、任务管理——覆盖日常编码任务的完整工具链,开箱即用。
兼容 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 浏览器界面,共享同一个核心引擎。
选择你的接入方式,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 均可接入。
# 通义千问 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
工具注册是声明式的,添加自定义工具只需追加到列表,或通过 SDK Builder 动态注册。