git-lrc 接入 ClaudeAPI 实战：让 Claude 给每一次 commit 做免费 AI 代码审查（2026 完整指南）

git-lrc 接入 ClaudeAPI 实战：让 Claude 给每一次 commit 做免费 AI 代码审查

AI 写代码越来越快，但"AI 顺手删掉的那行逻辑""被悄悄改掉的边界条件"往往要到上线才被发现。git-lrc 把代码审查搬到了 git commit 这个节点上——提交前先让 AI 审一遍 diff，把问题拦在进入项目历史之前。

而它 2026-06-04 发布的 v0.4.7 正式支持了 Anthropic Compatible API：你可以直接在它自带的连接器界面里，把审查后端指到 ClaudeAPI.com 这样的第三方 Claude 兼容端点，让 Claude 来审查你的每一次提交。本文走通这条路。

为什么要给 git-lrc 单独写一篇

git-lrc 本身支持 BYOK（Bring Your Own Key），默认走 Google Gemini 免费额度，同时也支持 OpenAI、Claude、DeepSeek、OpenRouter。但对国内用户来说，前面这些要么连不上、要么要科学上网。

v0.4.7 的关键变化是：新增了 “Anthropic Compatible API” 连接器，并把 gw.claudeapi.com 做成了 Base URL 下拉框里的内置预设。这意味着不用手填 URL，下拉一选就能把审查后端切到国内低延迟的 ClaudeAPI 中转上——这正是这篇教程要讲的核心配置。

跟前面那些"GUI 应用要绕过 UI 配环境变量"的工具不同，git-lrc 直接在 UI 里暴露了 Provider / Base URL / Model 三个字段，所以配置反而最直接。

官方文档与发布说明：

• git-lrc 项目主页：https://github.com/HexmosTech/git-lrc
• Compatible API support 章节：https://github.com/HexmosTech/git-lrc#compatible-api-support
• v0.4.7 Release Notes：https://github.com/HexmosTech/git-lrc/releases/tag/v0.4.7
• ClaudeAPI 文档入口：https://claudeapi.com/blog

一、git-lrc 是什么

git-lrc 是一款免费、源码可见（source-available）的预提交代码审查工具，口号是 Free, Micro AI Code Reviews That Run on Commit。它的核心作用：在你执行 git commit 前，自动对本次变更（diff）做一遍 AI 检查，有效防止因 AI 生成代码而引入的"隐形错误"。

核心功能一览：

• 自动触发 + 手动控制：默认 git commit 时自动运行，也支持 git lrc review 手动触发。
• 三种处理方式：review（运行 AI 审查）、vouch（手动担保、跳过 AI）、skip（直接跳过），所有操作都写进 git log。
• AI 驱动审查：重点发现逻辑被意外删除、安全检查被移除、凭据泄露、昂贵云 API 调用被引入、敏感数据写入日志等问题。
• 交互式审查界面：本地 Web 页面，类 GitHub 风格 diff、按严重程度分级的内联评论、审查摘要、一键复制问题、事件日志。
• 透明审计追踪：每次审查状态（是否运行、迭代次数、覆盖率）作为元数据写入 git log。
• 隐私友好：只分析暂存区 diff，审查完不存 diff。

二、准备：ClaudeAPI Key + git-lrc

2.1 注册 ClaudeAPI 并拿 Key

1. 访问 claudeapi.com，手机号/邮箱注册
2. 进入 console.claudeapi.com 控制台
3. 充值（支持支付宝、微信、对公转账）
4. 创建 API Key（必须勾选分组），复制 sk- 开头的 Key

接入点：

https://gw.claudeapi.com

https://gw.claudeapi.com

这是 Anthropic 原生协议的根路径。git-lrc 的下拉预设 ClaudeAPI (gw.claudeapi.com) 已经帮你填好了，无需手动拼 /v1。

2.2 安装 git-lrc

推荐通过 IPM 安装（全局安装 git hook）：

# Linux / macOS
curl -L https://hexmos.com/ipm-install | bash && ipm i HexmosTech/git-lrc

# Windows (PowerShell)
iwr https://hexmos.com/ipm-install-ps | iex; ipm i HexmosTech/git-lrc

# Linux / macOS
curl -L https://hexmos.com/ipm-install | bash && ipm i HexmosTech/git-lrc

# Windows (PowerShell)
iwr https://hexmos.com/ipm-install-ps | iex; ipm i HexmosTech/git-lrc

已经装过的老用户，更新到 v0.4.7：

lrc self-update

lrc self-update

验证版本（确认 ≥ 0.4.7，否则没有 Anthropic Compatible API 选项）：

lrc --version

lrc --version

三、端点冒烟测试（不要跳过）

进 git-lrc UI 之前，先确认 ClaudeAPI 端点本身能通——否则后面审查跑不起来你定位不到是 Key 问题还是配置问题。

直接用 cURL 打一发 Anthropic 原生协议：

curl https://gw.claudeapi.com/v1/messages \
  -H "x-api-key: sk-你的ClaudeAPI密钥" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "只回复 pong"}]
  }'

curl https://gw.claudeapi.com/v1/messages \
  -H "x-api-key: sk-你的ClaudeAPI密钥" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "只回复 pong"}]
  }'

Windows PowerShell 用 Invoke-RestMethod 更稳：

$headers = @{
  "x-api-key"         = "sk-你的ClaudeAPI密钥"
  "anthropic-version" = "2023-06-01"
  "content-type"      = "application/json"
}
$body = @{
  model      = "claude-sonnet-4-6"
  max_tokens = 256
  messages   = @(@{ role = "user"; content = "只回复 pong" })
} | ConvertTo-Json -Depth 5

Invoke-RestMethod -Method Post `
  -Uri "https://gw.claudeapi.com/v1/messages" `
  -Headers $headers -Body $body -TimeoutSec 120

$headers = @{
  "x-api-key"         = "sk-你的ClaudeAPI密钥"
  "anthropic-version" = "2023-06-01"
  "content-type"      = "application/json"
}
$body = @{
  model      = "claude-sonnet-4-6"
  max_tokens = 256
  messages   = @(@{ role = "user"; content = "只回复 pong" })
} | ConvertTo-Json -Depth 5

Invoke-RestMethod -Method Post `
  -Uri "https://gw.claudeapi.com/v1/messages" `
  -Headers $headers -Body $body -TimeoutSec 120

只看：HTTP 200、content 数组里 type: "text" 且 text 非空、model 字段与请求一致。通了再进 UI。

四、核心配置：在连接器界面接入 ClaudeAPI

打开管理界面：

lrc ui

lrc ui

进入 AI Connectors → Edit Connector，按下图配置：

逐项填写：

点 Update 保存。

关键一步：git-lrc 默认使用连接器列表里的第一个连接器。如果你希望提交时默认用 ClaudeAPI，记得回到连接器列表把这条拖到第一位。

五、提交时享受 Claude 审查

配置完成后，正常 git commit 就会触发审查（或手动 git lrc review）。审查结果会在本地 Web 页面以类 GitHub 的 diff 呈现，带 Critical / Error / Warning / Info 分级评论：

页面顶部是审查摘要，中间是文件与评论统计，底部 GIT ACTION 区让你直接选 Commit、Commit & Push 或 Abort Commit，还能一键 Copy Visible Issues 或 Send to Claude 继续追问。

💡 上图摘要区其实展示了一个真实场景——403: 预扣费额度失败，用户剩余额度：$0.007546，需要预扣费额度：$0.007974。这说明 git-lrc 确实在调用 ClaudeAPI 端点，只是账户余额差一点点。给 ClaudeAPI 充值后即可正常生成摘要——这也从侧面印证了连接器是真打通的。

六、常见错误对照表

七、配置速查

git-lrc 连接器（lrc ui → AI Connectors → Edit Connector）
├── Provider   : Anthropic Compatible API
├── API Key    : sk-你的ClaudeAPI密钥
├── Base URL   : ClaudeAPI (gw.claudeapi.com)   ← 内置下拉预设
└── Model      : claude-sonnet-4-6

别忘了
└── 把该连接器拖到列表第一位（git-lrc 默认用第一个）

验证链路
1. curl https://gw.claudeapi.com/v1/messages ...   # 端点通
2. lrc --version                                   # ≥ 0.4.7
3. git commit                                      # 触发审查，看 Web 结果页

git-lrc 连接器（lrc ui → AI Connectors → Edit Connector）
├── Provider   : Anthropic Compatible API
├── API Key    : sk-你的ClaudeAPI密钥
├── Base URL   : ClaudeAPI (gw.claudeapi.com)   ← 内置下拉预设
└── Model      : claude-sonnet-4-6

别忘了
└── 把该连接器拖到列表第一位（git-lrc 默认用第一个）

验证链路
1. curl https://gw.claudeapi.com/v1/messages ...   # 端点通
2. lrc --version                                   # ≥ 0.4.7
3. git commit                                      # 触发审查，看 Web 结果页

资源清单：

小结

git-lrc 把 AI 代码审查放在 git commit 这个"甜蜜点"上——比 PR 早、不依赖个人 IDE、不可绕过。v0.4.7 之后，接 ClaudeAPI 只需三步：

1. lrc ui → Provider 选 Anthropic Compatible API
2. Base URL 下拉直接选内置预设 ClaudeAPI (gw.claudeapi.com)，填 Key，Model 选 claude-sonnet-4-6
3. 把这条连接器拖到列表第一位，之后每次 git commit 都由 Claude 把关

国内场景下，把 git-lrc 的审查后端指到 claudeapi.com 的 Anthropic 兼容端点，就能用低延迟的国内中转、低成本地给每一次提交做一道 Claude 质量关。注册支持支付宝/微信，文档与 Key 在 console.claudeapi.com。