Ogcode

这个 Agent 能做什么，适合哪些场景？

Ogcode 是一个开源（AGPL-3.0，另有商业许可）、本地优先的 AI 编码智能体与智能体运行环境，由 Go 编写，通过浏览器界面（默认 http://localhost:9595）操作。它在执行前先对项目建立地图、按精确行号范围读取文件，从而节省 token；能跨文件实现功能、运行构建与测试、调查失败原因而非盲目重试。它支持计划模式与任务并行、可复用的 SKILL.md 工作流、外部 MCP 服务器、内置网页搜索，并以 Mermaid 图表、LaTeX、Plotly 图表和沙箱 HTML 等富结果展示输出。模型通过环境变量或 ogcode.json 配置，支持 Anthropic、OpenAI、OpenRouter 以及 Ollama 本地模型（无需 API 密钥）。权限按会话分为 Ask、Auto、Yolo 三档，并支持 Docker、远程部署（SSH 隧道、反向代理、VPN）等部署边界方案。

Ogcode 启动后以 ogcode 命令在 http://localhost:9595 提供 Web 界面。工作流程：先映射项目结构，再用精确行号范围选择性读取文件以保持上下文紧凑；然后跨文件编辑代码，执行构建与测试命令，并在失败时调查原因。它可将目标拆解为任务、并行执行相互独立的任务并创建拉取请求供评审。它通过记忆系统回忆过去的决策而非重放整个会话记录，以控制长会话的 token 成本。它内置网页搜索与页面阅读，支持可复用的 SKILL.md 技能工作流和外部 MCP 服务器，并可渲染 Mermaid 图表、LaTeX、PDF、Plotly 图表与沙箱 HTML。模型供应商由环境变量（ANTHROPIC_API_KEY、OPENAI_API_KEY、OPENROUTER_API_KEY、OLLAMA_BASE_URL）或 ogcode.json / ~/.config/ogcode/config.json 检测，环境变量优先级最高。每次工具执行的权限按会话在 Ask（逐步批准）、Auto（按风险放行）、Yolo（不提示）之间选择。

1. 接手陌生代码库的开发者：让 Ogcode 先映射项目、按行号大纲读取关键文件，快速理解代码而不必人工翻阅。
2. 需要交付完整功能的工程师：把目标拆成任务、并行执行独立任务，并生成拉取请求走评审流程。
3. 注重数据隐私的团队：用 Ollama 本地模型运行，代码与会话数据留在本机，无需 API 密钥。
4. 调试构建与测试失败的开发者：让智能体运行测试、调查失败原因，而不是盲目重试。
5. 远程服务器使用者：通过 SSH 隧道、带认证的反向代理或 VPN 在浏览器中访问远程部署的实例。
6. 需要沉淀团队流程的团队：将常用工作流写成 SKILL.md，并按技能设置权限（如 deploy-prod 设为 ask）。

如何安装或部署这个 Agent？

一键脚本安装：

curl -fsSL https://ogcode.in/install.sh | sh

或使用包管理器：

brew tap prasenjeet-symon/tap && brew install ogcode

winget install prasenjeet-symon.ogcode

Windows 无 winget 时：

irm https://ogcode.in/install.ps1 | iex

任何有 Go 的系统：

go install github.com/prasenjeet-symon/ogcode@latest

从源码构建需 CGO_ENABLED=1（Swift tree-sitter 绑定依赖 cgo）。也可用 Docker 运行：

docker run -p 9595:9595 \
  -v ~/.ogcode:/root/.ogcode \
  -v "$(pwd):/workspace" -w /workspace \
  ghcr.io/prasenjeet-symon/ogcode:latest

镜像同样发布在 Docker Hub：prasenjeetsimon/ogcode:latest。

如何使用这个 Agent？

至少设置一个模型供应商环境变量：

export ANTHROPIC_API_KEY=sk-ant-...

或使用本地模型，无需 API 密钥：

ollama serve
ogcode

启动后打开 Web 界面：

ogcode            # serves the UI on http://localhost:9595

项目级配置写在项目根目录的 ogcode.json，全局配置在 ~/.config/ogcode/config.json，环境变量优先：

{
  "providers": {
    "ollama": { "baseUrl": "http://localhost:11434" },
    "anthropic": { "apiKey": "sk-ant-..." }
  },
  "skills": {
    "paths": ["./team-skills"],
    "permissions": { "deploy-prod": "ask" }
  }
}

每个会话选择权限模式：Ask（逐步批准）、Auto（按风险放行）或 Yolo（无提示）。远程部署时切勿在无认证的情况下暴露到公网，推荐 SSH 隧道：

ssh -L 9595:localhost:9595 user@your-server

此外，可在设置界面连接 OG Lab 的 OGX 订阅计划，其模型经 OG Lab 网关运行，无需环境变量。

这个 Agent 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

最近版本

来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。

1. v0.48.0 2026-10-17
   发布说明摘录

   Release Notes — v0.48.0 Minor: The interface comes in light and dark Ogcode now has a light interface alongside the dark one it has always worn, and a Theme control in Settings → General to choose between them. The three options are Light, Dark, and System; System follows your operating system and switches live as your machine does, so a laptop that dims itself in the evening takes the app with it. Whatever you pick applies to the whole machine — every browser tab and every window — because the choice is kept by the server, not by one tab. The …

   在 GitHub 查看 ↗
2. v0.47.4 2026-10-17
   发布说明摘录

   Release Notes — v0.47.4 Patch: Compaction keeps the prompt you started the turn with When a turn folded its context with compact_context, the message the turn opened with — what you asked for, and any image you attached — could fall out of the model's view. The summary took its place. Everything the agent did after that point was working from a digest of your request instead of the request itself. The fold now keeps your original prompt, images included, at the head of what is sent, with the summary folded in beneath it. If the turn is compacted again …

   在 GitHub 查看 ↗
3. v0.47.3 2026-10-16
   发布说明摘录

   Release Notes — v0.47.3 Patch: Browser-backed search finishes what it starts Deep research fetches its chosen pages under one shared time budget, and the browser fallback was landing on the wrong side of it: the budget expired at the same instant an ordinary HTTP fetch timed out, so a page that needed a browser to render never got fetched. The window is now wide enough for the fallback to render and extract the page. On macOS that fallback is headless Chromium — Chrome, Chromium, Brave, or Edge, whichever is installed — with Safari kept only for a machine that has none of …

   在 GitHub 查看 ↗

常见问题