1Password CLI

어떤 작업에 사용하는가

1Password CLI의 실행 명령은 op입니다. API 키나 데이터베이스 비밀번호를 이미 1Password에 보관하는 개발자, 반복적인 계정 관리 작업을 처리하는 운영 담당자에게 적합합니다. 스크립트에 비밀번호를 직접 적는 대신 금고의 항목을 가리키는 참조를 사용하고, 실행 시 필요한 값을 가져오는 방식입니다.

항목 관리와 비밀정보 전달 외에도 사용자 초대와 권한 설정을 자동화할 수 있습니다. 조직 관리 명령은 해당 계정의 권한과 기능 범위 안에서 사용해야 합니다. [공식 제품 소개](https://1password.com/developers/cli)

지원 OS와 버전 검토

2026-10-07 확인 기준 공식 안정판은 2026-10-01에 출시된 2.40.0입니다. macOS용 범용 PKG와 Intel·Apple silicon용 ZIP이 제공되며, Windows·Linux·FreeBSD·OpenBSD 배포 파일도 있습니다. 따라서 제품 자체가 macOS 전용인 것은 아닙니다.

Mac 시작 문서는 macOS Big Sur 11.0.0 이상과 Bash·Zsh·sh·fish를 안내합니다. 앱 연동에 사용하는 데스크톱 앱의 요구사항도 별도로 확인해야 합니다. 구형 CLI 1은 2024-10-01 사용 중단 공지가 있으므로 기존 스크립트의 버전 검토가 필요합니다. [CLI 2 배포 기록](https://app-updates.agilebits.com/product_history/CLI2), [CLI 1 중단 공지](https://app-updates.agilebits.com/product_history/CLI)

Mac 설치와 첫 작업 순서

먼저 1Password 구독 계정과 Mac 앱을 준비합니다. 공식 문서의 Homebrew 명령 brew install 1password-cli를 사용하거나 공식 배포 페이지의 PKG를 선택한 뒤, op --version으로 설치된 버전을 확인합니다.

Mac 앱을 열고 잠금을 해제한 다음 Settings > Developer에서 Integrate with 1Password CLI를 켭니다. 지문 인증을 원하면 앱의 Touch ID도 설정합니다. 이후 op vault list를 실행해 인증하고 접근 가능한 금고 목록을 확인합니다. 여러 계정이 등록되어 있다면 op signin으로 사용할 계정을 선택합니다. [설치 및 시작 안내](https://www.1password.dev/cli/get-started)

실무 예시: 개발 서버에 API 키 전달

예를 들어 Development 금고의 Blog API 항목에 token 필드를 보관하고, app.env에는 API_TOKEN=op://Development/Blog API/token처럼 실제 키 대신 참조를 적습니다. 이후 op run --env-file=./app.env -- npm run dev로 개발 서버를 시작하면 실행 프로세스에 실제 토큰이 환경변수로 전달됩니다. 실제 프로젝트에서는 앱에서 복사한 참조를 사용하는 편이 정확합니다.

키를 교체해도 참조 경로가 유지되면 코드에 새 키를 다시 적을 필요가 없습니다. 다만 실행된 앱은 비밀 값을 받으므로 로그 출력과 디버깅 설정을 점검해야 합니다. 2.40.0 배포 기록도 출력 마스킹이 완전한 은닉을 보장하지 않는다고 명시합니다. [환경변수 전달 안내](https://www.1password.dev/cli/secrets-environment-variables), [보안 변경사항](https://app-updates.agilebits.com/product_history/CLI2)

무료 체험과 유료 조건

CLI 시작 문서는 1Password 구독을 요구하며, 개인 요금제에는 CLI를 포함한 개발자 도구가 안내되어 있습니다. 무료 다운로드를 영구 무료 계정 이용으로 해석하면 안 됩니다. Individual과 Families는 14일 무료 체험을 제공합니다.

확인 당시 USD 연간 결제 화면의 Individual 정상가는 월 환산 3.99달러, 신규 고객 첫해 프로모션은 2.99달러입니다. 프로모션은 1Password.com 직접 구독에 적용되며 외부 앱스토어 구매에는 적용되지 않습니다. 서비스 계정에는 요청 제한이 있고 기본 Personal·Private·Employee 및 기본 Shared 금고에 접근을 부여할 수 없습니다. [개인 요금 안내](https://1password.com/pricing/personal), [서비스 계정 제약](https://www.1password.dev/service-accounts/get-started)

문제가 생겼을 때 확인 순서

op 명령을 찾지 못하면 실행 파일 위치와 PATH, op --version부터 확인합니다. 계정이 표시되지 않으면 해당 계정이 Mac 앱에 추가되어 있는지 확인합니다. 연결 오류나 No accounts configured가 나타나면 앱 잠금 해제, CLI 연동 설정, 메뉴 막대 상주 설정 순서로 점검하고 앱을 다시 시작합니다. connectionreset 오류에서는 macOS의 1Password 백그라운드 실행 허용도 확인합니다.

항목을 읽지 못하면 선택한 계정, 금고 접근 권한, 참조의 금고·항목·필드 이름을 차례로 확인합니다. 서비스 계정이라면 허용된 금고와 읽기 권한 범위도 확인해야 합니다. [앱 연동 문제 해결](https://www.1password.dev/cli/app-integration)

다른 도구와 선택 기준

브라우저 로그인과 수동 조회가 주된 작업이라면 1Password 앱과 확장 프로그램을 먼저 고려할 수 있습니다. 기존 셸 스크립트에 비밀정보를 연결하려면 CLI, 애플리케이션 코드에 통합하려면 공식 SDK 문서를 검토하는 방식이 적절합니다.

무인 서버나 CI에서는 대화형 Touch ID 흐름보다 접근 범위를 제한한 서비스 계정을 검토합니다. 자체 인프라에 비밀정보 접근 서비스를 배치해야 한다면 1Password Connect Server가 비교 대상입니다. 선택 기준은 기존 금고 활용 여부, 실행 환경, 필요한 권한 범위와 별도 서비스 운영 부담입니다. [공식 도구 연계 안내](https://www.1password.dev/cli)

공식 안내

• Command Line Interface for Developers | 1Password · 확인 2026-10-07
• 1Password CLI · 확인 2026-10-07
• Get started with 1Password CLI · 확인 2026-10-07
• 1Password CLI Release Notes · 확인 2026-10-07
• Load secrets into the environment · 확인 2026-10-07
• Password Manager Pricing for Individuals & Families | 1Password · 확인 2026-10-07
• Get started with 1Password Service Accounts · 확인 2026-10-07
• Use the 1Password desktop app to sign in to 1Password CLI · 확인 2026-10-07
• 1Password CLI 1 Release Notes · 확인 2026-10-07