Claude Code 接入 Databricks Claude 模型完整教程（Windows 版）

最近在体验各种 AI Coding 工具时发现 Claude Code 在代码理解、项目分析、多文件修改等方面表现相当不错。不过对于很多企业用户来说直接连接 Anthropic 官方服务并不方便。幸运的是Databricks 已经提供了 Anthropic Endpoint我们可以让 Claude Code 直接接入企业内部的 Databricks 服务从而使用 Claude 模型。本文记录完整配置过程帮助大家快速完成部署。一、环境说明本文测试环境项目版本WindowsWindows 10 / Windows 11Node.js20.x LTSClaude Code最新版本模型databricks-claude-opus-4-6接入方式Databricks Anthropic Endpoint二、安装 Node.jsClaude Code 基于 Node.js 运行因此首先需要安装 Node.js。官方下载地址Node.js — Download Node.js®建议安装LTS 长期支持版本Node.js 20.x 及以上安装完成后打开 PowerShellnode --version npm --version正常情况下会看到类似输出v20.19.5 10.8.2说明安装成功。三、安装 Claude Code执行npm install -g anthropic-ai/claude-code等待安装完成。验证安装claude或者claude --version能够正常显示版本号即表示安装成功。四、首次启动 Claude Code第一次运行claudeClaude Code 会自动在用户目录创建配置文件C:\Users\用户名\.claude.json例如C:\Users\Administrator\.claude.json五、跳过首次引导可选Claude Code 首次运行会进入 Onboarding 流程。如果希望直接跳过可以修改C:\Users\用户名\.claude.json确认存在以下配置{ hasCompletedOnboarding: true }如果没有该字段手工添加即可。注意事项很多网上教程会贴出完整的.claude.json文件。实际上并不建议直接复制。因为里面包含大量 Claude 自动生成的信息例如{ userID: ..., lastSessionId: ..., lastModelUsage: {}, lastCost: 0.05 }这些数据属于用户标识会话记录模型调用统计本地运行状态Claude Code 会自动维护无需手工修改。真正需要关注的只有{ hasCompletedOnboarding: true }六、配置 Databricks Endpoint进入用户目录C:\Users\用户名\.claude如果不存在则手工创建。例如C:\Users\Administrator\.claude然后创建settings.json完整路径C:\Users\Administrator\.claude\settings.json内容如下{ env: { DISABLE_AUTOUPDATER: 1, CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: 1, ANTHROPIC_BASE_URL: https://你的Databricks地址/serving-endpoints/anthropic, ANTHROPIC_AUTH_TOKEN: 你的dapi开头Token, ANTHROPIC_MODEL: databricks-claude-opus-4-6 }, language: 中文 }七、配置项说明DISABLE_AUTOUPDATER关闭自动更新DISABLE_AUTOUPDATER: 1避免 Claude Code 自动升级导致配置失效。CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC关闭非必要网络请求CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: 1减少额外网络访问。ANTHROPIC_BASE_URLDatabricks Anthropic Endpoint 地址。示例https://adb-xxxxxxxxxxxxx.azuredatabricks.net/serving-endpoints/anthropic需要替换为自己的 Endpoint。ANTHROPIC_AUTH_TOKENDatabricks Personal Access Token。格式通常为dapiXXXXXXXXXXXXXXXXXXXX需要具备 Endpoint 调用权限。ANTHROPIC_MODEL指定调用模型ANTHROPIC_MODEL: databricks-claude-opus-4-6如果企业部署的是其他模型可以自行替换。language设置 Claude Code 默认语言language: 中文这样 Claude 会优先使用中文回复。八、启动测试重新打开 PowerShellclaude或者claude hello如果返回正常结果说明配置成功。例如你好我是 Claude...九、常见问题1. Claude 无法启动执行$env:CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS1然后重新启动claude2. 提示 Token 无效检查Token 是否正确Token 是否过期是否拥有 Endpoint 权限重点确认ANTHROPIC_AUTH_TOKEN配置无误。3. 提示连接失败检查Databricks Workspace 是否正常Endpoint 是否已启动网络是否能够访问 Databricks4. Claude 一直进入欢迎界面检查hasCompletedOnboarding: true是否配置成功。十、常用命令查看版本claude --version启动 Claudeclaude进入项目目录cd D:\Project claude查看帮助claude --help十一、卸载 Claude Code执行npm uninstall -g anthropic-ai/claude-code验证claude --version如果提示命令不存在则说明卸载成功。总结通过以上步骤我们完成了Node.js 安装Claude Code 安装跳过首次引导配置Databricks Anthropic Endpoint 接入中文环境配置常见问题排查至此Claude Code 已经可以直接通过 Databricks 调用 Claude 模型在本地终端中完成代码生成、代码重构、项目分析、自动化开发等工作。对于企业内部开发环境来说这种方案既保留了 Claude Code 的能力又能统一接入企业模型网关是目前比较成熟的落地方式之一。