الوثائق / الوكلاء / 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 أولاً في الطرفية الخاصة بك. يقوم بتسجيل دخولك عبر المتصفح ويحفظ مفتاحًا، والذي يقرأه الخادم، لذلك لا يحمل الإعداد أدناه أي شيء.
- قم بتشغيل claude mcp add في المستودع الخاص بك.
- أعد تشغيل الوكيل، أو أعد تحميل خوادم MCP الخاصة به، ليبدأ الترجمة.
- افتح مستودعك واطلب منه شيئًا مثل الموجه أدناه.
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 --agentclaude 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