Claude Code与本地模型集成实战：解决Skill无法调用的技术方案

1次阅读

没有评论

共计 2685 个字符，预计需要花费 7 分钟才能阅读完成。

很多开发者在尝试将 Claude Code 与本地模型集成时，会遇到 Skill 无法调用的问题。典型现象包括：

401 未授权错误
功能请求无响应
超时错误
返回结果格式不符预期

这些问题通常源于几个方面：

授权配置不正确
API 接口不兼容
数据格式不匹配
网络连接问题

Claude 官方 API 和本地模型 API 存在几个关键差异：

认证方式：Claude 使用 OAuth2.0，而本地模型可能使用简单的 API 密钥或 JWT
端点地址：Claude 有固定域名，本地模型通常是 IP+ 端口
请求格式：Claude 通常用 JSON，本地模型可能支持多种格式

在混合环境中使用 OAuth2.0 需要注意：

确保重定向 URI 配置正确
处理 token 刷新机制
管理不同环境的凭证

输入输出数据需要转换时考虑：

字段名映射
数据类型转换
错误处理

import requests
from typing import Dict, Any
from datetime import datetime, timedelta

class ClaudeLocalAdapter:
    """处理 Claude Code 与本地模型集成的适配器"""

    def __init__(self, local_model_url: str, client_id: str, client_secret: str):
        self.local_model_url = local_model_url
        self.client_id = client_id
        self.client_secret = client_secret
        self.access_token = None
        self.token_expiry = None

    def get_auth_token(self) -> str:
        """获取 OAuth2.0 访问令牌"""
        if self.access_token and datetime.now() < self.token_expiry:
            return self.access_token

        auth_url = "https://api.claude.ai/oauth2/token"
        payload = {
            "grant_type": "client_credentials",
            "client_id": self.client_id,
            "client_secret": self.client_secret
        }

        try:
            response = requests.post(auth_url, data=payload)
            response.raise_for_status()
            token_data = response.json()
            self.access_token = token_data["access_token"]
            self.token_expiry = datetime.now() + timedelta(seconds=token_data["expires_in"] - 60)  # 提前 60 秒过期
            return self.access_token
        except Exception as e:
            raise Exception(f"获取 token 失败: {str(e)}")

    def format_request(self, claude_input: Dict[str, Any]) -> Dict[str, Any]:
        """将 Claude 输入格式转换为本地模型格式"""
        return {"text": claude_input["prompt"],
            "params": {"temperature": claude_input.get("temperature", 0.7),
                "max_tokens": claude_input.get("max_tokens", 200)
            }
        }

    def format_response(self, local_response: Dict[str, Any]) -> Dict[str, Any]:
        """将本地模型响应转换为 Claude 格式"""
        return {
            "choices": [{"text": local_response["generated_text"],
                "index": 0,
                "finish_reason": "length"
            }]
        }

    def call_skill(self, skill_input: Dict[str, Any], retries: int = 3) -> Dict[str, Any]:
        """调用 skill 并处理重试逻辑"""
        token = self.get_auth_token()
        headers = {"Authorization": f"Bearer {token}",
            "Content-Type": "application/json"
        }

        local_format = self.format_request(skill_input)

        for attempt in range(retries):
            try:
                response = requests.post(
                    self.local_model_url,
                    json=local_format,
                    headers=headers,
                    timeout=30
                )
                response.raise_for_status()
                local_response = response.json()
                return self.format_response(local_response)
            except Exception as e:
                if attempt == retries - 1:
                    raise
                continue

        raise Exception("所有重试尝试均失败")

确保检查以下配置项：