---
title: インストール
sidebar:
  order: 4
---

`ocr` CLI をインストールするには、サポートされた 6 つの方法があります。

## NPM（推奨）

#### インストール

```bash
npm install -g @alibaba-group/open-code-review
```

特定のバージョンに固定：

```bash
npm install -g @alibaba-group/open-code-review@<version>
```

#### 更新

NPM 経由でインストールした場合、`ocr` はデフォルトで自動的に最新の状態を保ちます
（静的バイナリはこのメカニズムの対象外です）。`ocr` を実行するたびに、wrapper は
バックグラウンドで registry の最新バージョンを静かにチェックし、更新が見つかると
今回のレビューに影響を与えることなく自動的にアップグレードします。チェックの間には
18 分のクールダウンがあり、`OCR_UPDATE_INTERVAL`（分）で調整できます。

自動更新をオフにするには、`OCR_NO_UPDATE` に空でない任意の値を設定します。

```bash
export OCR_NO_UPDATE=1
```

#### アンインストール

```bash
npm uninstall -g @alibaba-group/open-code-review
```

## Homebrew（macOS / Linux）

```bash
brew install open-code-review
```

この formula はソースからビルドして `ocr` バイナリをインストールします。

後でアップグレードするには：

```bash
brew upgrade open-code-review
```

## MacPorts（macOS）

```bash
sudo port install open-code-review
```

この port はソースからビルドして `ocr` バイナリをインストールします。

後でアップグレードするには：

```bash
sudo port upgrade open-code-review
```

## インストールスクリプト（curl | sh）

GitHub Release バイナリのダウンロード（検証付き）をラップした便利なインストーラーです——CI のベース
イメージやヘッドレス環境に適しています。

```bash
curl -fsSL https://open-codereview.ai/install.sh | sh
```

2 つの環境変数を認識します。

| 変数 | デフォルト値 | 用途 |
|---|---|---|
| `OCR_INSTALL_DIR` | `/usr/local/bin` | `ocr` バイナリを配置する場所。 |
| `OCR_VERSION` | 最新 release | 特定の release tag に固定します（例：`v1.2.3`）。 |

このスクリプトは `darwin` と `linux` の `amd64` / `arm64` をサポートします。

Windows（PowerShell 5.1+）では、代わりに PowerShell インストーラーを使用してください：

```powershell
irm https://open-codereview.ai/install.ps1 | iex
```

同じ `OCR_INSTALL_DIR` と `OCR_VERSION` を認識します（`$env:OCR_INSTALL_DIR` /
`$env:OCR_VERSION` で設定）。デフォルトのインストール先は
`%LOCALAPPDATA%\Programs\ocr` です。

## GitHub Release バイナリ

Node.js をインストールしたくない場合は、
[releases ページ](https://github.com/alibaba/open-code-review/releases) から
静的バイナリを直接取得できます。

```bash
# macOS (Apple Silicon)
curl -Lo ocr https://github.com/alibaba/open-code-review/releases/latest/download/opencodereview-darwin-arm64
chmod +x ocr && sudo mv ocr /usr/local/bin/ocr

# macOS (Intel)
curl -Lo ocr https://github.com/alibaba/open-code-review/releases/latest/download/opencodereview-darwin-amd64
chmod +x ocr && sudo mv ocr /usr/local/bin/ocr

# Linux x86_64
curl -Lo ocr https://github.com/alibaba/open-code-review/releases/latest/download/opencodereview-linux-amd64
chmod +x ocr && sudo mv ocr /usr/local/bin/ocr

# Linux ARM64
curl -Lo ocr https://github.com/alibaba/open-code-review/releases/latest/download/opencodereview-linux-arm64
chmod +x ocr && sudo mv ocr /usr/local/bin/ocr

# Windows (AMD64)
curl -Lo ocr.exe https://github.com/alibaba/open-code-review/releases/latest/download/opencodereview-windows-amd64.exe

# Windows (ARM64)
curl -Lo ocr.exe https://github.com/alibaba/open-code-review/releases/latest/download/opencodereview-windows-arm64.exe
```

各 release では、バイナリの隣に `sha256sum.txt` も公開されており、完全性を検証できます。

```bash
curl -LO https://github.com/alibaba/open-code-review/releases/latest/download/sha256sum.txt
shasum -a 256 -c sha256sum.txt --ignore-missing
```

## ソースからビルドする

OCR 自体を変更する場合、またはプリコンパイル済みバイナリのないプラットフォームで実行する場合にのみ、この方法が必要です。

#### 前提条件

- [Go ≥ 1.25](https://go.dev/dl/)
- [Git](https://git-scm.com/)
- [Make](https://www.gnu.org/software/make/)

#### ビルド

```bash
git clone https://github.com/alibaba/open-code-review.git
cd open-code-review
make build              # dist/opencodereview を生成
sudo cp dist/opencodereview /usr/local/bin/ocr
```

#### 他のプラットフォーム向けにビルドする

```bash
make build-linux-amd64
make build-linux-arm64
make build-darwin-amd64
make build-darwin-arm64
make build-windows-amd64   # Windows (x86_64)
make build-windows-arm64   # Windows (ARM64)
make build-all          # 6 つすべてを一括ビルド
make sha256sum          # sha256sum.txt も生成
```

`make dist` は `clean → build-all → sha256sum` を実行し、バイナリの隣に
`VERSION` ファイルを書き込みます——これはまさに release パイプラインが実行するステップです。

#### テストの実行

```bash
make test               # LC_ALL=C go test -v -race -count=1 ./...
```

## インストールの検証

バイナリがどこから来たものであっても：

```bash
ocr version             # バージョン + git commit + ビルド日時を出力
ocr --help              # トップレベルの使い方
ocr review --help       # review コマンドの完全な引数リスト
```

"command not found" エラーが出る場合は、インストール先が `$PATH` 上にあることを確認してください。

```bash
which ocr
echo $PATH
```

## シェル補完を有効にする（任意）

`ocr` は bash、zsh、fish、PowerShell の Tab 補完に対応しています。

```bash
# bash
source <(ocr completion bash)

# zsh
ocr completion zsh > "${fpath[1]}/_ocr"
```

fish、PowerShell、および永続化の詳しい設定方法は [CLI リファレンス](./cli-reference.md#ocr-completion) を参照してください。


## OCR が状態を保存する場所

| パス | 保存内容 |
|---|---|
| `~/.opencodereview/config.json` | LLM エンドポイント、言語、テレメトリ設定（`ocr config set` で管理）。 |
| `~/.opencodereview/rule.json` | オプションのグローバルレビュールール。 |
| `~/.opencodereview/sessions/<encoded-repo-path>/<session-id>.jsonl` | レビューセッションごとのストリーミング JSONL トランスクリプト。`ocr viewer` で使用します。 |
| `~/.opencodereview/{last-update-check,update.lock,update-available}` | NPM wrapper のバックグラウンド更新チェックの状態。wrapper はより新しい release があるかをポーリングし（デフォルトで約 18 分ごと）、アップグレードの案内を表示します。`OCR_NO_UPDATE=1` で無効化するか、`OCR_UPDATE_INTERVAL`（分）で間隔を調整します。静的バイナリはこれらのファイルを書き込みません。 |
| `<repo>/.opencodereview/rule.json` | オプションのプロジェクトレベルのレビュールール——安全にコミットできます。 |

OCR は `~/.opencodereview/` の外に書き込むことは決してありません（NPM が一時的にバイナリをダウンロードする場合を除く）。
このディレクトリを削除すれば、クリーンなアンインストールが完了します。

## 関連項目

- [クイックスタート](../quickstart/)——LLM を設定して初回のレビューを完了します。
- [設定](../configuration/)——OCR が受け入れる各環境変数と config key。
- [コントリビュート](../contributing/)——ソースからビルドし、テストを実行して開発に参加します。
