sbx secret import

sbx secret import

sbx가 호스트 환경 변수에서 감지한 시크릿을 전역 키체인으로 가져오는 명령이에요. 한 번 가져오면 매 셸마다 환경 변수를 설정하지 않아도 모든 샌드박스에서 시크릿을 쓸 수 있어요.

출처: 문서

본문

sbx가 호스트 환경 변수(예: OPENAI_API_KEY, ANTHROPIC_API_KEY, GH_TOKEN)에서 감지한 시크릿을 전역 키체인으로 가져와요. 가져오면 시크릿이 모든 샌드박스에서 사용 가능해져서 매 셸마다 환경 변수를 설정하지 않아도 돼요.

감지된 각 환경 변수는 Y/n 프롬프트와 값의 마지막 4글자 미리보기로 대화형으로 제안돼요. 기존 저장 항목은 조용히 덮어쓰지 않아요:

  • 대화형 모드는 덮어쓰기 전에 확인을 요청해요.
  • --all은 프롬프트 없이 새 항목을 가져오지만 덮어쓰기는 건너뛰어요(저장 값을 실제로 교체하고 싶으면 --force를 쓰세요).
  • --force는 덮어쓰기까지 포함해 무조건 가져와요.

이미 OAuth 토큰이 구성된 서비스(예: sbx run claude … -- auth login 이후의 anthropic)는 건너뛰어요. 런타임에 OAuth 토큰이 우선하므로 api-key import는 절대 사용되지 않아요. OAuth에서 api-key 인증으로 전환하고 싶으면 먼저 sbx secret rm <service>를 실행하세요.

사용 가능한 서비스: anthropic, copilot, cursor, devin, droid, github, google, groq, mistral, nebius, openai, openrouter, xai

Options

| Option | Default | Description | | --all | | 프롬프트 없이 감지된 모든 환경 변수를 가져와요 | | --dry-run | | 쓰지 않고 무엇이 가져와질지 보여줘요 | | -f, --force | | 확인 없이 기존 저장 항목을 덮어써요 |

Global options

| Option | Default | Description | | --cloud | | 로컬 sandboxd 대신 Docker Cloud Sandboxes API로 디스패치해요 | | -D, --debug | | 디버그 로깅을 활성화해요 |

Examples

# 감지된 각 환경 변수를 순회하며 가져오기 전에 프롬프트
sbx secret import

# openai 서비스만 가져오기 (OPENAI_API_KEY 사용)
sbx secret import openai

# 비대화형: 프롬프트 없이 감지된 모든 것을 가져오기
sbx secret import --all

# 확인 없이 기존 저장 항목 덮어쓰기
sbx secret import openai --force

# 쓰지 않고 가져올 내용 미리보기
sbx secret import --dry-run

더 알아보기 (Learn more)