codexmate 0.0.43 → 0.0.45

package/cli/update.js

@@ -64,26 +64,92 @@ async function cmdToolUpdate(args = []) {
     }
 }
 
-async function fetchLatestVersion() {
+async function fetchLatestVersion(options = {}) {
     return new Promise((resolve, reject) => {
+        const timeoutMs = Number.isFinite(Number(options.timeoutMs))
+            ? Math.max(0, Number(options.timeoutMs))
+            : 5000;
         const url = 'https://registry.npmjs.org/codexmate/latest';
-        https.get(url, (res) => {
+        let settled = false;
+        const finish = (fn, value) => {
+            if (settled) return;
+            settled = true;
+            fn(value);
+        };
+        const req = https.get(url, (res) => {
             let data = '';
             res.on('data', (chunk) => { data += chunk; });
             res.on('end', () => {
                 try {
+                    if (res.statusCode && (res.statusCode < 200 || res.statusCode >= 300)) {
+                        finish(reject, new Error(`NPM registry returned ${res.statusCode}`));
+                        return;
+                    }
                     const json = JSON.parse(data);
-                    resolve(json.version || '');
+                    finish(resolve, json.version || '');
                 } catch (e) {
-                    reject(new Error('解析 NPM 响应失败'));
+                    finish(reject, new Error('解析 NPM 响应失败'));
                 }
             });
-        }).on('error', (err) => {
-            reject(err);
+        });
+        if (timeoutMs > 0) {
+            req.setTimeout(timeoutMs, () => {
+                req.destroy(new Error('获取 NPM 最新版本超时'));
+            });
+        }
+        req.on('error', (err) => {
+            finish(reject, err);
         });
     });
 }
 
+function normalizePackageVersion(value) {
+    const normalized = typeof value === 'string' ? value.trim().replace(/^v/i, '') : '';
+    return /^\d+(?:\.\d+){0,2}(?:[-+][0-9A-Za-z.-]+)?$/.test(normalized) ? normalized : '';
+}
+
+function comparePackageVersions(left, right) {
+    const normalizeParts = (value) => {
+        const normalized = normalizePackageVersion(value);
+        if (!normalized) return null;
+        return normalized.split(/[+-]/)[0].split('.').map((part) => Number.parseInt(part, 10) || 0);
+    };
+    const a = normalizeParts(left);
+    const b = normalizeParts(right);
+    if (!a || !b) return 0;
+    for (let i = 0; i < 3; i += 1) {
+        const diff = (a[i] || 0) - (b[i] || 0);
+        if (diff < 0) return -1;
+        if (diff > 0) return 1;
+    }
+    return 0;
+}
+
+let latestVersionStatusCache = null;
+
+async function fetchLatestVersionStatus(options = {}) {
+    const currentVersion = normalizePackageVersion(options.currentVersion) || String(options.currentVersion || '');
+    const timeoutMs = Number.isFinite(Number(options.timeoutMs)) ? Number(options.timeoutMs) : 5000;
+    const cacheTtlMs = Number.isFinite(Number(options.cacheTtlMs)) ? Math.max(0, Number(options.cacheTtlMs)) : 10 * 60 * 1000;
+    const now = typeof options.now === 'function' ? options.now() : Date.now();
+    if (latestVersionStatusCache && cacheTtlMs > 0 && now - latestVersionStatusCache.checkedAtMs < cacheTtlMs) {
+        return { ...latestVersionStatusCache.payload, cached: true };
+    }
+
+    const latestVersionRaw = await fetchLatestVersion({ timeoutMs });
+    const latestVersion = normalizePackageVersion(latestVersionRaw) || String(latestVersionRaw || '');
+    const payload = {
+        currentVersion,
+        latestVersion,
+        updateAvailable: !!currentVersion && !!latestVersion && comparePackageVersions(currentVersion, latestVersion) < 0,
+        source: 'npm',
+        checkedAt: new Date(now).toISOString(),
+        cached: false
+    };
+    latestVersionStatusCache = { checkedAtMs: now, payload };
+    return payload;
+}
+
 function detectInstallMethod() {
     const cliPath = path.resolve(__dirname, '..');
 
@@ -167,5 +233,9 @@ function updateViaStandalone(version) {
 }
 
 module.exports = {
-    cmdToolUpdate
+    cmdToolUpdate,
+    fetchLatestVersion,
+    fetchLatestVersionStatus,
+    normalizePackageVersion,
+    comparePackageVersions
 };

package/cli.js

@@ -148,7 +148,7 @@ const {
     deleteCodexSkills
 } = require('./cli/skills');
 const { cmdImportSkills: cmdImportSkillsFromUrl } = require('./cli/import-skills-url');
-const { cmdToolUpdate } = require('./cli/update');
+const { cmdToolUpdate, fetchLatestVersionStatus } = require('./cli/update');
 const {
     getFileStatSafe,
     isBootstrapLikeText,
@@ -291,7 +291,11 @@ const DEFAULT_BUILTIN_CLAUDE_PROXY_SETTINGS = Object.freeze({
     host: '127.0.0.1',
     port: 8328,
     provider: '',
+    upstreamProviderName: '',
+    upstreamBaseUrl: '',
+    upstreamApiKey: '',
     authSource: 'provider',
+    targetApi: 'responses',
     timeoutMs: 30000
 });
 const CLI_INSTALL_TARGETS = Object.freeze([
@@ -5740,7 +5744,9 @@ const {
     HTTPS_KEEP_ALIVE_AGENT,
     readConfigOrVirtualDefault,
     resolveBuiltinProxyProviderName,
-    resolveAuthTokenFromCurrentProfile
+    resolveAuthTokenFromCurrentProfile,
+    OPENAI_BRIDGE_SETTINGS_FILE,
+    resolveOpenaiBridgeUpstream
 });
 
 function applyBuiltinProxyProvider(params = {}) {
@@ -8082,15 +8088,17 @@ function buildClaudeSharePayload(config = {}) {
     const apiKey = typeof config.apiKey === 'string' ? config.apiKey : '';
     const baseUrl = typeof config.baseUrl === 'string' ? config.baseUrl : '';
     const model = typeof config.model === 'string' ? config.model : '';
+    const targetApi = normalizeClaudeTargetApi(config.targetApi);
 
     if (!baseUrl) return { error: 'Claude Base URL 未设置' };
-    if (!apiKey) return { error: 'Claude API 密钥未设置' };
+    if (!apiKey && targetApi !== 'ollama') return { error: 'Claude API 密钥未设置' };
 
     return {
         payload: {
             baseUrl: baseUrl.trim(),
             apiKey: apiKey.trim(),
-            model: (model && model.trim()) || DEFAULT_CLAUDE_MODEL
+            model: (model && model.trim()) || DEFAULT_CLAUDE_MODEL,
+            targetApi
         }
     };
 }
@@ -9404,19 +9412,93 @@ function maskKey(key) {
     return key.substring(0, 4) + '...' + key.substring(key.length - 4);
 }
 
+function normalizeClaudeTargetApi(value) {
+    const raw = typeof value === 'string' ? value.trim().toLowerCase() : '';
+    if (raw === 'chat_completions' || raw === 'chat-completions' || raw === 'chat/completions') {
+        return 'chat_completions';
+    }
+    if (raw === 'ollama') {
+        return 'ollama';
+    }
+    return 'responses';
+}
+
+function resetBuiltinClaudeProxySavedSettingsToResponses() {
+    const proxySettingsResult = readJsonObjectFromFile(BUILTIN_CLAUDE_PROXY_SETTINGS_FILE, DEFAULT_BUILTIN_CLAUDE_PROXY_SETTINGS);
+    const proxySettings = proxySettingsResult.ok && proxySettingsResult.data && typeof proxySettingsResult.data === 'object' && !Array.isArray(proxySettingsResult.data)
+        ? proxySettingsResult.data
+        : DEFAULT_BUILTIN_CLAUDE_PROXY_SETTINGS;
+    writeJsonAtomic(BUILTIN_CLAUDE_PROXY_SETTINGS_FILE, {
+        ...DEFAULT_BUILTIN_CLAUDE_PROXY_SETTINGS,
+        ...proxySettings,
+        enabled: false,
+        targetApi: 'responses'
+    });
+}
+
 // 应用到 Claude Code settings.json（跨平台）
-function applyToClaudeSettings(config = {}) {
-    assertToolConfigWriteAllowed('claude');
+async function applyToClaudeSettings(config = {}) {
+    let proxyStarted = false;
     try {
+        assertToolConfigWriteAllowed('claude');
         const apiKey = (config.apiKey || '').trim();
-        if (!apiKey) {
+        const targetApi = normalizeClaudeTargetApi(config.targetApi);
+        if (!apiKey && targetApi !== 'ollama') {
             return { success: false, mode: 'settings-file', error: '请先输入 API Key' };
         }
 
-        const baseUrl = (config.baseUrl || 'https://open.bigmodel.cn/api/anthropic').trim();
+        const configuredBaseUrl = typeof config.baseUrl === 'string' ? config.baseUrl.trim() : '';
+        const baseUrl = (configuredBaseUrl || (targetApi === 'ollama' ? 'http://127.0.0.1:11434' : 'https://open.bigmodel.cn/api/anthropic')).trim();
         const model = (config.model || DEFAULT_CLAUDE_MODEL).trim();
+        let settingsBaseUrl = baseUrl;
+        let settingsApiKey = apiKey;
+        let proxyResult = null;
+
+        if (targetApi === 'chat_completions' || targetApi === 'ollama') {
+            const upstreamProviderName = typeof config.name === 'string' ? config.name.trim() : '';
+            if (targetApi === 'chat_completions' && !configuredBaseUrl && !upstreamProviderName) {
+                return {
+                    success: false,
+                    mode: 'claude-proxy',
+                    error: 'chat_completions 模式需要显式的上游 Base URL 或可解析的 provider 名称'
+                };
+            }
+            await stopBuiltinClaudeProxyRuntime();
+            const proxyToken = crypto.randomBytes(24).toString('hex');
+            proxyResult = await startBuiltinClaudeProxyRuntime({
+                enabled: true,
+                host: DEFAULT_BUILTIN_CLAUDE_PROXY_SETTINGS.host,
+                provider: upstreamProviderName,
+                authSource: 'provider',
+                targetApi,
+                timeoutMs: DEFAULT_BUILTIN_CLAUDE_PROXY_SETTINGS.timeoutMs,
+                upstreamProviderName,
+                ...(configuredBaseUrl ? { upstreamBaseUrl: configuredBaseUrl } : {}),
+                upstreamApiKey: apiKey
+            });
+            if (!proxyResult || proxyResult.error || proxyResult.success === false || !proxyResult.listenUrl) {
+                await stopBuiltinClaudeProxyRuntime();
+                resetBuiltinClaudeProxySavedSettingsToResponses();
+                return {
+                    success: false,
+                    mode: 'claude-proxy',
+                    error: (proxyResult && proxyResult.error) || '启动 Claude 兼容代理失败'
+                };
+            }
+            proxyStarted = true;
+            settingsBaseUrl = proxyResult.listenUrl;
+            settingsApiKey = proxyToken;
+        } else {
+            await stopBuiltinClaudeProxyRuntime();
+            resetBuiltinClaudeProxySavedSettingsToResponses();
+        }
+
         const readResult = readJsonObjectFromFile(CLAUDE_SETTINGS_FILE, {});
         if (!readResult.ok) {
+            if (proxyStarted) {
+                await stopBuiltinClaudeProxyRuntime();
+                resetBuiltinClaudeProxySavedSettingsToResponses();
+            }
             return { success: false, mode: 'settings-file', error: readResult.error };
         }
 
@@ -9427,8 +9509,8 @@ function applyToClaudeSettings(config = {}) {
 
         const nextEnv = {
             ...currentEnv,
-            ANTHROPIC_API_KEY: apiKey,
-            ANTHROPIC_BASE_URL: baseUrl,
+            ANTHROPIC_API_KEY: settingsApiKey,
+            ANTHROPIC_BASE_URL: settingsBaseUrl,
             ANTHROPIC_MODEL: model
         };
         delete nextEnv.ANTHROPIC_AUTH_TOKEN;
@@ -9445,7 +9527,8 @@ function applyToClaudeSettings(config = {}) {
 
         const result = {
             success: true,
-            mode: 'settings-file',
+            mode: targetApi === 'responses' ? 'settings-file' : 'claude-proxy',
+            targetApi,
             targetPath: CLAUDE_SETTINGS_FILE,
             updatedKeys: [
                 'env.ANTHROPIC_API_KEY',
@@ -9453,11 +9536,23 @@ function applyToClaudeSettings(config = {}) {
                 'env.ANTHROPIC_MODEL'
             ]
         };
+        if (proxyResult) {
+            result.proxy = {
+                running: true,
+                listenUrl: proxyResult.listenUrl,
+                upstreamProvider: proxyResult.upstreamProvider || '',
+                mode: proxyResult.mode || (targetApi === 'ollama' ? 'anthropic-to-ollama' : 'anthropic-to-chat-completions')
+            };
+        }
         if (backupPath) {
             result.backupPath = backupPath;
         }
         return result;
     } catch (e) {
+        if (proxyStarted) {
+            try { await stopBuiltinClaudeProxyRuntime(); } catch (_) {}
+            try { resetBuiltinClaudeProxySavedSettingsToResponses(); } catch (_) {}
+        }
         return {
             success: false,
             mode: 'settings-file',
@@ -9570,6 +9665,40 @@ async function restoreCodexDir(payload) {
 }
 
 // CLI: 一行写入 Claude Code 配置
+function parseClaudeCommandArgs(argv = []) {
+    const positionals = [];
+    let targetApi = 'responses';
+    for (let i = 0; i < argv.length; i += 1) {
+        const token = String(argv[i] ?? '');
+        if (token === '--target-api' || token === '--targetApi') {
+            const nextValue = String(argv[i + 1] ?? '');
+            if (!nextValue || nextValue.startsWith('--')) {
+                throw new Error('错误: --target-api 需要一个值（responses、chat_completions 或 ollama）');
+            }
+            targetApi = normalizeClaudeTargetApi(nextValue);
+            i += 1;
+            continue;
+        }
+        positionals.push(token);
+    }
+
+    const baseUrl = positionals[0];
+    if (targetApi === 'ollama' && positionals.length === 2) {
+        return {
+            baseUrl,
+            apiKey: '',
+            model: positionals[1],
+            targetApi
+        };
+    }
+    return {
+        baseUrl,
+        apiKey: positionals[1],
+        model: positionals[2],
+        targetApi
+    };
+}
+
 async function cmdClaude(args = []) {
     const argv = Array.isArray(args) ? args : [];
     // 无参数 → 代理启动
@@ -9577,7 +9706,7 @@ async function cmdClaude(args = []) {
         return runProxyCommand('Claude', 'claude', [], '', { autoFlag: '--dangerously-skip-permissions' });
     }
     // 有参数 → 配置写入
-    const [baseUrl, apiKey, model] = argv;
+    const { baseUrl, apiKey, model, targetApi } = parseClaudeCommandArgs(argv);
     const normalizedBaseUrl = typeof baseUrl === 'string' ? baseUrl.trim() : '';
     const normalizedKey = typeof apiKey === 'string' ? apiKey.trim() : '';
     const normalizedModel = typeof model === 'string' && model.trim()
@@ -9586,19 +9715,21 @@ async function cmdClaude(args = []) {
 
     const silent = false;
 
-    if (!normalizedBaseUrl || !normalizedKey) {
+    if (!normalizedBaseUrl || (!normalizedKey && targetApi !== 'ollama')) {
         if (!silent) {
-            console.error('用法: codexmate claude <BaseURL> <API密钥> [模型]');
+            console.error('用法: codexmate claude <BaseURL> <API密钥> [模型] [--target-api responses|chat_completions|ollama]');
             console.log('\n示例:');
             console.log('  codexmate claude https://open.bigmodel.cn/api/anthropic sk-ant-xxx glm-4.7');
+            console.log("  codexmate claude http://127.0.0.1:11434 '' llama3.1:8b --target-api ollama");
         }
-        throw new Error('BaseURL 和 API 密钥必填');
+        throw new Error(targetApi === 'ollama' ? 'BaseURL 必填' : 'BaseURL 和 API 密钥必填');
     }
 
-    const result = applyToClaudeSettings({
+    const result = await applyToClaudeSettings({
         baseUrl: normalizedBaseUrl,
         apiKey: normalizedKey,
-        model: normalizedModel
+        model: normalizedModel,
+        targetApi
     });
 
     if (!result || result.success === false) {
@@ -11105,6 +11236,31 @@ function createWebServer({ htmlPath, assetsDir, webDir, host, port, openBrowser
                         case 'install-status':
                             result = buildInstallStatusReport();
                             break;
+                        case 'version-status': {
+                            const currentVersion = (() => {
+                                try {
+                                    const pkg = require('./package.json');
+                                    return pkg && pkg.version ? pkg.version : '';
+                                } catch (_) {
+                                    return '';
+                                }
+                            })();
+                            try {
+                                const force = !!(params && params.force);
+                                result = await fetchLatestVersionStatus({ currentVersion, timeoutMs: 2000, cacheTtlMs: force ? 0 : undefined });
+                            } catch (e) {
+                                result = {
+                                    currentVersion,
+                                    latestVersion: '',
+                                    updateAvailable: false,
+                                    source: 'npm',
+                                    checkedAt: new Date().toISOString(),
+                                    cached: false,
+                                    error: e && e.message ? e.message : '获取最新版本失败'
+                                };
+                            }
+                            break;
+                        }
                         case 'list':
                             result = buildMcpProviderListPayload();
                             break;
@@ -11297,7 +11453,7 @@ function createWebServer({ htmlPath, assetsDir, webDir, host, port, openBrowser
                             result = applyClaudeSettingsRaw(params || {});
                             break;
                         case 'apply-claude-config':
-                            result = applyToClaudeSettings(params.config);
+                            result = await applyToClaudeSettings(params.config);
                             if (result && !result.error) {
                                 const cfgName = (params && params.config && typeof params.config.name === 'string') ? params.config.name : '';
                                 const cfgFrom = (params && typeof params.previousName === 'string') ? params.previousName : '';
@@ -15894,9 +16050,20 @@ function createMcpTools(options = {}) {
             properties: {
                 apiKey: { type: 'string' },
                 baseUrl: { type: 'string' },
-                model: { type: 'string' }
+                model: { type: 'string' },
+                name: { type: 'string' },
+                targetApi: { type: 'string' }
             },
-            required: ['apiKey'],
+            allOf: [{
+                if: {
+                    not: {
+                        type: 'object',
+                        properties: { targetApi: { type: 'string', pattern: '^[\\s]*[oO][lL][lL][aA][mM][aA][\\s]*$' } },
+                        required: ['targetApi']
+                    }
+                },
+                then: { required: ['apiKey'] }
+            }],
             additionalProperties: false
         },
         handler: async (args = {}) => applyToClaudeSettings(args || {})
@@ -16352,7 +16519,7 @@ function printMainHelp() {
     console.log('  codexmate add <名称> <URL> [密钥] [--bridge <openai>]');
     console.log('  codexmate delete <名称>    删除提供商');
     console.log('  codexmate claude            等同于 claude --dangerously-skip-permissions');
-    console.log('  codexmate claude <BaseURL> <API密钥> [模型]  写入 Claude Code 配置');
+    console.log('  codexmate claude <BaseURL> <API密钥> [模型] [--target-api responses|chat_completions|ollama]  写入 Claude Code 配置');
     console.log('  codexmate auth <list|import|switch|delete|status>  认证管理');
     console.log('  codexmate add-model <模型> 添加模型');
     console.log('  codexmate delete-model <模型> 删除模型');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codexmate",
-  "version": "0.0.43",
+  "version": "0.0.45",
   "description": "Codex/Claude Code/OpenClaw 配置、会话与任务编排 CLI + Web 工具",
   "main": "cli.js",
   "bin": {

package/web-ui/app.js

@@ -73,6 +73,7 @@ document.addEventListener('DOMContentLoaded', () => {
                 showOpenclawConfigModal: false,
                 showConfigTemplateModal: false,
                 showAgentsModal: false,
+                promptsSubTab: 'codex',
                 showSkillsModal: false,
                 showHealthCheckModal: false,
                 showCodexBridgePoolModal: false,
@@ -270,6 +271,12 @@ document.addEventListener('DOMContentLoaded', () => {
                 installRegistryPreset: 'default',
                 installRegistryCustom: '',
                 installStatusTargets: null,
+                appLatestVersion: '',
+                appVersionStatusLoading: false,
+                appVersionStatusError: '',
+                appVersionStatusChecked: false,
+                appVersionStatusCheckedAt: '',
+                appVersionStatusSource: '',
                 newProvider: { name: '', url: '', key: '', model: '', useTransform: false },
                 resetConfigLoading: false,
                 editingProvider: { name: '', url: '', key: '', readOnly: false, nonEditable: false },
@@ -277,12 +284,13 @@ document.addEventListener('DOMContentLoaded', () => {
                 currentClaudeConfig: '',
                 currentClaudeModel: '',
                 claudeCustomModelDraft: '',
-                editingConfig: { name: '', apiKey: '', baseUrl: '', model: '' },
+                editingConfig: { name: '', apiKey: '', baseUrl: '', model: '', targetApi: 'responses' },
                 claudeConfigs: {
                     '智谱GLM': {
                         apiKey: '',
                         baseUrl: 'https://open.bigmodel.cn/api/anthropic',
                         model: 'glm-4.7',
+                        targetApi: 'responses',
                         hasKey: false
                     }
                 },
@@ -290,7 +298,8 @@ document.addEventListener('DOMContentLoaded', () => {
                     name: '',
                     apiKey: '',
                     baseUrl: '',
-                    model: ''
+                    model: '',
+                    targetApi: 'responses'
                 },
                 currentOpenclawConfig: '',
                 openclawConfigs: {
@@ -478,7 +487,7 @@ document.addEventListener('DOMContentLoaded', () => {
             }
             {
                 const NAV_STATE_STORAGE_KEY = 'codexmateNavState.v1';
-                const mainTabSet = new Set(['dashboard', 'config', 'sessions', 'usage', 'orchestration', 'market', 'plugins', 'docs', 'settings', 'trash']);
+                const mainTabSet = new Set(['dashboard', 'config', 'sessions', 'usage', 'orchestration', 'market', 'plugins', 'docs', 'settings', 'trash', 'prompts']);
                 let restored = null;
                 try {
                     const raw = localStorage.getItem(NAV_STATE_STORAGE_KEY) || '';
@@ -554,6 +563,14 @@ document.addEventListener('DOMContentLoaded', () => {
                             config.apiKey = '';
                             config.hasKey = false;
                         }
+                        const targetApiRaw = typeof config.targetApi === 'string' ? config.targetApi.trim().toLowerCase() : '';
+                        if (targetApiRaw === 'chat_completions' || targetApiRaw === 'chat-completions' || targetApiRaw === 'chat/completions') {
+                            config.targetApi = 'chat_completions';
+                        } else if (targetApiRaw === 'ollama') {
+                            config.targetApi = 'ollama';
+                        } else {
+                            config.targetApi = 'responses';
+                        }
                     }
                     localStorage.setItem('claudeConfigs', JSON.stringify(this.claudeConfigs));
                 } catch (e) {
@@ -630,6 +647,9 @@ document.addEventListener('DOMContentLoaded', () => {
                             }
                         }
                     }
+                    if (typeof this.loadAppVersionStatus === 'function') {
+                        void this.loadAppVersionStatus({ silent: true });
+                    }
                     void this.refreshClaudeSelectionFromSettings({ silent: true });
                     void this.syncDefaultOpenclawConfigEntry({ silent: true });
                 };
@@ -691,6 +711,19 @@ document.addEventListener('DOMContentLoaded', () => {
             this.clearSessionTimelineRefs();
         },
 
+        watch: {
+            mainTab(newTab) {
+                if (newTab === 'prompts' && typeof this.loadPromptsContent === 'function') {
+                    this.loadPromptsContent();
+                }
+            },
+            promptsSubTab() {
+                if (this.mainTab === 'prompts' && typeof this.loadPromptsContent === 'function') {
+                    this.loadPromptsContent();
+                }
+            }
+        },
+
         computed: createAppComputed(),
         methods: createAppMethods()
     };

package/web-ui/index.html

@@ -24,6 +24,7 @@
     <!-- @include ./partials/index/panel-trash.html -->
     <!-- @include ./partials/index/panel-market.html -->
     <!-- @include ./partials/index/panel-plugins.html -->
+    <!-- @include ./partials/index/panel-prompts.html -->
     <!-- @include ./partials/index/layout-footer.html -->
     <!-- @include ./partials/index/modals-basic.html -->
     <!-- @include ./partials/index/modal-webhook.html -->

package/web-ui/logic.claude.mjs

@@ -69,13 +69,21 @@ export function normalizeClaudeConfig(config) {
     const useKey = normalizeClaudeValue(safe.useKey);
     const externalCredentialType = normalizeClaudeValue(safe.externalCredentialType)
         || (apiKey ? '' : (authToken ? 'auth-token' : (useKey ? 'claude-code-use-key' : '')));
+    const targetApiRaw = normalizeClaudeValue(safe.targetApi).toLowerCase();
+    let targetApi = 'responses';
+    if (targetApiRaw === 'chat_completions' || targetApiRaw === 'chat-completions' || targetApiRaw === 'chat/completions') {
+        targetApi = 'chat_completions';
+    } else if (targetApiRaw === 'ollama') {
+        targetApi = 'ollama';
+    }
     return {
         apiKey,
         baseUrl: normalizeClaudeValue(safe.baseUrl),
         model: normalizeClaudeValue(safe.model),
         authToken,
         useKey,
-        externalCredentialType
+        externalCredentialType,
+        targetApi
     };
 }
 
@@ -102,6 +110,60 @@ function normalizeClaudeComparableUrl(value) {
     return trimmed.replace(/\/+$/g, '');
 }
 
+function isLoopbackClaudeProxyUrl(value) {
+    const raw = normalizeClaudeComparableUrl(value);
+    if (!raw) return false;
+    try {
+        const parsed = new URL(raw);
+        if (parsed.protocol !== 'http:') return false;
+        const host = normalizeClaudeValue(parsed.hostname).toLowerCase();
+        return host === '127.0.0.1' || host === 'localhost' || host === '[::1]' || host === '::1';
+    } catch (_) {
+        return false;
+    }
+}
+
+export function isLikelyBuiltinClaudeProxySettingsEnv(env = {}) {
+    const normalized = normalizeClaudeSettingsEnv(env);
+    return !!(
+        normalized.baseUrl
+        && normalized.model
+        && /^[a-f0-9]{48}$/i.test(normalized.apiKey)
+        && isLoopbackClaudeProxyUrl(normalized.baseUrl)
+    );
+}
+
+function isClaudeTransformConfig(config = {}) {
+    const targetApi = normalizeClaudeConfig(config).targetApi;
+    return targetApi === 'chat_completions' || targetApi === 'ollama';
+}
+
+export function matchBuiltinClaudeProxyConfigFromSettings(claudeConfigs = {}, env = {}, preferredName = '') {
+    if (!isLikelyBuiltinClaudeProxySettingsEnv(env)) {
+        return '';
+    }
+    const normalizedSettings = normalizeClaudeSettingsEnv(env);
+    const preferred = normalizeClaudeValue(preferredName);
+    if (preferred && claudeConfigs && claudeConfigs[preferred]) {
+        const config = normalizeClaudeConfig(claudeConfigs[preferred]);
+        if (isClaudeTransformConfig(config) && config.model === normalizedSettings.model) {
+            return preferred;
+        }
+    }
+
+    const matches = [];
+    for (const [name, config] of Object.entries(claudeConfigs || {})) {
+        const normalizedConfig = normalizeClaudeConfig(config);
+        if (!isClaudeTransformConfig(normalizedConfig)) {
+            continue;
+        }
+        if (normalizedConfig.model === normalizedSettings.model) {
+            matches.push(name);
+        }
+    }
+    return matches.length === 1 ? matches[0] : '';
+}
+
 function hasClaudeCredential(config = {}) {
     return !!(config.apiKey || config.authToken || config.useKey);
 }
@@ -156,7 +218,8 @@ export function findDuplicateClaudeConfigName(claudeConfigs = {}, config) {
             continue;
         }
         if (normalizeClaudeComparableUrl(normalizedExisting.baseUrl) !== comparableUrl
-            || normalizedExisting.model !== normalized.model) {
+            || normalizedExisting.model !== normalized.model
+            || normalizedExisting.targetApi !== normalized.targetApi) {
             continue;
         }
         if (normalized.apiKey && normalizedExisting.apiKey === normalized.apiKey) {