문제 해결

Craft 사용 중 발생할 수 있는 동기화, 성능, 로그인, 연결, 저장소 및 플랫폼별 일반 문제의 해결 방법입니다.

이 가이드는 Craft 사용 중 자주 만나게 되는 문제와 해결 방법을 정리한 것입니다. 플랫폼별 문제는 아래 관련 섹션을 펼쳐 확인하세요.

일부 문제 해결 주제는 해당 기능 문서에서 다루고 있습니다:

• 캘린더 문제
• 커스텀 도메인 문제
• 공유 문제
• 구독 문제
• 화이트보드 마이그레이션

​

동기화 문제

진단에서 '오프라인'으로 표시됩니다

이 문제를 해결하는 가장 쉬운 방법은 앱을 완전히 종료한 뒤 다시 실행하는 것입니다:

iOS에서:

• 앱을 강제 종료하세요
• 약 30초 기다리세요
• 앱을 다시 열어보세요

Mac에서:

1. Activity Monitor를 엽니다 (Spotlight에서 검색하거나 Applications > Utilities에서 찾기)
2. 목록에서 Craft를 찾습니다
3. Craft를 선택한 다음 상단의 정지 버튼을 클릭합니다
4. Craft를 다시 여세요

재시작 후 설정 > 진단으로 이동하여 동기화 가능 여부(Sync Availability)를 확인하세요.

문서가 기기 간에 동기화되지 않습니다

같은 계정을 사용 중인지 확인하세요:

한 기기에서 문서가 보이지 않는 경우 동일한 계정과 로그인 방법(이메일 vs Apple로 로그인)을 사용하고 있는지 확인하세요.

이메일 주소 확인 방법:

• Mac: 문서 목록의 좌측 상단, 아바타 옆에 이메일 주소가 표시됩니다
• iPad: 문서 목록의 좌측 상단 아바타를 탭하여 스페이스 목록을 열면 이메일 주소를 확인할 수 있습니다
• iPhone: 문서 목록의 우측 하단 아바타를 탭하여 스페이스 목록을 열면 이메일 주소를 확인할 수 있습니다

@privaterelay.appleid.com로 끝나는 이메일 주소가 보인다면, 이는 Apple로 로그인을 통해 생성된 자동 이메일 주소입니다.

수동으로 동기화 트리거하기

설정 > 진단을 열고 Sync Now 버튼을 탭하세요. 클릭 후 앱이 동기화를 재시도합니다.

VPN 또는 광고 차단기가 동기화를 차단함

경우에 따라 VPN, 광고 차단기(예: AdGuard), 또는 네트워크 모니터링 앱(예: LittleSnitch)이 기기 간 동기화를 방해할 수 있습니다. 다음을 시도해 보세요:

1. 이러한 앱을 일시적으로 비활성화합니다
2. Craft를 재시작합니다
3. 동기화 연결이 복원되었는지 확인합니다

브라우저 확장 기능인 “Hush”와 “Plume Guard”도 Craft 서버로의 접근을 차단할 수 있습니다.

회사 네트워크가 Craft를 차단함

회사 네트워크 설정, 방화벽, 개인정보 보호 프로그램이 Craft 트래픽을 차단할 수 있습니다. 회사에서 Craft를 사용 중이라면 IT 부서에 네트워크 설정을 확인해 달라고 요청하세요.

다음 URL을 화이트리스트에 추가해야 할 수 있습니다:

• api.craft.do
• docs.craft.do
• res.craft.do

관련 네트워크 문제는 웹/Windows에서 Craft에 액세스할 수 없음을 참조하세요.

​

로그인 문제

Mac에서 Apple ID로 로그인할 수 없음

Mac에서 Continue with Apple을 선택하면 비밀번호 입력을 요청받을 수 있습니다. 이는 Apple의 보안 조치입니다.

중요: Mac에 로그인할 때 사용하는 Mac 사용자 계정 암호를 입력해야 하며, Apple ID 암호가 아닙니다.

Apple ID 암호를 입력하면 오류 없이 같은 프롬프트가 다시 표시됩니다.

Craft 웹사이트나 앱에 접근할 수 없음

특정 브라우저 확장 기능, 광고 차단기 또는 사설 네트워크가 Craft 웹사이트나 앱 접근을 방해할 수 있습니다. 흔한 오류로는 “Server Not Found” 또는 페이지가 로드되지 않는 경우가 있습니다.

문제를 일으키는 것으로 알려진 앱:

• Hush
• Plume Guard

해결 방법:

1. 이러한 확장 기능을 일시적으로 비활성화하세요
2. 구성에서 Craft 도메인을 안전한 사이트로 등록하세요
3. 다른 네트워크로 접속해 보세요

여러 네트워크와 셀룰러 데이터에서도 문제가 지속되면 지원팀에 문의하세요.

​

성능 문제

macOS에서 Craft가 느리게 동작함

성능 문제가 발생하면 다음 단계를 시도하세요:

빠른 해결 방법:

1. Activity Monitor를 통해 앱을 재시작하세요 (동기화 문제 섹션 참조)
2. 불필요한 탭과 창을 닫으세요
3. 창 관리 앱(예: Magnet)을 사용 중이라면 최신 버전으로 업데이트되어 있는지 확인하세요

지원에 제공할 정보:

문제가 계속되면 지원에 아래 정보를 제공하세요:

• 외부 저장소 기반 Space를 사용 중인지 여부
• 창 관리 응용 프로그램을 사용 중인지 여부
• 서드파티 텍스트 편집 도구가 있는지 여부
• 시스템 설정 > 개인정보 보호 및 보안 > 손쉬운 사용(Accessibility) 아래 설치된 앱의 스크린샷
• 앱을 재시작하면 문제가 해결되는지 여부
• 여러 탭과 창이 문제를 유발하는지 여부

Spindump 생성 방법 (지속적인 문제용):

1. Activity Monitor를 엽니다
2. three-dot menu (⋯)를 클릭합니다
3. Spindump를 선택합니다
4. 파일을 저장하여 지원팀에 전송하세요

Windows에서 Craft가 느리게 동작함

Windows에서 성능 문제가 발생하면 다음을 확인하세요:

1. 사용 중인 Windows 버전은 무엇인가요?
2. 회사 네트워크/VPN에 연결되어 있나요?
3. 앱을 재시작하면 성능이 정상으로 돌아오나요?
4. 컴퓨터를 재시작하면 성능이 정상으로 돌아오나요?

문제가 계속되면 오류나 예기치 않은 동작을 전체 화면 녹화로 기록하여 지원팀에 공유하세요.

Mac에서 Craft와 함께 Grammarly Desktop 사용하기

Craft Mac 앱에서 Grammarly Desktop을 사용하려면:

1. Grammarly 데스크탑을 grammarly.com/desktop에서 다운로드하세요

2. 설치 후 Grammarly 앱을 실행하세요

3. System Settings > Privacy & Security > Accessibility에서 Grammarly를 활성화하는 안내를 따르세요

4. Craft 앱을 재시작하세요

이제 블록을 선택하면 Grammarly 위젯을 통해 교정 도구를 사용할 수 있습니다.

​

macOS 전용 문제

App Store에 최신 업데이트가 표시되지 않음

App Store에 Craft의 최신 버전 대신 “Open” 버튼만 보이는 경우:

1. App Store를 강제 종료하세요

2. App Store를 재시작하세요

3. “Craft Docs”를 검색하세요

4. 제목을 클릭하여 앱 상세 페이지로 들어가세요

5. 해당 페이지에서 업데이트 버튼이 보이는지 확인하세요

팝업: '다른 Craft가 이미 설치되어 있습니다'

이전 설치의 남은 파일 때문에 이 메시지가 나타날 수 있습니다. 보통 App Store와 Setapp 등 여러 출처에서 설치한 경우 발생합니다.

해결 방법:

1. Applications 폴더에서 Craft를 삭제하세요

2. Finder에서 Go > Go to Folder를 선택하고 아래 경로들을 한 번에 하나씩 붙여넣어 해당 내용을 삭제하세요:

   ~/Library/Group Containers/group.com.lukilabs.lukiapp.share/
   ~/Library/Containers/com.lukilabs.lukiapp
   
3. 그래도 해결되지 않으면 Group Containers와 Containers 폴더에서 “craft”, “lukilabs”, 또는 “lukiapp”을 포함한 파일을 찾아 삭제하세요

4. 선호하는 출처에서 Craft를 다시 설치하세요

​

iOS/iPadOS 전용 문제

파일 공유가 쓸모없는 링크로 전송됨

현재 Share Sheet를 통해 텍스트와 링크는 공유할 수 있지만, 사진이나 파일을 공유하면 쓸모없는 링크로 전송되는 경우가 있습니다.

회피 방법:

옵션 1: 복사 및 붙여넣기

1. Share Sheet에서 Copy를 선택하세요
2. Craft를 열세요
3. 올바른 문서에 붙여넣기 하세요

옵션 2: 다운로드 후 추가

1. 파일을 기기에 다운로드하세요
2. Craft에서 좌측 하단의 + 버튼을 탭하세요
3. Files 옵션을 선택하세요
4. 기기에서 파일을 선택하세요

​

Windows/Web 전용 문제

웹/Windows에서 Craft에 액세스할 수 없음

회사 장치나 네트워크에서 Craft에 접속할 때 회사의 프록시 솔루션이 접근을 차단할 수 있습니다.

IT 부서에 다음 URL을 화이트리스트에 추가해 달라고 요청하세요:

• api.craft.do
• docs.craft.do
• res.craft.do

'오프라인입니다' 메시지

이 메시지는 앱이 일시적으로 인터넷 또는 우리 서버와의 연결을 잃었음을 의미합니다. 앱은 자동으로 재연결을 시도합니다.

대응 방법:

• 인터넷 연결 확인: 연결이 활성화되어 있고 안정적인지 확인하세요
• 편집 일시 중지: 잠재적 데이터 손실을 피하려면 앱이 온라인으로 돌아올 때까지 편집을 중지하세요
• 페이지 새로고침: 연결이 안정적이고 저장되지 않은 변경사항이 없다면 페이지를 새로고침해 보세요 연결이 성공적으로 복원되면 메시지는 사라집니다.

썸네일 데이터 가져오기 실패

Web 버전에서 특정 붙여넣은 링크(예: LinkedIn)의 썸네일이 “Failed to fetch data.”로 표시될 수 있습니다.

설명: 링크 데이터를 가져오는 서드파티 제공업체가 차단된 것으로 보입니다. 이는 당사에서 직접 해결할 수 없는 외부 문제입니다.

다행인 점:

• 링크를 클릭하면 정상적으로 작동합니다
• 이 문제는 Web 버전에만 영향을 줍니다
• 개인 LinkedIn 프로필 링크에 국한되어 있습니다
• 회사 LinkedIn 링크는 정상적으로 표시됩니다
• Mac, iOS, iPad 앱에서는 모든 LinkedIn 썸네일이 정상적으로 작동합니다

Windows용 Craft 업데이트 방법

Craft for Windows는 앱을 종료했다가 다시 열면 자동으로 업데이트됩니다. 새 버전이 있을 경우 Windows 알림 센터(우측 하단)에 알림이 표시됩니다.

수동으로 업데이트하려면:

1. Craft for Windows를 제거하세요
2. craft.do/download 또는 Windows App Store에서 최신 버전을 다운로드하세요

​

데이터 및 저장소 문제

최근 삭제됨 폴더가 사라짐

최근 삭제됨 폴더가 사라지는 이유는 두 가지입니다:

1. 이전에 삭제한 문서가 30일 이상 지난 경우
2. 삭제된 폴더의 내용이 수동으로 삭제된 경우

실수로 삭제한 항목이 있다면 저장소 및 복구 문서에서 복구 옵션을 확인하세요.

오류: 외부 위치가 이미 추가되어 있음

문제: 외부 위치를 다시 추가하려고 할 때 “External location already added” 오류가 발생하지만 Space로 표시되지 않습니다.

해결 방법:

1. Craft 앱에서 로그아웃하세요

2. 다시 로그인하세요

3. 외부 위치를 다시 추가해 보세요

여전히 동일한 메시지가 표시되면:

1. 기기에서 Craft 앱을 삭제하세요
2. 앱을 다시 설치하세요
3. 외부 위치를 추가해 보세요

External Storage와 iCloud 동기화 문제

iCloud Drive 동기화의 신뢰성과 성능은 당사 통제 범위를 벗어납니다. 동기화가 잘 되지 않을 경우 다음 팁이 도움이 될 수 있습니다:

외부 스페이스를 여러 기기에서 사용하는 것은 권장하지 않습니다. 이로 인해 데이터 충돌과 데이터 손실이 발생할 수 있습니다. 스페이스 사용 방법이 확실하지 않다면 지원팀에 문의하세요.

문제 해결 단계:

1. 수동으로 동기화 트리거: Mac에서는 Finder를, iOS에서는 Files 앱을 열고 iCloud Drive 폴더로 이동하세요
2. 문서 편집: 문서 내용을 변경하여 동기화가 시작되도록 합니다
3. 인터넷 접속 확인: Wi‑Fi에 연결되어 있거나 빠른 셀룰러 연결을 사용 중인지 확인하세요. 기기 배터리도 충분히 충전되어 있어야 합니다
4. 비행기 모드 토글: 네트워크를 다시 연결하면 iCloud Drive 동기화가 시작될 수 있습니다
5. 셀룰러 동기화 설정 확인:
   • “System Services”를 설정 > Cellular Data에서 활성화하세요
   • 설정 > iCloud > iCloud Drive에서 “Use Cellular Data”를 켜세요
6. 배터리 수준 확인: 배터리가 낮으면 전력 절약을 위해 동기화 속도가 느려질 수 있습니다
7. iCloud 저장 용량 확인: 저장 용량을 초과하면 Craft가 동기화할 수 없습니다
8. 기기 재시작: iCloud 서비스가 백그라운드에서 정상 실행되는지 확인하기 위해 기기를 재시작하세요
9. iCloud 활성화 확인:
   • iOS: Apple ID로 iCloud에 로그인하고 iCloud Drive를 활성화하세요
   • Mac: Apple ID에 로그인하고 Apple ID 설정에서 iCloud Drive가 활성화되어 있는지 확인하세요
10. ‘Optimize Mac Storage’ 비활성화: Apple ID 설정에서 이 옵션이 켜져 있으면 Mac이 파일을 클라우드로 오프로드하여 파일이 없어 보일 수 있습니다
11. 인내심 가지기: iCloud Drive 동기화는 특히 초기 환경에서 시간이 걸릴 수 있습니다. 시작되기까지 하루가 걸릴 수 있습니다
12. 로그아웃 후 재로그인: iCloud Drive가 멈추거나 매우 느린 경우 iCloud에서 로그아웃했다가 다시 로그인하세요
13. 자동 시간 설정: 모든 기기가 자동 시간 설정을 사용하도록 하세요
14. OS 업데이트: Apple은 각 OS 버전에서 iCloud를 지속적으로 개선합니다
15. Apple의 시스템 상태 확인: Apple의 시스템 상태 페이지에서 iCloud 서비스가 정상인지 확인하세요

​

버그 신고

Craft에서 버그를 발견하셨다면 문제를 추적하는 데 도움을 주셔서 감사드립니다. 명확한 보고는 팀이 문제를 더 빠르게 조사하고 해결하는 데 큰 도움이 됩니다.

​

신고 전에 확인할 사항

• Craft의 최신 버전을 사용 중인지 확인하세요
• 앱을 재시작하거나 웹 버전을 새로고침하세요
• 문제가 계속되면 신고를 진행하세요

​

버그 신고에 포함할 내용

1. 버전 확인: 최신 버전을 사용 중인지 알려주세요

2. 환경 공유:

   • 기기 모델(예: MacBook Pro, iPhone 14, Windows 노트북)
   • 운영체제 및 버전(예: macOS Sonoma 14.2, iOS 17.3, Windows 11)
   • 플랫폼(데스크탑 앱, 모바일 앱, 또는 웹 버전)

3. 문제가 발생한 단계 설명:

   • 문제로 이어진 정확한 작업을 단계별로 적어주세요
   • 예: “문서 열기 > 새 페이지 추가 > 이미지 삽입 > 문제가 발생함”

4. 화면 녹화 포함:

   • 짧고 문제에 집중된 녹화를 하세요
   • 동작 사이에 여유를 두어 설명이 명확하도록 하세요
   • 전체 화면을 녹화하세요(잘라내지 마세요)
   • 가능한 최고 해상도로 녹화하세요
   • 시각적 버그나 오류 메시지에는 스크린샷도 유용합니다

​

화면 녹화 방법

iPhone:

• 설정 > 제어 센터에서 화면 녹화를 활성화하세요
• 제어 센터를 열고 녹화 버튼을 탭하세요
• 빨간 상태 막대를 탭하여 녹화를 중지하세요
• Apple 공식 가이드

Mac:

• Command + Shift + 5를 누르세요
• “Record Entire Screen” 또는 “Record Selected Portion”을 선택하세요
• Apple 공식 가이드

Windows:

• Windows Key + G를 눌러 Xbox Game Bar를 엽니다
• Capture 위젯을 사용하여 녹화하세요
• Microsoft 공식 가이드

​

신고 후 처리 과정

• 일회성 문제: 기록으로 남기고 유사 사례를 모니터링합니다
• 재현 가능한 버그: 내부적으로 에스컬레이션하여 조사 및 해결을 진행합니다

버그 신고에 시간을 내 주셔서 감사합니다. 여러분의 피드백은 Craft를 더 나은 서비스로 만드는 데 큰 도움이 됩니다.

---

​

추가 도움이 필요하신가요?

문제 해결책을 찾지 못하셨다면 도와드리겠습니다:

지원팀에 문의

도움받기