도움말

환경 변수 백업 복원하기

HaryAI Switch의 "셸 설정에서 제거" 버튼이 export를 삭제하기 전에 JSON 백업을 저장합니다. 해당 export를 복원하고 싶다면 백업을 읽고 직접 되돌리는 방법을 안내해 드립니다.

백업 저장 위치

fixer를 실행할 때마다 앱의 데이터 디렉터리 아래에 새 파일이 생성됩니다:

macOS~/Library/Application Support/HongqiaoSwitch/env-backups/

Windows%APPDATA%\HongqiaoSwitch\env-backups\

파일 이름에 타임스탬프가 포함됩니다, 예: env-backup-20260518_124530.json.

파일 안에 무엇이 있나요

각 백업은 일반 JSON입니다. conflicts 배열에 삭제된 모든 항목이 나열돼 있습니다:

{
  "backupPath": "...",
  "timestamp": "20260518_124530",
  "conflicts": [
    {
      "varName": "ANTHROPIC_BASE_URL",
      "varValue": "http://example.test",
      "sourceType": "file",
      "sourcePath": "/Users/you/.zshrc:3"
    }
  ]
}

varName — 제거된 환경 변수 이름
varValue — 제거 당시의 값 — 그대로 다시 붙여넣으세요
sourceType — 셸 rc 파일의 경우 "file" (macOS / Linux), Windows 레지스트리의 경우 "registry"
sourcePath — 원래 위치: Unix에서는 "경로:줄번호", Windows에서는 레지스트리 키 경로

macOS / Linux에서 복원하기

백업 JSON 파일을 아무 텍스트 편집기로 여세요.
복원하려는 항목마다 sourcePath를 확인하세요 — 콜론 앞 부분이 원래 export가 있던 셸 rc 파일입니다 (예: ~/.zshrc).
해당 파일을 열고 맨 아래에 한 줄을 추가하세요: export VARNAME="VALUE"
새 터미널을 열거나, 현재 터미널에서 source ~/.zshrc을 실행하세요.

Windows에서 복원하기

백업 JSON 파일을 아무 텍스트 편집기로 여세요.
시스템 속성 → 고급 → 환경 변수를 여세요.
사용자 변수(또는 원래 sourcePath에 맞는 시스템 변수)에서 JSON의 varName과 varValue로 변수를 생성하세요.
변경 사항이 적용되려면 새 PowerShell 또는 cmd 창을 여세요.

다음에 HaryAI Switch를 열면

같은 export를 복원하면 다음번 스캔 때 HaryAI Switch가 다시 충돌로 표시합니다. 예상된 동작입니다 — Claude Code와 Codex 모두 셸 환경 변수를 가장 높은 우선순위 설정 소스로 처리하므로, 셸이 export하는 내용은 앱이 쓴 내용을 덮어씁니다. export가 스위치와 공존하길 원한다면 둘 다 같은 게이트웨이를 가리키도록 설정하세요.

오래된 백업 정리하기

백업은 자동으로 삭제되지 않습니다. 스위치가 정상 작동하는 것을 확인한 후, 복원할 계획이 없는 env-backup-*.json 파일은 안전하게 삭제하셔도 됩니다.