À retenir
- OCR est un CLI dédié à la revue de code, pas un chatbot : lit les diffs Git → appels d'outils pour le contexte → commentaires ligne par ligne ; à modèle égal, environ ~1/9 des tokens de la revue générique Claude Code, Precision/F1 plus élevés (Recall un peu plus bas — moins de bruit).
- 12+ providers intégrés :
anthropic(Claude),openai(GPT), DashScope, DeepSeek, Kimi, Zhipuz-ai, etc. ; seulement deux protocoles : Anthropic Messages et OpenAI Chat Completions. - Gemini absent des presets, mais Google fournit une API compatible OpenAI — un provider personnalisé suffit ; passerelle Vertex AI entreprise idem.
- Deux voies d'exécution : ① OCR gère son LLM (
ocr review) ; ② Delegation Mode (ocr delegate) — OCR filtre fichiers et règles, la revue est faite par Claude Code / Cursor avec leur modèle. - La puissance du modèle n'est pas la ligne de partage — pipeline de revue (ingénierie déterministe + Agent) et voie de facturation (API OCR vs délégation abonnement) le sont.
Conclusion d'emblée : Open Code Review prend Claude et GPT, Gemini en voie personnalisée
Le plafond qualité est fixé par le modèle — le rapport signal/bruit et le coût par la pipeline déterministe d'OCR. Même Claude Opus : OCR consomme moins de tokens et génère moins de faux positifs que
/code-reviewnu dans Claude Code.
En août 2026, alibaba/open-code-review liste dans la doc de configuration officielle 13 providers intégrés. Trois chemins pour cet article :
- Claude (défaut recommandé) —
ocr config set provider anthropic, protocole natifanthropic; modèlesclaude-opus-4-6,claude-sonnet-4-6; litANTHROPIC_API_KEYou les variablesANTHROPIC_*de Claude Code. - GPT —
provider openai, endpointhttps://api.openai.com/v1; pour équipes avec ChatGPT Team / crédits API ougpt-5.x/o-series. - Gemini — pas de preset intégré ; via
custom_providersvers l'endpoint compatible OpenAI de Google (https://generativelanguage.googleapis.com/v1beta/openai/), modèlegemini-2.5-pro, etc. ; entreprise via URL passerelle Vertex.
Si vous êtes déjà dans l'écosystème Open Code Review Claude (plugin Claude Code installé), activez le Delegation Mode : OCR n'appelle pas d'API externe — la revue utilise le modèle de la session Claude Code. Quota d'abonnement et revue OCR partagent la même facture. Structure de coût totalement différente de « OCR avec sa propre clé API ».
1. Pourquoi « faire relire par Claude Code » ne suffit pas — et à quoi sert Open Code Review ?
Claude Code a le Skill /code-review — ça marche. Après deux ans de montée en charge chez Alibaba, OCR a été open-sourcé séparément. Trois douleurs :
- Couverture incomplète — Sur gros diff, l'Agent générique « choisit les fichiers importants » et en oublie ; OCR utilise sélection déterministe + bundling intelligent (ex.
message_en.propertiesavecmessage_zh.properties) pour tout couvrir. - Dérive de position — Les commentaires Agent ratent souvent les numéros de ligne ; OCR a un module d'ancrage et réflexion dédié.
- Qualité variable + gaspillage de tokens — Skills NL purs difficiles à déboguer ; benchmark OCR (50 dépôts OSS, 200 PR réelles, 10 langues) : à modèle égal, F1/Precision nettement supérieurs à Claude Code générique, environ 1/9 des tokens, plus rapide ; Recall un peu plus bas = moins de signalements volontaires, moins de triage de faux positifs.
Open Code Review Claude n'est pas « encore une couche Claude », mais Claude dans une pipeline optimisée pour la revue. Changez le modèle pour GPT ou Gemini — la pipeline reste. C'est l'intérêt du multi-modèle.
2. Qu'est-ce qu'Open Code Review ? Comment les modèles s'intègrent ?
2.1 Positionnement produit
OCR est un CLI global via npm install -g @alibaba-group/open-code-review (commande ocr). Flux typique :
ocr config provider # interactif : provider + modèle + test
ocr review # changements staged/unstaged du workspace
ocr review --from main --to feature/x # comparaison de branches
ocr scan --path internal/agent # scan complet (sans diff)
Outils Agent : file_read, code_search, file_read_diff, code_comment, etc. — références croisées, pas seulement la surface du patch.
2.2 Trois modes d'intégration
| Type | Entrée | Modèles typiques | Coût config | Pour qui |
|---|---|---|---|---|
| Provider intégré | ocr config provider |
Claude, GPT, DeepSeek, Qwen… | Faible (clé API) | Majorité des équipes — chemin par défaut |
| Provider personnalisé | custom_providers.* |
Gemini, vLLM maison, passerelle entreprise | Moyen (URL + protocol) | Passerelle modèle existante / intranet conformité |
| Delegation Mode | ocr delegate |
Modèle courant Claude Code / Cursor | Zéro clé OCR | Déjà abonné — économiser la facture API |
2.3 Liste complète des providers (2026-08)
Tous avec Base URL préconfigurée — seulement la clé API (ou variable d'environnement) :
| Nom | Protocole | Modèles / usage | Variable d'environnement |
|---|---|---|---|
anthropic | anthropic | Claude Opus / Sonnet | ANTHROPIC_API_KEY |
openai | openai | GPT-5.x / o-series | OPENAI_API_KEY |
dashscope | openai | Série Qwen | DASHSCOPE_API_KEY |
deepseek | openai | DeepSeek V3, etc. | DEEPSEEK_API_KEY |
kimi | openai | Moonshot Kimi | MOONSHOT_API_KEY |
z-ai | openai | Zhipu GLM | Z_AI_API_KEY |
volcengine | openai | Volcano Ark | ARK_API_KEY |
baidu-qianfan | openai | Ernie Qianfan | QIANFAN_API_KEY |
Aussi dashscope-tokenplan, tencent-tokenhub, hy-tokenplan, mimo, minimax, etc. | |||
Config : ~/.opencodereview/config.json ; override ponctuel : ocr review --model claude-sonnet-4-6 sans modifier le fichier.
3. Claude, GPT, Gemini : trois chemins de configuration détaillés
3.1 Claude (chemin le plus fluide pour OCR)
Claude utilise le protocole Anthropic natif, pas une couche compatible OpenAI — appels d'outils et Messages API les plus stables ; combinaison la plus validée en production Alibaba.
# Interactif (recommandé)
ocr config provider
# choisir anthropic → ANTHROPIC_API_KEY → claude-opus-4-6
# CI non interactif
ocr config set provider anthropic
ocr config set model claude-sonnet-4-6
ocr config set providers.anthropic.api_key "$ANTHROPIC_API_KEY"
ocr llm test
Réutiliser l'environnement Claude Code : si ANTHROPIC_AUTH_TOKEN / ANTHROPIC_BASE_URL sont exportés, OCR les reprend. Avec le plugin Claude Code, mêmes règles de revue via slash command dans l'IDE.
Conseil : gate avant merge PR → Sonnet (coût) ; modules sécurité/concurrence/finance → Opus ; désactiver thinking économise des tokens : ocr config set providers.anthropic.extra_body '{"thinking":{"type":"disabled"}}'.
3.2 GPT (voie OpenAI officielle)
ocr config set provider openai
ocr config set model gpt-5.2
ocr config set providers.openai.api_key "$OPENAI_API_KEY"
ocr review --from origin/main --to HEAD
GPT convient aux équipes centralisées sur OpenAI Platform ou l'écosystème Copilot. OCR normalise les URLs OpenAI ; Azure OpenAI via custom_providers avec endpoint de déploiement.
Vs Claude dans la même pipeline OCR : différence surtout dans le style d'inférence (GPT plus conventions, Claude plus cas limites) — même jeu d'outils.
3.3 Gemini (provider personnalisé, non intégré)
Google absent des presets, mais API Gemini avec compatibilité OpenAI :
ocr config set provider gemini-google
ocr config set custom_providers.gemini-google.url https://generativelanguage.googleapis.com/v1beta/openai/
ocr config set custom_providers.gemini-google.protocol openai
ocr config set custom_providers.gemini-google.model gemini-2.5-pro
ocr config set custom_providers.gemini-google.api_key "$GEMINI_API_KEY"
ocr config set custom_providers.gemini-google.models "gemini-2.5-pro,gemini-2.5-flash,gemini-2.0-flash"
ocr llm test
Pour gros monorepos, avantage théorique du contexte million de tokens — mais OCR bundle et shard lui-même ; la plupart des PR n'ont pas besoin du contexte max. Raison pragmatique : contrat GCP/Vertex, facture regroupée sur GCP. Vertex entreprise : url vers endpoint régional, protocol reste openai. Plus sur Gemini : Gemini 3.5 Pro — fonctions, prix, release.
4. Claude vs GPT vs Gemini : cinq dimensions (dans OCR)
| Famille | Entrée / protocole | Capacités dans OCR | Contexte / coût | Conformité | Public cible |
|---|---|---|---|---|---|
| Claude | Intégré anthropic ; délégation Claude Code |
Appels d'outils les plus stables ; plugin/Skill | Opus cher, moins d'omissions ; ~9× moins de tokens vs Agent nu | Conformité Anthropic ; URL Bedrock custom | Qualité revue par défaut ; abonnement Claude Code |
| GPT | Intégré openai |
Même pipeline ; o-series lent mais profond | Prix API selon modèle ; crédits Team pas directement dans OCR | Politique données OpenAI ; Azure privé | Stratégie fournisseur unique OpenAI |
| Gemini | Endpoint openai personnalisé |
Complet ; tester avec ocr llm test |
Flash bon marché pour CI massif ; Pro pour chemins critiques | GCP / Vertex IAM | Contrat Google ; long fichier unique ocr scan |
Comparaison horizontale Agents (écriture, pas revue) : GPT-5.6 vs Claude & Gemini — guide de choix. Là c'est écrire du code ; ici revue — structure de coût totalement différente.
5. Delegation Mode : voie « zéro clé API OCR » pour Open Code Review Claude
Pas d'achat API revue séparé ou interdiction de clés OCR en prod — Delegation Mode :
ocr delegate preview
ocr delegate rule src/handler.go src/handler_test.go
# OCR sort règles + liste fichiers → coller à Claude Code / Cursor Agent
Dans ce mode :
- OCR fait les étapes déterministes : sélection fichiers, règles (NPE, thread-safety, injection SQL, etc.), paquet de tâches de revue.
- Inférence LLM par Claude Code, Codex, Cursor — abonnement ou quota Agent existant.
- Plugin Claude Code, Codex Skill, Cursor Skill — slash command.
Chemin le plus court pour « Open Code Review Claude » : règles OCR, facture modèle via Claude Code Pro/Max. Inconvénient : pas de CI OCR non supervisé avec modèle propre (sauf Agent aussi sur le runner CI).
6. Matrice de scénarios
| Scénario | Recommandation | Pourquoi | À éviter |
|---|---|---|---|
| Développeur solo, Claude Pro | Délégation + plugin Claude Code | Zéro coût API OCR ; plus stable que /code-review nu |
Deuxième clé API Anthropic |
| Gate PR équipe (GitHub Actions) | OCR + API Claude Sonnet | Scriptable, parallèle, tokens maîtrisés | Délégation (pas d'Agent interactif en CI) |
| OSS, contributeurs mondiaux | OCR + GPT-5 mini / Flash | Pas cher, commentaires anglais suffisants | Opus par défaut (trop cher) |
| Finance / sécurité sensible | Claude Opus + ocr scan |
Haute Precision ; audit complet | Diff superficiel seulement |
| Contrat entreprise GCP | Gemini custom + Vertex | Facture GCP ; IAM unifié | Forcer un contrat Anthropic |
| Intranet sans API externe | dashscope / deepseek intégrés | Endpoints domestiques préconfigurés | api.anthropic.com direct |
7. Stacks recommandés
【Stack A — Solo · abonné Claude】
Revue : plugin OCR Claude Code + Delegation Mode
Code : Claude Code CLI (Sonnet par défaut)
Déclencheur : pre-push local → ocr delegate preview
Upgrade : gros PR → ocr review --model claude-opus-4-6 (API ponctuelle)
【Stack B — équipe 10 · API centralisée】
Revue : GitHub Action ocr review (Sonnet)
Code : Cursor + Claude Code en parallèle
Modèle : ANTHROPIC_API_KEY org ; pas de clés perso en CI
Règles : .ocr/rules filtre chemins
【Stack C — multi-cloud · coût】
PR quotidiennes : GPT-5 mini (openai)
Vendredi sécurité : Gemini 2.5 Pro (custom)
Branche release : Claude Opus
Bascule : ocr review --model <name> ponctuel
【Stack D — runner CI Mac cloud】
Exécution : kvmboot Mac cloud M4 permanent
Revue : ocr review --from main --to $PR_BRANCH
Environnement : xcodebuild sur la même machine
Voir : article double Agent Mac cloud sur kvmboot
Abonnement Claude Code vs délégation : Claude Code 2026 — tarifs et forfaits ; Skills : classement Claude Code Skills 2026 (/code-review et OCR se complètent — OCR spécialisé, Skill général).
8. Idées reçues
- Erreur 1 : OCR = Claude seulement. OpenAI et bien d'autres sont intégrés ; Claude est la reco par défaut, pas l'unique choix.
- Erreur 2 : Gemini impossible. Si —
custom_providers+ protocole OpenAI ; juste pas de preset en un clic. - Erreur 3 : modèle plus fort = zéro faux positif. La Precision vient de la pipeline ; Opus nu peut être pire qu'OCR+Sonnet.
- Erreur 4 : délégation = identique à ocr review. Même filtrage de règles ; délégation dépend de la session Agent — CI veut le mode API.
- Erreur 5 : ChatGPT Plus suffit pour OCR. Plus = chat ; OCR veut une clé API (OpenAI Platform) ou délégation Codex/Agent.
- Erreur 6 : langue de revue = langue du modèle. Langue via
ocr config set language français— indépendant du provider.
9. Mise en œuvre en 7 étapes
- Installer OCR :
npm install -g @alibaba-group/open-code-review, vérifierocr --versionet Git ≥ 2.41. - Choisir la voie de facturation : abonnement Claude Code → tester délégation ; gate CI → clé API.
- Configurer le provider :
ocr config provideranthropic / openai / Gemini custom ;ocr llm testdoit passer. - Smoke test local : vrai dépôt
ocr review, commentaires alignés au diff. - Plugin Agent (optionnel) : plugin OCR Claude Code / Cursor, slash command unifié.
- Brancher la CI : doc CI/CD officielle, trigger PR ;
--modelquotidien vs sécurité. - Revue mensuelle : facture API vs triage faux positifs ; ajuster le palier modèle, pas Opus aveuglément.
Revue et build sur une même pipeline : OCR avec xcodebuild sur le même nœud Mac cloud — pas d'attente d'un second runner.
10. FAQ
Open Code Review prend Claude en charge ?
Oui. anthropic est intégré, Messages API native ; Opus/Sonnet ; plugin Claude Code + délégation pour réutiliser l'abonnement.
GPT / OpenAI ?
Oui, provider openai intégré avec OPENAI_API_KEY ; Azure OpenAI par URL custom.
Gemini ?
Pas de preset — custom_providers vers l'endpoint compatible OpenAI de Google ; Vertex entreprise idem.
Différence avec /code-review de Claude Code ?
Même modèle : OCR économise tokens, lignes plus précises, moins de faux positifs ; Skill plus flexible, plus variable. Les deux combinables : OCR en gate CI, Skill en local.
Sans clé API ?
Oui — ocr delegate vers Claude Code / Cursor ; OCR garde fichiers et règles.
Changer de modèle une fois ?
ocr review --model claude-opus-4-6 — sans toucher config.json.
11. Synthèse
Quelles IA Open Code Review prend en charge ? — Claude et GPT prêts à l'emploi, plus Qwen, DeepSeek, Kimi, etc. ; Gemini via voie OpenAI compatible custom ; Delegation Mode confie le modèle à Claude Code / Cursor — « Open Code Review Claude » sans clé en double.
Ne vous perdez pas dans « quel modèle est le plus fort » — dans OCR, la pipeline compte plus que le nom du modèle. D'abord la voie de facturation (API vs délégation), puis le palier scénario (Sonnet quotidien / Opus gate / Flash économie), puis affiner le provider. Claude, GPT et Gemini deviennent des moteurs interchangeables, pas trois réinventions.
OCR + build en CI — un Mac cloud suffit
Après ocr review sur une PR viennent souvent xcodebuild, signature ou tests d'intégration — séparer runners revue et build, et les tokens économisés partent en files d'attente. kvmboot Mac cloud mini M4 comme nœud unique : revue et build iOS/macOS sur la même machine, mémoire unifiée Apple Silicon pour workers de revue parallèles, macOS natif sans WSL ; 7×24 pour GitHub Actions self-hosted ou scans launchd.
Commencez par une location journalière « OCR → build → test », puis mensuelle. kvmboot Mac cloud est le plan d'exécution rentable pour Open Code Review + toolchain Apple — voir les forfaits et validez sur place les résultats Claude / GPT / Gemini.