Opencodex Skill：把 VS Code 变成免费编程 Agent 的视觉神器

Opencodex Skill：把 VS Code 变成免费编程 Agent 的视觉神器

总结

Opencodex 是一款完全免费、无需注册即可使用的开源编程 Agent，直接以 VS Code 侧边栏形式嵌入开发环境。接入了 OpenCode 内置免费模型、OpenRouter、Groq、Gemini、Ollama 等多平台，免去配置烦恼，开箱即用——让任何人都能在自己熟悉的编辑器里拥有一个完整功能的 AI 编程助手。截至 2026-09-09 在 GitHub 约 490+ 星，正处于快速增长期。

功能与原则

Opencodex 的核心理念是零门槛接入：安装 VS Code 插件、打开文件夹、点开聊天窗口，选一个免费模型，直接开聊。它不绑定任何单一 AI 提供商，支持本地模型和云端免费 tier，用完即走。

核心原则：
– 免费优先：默认 OpenCode 提供商无需账号、免 API Key
– 工作区隔离：文件操作限制在当前工作目录内，.env 等凭证文件被屏蔽
– 可见可复：每一步计划、推理、工具调用、失败重试全部在侧边栏可视化展示
– 用户控制权：Ask / Auto edits / Open access 三档权限分级，危险操作必须确认

认可度

• GitHub 星数：约 490+（截至 2026-09-09），GitHub Trending 今日上榜
• VS Code Marketplace：可直接从 Marketplace 一键安装
• 定位：VS Code 扩展类编程 Agent，与 Claude Code、Codex 同赛道，但主打免费 + 零配置
• 开发活跃度：2026 年中上线，保持高频更新

链接

GitHub（VS Code 扩展版）：https://github.com/matonhp5108/Opencodex

VS Code Marketplace 安装地址：https://marketplace.visualstudio.com/items?itemName=EvaanChowdhry.opencodex-agent

原作者

由 matonhp5108（GitHub username）开发维护，扩展名标注为 EvaanChowdhry。项目定位为”让每个开发者都能在 VS Code 里免费用上 AI 编程 Agent”，社区驱动，代码开源可见。

介绍

Opencodex 将 Codex 风格的 Agent 循环直接嵌入 VS Code 编辑器。安装后，编辑器标题栏会出现一个 “O” 按钮，点击即可打开聊天面板。无需注册账号、无需配置 API Key——默认的 OpenCode 免费模型开箱即用。

它的 Agent 能力相当完整：读取和搜索当前工作区、创建和编辑文件、运行终端命令、调用 MCP 服务器、派分子 Agent 执行探索任务、浏览 GitHub Issues、提交 PR 等。每一个操作步骤都在侧边栏实时展示（可折叠的工具调用日志 + 推理过程），出错会自动重试，用户可以随时接管。

如果你不想用云端模型，也可以配置 Ollama，在本地运行兼容模型，数据完全不离开本机。

特点

• 零配置启动：无需账号、无需 API Key，默认免费模型直接用
• 多提供商切换：OpenCode、OpenRouter、Groq、Gemini、Mistral、Ollama 一个界面自由切换
• 可见的 Agent 思维：侧边栏实时展示计划、推理、工具调用和流式输出，过程透明可查
• 工作区安全隔离：文件操作锁定在当前目录，.env 等敏感文件被阻止访问
• 三级权限控制：Ask（所有操作需确认）→ Auto edits（安全命令自动执行）→ Open access（全权限，谨慎使用）
• 本地模型支持：通过 Ollama 可完全本地运行，保护代码隐私
• 并行工作分支：支持在 .opencodex/worktrees 下创建隔离分支，各任务独立窗口推进
• Browser Testing：内置 Chromium 浏览器测试，Agent cursor 可视化，真实键盘事件模拟
• GitHub 深度集成：可浏览 Issues、创建分支、提交 PR、查看 CI 状态

使用方法

安装步骤：
1. 在 VS Code 中搜索 opencodex-agent 或访问 Marketplace 点击安装
2. 打开任意项目文件夹
3. 点击编辑器标题栏的 “O” 按钮，或用 Command Palette 执行 Opencodex: Open Chat
4. 完成一次性设置（默认 OpenCode 提供商无需配置），在 composer 下方选择免费模型
5. 描述你想完成的任务，开始对话

最小示例：

> Opencodex: Open Chat
> "帮我重构 src/utils/format.ts，去掉重复的日期格式化逻辑，保留 ISO 和本地两种格式"
→ Agent 自动读取文件 → 分析 → 列出改动计划 → 用户确认 → 自动执行

进阶配置（可选）：
– 在 Settings 中添加 OpenRouter / Groq / Gemini 的 API Key，获得更多模型选择
– 配置 Ollama，使用本地模型（如 qwen2.5-coder）完全离线编程
– 启用 MCP 服务器，连接数据库、Git、Notion 等外部工具

使用场景与人群

适用场景：
– 快速原型开发：需要 AI 辅助写代码但不想注册任何服务
– 多模型对比：用同一套界面在多个模型之间快速切换，比较输出质量
– 本地隐私敏感：代码不希望发送到任何云端，通过 Ollama 完全本地运行
– 轻量化 Code Review：Agent 辅助审查 PR、生成变更说明、检查代码风格
– 教学与演示：VS Code 环境对学生和新手最友好，无需学习命令行

目标用户：
– VS Code 重度用户（不想换编辑器）
– 初学 AI 编程的开发者（零门槛体验 Agent 能力）
– 对 API 成本敏感的个人开发者（免费 tier 优先）
– 需要在受限网络环境工作的工程师（Ollama 本地模式）

输入与输出案例

案例一：工作区重构
– 输入："把当前项目的错误处理统一迁移到 src/errors/index.ts，导出统一类型和工厂函数"
– 输出：Agent 读取所有现有文件 → 识别错误处理模式 → 起草新模块 → 在 Ask 模式弹出 diff 确认 → 用户点击 Apply → 文件创建完成

案例二：Browser Testing
– 输入："打开首页，点击登录按钮，截图并检查控制台有无报错"
– 输出：Agent 启动 Chromium → 导航到本地服务 → 模拟点击 → 捕获实时 cursor 动画 → 检测 console error → 输出截图路径和控制台日志摘要

GitHub: https://github.com/matonhp5108/Opencodex