ClaudeMap

Harness Bridge

一个本地启动器：让 Claude Code 与其他七种编码 harness 直连任意 OpenAI / Anthropic / Responses 兼容端点——不改任何一行配置文件。

SDK 与工具launcherlocal-modelsclimenu-barendpoints
访问项目0xSero/harness-bridge

Harness Bridge 会实际探测端点的 /chat/completions、/messages 与 /responses 来发现它真正支持的方言，然后只提供确定可用的 harness——Claude Code 走 messages 方言，经 ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN 与 --model 接入。一次会话就是一条可读命令，不是生成的脚本：端点、密钥与模型随启动环境传递，你的 ~/.claude.json 等配置一个都不改，密钥以 0600 权限落盘、从不出现在命令行里。它还会把端点 /models 返回的真实上下文窗口告诉 Claude Code（经 CLAUDE_CODE_MAX_CONTEXT_TOKENS 等环境变量），本地模型不再触发过早压缩。一个核心、四种外壳：CLI（harness-bridge / hbr）、macOS 菜单栏应用与仅监听回环的 Web UI；缺失的 harness 会用官方包自动安装；推理力度按 harness 分别映射。

它做什么

  • 方言靠探测不靠声明：先探清端点真正支持什么再提供 harness——Responses 形状的流量绝不会打到纯 chat 端点上
  • 你的配置一个不改：端点、密钥与模型随启动环境传递；配置文件 0600，密钥从不出现在命令行或会话里
  • 把 /models 返回的真实上下文窗口告诉 Claude Code，本地模型不再因默认按 128k 而过早压缩
  • 一个核心、四种外壳：CLI（harness-bridge/hbr）、macOS 菜单栏应用、监听 127.0.0.1:4141 的回环 Web UI

什么时候用

让 Claude Code 对接本地或自托管端点——vLLM 类网关、公司代理、替代服务商——并在一处切换模型或 harness，全程不碰 ~/.claude.json。

如何上手

git clone https://github.com/0xSero/harness-bridge && cd harness-bridge
bun install
cd packages/cli && bun link      # Bun >= 1.1；把 harness-bridge / hbr 放进 PATH

harness-bridge providers add --name HomeLab --url http://host:8080/v1 --key sk-...
harness-bridge models            # 端点实际提供哪些模型
harness-bridge run claude        # 打开的 Claude Code 已在跟它对话

注意事项

为了在本地端点上省事，Claude Code 默认带 --dangerously-skip-permissions 启动（Codex 同样带绕过标志）——可用 args 查看，也能用 --safe 或自定义标志按次覆盖。Web UI 只监听回环、无鉴权。菜单栏应用需要 macOS 加 Xcode 命令行工具；CLI 需要 Bun 1.1 以上。缺失的 harness 默认会从官方包自动安装，除非设置 --no-install。MIT。

代码仓库

0xSero/harness-bridge

收录日期

地图上的相关资源

  • Claude for Siri

    SDK / 工具

    用你已登录的 Claude Code 账号回答 macOS Spotlight 与 Siri 的提问——一个实验性的 macOS 27 模型委派提供者。

    • macos
    • siri
    • spotlight
    • model-delegation
    查看

  • AI Coding Assistant Data Extractor

    SDK / 工具

    把十个 AI 编程助手的本地聊天记录提取成统一 JSONL——微调、分析，或赶在本地数据库被清空前备份多年的对话。纯标准库实现。

    • cli
    • data-export
    • jsonl
    • backup
    查看

  • Data Maskit (数据面具)

    SDK / 工具

    AI 编程助手的本地隐私网关——请求出网前把密钥、连接串、PII 打码成结构化占位符，回复流式无感还原。

    • privacy
    • gateway
    • pii
    • proxy
    查看