1. 项目定位与用途
Codeany 是一个开源的 AI 驱动终端代理，专为软件工程场景设计。它运行在命令行环境中，提供交互式 TUI 界面，使开发者能够通过自然语言或 slash 命令与 AI 协作，完成代码理解、调试、测试、提交等任务。项目基于 Go 语言开发，核心依赖包括 Bubble Tea（终端 UI 框架）、Open Agent SDK（AI 代理能力）、Cobra（CLI 解析）等，旨在将 AI 助手深度嵌入开发工作流，提升效率。
项目档案命令行工具
Codeany 开源 AI 终端代理：Go 编写的软件工程助手，支持 78 命令与插件系统
Codeany 是基于 Go 和 Bubble Tea 构建的开源 AI 终端代理，专为软件工程师设计。支持 78 个内置 slash 命令、自定义技能与插件、MCP 协议、多模型提供商切换，涵盖代码审查、调试、测试、Git 操作等场景。提供交互式、管道式、打印式等多种使用模式，可通过脚本或 go install 快速安装，提升开发效率。
AI 总结
Codeany 是一个用 Go 编写的开源 AI 驱动终端代理，专为软件工程任务设计，通过交互式 TUI 界面和 78 个 slash 命令，将 AI 能力深度集成到命令行工作流中，提升开发效率。
中文项目介绍
Codeany 是基于 Go 语言开发的开源 AI 终端代理，面向软件工程师提供智能命令行辅助。它采用 Bubble Tea TUI 框架构建交互式界面，并依托 Open Agent SDK 实现 AI 能力与工具调用。项目内置 78 个 slash 命令，覆盖代码审查、调试、测试、Git 操作等常见工程场景，同时支持技能与插件系统、MCP 协议、多模型提供商切换及自更新功能。通过将 AI 助手深度嵌入终端环境，Codeany 有效减少了开发者在编辑器、终端与 AI 聊天界面之间的切换成本，实现上下文感知的自动化任务处理。其配置系统支持 JSON/YAML 格式持久化，并提供交互式、管道式、打印式等多种使用模式，适应不同工作流需求。
详细信息与使用说明
2. 核心功能特性
Codeany 提供 78 个内置 slash 命令，涵盖帮助、模型切换、成本统计、会话管理、代码审查、Bug 调查、测试执行、Git 操作等功能。支持技能系统（在 .codeany/skills/ 定义自定义能力）和插件系统（在 ~/.codeany/plugins/ 扩展），并集成 MCP（Model Context Protocol）服务器以增强上下文获取。此外，支持多模型提供商（如 Anthropic、OpenRouter）、中文与输入法优化、自更新机制，以及 JSON 输出、管道模式、非交互式打印等灵活使用方式。
3. 解决的问题
Codeany 解决了开发者在日常工作中频繁切换工具（编辑器、终端、AI 聊天界面）导致的上下文丢失和效率低下问题。通过将 AI 能力直接嵌入终端，它提供上下文感知的软件工程辅助，能够自动分析代码库、生成提交信息、运行测试、审查差异、调查 Bug，从而减少手动操作，加速开发周期。同时，其权限系统和配置持久化确保了安全性与可重复性。
4. 适用场景
Codeany 适用于多种软件工程场景：代码库解释与导航（快速理解陌生项目）、代码审查与质量检查（自动化审查建议）、Bug 调查与根因分析（结合日志与代码追踪）、自动化测试执行与结果分析（运行并解读测试）、Git 操作辅助（提交信息生成、差异摘要）、项目初始化（生成 CODEANY.md 配置）。此外，通过自定义技能和插件，可扩展至部署、监控、文档生成等特定团队需求。
5. 安装方式
Codeany 提供两种官方安装方式：一是通过安装脚本一键安装，在终端执行 curl -fsSL https://raw.githubusercontent.com/codeany-ai/codeany/main/install.sh | sh；二是从源码安装，需预先安装 Go 环境，运行 go install github.com/codeany-ai/codeany/cmd/codeany@latest。安装后，可通过 codeany 命令启动。仓库中未明确给出其他包管理器（如 apt、brew）的安装步骤，也未提供 Windows 特定安装指南。
6. 使用方式
Codeany 支持多种使用模式：交互式模式直接运行 codeany 进入 TUI 界面；带初始提示运行如 codeany "explain this codebase"；管道模式通过 echo "query" | codeany -p 处理输入；打印模式使用 codeany --print -y "command" 非交互式输出结果；JSON 输出添加 --output-format json 参数；跳过权限提示使用 -y 标志；指定模型使用 -m 参数如 -m opus-4-6。此外，可通过环境变量配置 API 密钥和模型参数，详见 README 设置部分。
思维导图
当前仓库信息不足，或结构不够稳定，暂时没有生成可靠的思维导图。
常见问题
如何安装 Codeany？
可通过安装脚本：curl -fsSL https://raw.githubusercontent.com/codeany-ai/codeany/main/install.sh | sh；或从源码安装：go install github.com/codeany-ai/codeany/cmd/codeany@latest。需预先安装 Go 环境（用于源码安装）。
如何配置 API 密钥以使用 AI 功能？
根据使用的提供商设置环境变量：Anthropic 用户设置 ANTHROPIC_API_KEY；OpenRouter 或自定义提供商需设置 CODEANY_API_KEY、CODEANY_BASE_URL（如 https://openrouter.ai/api）和 CODEANY_MODEL（如 anthropic/claude-sonnet-4-5）。
Codeany 支持哪些 AI 模型提供商？
支持多提供商，包括 Anthropic（Claude 系列）、OpenRouter 及自定义端点。可通过 /model 命令或配置文件切换模型，也可通过 -m 命令行参数指定特定模型（如 opus-4-6）。
如何使用管道模式处理输入？
通过管道将输入传递给 Codeany，例如 echo "what is 2+2" | codeany -p。可结合 -y 跳过权限提示，或添加 --output-format json 输出 JSON 格式结果。管道模式适用于非交互式自动化场景。
如何扩展 Codeany 的功能？
通过技能系统在项目目录 .codeany/skills/<name>/SKILL.md 定义自定义能力；通过插件系统在 ~/.codeany/plugins/ 目录安装插件（需 plugin.json 配置）；还支持 MCP 服务器集成以扩展上下文来源。具体创建方法参考 README 中的 Skills 和 Configuration 部分。