要让 CC-Switch（开源名通常为 code-switch）将 Claude Code 的请求转发到本地运行的模型（例如通过 Ollama 运行的本地模型），核心原理是利用 CC-Switch 在本地建立的代理服务（默认端口通常为 18100 或 15721），将 Claude Code 的 API 格式转换为兼容本地模型的接口。

以下是具体的设置步骤：
第一步：准备本地模型（以 Ollama 为例）

确保你的本地模型服务已经启动，并且开启了 API 监听。

下载并运行 Ollama，启动一个适合代码生成的本地模型（例如 qwen2.5-coder 或 deepseek-coder）。

默认情况下，Ollama 会在本地的 http://127.0.0.1:11434 开启 OpenAI 兼容接口。你可以通过浏览器访问该地址，看到 Ollama is running 说明正常。

第二步：在 CC-Switch 中添加本地供应商

打开 CC-Switch 客户端。

在主界面顶部选中 Claude Code 图标，点击右上角的 「+」（添加新供应商）。

填写本地模型的配置信息：

    供应商名称：自定义（例如 Ollama-Local）

    接口类型：选择 OpenAI 或 Custom（取决于 CC-Switch 提供的选项，Ollama 完美兼容 OpenAI 接口规范）

    请求地址 (Base URL)：输入你本地模型的 API 地址。

        如果是 Ollama，输入： http://127.0.0.1:11434/v1

    API Key：本地模型通常不需要 Key，但为了通过 Claude Code 的校验，可以随意填一个占位符（例如 ollama 或 local-key）。

配置模型映射（关键步骤）：
展开高级选项中的模型映射（Model Mapping）。Claude Code 内部写死了向 claude-3-5-sonnet 等模型发送请求，你需要把它们映射为你本地模型的实际名称：

    主模型 / Sonnet 默认模型：输入你本地模型的真实名称（例如 qwen2.5-coder:7b 或 deepseek-r1:14b）。

    Haiku 默认模型：也可以映射为相同的本地模型。

点击保存/添加，并在主界面点击该供应商右侧的 「启用」。

第三步：配置 Claude Code 环境变量

CC-Switch 启用后，会在本地创建一个代理端口（假设为默认的 http://127.0.0.1:18100）。你需要告诉 Claude Code 将请求发送到 CC-Switch，而不是 Anthropic 官方服务器。

打开你的终端，根据操作系统执行以下命令：

对于 Linux / macOS：
Bash

export ANTHROPIC_BASE_URL=http://127.0.0.1:15721
export ANTHROPIC_AUTH_TOKEN=local-key

（注：如果永久生效，可以将上述两行写入 ~/.bashrc 或 ~/.zshrc 中）

对于 Windows (PowerShell)：
PowerShell

$env:ANTHROPIC_BASE_URL="http://127.0.0.1:15721"
$env:ANTHROPIC_AUTH_TOKEN="local-key"

第四步：启动 Claude Code 测试

在配置好环境变量的终端里，进入你的项目目录，直接运行：
Bash

claude

此时，Claude Code 发出的所有指令都会经过 CC-Switch，被自动转换为本地模型的接口，从而实现完全本地化/免费的代码助手体验。

⚠️ 避坑提示：
如果启动后报错提示连接超时或认证失败，请检查 CC-Switch 主页左上角「设置」中的 路由监听地址与端口，确保第参步中的 ANTHROPIC_BASE_URL 端口号（如 18100 或 15721）与 CC-Switch 实际监听的端口完全一致。

标签: none

添加新评论