Codehamr

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

Codehamr 是一个 MIT 许可的独立终端编码代理，用 Go 编写，通过安装脚本提供 Linux、macOS 和 Windows（amd64/arm64）二进制。它通过 bash、read_file、write_file、edit_file 四个工具读取项目、修改代码、运行检查并汇报结果。模型接入完全由用户选择：默认配置一个指向 http://localhost:11434 的本地 Ollama 模型，也可添加 OpenRouter 等 API 供应商配置，无需项目账号或订阅。所有对话、提示历史和可选日志都保存在项目下的 .codehamr/ 目录中，API 请求只发往你配置的端点。它不提供沙箱，shell 命令以当前用户权限执行，Windows 上需在 WSL2 或 Linux devcontainer 内运行。

在项目目录启动后，codehamr 读取 .codehamr/config.yaml 中的模型配置（模型 ID、API 基址、可选密钥、context_size），按 Responses API 流式调用所选模型（如 qwen3.8:27b 或 anthropic/claude-opus-5.5）。代理通过四个工具循环工作：bash 执行 /bin/sh 命令、read_file 读取文件、write_file 写入文件、edit_file 编辑文件；它读取你的项目、做出修改、运行构建或测试检查，完成后答复。嵌入式系统提示要求它验证改动并把无法运行的检查标记为 unverified。/models 列出或切换配置，/clear 重置对话，提示历史保存在 .codehamr/history，可选 logging: true 将提示、响应和工具活动记录到 .codehamr/log.txt。

1. 想在本地 Ollama 模型上运行编码代理、希望代码和提示不离开本机的隐私敏感开发者
2. 已有 OpenRouter 或其他 Responses API 兼容供应商账号、想在终端中调用 Claude 等大模型改代码的工程师
3. 希望在 devcontainer 或虚拟机内让代理自动执行构建与测试并汇报检查结果的团队
4. 偏好极简工具链（一个二进制、一个配置文件、两个斜杠命令）而非重型 IDE 插件的用户
5. 需要在低配离线环境或自托管推理服务器上试用编码代理的评估者

如何安装或部署这个 Agent？

Linux 或 macOS：

curl -fsSL https://raw.githubusercontent.com/codehamr/codehamr/main/install.sh | bash

Windows：

curl -fsSL https://raw.githubusercontent.com/codehamr/codehamr/main/install.cmd -o install.cmd && install.cmd

两个安装脚本从项目 GitHub Releases 下载二进制。首次启动会在当前目录生成 .codehamr/config.yaml，默认包含一个 local 配置。

如何使用这个 Agent？

在项目目录运行 codehamr 即可开始。若使用 OpenRouter：

export OPENROUTER_API_KEY='your API key'
codehamr

然后输入 /models openrouter 切换配置。配置示例：

active: local
models:
    local:
        llm: qwen3.8:27b
        url: http://localhost:11434
        key: ""
        context_size: 262144
    openrouter:
        llm: anthropic/claude-opus-5.5
        url: https://openrouter.ai/api/v1
        key: ${OPENROUTER_API_KEY}
        context_size: 1000000

在 Ollama 上需将 context_size 与 OLLAMA_CONTEXT_LENGTH 或 Modelfile 的 num_ctx 对齐。操作键：Enter 提交提示，Alt+Enter 换行，Ctrl+C 取消当前回合（再按退出），Ctrl+D 在空提示时退出，Ctrl+L 清屏保留对话，/clear 重置对话与历史。

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

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

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

FollowAgents 如何评估这个 Agent？

最近版本

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

1. 2026-09-25 2026-09-25
   发布说明摘录

   Changelog * media * cleanup

   在 GitHub 查看 ↗
2. 2026-09-19 2026-09-19
   发布说明摘录

   Changelog * handling responses

   在 GitHub 查看 ↗
3. 2026-09-17 2026-09-17
   发布说明摘录

   Changelog * handling reasoning * handling reasoning

   在 GitHub 查看 ↗

常见问题