# 1Password CLI

ターミナルから1Passwordの保管庫とシークレットにアクセスし、コマンドに認証情報を注入し、スコープ付きサービスアカウントで自動化できます。

> これは OpenNavo の 1Password CLI ページの Markdown 版で、内容はウェブページと同じです： <https://opennavo.com/ja/apps/1password-cli>

- **最新バージョン**: `2.42.0`
- **開発元**: 1Password (AgileBits Inc.)
- **ホームページ**: <https://developer.1password.com/docs/cli>
- **カテゴリ**: [セキュリティとプライバシー](https://opennavo.com/ja/categories/security)
- **インストール**: `brew install --cask 1password-cli`
- **過去 30 日間のインストール数**: 27,273
- **Homebrew**: インストール可能、Homebrew で更新
- **ダウンロードURL**: <https://cache.agilebits.com/dist/1P/op2/pkg/v2.42.0/op_darwin_arm64_v2.42.0.zip>
- **SHA-256**: `216e86c6db491c752ccb7819b3b1851cc8456ea015a1f7c8a58dd103ef0a474e`
- **付属コマンド**: op

SHA-256 はダウンロードしたファイルが完全かを確かめるためのもので、安全性の認証ではありません。

## インストールとアンインストールの内容

```json
[
  {
    "declaration": {
      "binary": [
        "op"
      ],
      "target": "$HOMEBREW_PREFIX/bin/op"
    },
    "phase": "install",
    "sources": [
      "op"
    ],
    "target": "$HOMEBREW_PREFIX/bin/op",
    "type": "binary"
  },
  {
    "declaration": {
      "generate_completions_from_executable": [
        "op",
        "completion",
        {
          "base_name": null,
          "shell_parameter_format": null,
          "shells": [
            "bash",
            "zsh",
            "fish"
          ]
        }
      ]
    },
    "phase": "install",
    "sources": [
      "op",
      "completion"
    ],
    "type": "generate_completions_from_executable"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": "~/.config/op"
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## 紹介

1Password CLI は、1Password の Vault と開発者向けシークレットをターミナルにもたらします。`op` コマンドは、スクリプトに認証情報をハードコーディングすることなく、制御された認証情報へのアクセスを必要とする開発者、管理者、自動化を対象としています。

### 主な機能
- コマンドライン コマンドを使用して Vault とアイテムを検索および管理します。
- `op://` 参照を通じてシークレットを読み取り、`op run` で子プロセスに読み込むか、`op inject` で構成テンプレートに代入します。
- 1Password デスクトップ アプリを通じて認証します（サポートされている生体認証を含む）。または、ヘッドレス自動化のために、選択した Vault または Environments にスコープされたサービス アカウント トークンを使用します。
- Bash、Zsh、Fish 用のシェル補完を生成します。別個の 1Password Shell Plugins が、サポートされているサードパーティ開発ツールとの認証を統合します。

### インストールと初回使用
macOS では、`brew install --cask 1password-cli` でこの Homebrew cask をインストールし、`op --version` を確認します。Homebrew は `op` を自身のバイナリ ディレクトリにリンクし、シェル補完を生成します。デスクトップ認証では、1Password デスクトップ アプリをインストールしてサインインし、Settings → Developer → Integrate with 1Password CLI を有効にしてから、`op vault list` を試します。複数のアカウントがある場合、`op signin` でアカウントを選択します。サービス アカウントは、共有ビルドおよびヘッドレス サーバー向けの推奨される代替手段です。自動化に必要なアクセスのみを構成してください。

### システム、依存関係、競合
公式の macOS 入門ガイドでは、macOS Big Sur 11 以降と Bash、Zsh、sh、Fish を指定しています。公式ダウンロードは Apple Silicon および Intel Mac をサポートします。Windows および Linux ビルドは別途提供されています。Windows のドキュメントでは PowerShell を使用します。Linux デスクトップ統合には、1Password for Linux、PolKit、および実行中の PolKit 認証エージェントが必要です。デスクトップ アプリ統合には、対応するインストール済みの 1Password アプリと、資格のあるサインイン済みアカウントが必要です。これはサービス アカウント認証とは異なります。このカタログ エントリは、デスクトップ アプリではなく macOS CLI をインストールします。Homebrew は、この cask に対して追加の formula 依存関係を宣言しておらず、`1password-cli@1` および `1password-cli@beta` との競合を宣言しています。これらの代替 cask も `op` を提供するため、これと併せてインストールしないでください。

### アカウント、費用、ライセンス
個人用 Vault を使用するには、1Password アカウントとサブスクリプションが必要です。サービス アカウント アクセスは、アカウントで利用可能な機能と権限によって異なります。サブスクリプション プラン、トライアル、およびビジネス条件は 1Password によって定義されます。CLI は、1Password の適用される条件の下で配布されるプロプライエタリ ソフトウェアです。別個のオープンソース Shell Plugins プロジェクトは、完全な CLI のライセンスを規定するものではありません。完全な CLI の公開ソース リポジトリは確認されていません。

`op run` の出力マスキングはベスト エフォートであり、シークレットが隠蔽されることを保証しません。シークレットのログ記録や、生成されたシークレットを含むファイルのコミットは避けてください。

公式リファレンス: [CLI の概要](https://www.1password.dev/cli)、[はじめに](https://www.1password.dev/cli/get-started)、[リリース ノート](https://releases.1password.com/developers/cli/)、および[利用規約](https://1password.com/legal/terms-of-service)。

## システム要件

- macOS 27, 26, 15, 14, 13, 12, 11 向けのビルド · アプリのバージョン: 2.42.0 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/1/1password-cli.rb> · 2026-11-22 に確認
  - <https://cache.agilebits.com/dist/1P/op2/pkg/v2.42.0/op_darwin_amd64_v2.42.0.zip>
  - SHA-256: `917b0d2b41de3d943bb6562331275c43c4b525af6b003eade06248905ddd62b0`
- macOS 27, 26, 15, 14, 13, 12, 11 向けのビルド · アプリのバージョン: 2.42.0 · Apple シリコン · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/1/1password-cli.rb> · 2026-11-22 に確認
  - <https://cache.agilebits.com/dist/1P/op2/pkg/v2.42.0/op_darwin_arm64_v2.42.0.zip>
  - SHA-256: `216e86c6db491c752ccb7819b3b1851cc8456ea015a1f7c8a58dd103ef0a474e`

## アンインストール

- `brew uninstall --cask 1password-cli`

通常のアンインストールではアプリ本体だけを削除し、設定とキャッシュは残ります。

### 完全な削除（任意）

- `brew uninstall --zap --cask 1password-cli`

`--zap` は Homebrew の定義に記載された設定やキャッシュなどのファイルも削除します。ほかのアプリと共有しているデータが含まれる場合があり、削除すると元に戻せません。何も残らないことを保証するものでもありません。残しておきたいデータは先にバックアップしてください。設定とキャッシュを残す場合は、`--zap` を付けないでください。

通常のアンインストールではアプリ本体だけを削除し、設定とキャッシュは残ります。

- ファイルとフォルダ: `~/.config/op` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/1/1password-cli.rb> · 以上の項目は Homebrew の定義に基づくもので、2026-11-22 に確認しました。定義で削除対象と宣言されている内容を示すだけで、お使いの Mac にすべてがあるとは限りません。

## 最新バージョンのリリースノート

### 2.42.0 (2026-11-03)

1Password CLI 2.42.0 が 2026-11-03 にリリースされ、正式提供となった `op environment secret list` コマンドと新しいシェルプラグイン群が追加されました。

- `op environment secret list` が正式提供となりました。1Password Environment 内の各シークレットの名前と値、および各シークレットが隠されているかどうかを一覧表示します。
- 新しいシェルプラグインにより、Stackhero CLI、npm と pnpm、Octopus Deploy CLI、Doppler CLI、CockroachDB CLI（`cockroach sql`）、LocalXpose CLI（`loclx`）、MotherDuck と組み合わせた DuckDB CLI、Postman CLI、Spacelift CLI（`spacectl`）、Netlify CLI、xAI Grok CLI、OpenBao CLI（`bao`）で Touch ID などのロック解除オプションが使えるようになりました。
- Argo CD プラグインは、`argocd` の対象がアイテムの Address に保存されたサーバーである場合にのみ認証情報を提供するようになったため、`--argocd-context` と `--server` はプラグインなしの場合と同じ動作になります。
- Akamai プラグインと Pipedream プラグインは、改行を含む認証情報の値を生成する設定ファイルに書き込みません。
- Sourcegraph プラグインは現在の `sgp_` トークン形式に対応し、Endpoint フィールドが必須になりました。
- Hugging Face プラグインは `huggingface-cli` ではなく `hf` コマンドを使用します。`op plugin init hf` を実行し、古いエイリアスを削除してください。
- LocalStack プラグインは、非推奨の `LOCALSTACK_API_KEY` ではなく `LOCALSTACK_AUTH_TOKEN` を使用します。
- `op item get`、`op read`、`op run`、`op inject` は、住所の一部（番地や国など）が空の場合でも、その address フィールドの値を返すようになりました。
- MySQL プラグインは `my.cnf` に書き込む値を引用符で囲みエスケープするため、`#`、バックスラッシュ、前後の空白を含むパスワードでも正しく認証されます。
- OpenTofu プラグインは Terraform プラグインと同様に、`tofu workspace` コマンドに認証情報を提供します。
- AWS プラグインは、MFA を有効にしたプロファイルが `source_profile` 経由でロールを引き受ける際に「Cannot call GetSessionToken with session credentials」で失敗しなくなりました。

[公式リリースノート](https://app-updates.agilebits.com/product_history/CLI2)

## 情報と出典

- <https://opennavo.com/ja/apps/1password-cli>
- <https://opennavo.com/ja/apps/1password-cli/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/1/1password-cli.rb> · 2026-11-22 に確認
- <https://formulae.brew.sh/cask/1password-cli>
