数据不出域也能用 AI 编程，free-claude-code 本地化部署全记录

对于身处企业内网的开发团队而言代码资产的安全性往往高于一切。将核心业务逻辑上传至第三方云端 API不仅面临数据泄露的合规风险更可能触碰企业内部的安全红线。然而完全放弃 AI 辅助编程又意味着效率的倒退。如何在“数据不出域”的前提下依然享受类似 Claude Code 的智能编码体验free-claude-code开源项目提供了一套完美的本地化代理方案它不改变前端交互习惯却将后端推理能力完全收归内网实现了真正的私有化部署。构建本地模型后端Ollama 与 LM Studio实现数据私有化的第一步是搭建一个完全运行在本地或内网服务器上的大模型后端。这一步确保了所有推理计算都在内部完成无需任何外网请求。目前最主流的方案是使用Ollama或LM Studio。两者都支持加载常见的开源模型如 Llama 3、Qwen2.5-Coder 等并提供标准的 API 接口。若选择Ollama安装后只需在终端执行以下命令拉取并运行模型ollama pull qwen2.5-coder:7b ollama serve默认情况下Ollama 会监听http://localhost:11434。如果是部署在内网服务器上需确保该端口对开发机可见。若偏好图形化界面管理LM Studio是不错的选择。启动软件后在Local Server选项卡中加载模型并点击Start Server同样会暴露一个兼容 OpenAI 格式的 HTTP 端点。无论选择哪种方式目标都是获得一个稳定的、可访问的模型服务地址这是后续代理转发的基础。部署 free-claude-code 代理中间件有了本地模型后端接下来需要部署free-claude-code作为中间件。它的核心作用是将 Claude Code 客户端发出的 Anthropic 协议请求“翻译”并转发给我们刚才搭建的本地后端。该项目基于 Python 和 FastAPI 构建部署过程非常轻量。首先克隆项目源码并安装依赖推荐使用uv以加速环境配置git clone https://github.com/Alishahryar1/free-claude-code.git cd free-claude-code uv sync配置环节是关键。我们需要复制环境变量模板并根据内网实际情况修改.env文件cp .env.example .env在.env文件中重点配置后端路由。假设我们使用本地 Ollama配置如下# 指向本地 Ollama 服务 OLLAMA_BASE_URLhttp://localhost:11434 # 指定使用的本地模型名称 MODELollama/qwen2.5-coder:7b # 认证 Token可自定义客户端需保持一致 ANTHROPIC_AUTH_TOKENinternal-secure-token如果模型部署在局域网另一台服务器例如 IP 为192.168.1.50只需将OLLAMA_BASE_URL改为对应的内网 IP 即可。配置完成后启动代理服务uv run uvicorn server:app --host 0.0.0.0 --port 8082此时一个运行在8082端口的本地代理网关已准备就绪它正静静等待来自 IDE 的连接。IDE 集成与内网连接配置代理服务启动后最后一步是让 VS Code 或 JetBrains 系列 IDE 连接到这个本地端口而非官方云端。VS Code 配置在 VS Code 中可以通过设置环境变量或直接修改插件配置来指向本地代理。推荐在项目根目录创建.vscode/settings.json或在用户设置中添加claudeCode.environmentVariables: [ { name: ANTHROPIC_BASE_URL, value: http://localhost:8082 }, { name: ANTHROPIC_AUTH_TOKEN, value: internal-secure-token } ]保存后重启 VS CodeClaude Code 插件发出的所有请求将被重定向到本地的free-claude-code服务。JetBrains IDE 配置对于 IntelliJ IDEA、PyCharm 等用户需找到 ACP 代理的配置文件。通常位于~/.jetbrains/acp.json(macOS/Linux) 或%APPDATA%\JetBrains\acp.json(Windows)。添加如下配置块{ acp.registry.claude-acp: { env: { ANTHROPIC_BASE_URL: http://localhost:8082, ANTHROPIC_AUTH_TOKEN: internal-secure-token } } }重启 IDE 后即可在完全隔离的内网环境中使用智能代码补全和对话功能。内网环境调试与网络隔离技巧在严格网络隔离的企业环境中部署过程可能会遇到防火墙或端口占用问题。以下是几个实用的排查技巧端口占用检查若启动代理时报错Address already in use可使用netstat -ano | findstr :8082(Windows) 或lsof -i :8082(Linux/Mac) 查找占用进程必要时更换端口并在 IDE 配置中同步修改。防火墙策略如果模型后端部署在独立服务器上务必在服务器防火墙中放行 Ollama 默认端口11434以及代理服务器端口。在内网开发机上尝试curl http://服务器 IP:11434/api/tags验证连通性。日志监控free-claude-code启动时会输出详细日志。若 IDE 连接无响应观察代理服务端控制台是否有请求流入这能迅速判断是网络不通还是配置错误。通过这套方案企业开发团队既保留了 Claude Code 流畅的交互体验和强大的工程能力又彻底消除了数据出域的隐患。代码始终在本地流转模型推理在内网完成真正实现了安全与效率的平衡。对于对合规性有着严苛要求的金融、政务及核心研发部门这种“本地模型 代理中间件”的架构无疑是当前最稳妥的智能化升级路径。