diff --git a/console/src/api/types/provider.ts b/console/src/api/types/provider.ts
index 1b31a5840..3ca7221de 100644
--- a/console/src/api/types/provider.ts
+++ b/console/src/api/types/provider.ts
@@ -23,6 +23,8 @@ export interface ProviderInfo {
   api_key: string;
   base_url: string;
   generate_kwargs: Record<string, unknown>;
+  /** Custom headers for API requests. */
+  default_headers: Record<string, string>;
 }
 
 export interface ProviderConfigRequest {
@@ -30,6 +32,7 @@ export interface ProviderConfigRequest {
   base_url?: string;
   chat_model?: string;
   generate_kwargs?: Record<string, unknown>;
+  default_headers?: Record<string, string>;
 }
 
 export interface ModelSlotConfig {
@@ -55,6 +58,7 @@ export interface CreateCustomProviderRequest {
   api_key_prefix?: string;
   chat_model?: string;
   models?: ModelInfo[];
+  default_headers?: Record<string, string>;
 }
 
 export interface AddModelRequest {
@@ -126,10 +130,12 @@ export interface TestProviderRequest {
   base_url?: string;
   chat_model?: string;
   generate_kwargs?: Record<string, unknown>;
+  default_headers?: Record<string, string>;
 }
 
 export interface TestModelRequest {
   model_id: string;
+  default_headers?: Record<string, string>;
 }
 
 export interface DiscoverModelsResponse {
diff --git a/console/src/pages/Settings/Models/components/modals/CustomProviderModal.tsx b/console/src/pages/Settings/Models/components/modals/CustomProviderModal.tsx
index c739752de..ccf2036db 100644
--- a/console/src/pages/Settings/Models/components/modals/CustomProviderModal.tsx
+++ b/console/src/pages/Settings/Models/components/modals/CustomProviderModal.tsx
@@ -1,8 +1,28 @@
 import { useState, useEffect } from "react";
-import { Form, Input, Modal, Select, message } from "@agentscope-ai/design";
+import {
+  Form,
+  Input,
+  Modal,
+  Select,
+  message,
+  Button,
+} from "@agentscope-ai/design";
+import { Space } from "antd";
+import {
+  PlusOutlined,
+  DeleteOutlined,
+  DownOutlined,
+  RightOutlined,
+} from "@ant-design/icons";
 import api from "../../../../../api";
 import { useTranslation } from "react-i18next";
 
+interface HeaderItem {
+  id: string;
+  key: string;
+  value: string;
+}
+
 interface CustomProviderModalProps {
   open: boolean;
   onClose: () => void;
@@ -17,23 +37,61 @@ export function CustomProviderModal({
   const { t } = useTranslation();
   const [saving, setSaving] = useState(false);
   const [form] = Form.useForm();
+  const [headers, setHeaders] = useState<HeaderItem[]>([]);
+  const [advancedOpen, setAdvancedOpen] = useState(false);
 
   useEffect(() => {
     if (open) {
       form.resetFields();
+      setHeaders([]);
+      setAdvancedOpen(false);
     }
   }, [open, form]);
 
+  const addHeader = () => {
+    // Pre-fill User-Agent for the first header (common for Kimi Coding Plan)
+    const newHeader: HeaderItem = {
+      id: crypto.randomUUID(),
+      key: headers.length === 0 ? "User-Agent" : "",
+      value: "",
+    };
+    setHeaders([...headers, newHeader]);
+  };
+
+  const removeHeader = (index: number) => {
+    setHeaders(headers.filter((_, i) => i !== index));
+  };
+
+  const updateHeader = (
+    index: number,
+    field: keyof Omit<HeaderItem, "id">,
+    value: string,
+  ) => {
+    const newHeaders = [...headers];
+    newHeaders[index][field] = value;
+    setHeaders(newHeaders);
+  };
+
   const handleSubmit = async () => {
     try {
       const values = await form.validateFields();
       setSaving(true);
+
+      // Convert headers array to object
+      const defaultHeaders: Record<string, string> = {};
+      headers.forEach(({ key, value }) => {
+        if (key.trim()) {
+          defaultHeaders[key.trim()] = value;
+        }
+      });
+
       await api.createCustomProvider({
         id: values.id.trim(),
         name: values.name.trim(),
         default_base_url: values.default_base_url?.trim() || "",
         api_key_prefix: values.api_key_prefix?.trim() || "",
         chat_model: values.chat_model || "OpenAIChatModel",
+        default_headers: defaultHeaders,
       });
       message.success(
         t("models.providerCreated", { name: values.name.trim() }),
@@ -123,6 +181,78 @@ export function CustomProviderModal({
             ]}
           />
         </Form.Item>
+
+        {/* Advanced Config - Headers */}
+        <div style={{ marginTop: 16 }}>
+          <button
+            type="button"
+            onClick={() => setAdvancedOpen(!advancedOpen)}
+            style={{
+              background: "none",
+              border: "none",
+              padding: 0,
+              cursor: "pointer",
+              fontSize: 14,
+              color: "#666",
+              display: "flex",
+              alignItems: "center",
+              gap: 4,
+            }}
+          >
+            {advancedOpen ? <DownOutlined /> : <RightOutlined />}
+            {t("models.advancedConfig", "Advanced Config")}
+          </button>
+
+          {advancedOpen && (
+            <div style={{ marginTop: 12 }}>
+              <div style={{ marginBottom: 8, fontSize: 14, color: "#333" }}>
+                {t("models.customHeaders", "Custom Headers")}
+              </div>
+              {headers.map((header, index) => (
+                <Space
+                  key={header.id}
+                  style={{ display: "flex", marginBottom: 8 }}
+                  align="baseline"
+                >
+                  <Input
+                    placeholder="Header Key (e.g. User-Agent)"
+                    value={header.key}
+                    onChange={(e) => updateHeader(index, "key", e.target.value)}
+                    style={{ width: 200 }}
+                  />
+                  <Input
+                    placeholder="Header Value"
+                    value={header.value}
+                    onChange={(e) =>
+                      updateHeader(index, "value", e.target.value)
+                    }
+                    style={{ width: 200 }}
+                  />
+                  <Button
+                    type="text"
+                    danger
+                    icon={<DeleteOutlined />}
+                    onClick={() => removeHeader(index)}
+                  />
+                </Space>
+              ))}
+              <Button
+                type="dashed"
+                onClick={addHeader}
+                icon={<PlusOutlined />}
+                size="small"
+              >
+                {t("models.addHeader", "Add Header")}
+              </Button>
+              <div style={{ marginTop: 8, fontSize: 12, color: "#888" }}>
+                {t(
+                  "models.headersHint",
+                  "Optional: Add custom HTTP headers for API requests. Example: User-Agent: KimiCLI/0.77",
+                )}
+              </div>
+            </div>
+          )}
+        </div>
       </Form>
     </Modal>
   );
diff --git a/console/src/pages/Settings/Models/components/modals/ProviderConfigModal.tsx b/console/src/pages/Settings/Models/components/modals/ProviderConfigModal.tsx
index fe77f8a14..273df6831 100644
--- a/console/src/pages/Settings/Models/components/modals/ProviderConfigModal.tsx
+++ b/console/src/pages/Settings/Models/components/modals/ProviderConfigModal.tsx
@@ -8,7 +8,14 @@ import {
   Button,
   Select,
 } from "@agentscope-ai/design";
-import { ApiOutlined, DownOutlined, RightOutlined } from "@ant-design/icons";
+import { Space } from "antd";
+import {
+  ApiOutlined,
+  DownOutlined,
+  RightOutlined,
+  DeleteOutlined,
+  PlusOutlined,
+} from "@ant-design/icons";
 import type { ProviderConfigRequest } from "../../../../../api/types";
 import api from "../../../../../api";
 import { useTranslation } from "react-i18next";
@@ -241,6 +248,12 @@ function JsonCodeEditor({
   );
 }
 
+interface HeaderItem {
+  id: string;
+  key: string;
+  value: string;
+}
+
 interface ProviderConfigModalProps {
   provider: {
     id: string;
@@ -252,6 +265,7 @@ interface ProviderConfigModalProps {
     freeze_url: boolean;
     chat_model: string;
     generate_kwargs: Record<string, unknown>;
+    default_headers?: Record<string, string>;
   };
   activeModels: any;
   open: boolean;
@@ -272,9 +286,69 @@ export function ProviderConfigModal({
   const [formDirty, setFormDirty] = useState(false);
   const [advancedOpen, setAdvancedOpen] = useState(false);
   const [form] = Form.useForm<ProviderConfigFormValues>();
+  const [headers, setHeaders] = useState<HeaderItem[]>([]);
   const selectedChatModel = Form.useWatch("chat_model", form);
   const canEditBaseUrl = !provider.freeze_url;
 
+  // Convert default_headers object to array for UI
+  useEffect(() => {
+    if (
+      provider.default_headers &&
+      Object.keys(provider.default_headers).length > 0
+    ) {
+      const headerArray = Object.entries(provider.default_headers).map(
+        ([key, value]) => ({
+          id: crypto.randomUUID(),
+          key,
+          value: String(value),
+        }),
+      );
+      setHeaders(headerArray);
+    } else {
+      setHeaders([]);
+    }
+  }, [provider.default_headers, open]);
+
+  const addHeader = () => {
+    // Pre-fill User-Agent for the first header (common for Kimi Coding Plan)
+    const newHeader: HeaderItem = {
+      id: crypto.randomUUID(),
+      key: headers.length === 0 ? "User-Agent" : "",
+      value: "",
+    };
+    setHeaders([...headers, newHeader]);
+    setFormDirty(true);
+  };
+
+  const removeHeader = (index: number) => {
+    setHeaders(headers.filter((_, i) => i !== index));
+    setFormDirty(true);
+  };
+
+  const updateHeader = (
+    index: number,
+    field: keyof Omit<HeaderItem, "id">,
+    value: string,
+  ) => {
+    const newHeaders = [...headers];
+    newHeaders[index][field] = value;
+    setHeaders(newHeaders);
+    setFormDirty(true);
+  };
+
+  // Helper function to convert headers array to object
+  const headersToObject = (
+    headersArray: HeaderItem[],
+  ): Record<string, string> => {
+    const result: Record<string, string> = {};
+    headersArray.forEach(({ key, value }) => {
+      if (key.trim()) {
+        result[key.trim()] = value;
+      }
+    });
+    return result;
+  };
+
   const parseGenerateConfig = (value?: string) => {
     const trimmed = value?.trim();
     if (!trimmed) {
@@ -391,6 +465,8 @@ export function ProviderConfigModal({
         values.generate_kwargs_text?.trim(),
       );
 
+      const defaultHeaders = headersToObject(headers);
+
       // Validate connection before saving
       // For local providers, we might skip this or just check if models exist (which the backend does)
       if (!provider.is_custom) {
@@ -398,6 +474,7 @@ export function ProviderConfigModal({
           api_key: values.api_key,
           base_url: values.base_url,
           chat_model: values.chat_model,
+          default_headers: defaultHeaders,
         });
 
         if (!result.success) {
@@ -412,6 +489,7 @@ export function ProviderConfigModal({
         base_url: values.base_url,
         chat_model: values.chat_model,
         generate_kwargs: hasGenerateConfigInput ? generateConfig : {},
+        default_headers: defaultHeaders,
       });
 
       await onSaved();
@@ -436,10 +514,14 @@ export function ProviderConfigModal({
         "base_url",
         "chat_model",
       ]);
+
+      const defaultHeaders = headersToObject(headers);
+
       const result = await api.testProviderConnection(provider.id, {
         api_key: values.api_key,
         base_url: values.base_url,
         chat_model: values.chat_model,
+        default_headers: defaultHeaders,
       });
       if (result.success) {
         message.success(result.message || t("models.testConnectionSuccess"));
@@ -657,6 +739,65 @@ export function ProviderConfigModal({
             </span>
           </button>
 
+          {/* Custom Headers Section */}
+          {advancedOpen && (
+            <div style={{ marginBottom: 16 }}>
+              <div
+                style={{
+                  marginBottom: 8,
+                  fontSize: 14,
+                  color: "#333",
+                  fontWeight: 500,
+                }}
+              >
+                {t("models.customHeaders", "Custom Headers")}
+              </div>
+              {headers.map((header, index) => (
+                <Space
+                  key={header.id}
+                  style={{ display: "flex", marginBottom: 8 }}
+                  align="baseline"
+                >
+                  <Input
+                    placeholder="Header Key (e.g. User-Agent)"
+                    value={header.key}
+                    onChange={(e) => updateHeader(index, "key", e.target.value)}
+                    style={{ width: 220 }}
+                  />
+                  <Input
+                    placeholder="Header Value"
+                    value={header.value}
+                    onChange={(e) =>
+                      updateHeader(index, "value", e.target.value)
+                    }
+                    style={{ width: 220 }}
+                  />
+                  <Button
+                    type="text"
+                    danger
+                    icon={<DeleteOutlined />}
+                    onClick={() => removeHeader(index)}
+                  />
+                </Space>
+              ))}
+              <Button
+                type="dashed"
+                onClick={addHeader}
+                icon={<PlusOutlined />}
+                size="small"
+                style={{ marginBottom: 8 }}
+              >
+                {t("models.addHeader", "Add Header")}
+              </Button>
+              <div style={{ fontSize: 12, color: "#888" }}>
+                {t(
+                  "models.headersHint",
+                  "Optional: Add custom HTTP headers for API requests. Example: User-Agent: KimiCLI/0.77",
+                )}
+              </div>
+            </div>
+          )}
+
           <Form.Item
             hidden={!advancedOpen}
             name="generate_kwargs_text"
diff --git a/console/src/pages/Settings/Models/components/modals/RemoteModelManageModal.tsx b/console/src/pages/Settings/Models/components/modals/RemoteModelManageModal.tsx
index e4cdb1196..b1e9cf49e 100644
--- a/console/src/pages/Settings/Models/components/modals/RemoteModelManageModal.tsx
+++ b/console/src/pages/Settings/Models/components/modals/RemoteModelManageModal.tsx
@@ -61,6 +61,7 @@ export function RemoteModelManageModal({
       setSaving(true);
       const testResult = await api.testModelConnection(provider.id, {
         model_id: id,
+        default_headers: provider.default_headers,
       });
 
       if (!testResult.success) {
@@ -108,6 +109,7 @@ export function RemoteModelManageModal({
     try {
       const result = await api.testModelConnection(provider.id, {
         model_id: modelId,
+        default_headers: provider.default_headers,
       });
       if (result.success) {
         message.success(result.message || t("models.testConnectionSuccess"));
diff --git a/src/copaw/app/routers/providers.py b/src/copaw/app/routers/providers.py
index 1fba69b5b..11a6851d6 100644
--- a/src/copaw/app/routers/providers.py
+++ b/src/copaw/app/routers/providers.py
@@ -3,7 +3,7 @@
 
 from __future__ import annotations
 
-from typing import List, Literal, Optional
+from typing import Dict, List, Literal, Optional
 from copy import deepcopy
 
 from fastapi import APIRouter, Body, Depends, HTTPException, Path, Request
@@ -44,6 +44,10 @@ class ProviderConfigRequest(BaseModel):
             "(e.g., openai.chat.completions, anthropic.messages)."
         ),
     )
+    default_headers: Optional[dict] = Field(
+        default_factory=dict,
+        description="Custom headers for API requests",
+    )
 
 
 class ModelSlotRequest(BaseModel):
@@ -58,6 +62,10 @@ class CreateCustomProviderRequest(BaseModel):
     api_key_prefix: str = Field(default="")
     chat_model: ChatModelName = Field(default="OpenAIChatModel")
     models: List[ModelInfo] = Field(default_factory=list)
+    default_headers: Dict[str, str] = Field(
+        default_factory=dict,
+        description="Custom headers for API requests",
+    )
 
 
 class AddModelRequest(BaseModel):
@@ -93,6 +101,7 @@ async def configure_provider(
             "base_url": body.base_url,
             "chat_model": body.chat_model,
             "generate_kwargs": body.generate_kwargs,
+            "default_headers": body.default_headers,
         },
     )
     if not ok:
@@ -129,6 +138,7 @@ async def create_custom_provider_endpoint(
                 api_key_prefix=body.api_key_prefix,
                 chat_model=body.chat_model,
                 extra_models=body.models,
+                default_headers=body.default_headers,
             ),
         )
     except ValueError as exc:
@@ -159,6 +169,10 @@ class TestProviderRequest(BaseModel):
 
 class TestModelRequest(BaseModel):
     model_id: str = Field(..., description="Model ID to test")
+    default_headers: Optional[Dict[str, str]] = Field(
+        default_factory=dict,
+        description="Custom headers for API requests",
+    )
 
 
 class DiscoverModelsRequest(BaseModel):
@@ -213,6 +227,8 @@ async def test_provider(
             tmp_provider.api_key = body.api_key
         if body and body.base_url:
             tmp_provider.base_url = body.base_url
+        if body and body.default_headers:
+            tmp_provider.default_headers = body.default_headers
         ok, msg = await tmp_provider.check_connection()
         return TestConnectionResponse(
             success=ok,
@@ -275,7 +291,13 @@ async def test_model(
         provider = manager.get_provider(provider_id)
         if provider is None:
             raise ValueError(f"Provider '{provider_id}' not found")
-        ok, msg = await provider.check_model_connection(model_id=body.model_id)
+        # Ensure we don't accidentally modify provider config during test
+        tmp_provider = deepcopy(provider)
+        if body.default_headers:
+            tmp_provider.default_headers = body.default_headers
+        ok, msg = await tmp_provider.check_model_connection(
+            model_id=body.model_id,
+        )
         return TestConnectionResponse(
             success=ok,
             message=(
diff --git a/src/copaw/providers/models.py b/src/copaw/providers/models.py
index 53a97fb24..fd50f5ca3 100644
--- a/src/copaw/providers/models.py
+++ b/src/copaw/providers/models.py
@@ -3,7 +3,7 @@
 
 from __future__ import annotations
 
-from typing import List
+from typing import Dict, List
 
 from pydantic import BaseModel, Field
 
@@ -69,6 +69,10 @@ class CustomProviderData(BaseModel):
         default="OpenAIChatModel",
         description="Chat model class name (e.g., 'OpenAIChatModel')",
     )
+    default_headers: Dict[str, str] = Field(
+        default_factory=dict,
+        description="Custom headers for API requests",
+    )
 
 
 class ModelSlotConfig(BaseModel):
diff --git a/src/copaw/providers/openai_provider.py b/src/copaw/providers/openai_provider.py
index 664020c90..f0f034a9c 100644
--- a/src/copaw/providers/openai_provider.py
+++ b/src/copaw/providers/openai_provider.py
@@ -19,11 +19,14 @@ class OpenAIProvider(Provider):
     """Provider implementation for OpenAI API and compatible endpoints."""
 
     def _client(self, timeout: float = 5) -> AsyncOpenAI:
-        return AsyncOpenAI(
-            base_url=self.base_url,
-            api_key=self.api_key,
-            timeout=timeout,
-        )
+        client_kwargs = {
+            "base_url": self.base_url,
+            "api_key": self.api_key,
+            "timeout": timeout,
+        }
+        if self.default_headers:
+            client_kwargs["default_headers"] = self.default_headers
+        return AsyncOpenAI(**client_kwargs)
 
     @staticmethod
     def _normalize_models_payload(payload: Any) -> List[ModelInfo]:
@@ -115,19 +118,25 @@ def get_chat_model_instance(self, model_id: str) -> ChatModelBase:
         ]
 
         client_kwargs = {"base_url": self.base_url}
+        headers = {}
 
         if self.base_url in dashscope_base_urls:
-            client_kwargs["default_headers"] = {
-                "x-dashscope-agentapp": json.dumps(
-                    {
-                        "agentType": "CoPaw",
-                        "deployType": "UnKnown",
-                        "moduleCode": "model",
-                        "agentCode": "UnKnown",
-                    },
-                    ensure_ascii=False,
-                ),
-            }
+            headers["x-dashscope-agentapp"] = json.dumps(
+                {
+                    "agentType": "CoPaw",
+                    "deployType": "UnKnown",
+                    "moduleCode": "model",
+                    "agentCode": "UnKnown",
+                },
+                ensure_ascii=False,
+            )
+
+        # Merge custom default_headers
+        if self.default_headers:
+            headers.update(self.default_headers)
+
+        if headers:
+            client_kwargs["default_headers"] = headers
 
         return OpenAIChatModelCompat(
             model_name=model_id,
diff --git a/src/copaw/providers/provider.py b/src/copaw/providers/provider.py
index d8d449e74..a79060e0a 100644
--- a/src/copaw/providers/provider.py
+++ b/src/copaw/providers/provider.py
@@ -2,7 +2,7 @@
 """Definition of Provider."""
 
 from abc import ABC, abstractmethod
-from typing import Dict, List, Type, Any
+from typing import Any, Dict, List, Type
 from pydantic import BaseModel, Field
 
 from agentscope.model import ChatModelBase
@@ -61,6 +61,10 @@ class ProviderInfo(BaseModel):
         default_factory=dict,
         description="Generation parameters for agentscope chat models.",
     )
+    default_headers: Dict[str, str] = Field(
+        default_factory=dict,
+        description="Custom headers for API requests",
+    )
 
 
 class Provider(ProviderInfo, ABC):
@@ -138,6 +142,12 @@ def update_config(self, config: Dict) -> None:
             and isinstance(config["generate_kwargs"], dict)
         ):
             self.generate_kwargs = config["generate_kwargs"]
+        if (
+            "default_headers" in config
+            and config["default_headers"] is not None
+            and isinstance(config["default_headers"], dict)
+        ):
+            self.default_headers = config["default_headers"]
 
     def get_chat_model_cls(self) -> Type[ChatModelBase]:
         """Return the chat model class associated with this provider."""
@@ -188,6 +198,7 @@ async def get_info(self, mock_secret: bool = True) -> ProviderInfo:
             freeze_url=self.freeze_url,
             require_api_key=self.require_api_key,
             generate_kwargs=self.generate_kwargs,
+            default_headers=self.default_headers,
         )