diff --git a/ai-migrator/claude-provider-config.mdx b/ai-migrator/claude-provider-config.mdx
new file mode 100644
index 00000000..60507a1a
--- /dev/null
+++ b/ai-migrator/claude-provider-config.mdx
@@ -0,0 +1,60 @@
+---
+id: claude-provider-configuration
+title: "Configuring Anthropic Claude as AI Provider"
+description: "How to use Anthropic Claude with Tolgee AI Migrator"
+sidebar_label: "Claude Provider"
+---
+
+# Configuring Anthropic Claude as AI Provider
+
+Tolgee AI Migrator supports Anthropic Claude as an alternative AI provider to OpenAI and Azure OpenAI.
+
+## What is Anthropic Claude?
+
+Anthropic Claude is a powerful AI language model that you can use to perform your localization migration tasks.
+
+## Getting Your Claude API Key
+
+1. Visit the Anthropic Console: https://console.anthropic.com/
+2. Sign up or log in.
+3. Navigate to the API Keys section.
+4. Create a new API key and copy it securely.
+
+## Using Claude with Tolgee Migrator
+
+You can specify Claude as your AI provider using the `--provider` flag and provide your Claude API key with `--claude-api-key`.
+
+Example:
+
+```bash
+tolgee-migrator migrate -p 'src/**/*.tsx' -r react --provider claude --claude-api-key <your-claude-api-key>
+```
+
+Alternatively, you can set the environment variable `CLAUDE_API_KEY` to your API key.
+
+## Switching Between Providers
+
+You can switch between OpenAI, Azure OpenAI, and Claude by using the `--provider` flag:
+
+- **OpenAI (default):**
+
+```bash
+tolgee-migrator migrate -p 'src/**/*.tsx' -r react -k <your-openai-api-key>
+```
+
+- **Azure OpenAI:**
+
+```bash
+tolgee-migrator migrate -p 'src/**/*.tsx' -r react --provider azure --azure-api-key <your-azure-api-key> --endpoint <your-endpoint> --deployment <your-deployment>
+```
+
+- **Claude:**
+
+```bash
+tolgee-migrator migrate -p 'src/**/*.tsx' -r react --provider claude --claude-api-key <your-claude-api-key>
+```
+
+This flexibility allows you to choose the AI provider that best fits your needs.
+
+---
+
diff --git a/ai-migrator/two-pass-migration.mdx b/ai-migrator/two-pass-migration.mdx
new file mode 100644
index 00000000..338c2c32
--- /dev/null
+++ b/ai-migrator/two-pass-migration.mdx
@@ -0,0 +1,67 @@
+---
+id: two-pass-migration
+title: "Two-Pass Migration Review Flow"
+description: "How to use the two-pass review flow in Tolgee AI Migrator"
+sidebar_label: "Two-Pass Migration"
+---
+
+# Two-Pass Migration Review Flow
+
+The Tolgee AI Migrator now supports a two-pass migration process to give you better control and review over your localization migration.
+
+## What is Two-Pass Migration?
+
+Instead of migrating all files and generating the status file in one go, the two-pass approach splits the process into steps:
+
+1. **First Pass:** The migrator replaces raw strings with Tolgee SDK calls and inserts JSON-formatted comments above each call. These comments contain metadata like key names, descriptions, and default values.
+2. **Review:** You manually review the migrated files with inline comments in your IDE, allowing you to verify and adjust the migration before finalizing.
+3. **Second Pass:** You run a separate command to extract these inline comments, remove them from the code, and generate the `.tolgee/migration-status.json` file.
+4. **Upload:** Finally, you upload the keys to the Tolgee platform.
+
+## How to Use Two-Pass Migration
+
+### First Pass: Migrate with Inline Comments
+
+Run the migrator with the `--inline-comments` flag:
+
+```bash
+tolgee-migrator migrate -p 'src/**/*.tsx' -r react -k <your-api-key> --inline-comments
+```
+
+
+This will insert JSON comments above each Tolgee SDK call, like this:
+
+```json
+/**
+
+{"description": "Welcome message for users", "default": "Welcome!"}
+*/
+
+<T keyName="welcome-message" />
+```
+
+
+### Review
+
+Open the migrated files in your IDE and review the inline comments to ensure the migration is correct.
+
+### Second Pass: Extract Comments and Generate Status File
+
+After review, run the extract-comments command to remove inline comments and generate the migration status file:
+
+```bash
+tolgee-migrator extract-comments -p 'src/**/*.tsx'
+```
+
+### Upload Keys
+
+Upload the keys to Tolgee:
+
+```bash
+tolgee-migrator upload-keys -ak <your-tolgee-api-key>
+```
+
+This workflow helps you catch issues early and maintain a clean migration history.
+
+---
+