安装

从 VS Code Marketplace

1. 打开 VS Code（或兼容分支）
2. 进入扩展（Ctrl+Shift+X / Cmd+Shift+X）
3. 搜索 Cortex Agent
4. 安装 cortex-labs.cortex-agent

code --install-extension cortex-labs.cortex-agent

从 Open VSX

适用于 VSCodium、Cursor、Windsurf 及其他 Open VSX 客户端： open-vsx.org

ovsx install cortex-labs.cortex-agent

从 VSIX

从 GitHub Releases 下载 .vsix，然后：

code --install-extension cortex-agent-<version>.vsix

首次运行

1. 在 opencode.ai 创建或使用 OpenCode 账户 — 那是你的 AI 账单。Cortex 无单独注册。
2. 安装 OpenCode CLI 并确保在 PATH 上（或设置 cortex.opencodeBinary）。在 Windows 上，Cortex 会查找 opencode.exe。
3. 安装 Cortex，然后打开聊天（状态栏或 Ctrl/Cmd+Alt+C）— 以右侧编辑器面板打开。项目文件夹可选；没有时，Cortex 用用户主目录处理一般问题。
4. 完成 引导 （或打开 Connect）：Get API key → 粘贴 → Save。即使本地服务器尚未就绪，Cortex 也会写入 OpenCode 的本地 auth.json。更强模型在 Models。
5. 选择模型（或保持 Auto）并开始聊天

要求

• VS Code 1.100+（或兼容分支）
• OpenCode 账户 / 订阅（唯一的 AI 账户 — 无需 Cortex 注册）
• PATH 上的 OpenCode CLI ≥ 1.18.0（或 cortex.opencodeBinary）
• 最终构建 v1.0.0 在发布日后约 6 个月过期（183 天；cortex.beta.expirationDate）。之后请从 GitHub Releases 安装更新的 VSIX，或将 cortex.beta.enabled 设为 false。