> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wandb.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> User Settings에서 프로필 정보, 계정 기본값, 알림, 베타 제품 참여, GitHub 인테그레이션, 저장소 사용량, 계정 활성화를 관리하고 팀을 생성합니다.

# User Settings 관리

User Settings에서는 프로필, 기본 팀, API 키, 알림, 인테그레이션, 기타 계정 수준 옵션을 관리할 수 있습니다. 이 페이지에서는 User Settings의 각 섹션과 사용 방법을 설명합니다.

User Settings를 열려면 사용자 프로필 페이지로 이동한 다음, 오른쪽 상단에 있는 사용자 아이콘을 선택합니다. 드롭다운 메뉴에서 **Settings**를 선택합니다.

<div id="profile">
  ## 프로필
</div>

**프로필** 섹션에서는 계정 이름과 소속 기관을 관리하고 수정할 수 있습니다. 필요에 따라 소개글과 위치를 추가하고, 개인 또는 소속 기관의 웹사이트를 연결하고, 프로필 이미지를 업로드할 수 있습니다.

<div id="edit-your-intro">
  ### 자기소개 수정하기
</div>

자기소개는 프로필 상단에 표시되며, 자신을 소개하거나 프로젝트를 연결하거나 관련 계정을 공유하기에 좋은 공간입니다.

자기소개를 수정하려면 프로필 상단의 **편집**을 클릭하세요. 열리는 WYSIWYG 편집기는 Markdown을 지원합니다.

1. 줄을 수정하려면 해당 줄을 클릭하세요. 시간을 절약하려면 `/`를 입력한 다음 목록에서 Markdown을 선택하면 됩니다.
2. 항목의 드래그 핸들을 사용해 위치를 옮기세요.
3. 블록을 삭제하려면 드래그 핸들을 클릭한 다음 **삭제**를 클릭하세요.
4. 변경 사항을 저장하려면 **저장**을 클릭하세요.

업데이트된 자기소개가 이제 프로필에 표시됩니다.

<div id="add-social-badges">
  #### 소셜 배지 추가
</div>

X에서 `@weights_biases` 계정을 팔로우하는 배지를 추가하려면, 배지 이미지를 가리키는 HTML `<img>` 태그가 포함된 Markdown 스타일 링크를 추가하세요:

```markdown theme={null}
[![X: @weights_biases](https://img.shields.io/twitter/follow/weights_biases?style=social)](https://x.com/intent/follow?screen_name=weights_biases)
```

`<img>` 태그에서는 `width`, `height` 또는 둘 다 지정할 수 있습니다. 둘 중 하나만 지정하면 이미지의 가로세로 비율이 유지됩니다.

<div id="default-team">
  ## 기본 팀
</div>

둘 이상의 팀에 속해 있는 경우 **기본 팀** 섹션에서 run 또는 Weave 트레이스에 팀이 지정되지 않았을 때 사용할 기본 팀을 설정할 수 있습니다. 한 팀에만 속해 있는 경우에는 해당 팀이 기본값이므로 이 섹션은 표시되지 않습니다.

기본 팀을 설정하는 방법은 배포 환경에 따라 다릅니다. 사용 중인 환경에 맞는 탭을 선택하세요.

<Tabs>
  <Tab title="Multi-tenant Cloud">
    **Default location to create new projects in** 옆의 드롭다운을 클릭한 다음 기본 팀을 선택하세요.
  </Tab>

  <Tab title="Dedicated Cloud / Self-Managed">
    1. **Default location to create new projects in** 옆의 드롭다운을 클릭한 다음 기본 팀 또는 개인 entity를 선택하세요.
    2. **선택 사항:** 관리자가 **계정** > **Settings** > **Privacy**에서 공개 프로젝트를 켠 경우, 새 프로젝트의 기본 공개 범위를 설정하세요. **Default project privacy in your personal account** 옆의 버튼을 클릭한 다음 **Private**(기본값) 또는 **Public**을 선택하세요.
    3. **선택 사항:** 관리자가 **계정** > **Settings** > **Privacy**에서 [default saving and diffing code](/ko/models/app/features/panels/code/)를 켠 경우, **Enable code saving in your personal account**를 클릭하여 run에 대해 이 기능을 활성화하세요.
  </Tab>
</Tabs>

<Note>
  자동화된 환경에서 스크립트를 실행할 때 기본 팀을 지정하려면 `WANDB_ENTITY` [환경 변수](https://docs.wandb.ai/models/track/environment-variables)를 사용해 기본 위치를 지정하세요.
</Note>

<div id="teams">
  ## 팀
</div>

**팀** 섹션에는 내가 속한 모든 팀이 표시됩니다.

* 팀 이름을 클릭해 팀 페이지로 이동합니다.
* 추가 팀에 참여할 권한이 있으면 **가입할 수 있는 팀을 찾았습니다** 옆의 **팀 보기**를 클릭합니다.
* **선택 사항:** **공개 프로필에서 팀 숨기기**를 켭니다.

<Note>
  팀을 생성하거나 관리하려면 [팀 관리](/ko/platform/app/settings-page/teams/)를 참조하세요.
</Note>

<div id="api-keys">
  ## API 키
</div>

**API 키** 섹션에서는 W\&B 서비스에 인증할 때 사용하는 개인 API 키를 관리할 수 있습니다. 이 섹션에서 기존 키를 검토하고, 새 키를 만들고, 더 이상 필요하지 않은 키를 취소할 수 있습니다.

<div id="view-your-api-keys">
  ### API 키 보기
</div>

API 키 테이블에는 다음이 표시됩니다:

* **키 ID**: 각 API 키의 첫 부분으로, 식별에 사용됩니다.
* **이름**: 키를 만들 때 지정한 설명용 이름입니다.
* **생성됨**: 키가 생성된 시점입니다.
* **마지막 사용**: 가장 최근 사용 타임스탬프입니다.

<Note>
  보안을 위해 테이블에는 키 ID(키의 첫 부분)만 표시됩니다. 전체 시크릿 API 키는 키를 만들 때 한 번만 표시됩니다.
</Note>

API 키 목록을 필터링하려면 키 이름 또는 ID의 일부를 입력하세요.

<div id="create-a-new-api-key">
  ### 새 API 키 생성
</div>

API 키를 만들려면 자세한 내용이 있는 **개인 API 키** 또는 **서비스 계정 API 키** 탭을 선택하세요.

<Tabs>
  <Tab title="개인 API 키">
    사용자 ID에 속한 개인 API 키를 만들려면 다음 단계를 따르세요.

    1. W\&B에 로그인한 다음 사용자 프로필 아이콘 **> User Settings**를 클릭합니다.
    2. **Create new API key**를 클릭합니다.
    3. API 키를 식별할 수 있는 설명적인 이름을 입력합니다.
    4. **Create**를 클릭합니다.
    5. 표시된 API 키를 즉시 복사해 안전하게 저장합니다.
  </Tab>

  <Tab title="서비스 계정 API 키">
    서비스 계정 소유의 API 키를 생성하려면 다음 단계를 따르세요.

    1. 팀 또는 조직 설정에서 **Service Accounts** 탭으로 이동합니다.
    2. 목록에서 서비스 계정을 찾습니다.
    3. **작업 (<Icon icon="ellipsis" iconType="solid" />)** 메뉴를 클릭한 다음 **Create API key**를 클릭합니다.
    4. API 키 이름을 지정한 다음 **Create**를 클릭합니다.
    5. 표시된 API 키를 즉시 복사해 안전한 곳에 저장합니다.
    6. **Done**을 클릭합니다.

    서로 다른 환경이나 워크플로를 지원하기 위해 하나의 서비스 계정에 여러 API 키를 생성할 수 있습니다.
  </Tab>
</Tabs>

<Warning>
  W\&B는 전체 API 키를 생성 시점에 한 번만 표시합니다. 대화 상자를 닫으면 전체 API 키를 다시 볼 수 없습니다. Settings에서는 키 ID(키의 첫 부분)만 확인할 수 있습니다. 전체 API 키를 분실한 경우 새 API 키를 만들어야 합니다.
</Warning>

안전한 저장 옵션은 [API 키를 안전하게 저장하기](/ko/platform/app/settings-page/user-settings/#store-and-handle-api-keys-securely)를 참조하세요.

<div id="delete-an-api-key">
  ### API 키 삭제
</div>

더 이상 필요하지 않거나 노출되었을 수 있는 경우 API 키를 삭제하세요. API 키를 삭제해 액세스를 철회하려면 다음 단계를 따르세요.

1. API 키 테이블에서 삭제할 키를 찾으세요.
2. 키 옆의 Delete 버튼을 클릭하세요.
3. 삭제를 확인하세요.

W\&B는 테이블에서 해당 키를 제거하며, 더 이상 그 키로 인증할 수 없습니다.

<Warning>
  API 키를 삭제하면 해당 키를 사용하는 모든 스크립트 또는 서비스의 액세스가 즉시 취소됩니다. 기존 키를 삭제하기 전에 모든 시스템이 새 키를 사용하도록 업데이트했는지 확인하세요.
</Warning>

<div id="store-and-handle-api-keys-securely">
  ## API 키를 안전하게 저장하고 관리하기
</div>

API 키는 W\&B 계정에 접근할 수 있게 하므로 비밀번호처럼 보호해야 합니다. 다음 섹션에서는 권장 저장 방법, 피해야 할 관행, 코드에 키를 전달하는 방법, 그리고 최신 키에 필요한 SDK 버전 요구 사항을 설명합니다.

<div id="recommended-storage-methods">
  ### 권장 저장 방법
</div>

다음 방법 중 하나를 사용하여 API 키를 안전하게 저장하세요.

* **Secrets manager**: [AWS Secrets Manager](https://aws.amazon.com/secrets-manager/), [HashiCorp Vault](https://developer.hashicorp.com/vault), [Azure Key Vault](https://azure.microsoft.com/en-us/products/key-vault), 또는 [Google Secret Manager](https://cloud.google.com/security/products/secret-manager)와 같은 전용 시크릿 관리 시스템을 사용하세요.
* **Password manager**: 신뢰할 수 있는 비밀번호 관리 애플리케이션을 사용하세요.
* **OS-level keychains**: macOS Keychain, Windows Credential Manager, 또는 Linux secret service에 키를 저장하세요. 프로덕션 환경에는 권장되지 않습니다.

<div id="what-to-avoid">
  ### 피해야 할 사항
</div>

다음과 같은 관행은 API 키를 노출시킬 수 있으므로 피하세요.

* Git과 같은 버전 관리 시스템에 API 키를 절대 커밋하지 마세요.
* API 키를 평문 설정 파일에 저장하지 마세요.
* `ps`와 같은 OS 명령의 출력에 표시되므로, 명령줄 인수로 API 키를 전달하지 마세요.
* 이메일, 채팅 또는 기타 암호화되지 않은 채널을 통해 API 키를 공유하지 마세요.
* 소스 코드에 API 키를 하드코딩하지 마세요.

API 키가 노출된 경우, W\&B 계정에서 즉시 해당 API 키를 삭제하고 [지원팀](mailto:support@wandb.ai) 또는 AISE에 문의하세요.

<div id="environment-variables">
  ### 환경 변수
</div>

코드에서 API 키를 사용할 때는 환경 변수를 통해 전달하세요:

```bash theme={null}
export WANDB_API_KEY="[YOUR-API-KEY]"
```

이 방식은 키를 소스 코드에 넣지 않도록 하고, 필요할 때 더 쉽게 교체할 수 있게 해줍니다.

<Warning>
  `ps` 같은 OS 명령어의 출력에 표시되므로, 환경 변수를 명령어와 같은 줄에서 설정하지 마세요:

  ```bash theme={null}
  # 이 패턴은 피하세요. 프로세스 관리자에 API 키가 노출될 수 있습니다
  export WANDB_API_KEY="[YOUR-API-KEY]" ./my-script.sh
  ```
</Warning>

<div id="sdk-version-compatibility">
  ### SDK 버전 호환성
</div>

최신 API 키를 사용하는 경우, SDK 버전이 이를 지원하는지 확인하세요. 새 API 키는 기존 키보다 더 깁니다. 이전 버전의 `wandb` 또는 `weave` SDK로 인증할 때 API 키 길이 오류가 발생할 수 있습니다.

**해결 방법**: 최신 SDK 버전으로 업데이트하세요.

* `wandb` SDK v0.22.3+

  ```bash theme={null}
  pip install --upgrade wandb==0.22.3
  ```
* `weave` SDK v0.52.17+
  ```bash theme={null}
  pip install --upgrade weave==0.52.17
  ```

SDK를 바로 업그레이드할 수 없다면, 우회 방법으로 `WANDB_API_KEY` 환경 변수를 사용해 API 키를 설정하세요.

<div id="beta-features">
  ## 베타 기능
</div>

**베타 기능** 섹션에서는 부가 기능과 개발 중인 제품의 미리보기를 선택적으로 활성화할 수 있습니다. 활성화하려는 베타 기능 옆의 토글 스위치를 선택하세요.

<div id="alerts">
  ## 알림
</div>

run이 비정상 종료되거나 완료될 때 알림을 받거나, [`wandb.Run.alert()`](/ko/models/runs/alert/)를 사용해 맞춤형 알림을 설정할 수 있습니다. 알림은 이메일 또는 Slack을 통해 받게 됩니다. 알림을 받을 이벤트 유형 옆의 스위치를 켜세요:

* **Runs finished**: W\&B run이 성공적으로 완료되면 알림을 받습니다.
* **Run crashed**: run이 정상적으로 완료되지 못하고 실패하면 알림을 받습니다.

알림을 설정하고 관리하는 방법에 대한 자세한 내용은 [ `wandb.Run.alert()`로 알림 보내기](/ko/models/runs/alert/)를 참조하세요.

<div id="personal-github-integration">
  ## 개인 GitHub 인테그레이션
</div>

개인 GitHub 계정을 연결하면 W\&B가 사용자를 대신해 GitHub 리소스에 액세스할 수 있습니다. GitHub 계정을 연결하려면 다음 단계를 따르세요.

1. **Connect Github** 버튼을 선택하세요. W\&B가 OAuth 승인 페이지로 리디렉션합니다.
2. **Organization access** 섹션에서 액세스를 부여할 조직을 선택하세요.
3. **Authorize wandb**를 선택하세요.

이제 개인 GitHub 계정이 W\&B 계정에 연결되었습니다.

<div id="delete-your-account">
  ## 계정 삭제
</div>

계정을 삭제하려면 **계정 삭제** 버튼을 선택하세요.

<Warning>
  계정 삭제는 되돌릴 수 없습니다.
</Warning>

<div id="storage">
  ## 저장소
</div>

**저장소** 섹션에서는 계정이 W\&B 서버에서 사용한 총 메모리를 설명합니다. 기본 저장소 플랜은 100 GB입니다. 저장소 및 가격에 대한 자세한 내용은 [가격](https://wandb.ai/site/pricing) 페이지를 참조하세요.