anicode

前端无关的通用型 AI Agent 终端界面（TUI），调研、写作、分析、规划和工具协作都是一等能力，软件工程是重点强化的核心长项。支持多 provider、工具调用、权限门、会话持久化、守护进程与 MCP。

默认以本地单进程模式运行，会话使用内置 SQLite；PostgreSQL、daemon、Vault/KMS、S3 和 Remote Runtime 均为显式可选项。登录 AniCode Cloud 后，默认模型是 anicode-cloud/deepseek-v4-flash；未登录时默认使用 deepseek/deepseek-v4-flash 和用户自己的 DeepSeek 凭证，并给出明确登录引导。--demo 可完全离线启动。

安装

npm install -g anicode

装好后命令名是 anicode：

anicode --version
anicode --list-providers       # 查看内置 provider 元数据（不读取凭证）
anicode --list-models          # 查看随版本发布的静态模型目录（不代表在线）
anicode auth login             # 交互登录；密码隐藏输入，不接受 argv/管道密码
anicode auth status            # 只显示安全状态 DTO，不输出任何 token
anicode auth logout            # 删除本机 Cloud refresh token
OPENAI_API_KEY='...' anicode credentials import OPENAI_API_KEY
ANICODE_CREDENTIAL_KEYS=OPENAI_API_KEY anicode --model openai/gpt-5
anicode credentials list       # 只列显式引用名，不读取 Keychain/Vault/KMS
anicode credentials remove OPENAI_API_KEY

普通启动不会枚举 OS Keychain，也不会把 .env 或 shell 中的密钥自动持久化。若启用了系统凭证库， 本地 TUI、exec 和 MCP host 仅在需要判断默认路由、明确选择 Cloud 或恢复未知会话时读取 AniCode Cloud 专用命名空间中的单个 refresh 记录；动态 HTTP host 启动时也会恢复它。--demo、明确的非 Cloud 模型和 非 Cloud config.model 不触碰该记录。Keychain 中只持久化 refresh token，短期 access token 只进入内存 Credential Broker。 没有显式模型来源时，启动恢复使用短硬截止；Keychain 或登录服务慢/离线会安全取消本次恢复并快速回落到用户自己的 deepseek/deepseek-v4-flash，迟到的读取或响应不能再写回登录态。显式 --model anicode-cloud[/...] 或 Cloud config.model 不会被静默改写，并使用完整认证截止后给出明确错误。裸 anicode-cloud 等价于 anicode-cloud/deepseek-v4-flash。 共享 DeepSeek key 始终留在服务端网关，不会下发、写入配置或出现在 CLI 状态 DTO/日志中。环境密钥只在当前进程 Broker 中使用；长期保存必须通过 credentials import 明确执行，运行时再用 ANICODE_CREDENTIAL_KEYS 指定允许按需读取的精确名称。provider 诊断、默认模型选择和会话 create/open/resume 都是 metadata-only；懒加载引用直到该会话首次实际 send/stream 才读取，失败后可在 解锁或修复凭据后重试，且失败时不会继续打开其他 fallback Keychain 条目。credentials list、 auth list 和只浏览模型元数据不会打开 Keychain；Cloud 登录态请使用会精确读取上述专用记录的 auth status。 Cloud refresh token 只保存在当前设备；换新设备时重新执行一次 anicode auth login，无需复制任何 DeepSeek key。 anicode serve 会发布由宿主登录态与宿主 config 决定的默认模型；无 --model 且无客户端 config 的 anicode --http 会采用这个宿主默认值。因此已登录的 serve 会话默认走 AniCode Cloud 共享网关，而显式模型和 客户端 config 仍保持权威；连接不支持该 capability 的旧 host 时兼容回落到 direct DeepSeek。 已物化的 SDK/provider client 可能继续持有凭据副本；credentials remove 或外部轮换后，应重启已使用 该凭据的常驻 AniCode 进程以可靠应用变更。

仍会访问 Keychain 的动作是精确的：启动时恢复 AniCode Cloud 登录、首次实际使用某个懒加载 provider、最终选择模型后的鉴权目录 校验、连接显式启用且需要凭据的 MCP/控制平面，以及 credentials import/remove、 auth login/status/logout/migrate 或轮换等读写/迁移动作。原生调用位于有硬截止的 helper 子进程，凭据请求仅经 bounded stdin 传递；无法证明写入/删除是否完成时会报告 indeterminate，不会盲目回滚。测试/密闭 构建应同时设置 ANICODE_CREDENTIAL_BACKEND=memory ANICODE_DISABLE_OS_KEYCHAIN=1，将任何意外系统 凭据库访问变成原生 API 调用前错误。

使用

# 推荐：登录后默认通过 AniCode Cloud 使用 DeepSeek（共享 provider key 不下发）
anicode auth login
anicode auth status
anicode

# 或使用自己的 DeepSeek key
export DEEPSEEK_API_KEY=...
anicode

# 零网络调试（无需 API key，离线流式 echo + 真实工具链路）
anicode --demo

# Gemini
export GEMINI_API_KEY=...
anicode --model gemini/<model-id>

# 任意 OpenAI 兼容端点
export CUSTOM_OPENAI_BASE_URL=http://127.0.0.1:9000/v1
anicode --model custom/<model-id>

TUI 内命令:/model 选模型 · /sessions 列会话 · /resume <id> 续接 · /new [标题] · /help。 受信任的本地交互 TUI 默认使用最高权限并自动批准（首次用 anicode trust grant --cwd "$PWD" 授信）；该默认仍服从显式 deny / ask、sandbox、网络策略与 workspace scope。Shift+Tab 可在普通、自动接受编辑、跳过授权之间循环（不含计划档），弹框打开时也有效。未信任、远端与无头入口保持保守。运行中 Enter 追加指令、Esc 中断；若仍有授权提示，可用 y 允许 / a 允许并记住 / n 拒绝。 默认保留终端原生鼠标框选/复制与备用屏滚轮回看；需要鼠标点击弹框时用 anicode --mouse，或在运行中用 /mouse on|off 切换。 POSIX 终端中 Ctrl+Z 挂起、fg 恢复，默认 Ctrl+Q 退出。 /model 打开、搜索、滚动或按 Esc 关闭时只展示静态 metadata，不读取凭据；按 Enter/Tab 确认后只对 所选 provider 做一次鉴权目录校验，所选模型必须在本次返回中且兼容文本/工具调用。直接指定模型和 once 也不能绕过所选 provider 的实时目录校验；目录请求不会逐模型发起计费推理探测。

说明

本包是自包含产物:core / shared / TUI 的源码已打包进单个 dist/cli.js, 所有外置运行时依赖均在 package.json 中声明并由发布门禁校验。需要 Node >= 22.15.0；CI 会持续 验证最低版本、发布用 Node 24 LTS 和 Node current 最新稳定版。npm 包内含 MIT LICENSE。

源码与完整文档:https://github.com/anton6202527/anicode