localize.dev

الوثائق / الوكلاء / Claude Code

توطين تطبيق باستخدام Claude Code

أضف خادم localize.dev MCP وخطاف ما بعد التحرير إلى Claude Code، بحيث تحصل نصوص واجهة المستخدم الجديدة على مفاتيح ترجمة وترجمات أثناء كتابة Claude للكود.

كيف يعمل

يمكن لـ Claude Code كتابة كود i18n، ولكنه لا يعرف أي النصوص فاتته أو ما تحتاجه لغاتك الأخرى. مع خادم localize.dev MCP، فإنه يستدعي localize على الملفات التي قام بتغييرها: يحصل النص على مفاتيح، ويتم إعادة كتابة الكود إلى مكتبة i18n الخاصة بك، وتتم ترجمة الرسائل الجديدة إلى كل لغة يشحن بها التطبيق.

يضيف npx localize-dev init --agent الخادم إلى .mcp.json وخطاف ما بعد التحرير إلى .claude/settings.json. بعد كل تحرير، يقوم الخطاف بفحص الملف الذي لمسه Claude، وعندما يجد نصًا غير مترجم، يخبر Claude باستدعاء localize، حتى لا يضطر أحد إلى تذكر السؤال.

إعدادها

قم بتشغيل npx localize-dev login أولاً في الطرفية الخاصة بك. يقوم بتسجيل دخولك عبر المتصفح ويحفظ مفتاحًا، والذي يقرأه الخادم، لذلك لا يحمل الإعداد أدناه أي شيء.

  1. قم بتشغيل claude mcp add في المستودع الخاص بك.
  2. أعد تشغيل الوكيل، أو أعد تحميل خوادم MCP الخاصة به، ليبدأ الترجمة.
  3. افتح مستودعك واطلب منه شيئًا مثل الموجه أدناه.
terminal
claude mcp add localize -- npx -y localize-dev mcp

# Share it with your team through .mcp.json
claude mcp add --scope project localize -- npx -y localize-dev mcp

# Or the server, the after-edit hook and AGENTS.md in one go
npx localize-dev init --agent
أو قم بتثبيت المكون الإضافي
claude plugin marketplace add ufortstephen/localize-dev
claude plugin install localize-dev@uselocalize

ما تحصل عليه

أين يذهب الخادم
.mcp.json
خادم
localize-dev mcp، تم تشغيله باستخدام npx على جهازك
مفتاح
الذي حفظه npx localize-dev login
ما يضيفه init --agent
الخادم في .mcp.json، وخطاف ما بعد التحرير في .claude/settings.json، وقسم AGENTS.md

من الجيد معرفته

  • المكون الإضافي هو الطريق الآخر للدخول. يضيف الخادم ومهارة تخبر Claude متى تستخدمه، ويترك المستودع وشأنه.
  • يعمل الخطاف npx localize-dev hook بعد التحرير، والتحرير المتعدد، والكتابة. يقوم بالمسح فقط، لذا فهو لا يحتاج إلى مفتاح ولا يستخدم أيًا من حصتك. قم بتعيين LOCALIZE_DEV_HOOK=off لإيقافه مؤقتًا.
  • يقرأ Claude Code CLAUDE.md، وليس AGENTS.md. عندما لا يحتوي المستودع على CLAUDE.md، يقوم init --agent بإنشاء واحد يستورد AGENTS.md، لذلك يتبع كلا الوكيلين نفس التعليمات.

جربه

اسأل شيئًا كهذا. يجب على الوكيل استدعاء أداة localize.

“ترجمة src/components/Checkout.tsx إلى الإسبانية والفرنسية.”

احتفظ بها مترجمة

لا يزال النص الذي يتركه الوكيل ثابتًا يتم اكتشافه: يفشل npx localize-dev check في CI في طلب سحب يضيف نسخة غير مترجمة، ولا يحتاج إلى مفتاح.

npx localize-dev check

جميع الوكلاء ومرجع الأداة موجودون في صفحة خادم MCP.