权限与安全
工具按只读、写入、执行、危险四级分级，Shell 命令自动分类，默认 fail-closed，路径逃逸防护。
$ pip install "codeagent[all]"
Python 3.10+，支持 macOS 与 Windows。不想装环境？直接下载桌面版安装包。
三路模型接入，一行切换
云端 API、本地部署、聚合网关任意组合。逗号串联多个后端，本地优先、云端兜底，故障自动跳过。
云端 API
Anthropic Claude、OpenAI 官方直连，--base-url 可指向任何 OpenAI 兼容端点。
本地部署
Ollama、LM Studio、vLLM、llama.cpp。免 key，模型跑在本机，离线也能用。
聚合网关
OpenRouter、硅基流动、AiHubMix、One-API 自建中转。一把 key 调遍上游所有模型。
聚合模式 · fallback 与轮询
# 本地优先，本地挂了自动切云端（fallback 故障转移） codeagent chat --provider ollama,openrouter # 多把 key、多个中转轮询分流 codeagent run "重构这个模块" \ --provider openrouter,siliconflow,oneapi \ --strategy round-robin # 每个后端的累计失败次数，可观测 print(provider.failures)
一个框架，装下整套开发装备
从 Agent 循环到权限安全，从记忆到技能自进化，全部为真实项目打磨。
完整的 Agent 循环
消息历史管理、工具调用调度、结果回传、迭代上限保护与 token 用量统计。内置文件读写、正则搜索、Shell 执行等编码工具集。
理解任务→
调用工具→
读取反馈→
收敛作答
↩ 未达目标则继续迭代，触顶软收束
MCP 生态
stdio 与 streamable-HTTP 双传输，Claude 风格配置，瞬间接入数据库、浏览器与第三方服务。
预算控制
token 预算上限，子 Agent 用量归入根预算，预算状态实时注入上下文，模型自适应调整探索深度。
自我调试
生成、执行反馈、橡皮鸭解释、最小修复的闭环，源自 Google Research 的 ICLR 2024 论文。
记忆系统与技能自进化
对话压缩撑住长会话，跨会话长期记忆带 mem0 式事实对账。兼容社区 SKILL.md 技能包，任务完成后自动反思蒸馏新技能，经验跨会话复利增长。
语音与情感
8 种情绪映射神经音色，edge-tts 免费朗读，Whisper 离线识别，全链路不依赖云服务。
网页与 OCR
Scrapling 自适应抓取，stealth 模式可绕反爬；tesseract 与 EasyOCR 双引擎图像文字识别。
多 Agent 编排
一套制度，一张蓝图
固定流水线保证质量关卡，自由 DAG 应对复杂流程。两种引擎，按任务选型。
三省六部：制度性审核的固定流水线
任何方案必须通过门下省质量关卡才能进入执行层。封驳打回、状态机保护、审计留痕，一部失败不拖累全局。
中书省规划拆解
门下省审议把关
尚书省派发调度
六部并行执行
回奏汇总报告
封驳打回，最多 3 轮
角色人格可替换
状态机保护
JSONL 审计留痕
故障隔离
蓝图：自由 DAG 工作流
十种节点自由连线：条件路由、人工审批门、join 仲裁、loop 循环、command 原语。YAML 严格加载，运行结束输出评分卡。
拓扑分层并行调度
每节点独立模型
拒绝自动跳过下游
运行评分卡可复盘
领导模式：一个席位，指挥多模型团队
语音或文字下达命令，领导席位自动拆解分派给不同模型的工人，进度随时可查可播报。
workers.yaml · 工人花名册
# 每个工人一个模型，聪明大脑规划、便宜模型干活 workers: - name: claude provider: anthropic description: 擅长代码架构与审查 - name: qwen provider: ollama model: qwen2.5-coder:7b description: 本地快速执行批量任务
语音指挥 + 语音汇报
codeagent lead --workers workers.yaml --mic --voice
自动拆解，依赖分批
LLM 把命令拆成分派计划，无依赖的任务并行，有依赖的按批串行并传递上游成果。
外部增援
工人卡住可呼叫本机其他 agent 平台：Claude Code、Codex、Gemini CLI、cursor-agent、opencode 自动发现。
本地存档，可复盘
每次指挥运行持久化到 ~/.codeagent/runs/，命令、计划、进度快照全部留在本机。
个性化设置全局生效
称呼、语言、机器上下文一次设置，chat、run、lead 与每个工人全部生效。
隐私与安全：数据不出本机
本机优先是默认设计，不是可选项。无遥测、无广告，密钥只存在你的设备上。
本机存储
对话、项目与配置写入 ~/.codeagent/，密钥单独存放且权限受限，不会自动上传。
零遥测零广告
不含遥测与广告 SDK，也不向 LunarCoreAgent 回传任何使用统计。
只去你指定的端点
对话与代码片段仅发送给你自己配置的模型服务，受对应服务商条款约束。
高风险操作先确认
写文件、执行命令默认需你批准，工具按风险四级分级，默认 fail-closed。
开始使用
下载桌面版，或一行装好 CLI
桌面版自带图形窗口，无需 Python 环境。当前版本 0.76.0，三平台安装包由 GitHub Actions 自动构建。
桌面版内含：聊天窗口（可随时停止生成）、项目归档、图形设置面板（模型连接、聚合策略、个性化）、版本与更新日志页。命令行用户执行 pip install "codeagent[all]" 即可，Ollama 本地模型免 key。