[FEATURE] Add Multilingual (i18n) Support for Slash Command Descriptions (/ 슬래시 커맨드의 자동완성 때 뜨는 설명문구를 다국어 지원하는 방향 제안)

Status Open
Maintainer reply None cached
Activity 1 comment · opened Jul 21, 2026

Preflight Checklist

  • [x] I have searched existing requests and this feature hasn't been requested yet
  • [x] This is a single feature request (not multiple features)

Problem Statement

  • Current State: When a user types the slash command (/login), the accompanying description text ("Sign in with your Claude account") is currently displayed as a static English string.
  • Opportunity for Improvement: We have a great opportunity to implement dynamic language support (i18n) for slash command descriptions, allowing the text to seamlessly adapt to each user's language settings.
  • Potential Impact: Non-English speaking users might find it slightly challenging to instantly grasp the command's exact purpose. By providing localized descriptions, we can make the command interface significantly more intuitive and user-friendly for our broader global audience.
  • 현재 상황 (Current State): 슬래시 커맨드(/login) 입력 시 메뉴 옆에 표시되는 설명 문구("Sign in with your Claude account")가 영어 단일 언어로 고정되어 제공되고 있습니다.
  • 개선 제안 배경 (Opportunity): 명령어에 대한 부가 설명 영역에 다국어(i18n) 지원이 아직 적용되지 않아, 사용자의 언어 환경에 맞춘 유연한 안내가 어려운 상황입니다.
  • 기대 효과 (Potential Impact): 영어에 익숙하지 않은 글로벌 사용자분들은 해당 커맨드의 정확한 용도를 즉각적으로 파악하는 데 약간의 불편함을 느낄 수 있습니다. 이 설명을 다국어로 지원하게 된다면, 다양한 언어권의 사용자들이 명령어 기능을 훨씬 더 직관적이고 편리하게 활용할 수 있을 것으로 기대됩니다.

Proposed Solution

  • Implement i18n Architecture: Remove the hardcoded English string ("Sign in with your Claude account") from the /login command description and transition to a dynamic, internationalized structure.
  • Dynamic Language Detection: Automatically detect the user's browser locale or account language preferences, and dynamically map it to the corresponding localized text (e.g., "Claude 계정으로 로그인" for Korean users).
  • Centralized Resource Management: Manage all translated strings in centralized resource files (e.g., JSON). This approach ensures scalability, making it easy to add new languages or update existing texts in the future without requiring major code changes.
  • 다국어(i18n) 아키텍처 도입: /login 명령어의 설명 영역에 하드코딩된 영문 텍스트("Sign in with your Claude account")를 제거하고, 다국어를 지원하는 동적 텍스트 구조로 전환합니다.
  • 동적 언어 감지 및 매핑: 사용자의 브라우저 로케일(Locale) 정보나 앱 내 설정된 기본 언어를 자동으로 감지하여, 그에 맞는 언어 리소스(예: 한국어의 경우 "Claude 계정으로 로그인")를 렌더링합니다.
  • 리소스 중앙화 및 확장성 확보: 지원하는 모든 언어의 번역 데이터를 JSON 형태의 리소스 파일로 중앙 관리하여, 향후 새로운 언어를 추가하거나 문구를 수정할 때 코드 배포 없이 유연하게 대응할 수 있도록 구성합니다.

Alternative Solutions

  • I've tried using...: I've tried using browser-built-in translation tools or extensions, but they often fail to detect and translate dynamic UI overlays like slash command tooltips, or they end up breaking the UI layout.
  • Currently I work around this by...: Currently, I work around this by providing separate translated onboarding guides or external documentation that explain what the English descriptions for commands like /login mean. However, this creates friction as users have to context-switch to look up the information.
  • Other tools solve this by...: Other tools (like Slack or Notion) solve this by implementing standard i18n libraries. They detect the user's locale via browser settings or account preferences and map the command descriptions to a localized resource file (e.g., JSON) before rendering the command palette, ensuring a seamless native experience.
  • I've tried using (시도해 본 방법): 브라우저에 내장된 자동 번역 확장 프로그램이나 기능을 사용해 보기도 했지만, 슬래시 커맨드 팝업처럼 동적으로 나타나는 UI 오버레이에는 번역기가 제대로 인식되지 않거나 레이아웃이 깨지는 경우가 많았습니다.
  • Currently I work around this by (현재의 임시 해결책): 현재는 이 문제를 우회하기 위해, 신규 사용자 온보딩 문서나 별도의 가이드 페이지에 /login 등 주요 명령어의 영문 설명이 무슨 뜻인지 일일이 번역해서 안내하고 있습니다. 하지만 사용자가 문서를 따로 찾아봐야 하므로 흐름이 끊기는 단점이 있습니다.
  • Other tools solve this by (다른 서비스들의 해결 방식): Slack이나 Notion 같은 다른 글로벌 툴들은 이 문제를 해결하기 위해, 브라우저의 로케일(Locale) 정보나 사용자 프로필의 언어 설정을 감지하여 명령어 팔레트가 렌더링될 때 다국어 리소스(JSON 등) 파일에서 해당 언어의 텍스트를 불러와 보여주는 i18n 프레임워크를 적용하고 있습니다.

Priority

High - Significant impact on productivity

Feature Category

CLI commands and flags

Use Case Example

  1. A new non-English speaking user, whose system and browser language are set to Korean, accesses the platform for the first time.
  2. They type a slash (/) in the chat input field to explore the available commands and figure out how to authenticate.
  3. With this feature, instead of seeing the hardcoded English text "Sign in with your Claude account", they would see a localized description such as "Claude 계정으로 로그인" right next to the /login command.
  4. This would save them time and cognitive effort because they can instantly and intuitively grasp the command's purpose in their native language. It removes a minor friction point, leading to a much smoother and more welcoming onboarding experience.
  1. 브라우저 및 앱 언어 설정이 '한국어'로 되어 있는 비영어권 신규 사용자가 서비스에 처음 접속합니다.
  2. 어떤 기능들이 있는지 확인하고 로그인을 진행하기 위해 채팅 입력창에 슬래시(/)를 입력하여 명령어 목록을 탐색합니다.
  3. 이 기능(다국어 지원)이 적용된다면, 사용자는 /login 명령어 옆에서 "Sign in with your Claude account"라는 영어 텍스트 대신, 설정된 언어에 맞춰 "Claude 계정으로 로그인"이라는 번역된 설명 문구를 보게 됩니다.
  4. 이는 사용자가 낯선 언어를 해석하거나 기능을 유추할 필요 없이 즉각적으로 명령어의 목적을 이해할 수 있게 해주어, 초기 탐색 시간을 줄이고 훨씬 매끄럽고 환영받는 듯한 사용자 경험을 제공할 수 있기 때문에 유용합니다.

Additional Context

  • Performance Optimization: To prevent initial rendering delays, localized resource (JSON) files should be loaded asynchronously (lazy loading) based on the active locale.
  • UI Layout Flexibility: Translated text often expands in length (e.g., in German or Spanish). The command palette overlay must handle text wrapping or truncation gracefully to prevent layout breakage.
  • Fallback Mechanism: A robust fallback logic is mandatory. If a user connects with an unsupported locale, the system must safely default to the English string ("Sign in with your Claude account").
  • 성능 최적화: 언어 리소스(JSON) 파일 크기가 커질 경우 초기 로딩 속도에 영향을 줄 수 있으므로, 사용자의 현재 언어 파일만 비동기(Lazy loading)로 불러오는 처리가 필요합니다.
  • UI 레이아웃 유연성: 독일어, 스페인어 등 번역 시 영문보다 텍스트 길이가 길어지는 언어를 대비해, 커맨드 팔레트 드롭다운 내에서 텍스트 줄임(Truncation) 및 줄바꿈 처리가 레이아웃을 깨지 않도록 구현해야 합니다.
  • 기본값(Fallback) 정책: 시스템에 번역 데이터가 존재하지 않는 미지원 로케일(Locale)로 접속하는 사용자를 위해, 기본값인 영문("Sign in with your Claude account")이 안전하게 출력되도록 예외 처리가 필수적입니다.

View original on GitHub ↗

This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗