MicroCodex 是一个在您的终端中本地运行的超轻量编码代理。MicroCodex 用 C++23 编写，提供一次性提示、互动终端用户界面、本地编码工具、持久对话以及自动上下文压缩。快速开始安装和运行 MicroCodex在 Mac 或 Linux 上运行以下命令以安装 MicroCodex: curl -fsSL https://github.com/paoloanzn/microcodex/releases/latest/download/install.sh | sh 然后简单运行 microcodex login 登录，接着运行 microcodex 开始使用。您还可以前往最新的 GitHub Release 并下载适合您平台的二进制文件。每个 GitHub Release 包含以下可执行文件：macOS Apple Silicon/arm64: microcodex-aarch64-apple-darwin.tar.gz x86_64: microcodex-x86_64-apple-darwin.tar.gz Linux x86_64: microcodex-x86_64-unknown-linux-gnu.tar.gz arm64: microcodex-aarch64-unknown-linux-gnu.tar.gz 每个归档包含一个平台名称的条目（例如， microcodex-aarch64-apple-darwin），因此您可能想在解压后重命名为 microcodex。安装程序为当前架构选择本机构建。Linux 需要 libcurl 和 OpenSSL 运行时库。要安装特定版本，请设置 MICROCODEX_RELEASE：curl -fsSL https://github.com/paoloanzn/microcodex/releases/latest/download/install.sh | MICROCODEX_RELEASE=v0.1.0 sh 使用您的 ChatGPT 计划运行 MicroCodex 运行 microcodex login，然后在浏览器中打开显示的 URL。在远程或无头机器上，运行 microcodex login --device-auth 并在验证 URL 中输入显示的一次性代码。MicroCodex 将生成的 OAuth 凭据存储在 $CODEX_HOME 下，或者当 CODEX_HOME 未设置时存储在 ~/.codex 下。然后，您可以开始互动会话或者传递一次性提示：microcodex microcodex "找到故障测试，修复它并运行相关测试套件" 警告：MicroCodex 不是一个沙盒。在启动用户的 shell 之前，它应用了一个简单的词法拒绝列表，阻止强制删除文件（rm -f / rm -rf）、git reset --hard、强制 git clean、git checkout --、磁盘格式化工具和关机命令。这个保护并不是一个 shell 解析器，也不是一个完全的安全边界：不在拒绝列表中的命令以及所有文件操作与 MicroCodex 进程具有相同的权限。使用 Codex 技能 MicroCodex 发现安装在 $CODEX_HOME/skills 下的与 Codex 相同的文件系统技能，或者当 CODEX_HOME 未设置时在 ~/.codex/skills 下。每个技能必须有一个 SKILL.md，里面包含带有名称和描述的 YAML 前言。技能元数据在会话启动时添加到代理指令中；只有当其名称或描述与任务匹配时，才会读取完整技能。源代码构建构建需要 C++23 编译器、make、libcurl 开发文件和 Linux 上的 OpenSSL 开发文件。git clone --recurse-submodules https://github.com/paoloanzn/microcodex.git cd microcodex make 可执行文件被写入 build/microcodex。使用 make test 运行测试套件。已知错误和问题MCP 支持尚未实现。在使用 MicroCodex 时，当前无法从终端复制文本。bash 安全门是一个词法拒绝列表，而不是一个完整的安全命令策略或沙盒；间接或未识别的破坏性命令可能不会被阻止。文档CLI 使用安装和构建 测试本存储库根据 Apache-2.0 许可证许可。