Nasiko

项目简介

Nasiko 是面向 AI 代理、编码代理框架与工具的开放运行时。它能发现已在运行的编码代理，按代理框架和模型归集成本，把 LLM 调用路由到指定模型，并在网关执行策略、追踪每次运行。

核心功能

• TokenOps 在运行前预测成本，实时按团队、代理和模型监控支出，并在运行越过成本、循环或重试边界时中止或升级处理。
• LLM Router 向代理提供基础 URL 和短期身份令牌，而不是真实 API 密钥；提供商、模型和密钥在服务端解析，代理与日志都不会看到真实密钥。
• Runtime Controls 在网关对每次调用执行策略，包括工具与数据限制、预算与重试上限、敏感操作审批、紧急停止开关和审计记录。
• Multi-Agent Harness 跨现有模型、提供商和框架组合工作流，协调提供商切换、回退路由、跨步骤状态，并追踪每次交接。
• 平台提供代理注册表、身份与访问映射、租户隔离、网关路由，以及成本与追踪的可观测性。
• Nasiko 可发现并管理 Claude Code、Codex、OpenCode 和 Cursor CLI 等编码代理，并为受支持的代理框架提供会话上报和 LLM 路由。

适用场景

• 按编码代理、代理框架、模型和团队归集 AI 支出，而不是只对一张提供商账单做反向拆解。
• 将 Claude Code、Codex 或 OpenCode 的 LLM 调用路由到指定提供商和模型，包括用 OpenAI 密钥承接 Anthropic 格式流量。
• 为生产代理执行 MCP 工具与数据访问策略、审批、预算限制和紧急停止。
• 组合并追踪跨多个模型提供商和框架的多代理工作流，同时在运行中检查成本与策略。

快速开始

• 从代码检出安装 CLI：cargo install --path cli/ --force，然后运行 nasiko agents discover，在不改动设置的情况下查看已检测到的编码代理。
• 不想安装 Rust 时，可使用仅用 Docker 的快速开始。
• 下载适用于 macOS、Windows 或 Linux 的 Nasiko 桌面应用。
• 需要路由时，创建 LLM 配置并连接受支持的代理框架，例如 nasiko connect claude --config <llm-config-name>。

部署与要求

• 仅用 Docker 的快速开始只需 Docker；从源码安装 CLI 需要 Rust。
• 会话上报和路由需要可用的控制平面与有效登录。
• 本地编码代理路由需要 AGENT_JWT_SECRET，自定义 LLM 配置也不例外。
• 编码代理遥测导出需要 CODING_AGENT_OTLP_ENDPOINT；未设置时，回执会在没有导出 worker 的情况下保持待处理状态。

采用前须知

• 许可证：Other。在使用、修改或分发项目前，请确认其具体条款。