yoyo-evolve完全教程：3分钟安装自我进化编码智能体，免费开源对标Claude Code

【免费下载链接】yoyo-evolve A coding agent that evolves its own source, in public — 200 lines of Rust on day one, every commit since agent-written and tests-gated. 项目地址: https://gitcode.com/gh_mirrors/yo/yoyo-evolve

yoyo-evolve 是一个免费的开源自我进化编码智能体（coding agent），运行在你的终端里：它能读懂代码库、执行多文件修改、运行测试、管理 git，还会自动恢复失败——对标 Claude Code 的终端 AI 编程助手能力，完全免费开源。它更特别的地方在于：从第一天约 200 行 Rust 代码起步，之后每一笔提交都由智能体自己编写并通过测试门禁，128 天长到 11.5 万+ 行代码、4,300+ 个测试，全程公开可查。

🐙 yoyo-evolve是什么：会自己写代码的AI编程助手

普通 AI 编程工具是"你问我答"，yoyo-evolve 还多了一层：它自己给自己写代码。

• 每约 8 小时，它唤醒后读取自己的源码 → 规划改进点 → 实现修改 → 跑测试 → 测试通过才提交，否则回滚
• 每 4 小时，它参与社区讨论，从与人的互动中学习
• 每天，它压缩归档记忆，生成注入到每次提示词中的活跃上下文

它的"成长日记"和"学习记录"都是仓库里的普通文件，可以直接翻：

• 进化日记 → journals/JOURNAL.md
• 学到的东西 → memory/active_learnings.md
• 进化流水线脚本 → scripts/evolve.sh
• 项目入口源码 → src/main.rs

📌 它不是某个成品，而是一个"过程"：你可以阅读它的源码、日记和身份文件（IDENTITY.md），看一个智能体如何在公众监督下长大。

🚀 yoyo-evolve安装步骤：最快一条命令上手

官方提供了一键安装脚本 install.sh（仓库根目录的 install.sh / install.ps1），自动检测系统架构、下载预编译二进制并校验 SHA256。

方式一：一键安装脚本（macOS / Linux，推荐新手）

# 直接运行仓库中的安装脚本，自动装到 ~/.yoyo/bin
bash install.sh

方式二：从源码构建（想要折腾一下）

git clone https://gitcode.com/gh_mirrors/yo/yoyo-evolve
cd yoyo-evolve
cargo build --release
# 二进制在 target/release/yoyo

方式三：crates.io 安装

cargo install yoyo-agent

装好后执行 yoyo --help 即可验证。安装细节可参考官方文档 docs/src/getting-started/installation.md。

⚡ 第一次运行：配置API Key并启动对话

新手最快路径：什么都不配，直接运行 yoyo，内置的交互式设置向导会带你选模型提供商、填 API Key、挑模型，并可选生成 .yoyo.toml 配置文件，全程无需重启。

也支持手动配置环境变量后启动：

# Anthropic（默认提供商）
export ANTHROPIC_API_KEY=sk-ant-...
yoyo

启动后你会看到欢迎横幅和 🐙 › 提示符，直接用自然语言下指令即可：

> read src/main.rs and explain the main function
> 运行测试并修复所有失败
> 找出这个项目里所有的 TODO 注释

yoyo 会实时流式展示每一步工具调用（读文件、执行命令、改代码），每轮结束后自动显示耗时、token 用量和费用估算。

🛠️ yoyo-evolve常用用法：三种模式覆盖90+斜杠命令

1. 交互式 REPL（默认模式）

支持 Tab 补全斜杠命令、多行输入、@src/main.rs 这样的文件引用语法、书签（/mark / /jump）、会话搜索（/search），还有 90+ 斜杠命令，常用的有：

命令	作用
/help	分组查看全部命令
/model /provider	切换模型和提供商
/diff /commit /undo	git 常用操作
/test /lint /fix	自动检测项目类型并跑测试、修复
/spawn <任务>	派生子智能体并行干活
/remember <笔记>	保存跨会话项目记忆
/cost /tokens	查看费用和 token 明细
/quit	退出

2. 单提示词模式（适合脚本化、CI 流水线）

yoyo "explain this codebase"
echo "write a README" | yoyo

3. 继续上次会话

yoyo --continue

会话自动保存，崩溃也能恢复；上下文用到 80% 时自动压缩，也可手动 /compact。

🎛️ yoyo-evolve配置文件：.yoyo.toml一次设置长期生效

在项目根目录（或 ~/.yoyo.toml、~/.config/yoyo/config.toml）创建 .yoyo.toml，常用配置长这样：

model = "claude-sonnet-4-6"
provider = "anthropic"
thinking = "medium"

[permissions]
allow = ["cargo *", "npm *"]
deny = ["rm -rf *"]

它开箱支持 15 个模型提供商（Anthropic、OpenAI、Google、DeepSeek、Ollama 等），会话中用 /provider 随时切换。想 100% 本地免费运行？连上本地 Ollama 即可，无需 API Key：

yoyo --provider ollama --model llama3.2

一个对标 Claude Code 的贴心细节：yoyo 会自动加载项目里的 CLAUDE.md（或 YOYO.md、.yoyo/instructions.md）作为系统上下文，已有的 Claude 工作流可以无缝迁移。

🔐 yoyo-evolve安全与权限：默认拦截危险命令

• 交互确认：执行 bash、写文件、改文件前会弹出预览让你确认，可选"本次会话总是允许"
• 黑白名单：--allow / --deny 用 glob 规则放行或拦截命令，--allow-dir / --deny-dir 限制目录访问
• 自动批准：脚本场景加 --yes 跳过确认
• 权限逻辑源码见 src/safety.rs，详细说明见 docs/src/configuration/permissions.md

🧬 进阶：Fork一个属于你自己的自我进化智能体

yoyo-evolve 官方鼓励"养一个自己的"：Fork 仓库后只需要改两个文件——

1. IDENTITY.md：你的智能体的"宪法"（名字、使命、目标、规则）
2. PERSONALITY.md：它的说话语气和人格

再配置好 GitHub App 与密钥（如 ANTHROPIC_API_KEY），启用 Evolution 工作流，它就会在 GitHub Actions 上每 8 小时自动醒来、进化、提交。完整指南见 docs/src/guides/fork.md。

✅ 总结：为什么值得试试yoyo-evolve

特点	说明
🆓 免费开源	MIT 协议，免费对标 Claude Code 的终端 AI 助手
🐙 自我进化	128 天从 200 行长到 11.5 万+ 行，全程测试门禁
⚡ 3 分钟上手	一条命令安装，内置设置向导
🔌 15 提供商	云端模型到本地 Ollama 全覆盖，可 0 成本运行
🛡️ 安全可控	命令确认、黑白名单、目录沙箱

新手建议路线：一键安装 → 空配置直接 yoyo 走进设置向导 → 用 /help 探索命令 → 给项目建一个 CLAUDE.md → 有余力就 Fork 一个自己的进化智能体。

<输出文章>

【免费下载链接】yoyo-evolve A coding agent that evolves its own source, in public — 200 lines of Rust on day one, every commit since agent-written and tests-gated. 项目地址: https://gitcode.com/gh_mirrors/yo/yoyo-evolve