入门指南

让 AI 帮你配置 manage-env

只需复制一段提示词给 AI 编程工具,再在自己的终端里完成少量必须由本人执行的信任设置。

一次性终端设置

这些步骤会修改本机设置或验证身份,因此由你亲自执行。无需把密码、邮件验证码或密钥值粘贴到聊天中。

  1. 安装公开 CLI

    支持 macOS 和 Linux,并会校验下载的二进制文件。

    curl -fsSL https://manage-env.com/install | sh
  2. 创建账户或登录

    新账户使用 signup,已有账户使用 login。邮件验证码和密码只在你的终端中输入。

    menv signup # 或: menv login
  3. 在仓库根目录连接

    为 Claude Code 和 Cursor 注册本地 menv MCP 服务器,并把安全规则写入 AGENTS.md。

    menv connect
  4. 重启 AI 编程工具

    完全重启以加载新的 MCP 服务器;如果工具询问,请批准 menv 服务器。

接下来交给 AI

重启后,把页面顶部复制的提示词粘贴到新对话。AI 只报告状态和键名,不报告值。

detect_required_keys

查找所需环境变量

读取 .env.example,区分可以生成的内容和需要你决定的内容。

init_project · setup_project

创建项目和安全值

绑定仓库、生成随机密钥和密钥对,并填写非敏感默认配置。

request_value_from_user

只向你询问第三方签发的值

Stripe 密钥、数据库 URL 等在 AI 无法读取的本地终端提示中输入。

run_with_secrets · sync_to_target

运行应用并同步已批准的目标

使用值但不返回值,只报告结果、耗时、目标和键名。

密钥值会去哪里?

AI 负责协调工作,可信的本地路径负责处理值。

AI 聊天和工具结果

只接收状态、键名和下一步。不要把密钥值粘贴到聊天中。

你的终端和本地进程

第三方签发的值由你在本地输入,仅在获批准的进程需要时解密并注入。

manage-env 服务器

只保存加密数据和不含值的元数据,不会收到打开保险库所需的明文值。

问题排查

找不到 menv 命令

把 $HOME/.local/bin 加入 PATH,打开新终端,再次运行 menv --version。

AI 看不到 menv 工具

在仓库根目录再次运行 menv connect,重启 AI 工具,并在提示时批准 menv MCP 服务器。

AI 说某个值需要你输入

在本地终端提示中粘贴该值,绝不要在聊天中回复这个值。

准备连接第一个仓库了吗?

个人账户免费。创建账户后回到这里复制配置提示词。

创建免费账户