AI Code With

Open WebUI API 키 설정

Open WebUI API 키: 연결에서 본인 키 설정

관리자 패널의 연결에서 이 필드들을 본인 API 키로 채우면 Open WebUI에서 Claude 모델을 사용할 수 있습니다. 사용한 만큼 지불하세요.

설정 시작API 키 받기 →
관리자 패널 → 설정 → 연결UI
config
Admin Panel → Settings → Connections → OpenAI API → +
URL: https://api.aicodewith.ai/v1
API Key: sk-***
Save → new chat → model selector → claude-haiku-4-5-20251001

설정 단계

나중에 사용할 터미널을 위해 이 키를 저장하세요

이 도구는 키를 자체 설정에 저장합니다. 로그인한 후 키를 복사하여 아래 단계의 API 키 필드에 붙여넣으세요.

API 키
sk-***

로그아웃한 방문자에게는 자리 표시자만 표시됩니다. 로그인하면 키를 채워 드립니다. Sign in · 콘솔에서 키 받기

복사는 명령을 클립보드에 넣을 뿐입니다. 아직 터미널에서 실행하거나 도구 설정에 키를 붙여넣어야 합니다. API 키 받는 방법

이 단계는 Linux(Open WebUI v0.12.0)에서 테스트되었습니다. macOS와 Windows는 아직 테스트되지 않아 목록에 없습니다.

  1. 아직 Open WebUI가 없나요? 설치하세요 (설치되어 있으면 건너뛰세요)

    uv tool install open-webui를 실행한 다음 uv tool list | grep open-webui를 실행하세요. 버전과 함께 open-webui가 표시되면 설치된 것입니다. 그런 다음 open-webui serve를 실행하고 터미널에 표시된 주소를 여세요.

    Open WebUI v0.12.0이 설치되었는지 확인하려면 uv tool list | grep open-webui를 실행하세요 (버전은 빨간색 상자로 표시됨)

  2. 아바타를 클릭하고 관리자 패널을 여세요

    Open WebUI 홈 페이지에서 왼쪽 아래의 아바타를 클릭한 다음 메뉴에서 관리자 패널을 클릭하세요.

    Open WebUI 홈 페이지를 열고 왼쪽 아래의 아바타를 클릭하세요. 메뉴의 관리자 패널 항목이 빨간색 상자로 표시되어 있습니다.

  3. 상단의 설정을 클릭하세요

    관리자 패널 페이지에서 상단의 설정 탭을 클릭하세요.

    관리자 패널 페이지에서 상단의 설정 탭을 클릭하세요 (빨간색 상자로 표시됨)

  4. 왼쪽의 연결을 클릭하세요

    왼쪽 사이드바의 AI 아래에 있는 연결을 클릭하세요. OpenAI API 섹션이 보일 것입니다.

    열리는 설정 페이지에서 왼쪽 사이드바의 AI 아래에 있는 연결을 클릭하세요 (빨간색 상자로 표시됨)

  5. URL과 API 키로 연결 추가하기

    OpenAI API 섹션에서 오른쪽의 +를 클릭하세요. URL을 https://api.aicodewith.ai/v1로 설정하고 API 키를 붙여넣은 다음(API 키 받기), 저장을 클릭하세요.

    OpenAI API 섹션에서 오른쪽의 +를 클릭하여 연결 추가를 여세요: URL을 https://api.aicodewith.ai/v1로 설정하고 API 키를 붙여넣은 다음 저장을 클릭하세요.

  6. 연결이 활성화되었는지 확인하세요

    저장 후 https://api.aicodewith.ai/v1 연결이 OpenAI API 아래에 표시되고 스위치가 켜져 있습니다.

    저장 후 https://api.aicodewith.ai/v1 연결이 OpenAI API 아래에 표시되고 활성화됩니다 (빨간색 상자)

  7. 다시 확인하고 싶나요? 연결을 여세요

    연결 옆의 톱니바퀴를 클릭하여 연결 편집을 열고 URL을 확인하세요. API 키는 점으로 마스킹된 상태로 유지됩니다.

    연결 옆의 톱니바퀴를 클릭하여 연결 편집을 여세요: URL은 https://api.aicodewith.ai/v1이고 아래의 API 키는 점으로 마스킹된 상태(Bearer)로 유지됩니다.

  8. 새 채팅에서 모델 선택하기

    새 채팅을 시작하고 모델 선택기를 여세요. claude-haiku-4-5-20251001 및 다른 모델이 나열되면 URL이 올바른 것입니다. 키가 올바른지는 답장을 받는 9단계에서 확인할 수 있습니다.

    모델 선택기를 여세요. aicodewith에서 제공하는 모델이 나타나며 claude-haiku-4-5-20251001이 빨간색 상자로 표시됩니다.

  9. 테스트 메시지 보내기

    claude-haiku-4-5-20251001을 선택하고 Reply with exactly: Hello from aicodewith.ai를 보내세요. Hello from aicodewith.ai라는 답장이 오면 완료된 것입니다.

    claude-haiku-4-5-20251001을 선택하고 “Reply with exactly: Hello from aicodewith.ai”를 보내세요. 모델이 Hello from aicodewith.ai라고 답장합니다 (상자 표시).

  10. 잘못된 URL의 모습: OpenAI: Network Problem

    URL이 잘못된 경우(예: https://api.aicodewith.ai/nope), 확인(새로 고침 아이콘)을 클릭하면 오른쪽 상단에 OpenAI: Network Problem이 표시됩니다. 해결 방법은 일반적인 오류를 참조하세요.

    URL이 잘못된 경우(예: 끝이 /nope인 경우), 확인(새로 고침 아이콘)을 클릭하면 오른쪽 상단에 "OpenAI: Network Problem" 토스트가 표시됩니다 (상자 표시).

  11. URL을 다시 /v1로 설정하고 다시 채팅하세요

    URL을 다시 https://api.aicodewith.ai/v1로 설정하고 저장하세요. 새 채팅에서 Hello from aicodewith.ai라는 답장이 오면 다시 작동하는 것입니다.

    URL을 https://api.aicodewith.ai/v1로 복원하고 저장한 후, 새 채팅에서 다시 Hello from aicodewith.ai라고 답장하여 구성이 복원되었음을 확인합니다.

자주 발생하는 오류

OpenAI: 네트워크 문제

표시되는 내용

OpenAI: Network Problem
원인
연결 URL이 잘못되었습니다(예: https://api.aicodewith.ai/nope). 따라서 확인(새로고침 아이콘)을 해도 연결할 수 없습니다
해결 방법
URL을 https://api.aicodewith.ai/v1로 설정하고 저장하세요. 그러면 새 채팅이 정상적으로 응답합니다

5단계로 돌아가기: URL과 API 키로 연결 추가 →

URL이 잘못된 경우(예: /nope로 끝나는 경우) 확인(새로고침 아이콘)을 클릭하면 오른쪽 상단에 토스트 "OpenAI: Network Problem"이 (박스로 표시되어) 나타납니다

FAQ

Open WebUI에서 내 API 키를 어떻게 사용하나요?

관리자 패널 → 설정 → 연결에서 OpenAI API 섹션의 +를 클릭하고, URL을 https://api.aicodewith.ai/v1로 설정한 뒤 API 키를 붙여넣고 저장하세요.

Open WebUI API 키를 다시 입력해야 하나요?

아니요. 키는 Open WebUI 자체 데이터베이스에 저장되고 재시작해도 유지되며, 환경 변수가 필요하지 않습니다.

Open WebUI 버전은 어떻게 확인하나요?

open-webui에는 --version 플래그가 없습니다. uv로 설치했다면 uv tool list | grep open-webui를 실행하세요.

Open WebUI에서 OpenAI: Network Problem이 표시됩니다. 이제 어떻게 해야 하나요?

연결 URL이 잘못되었습니다. https://api.aicodewith.ai/v1로 설정하고 저장하세요. 위의 일반적인 오류를 참조하세요.

출처

관련 링크

AI Code With API 키 받기모델 및 가격기타 통합