最近在体验各种 AI Coding 工具时,发现 Claude Code 在代码理解、项目分析、多文件修改等方面表现相当不错。
不过对于很多企业用户来说,直接连接 Anthropic 官方服务并不方便。幸运的是,Databricks 已经提供了 Anthropic Endpoint,我们可以让 Claude Code 直接接入企业内部的 Databricks 服务,从而使用 Claude 模型。
本文记录完整配置过程,帮助大家快速完成部署。
一、环境说明
本文测试环境:
二、安装 Node.js
Claude Code 基于 Node.js 运行,因此首先需要安装 Node.js。
官方下载地址:
https://nodejs.org/en/download
建议安装:
LTS 长期支持版本
Node.js 20.x 及以上
安装完成后打开 PowerShell:
node --version
npm --version
正常情况下会看到类似输出:
v20.19.5
10.8.2
说明安装成功。
三、安装 Claude Code
执行:
npm install -g @anthropic-ai/claude-code
等待安装完成。
验证安装:
claude
或者:
claude --version
能够正常显示版本号即表示安装成功。
四、首次启动 Claude Code
第一次运行:
claude
Claude 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_URL
Databricks Anthropic Endpoint 地址。
示例:
https://adb-xxxxxxxxxxxxx.azuredatabricks.net/serving-endpoints/anthropic
需要替换为自己的 Endpoint。
ANTHROPIC_AUTH_TOKEN
Databricks Personal Access Token。
格式通常为:
dapiXXXXXXXXXXXXXXXXXXXX
需要具备 Endpoint 调用权限。
ANTHROPIC_MODEL
指定调用模型:
"ANTHROPIC_MODEL": "databricks-claude-opus-4-6"
如果企业部署的是其他模型,可以自行替换。
language
设置 Claude Code 默认语言:
"language": "中文"
这样 Claude 会优先使用中文回复。
八、启动测试
重新打开 PowerShell:
claude
或者:
claude hello
如果返回正常结果,说明配置成功。
例如:
你好,我是 Claude...
九、常见问题
1. Claude 无法启动
执行:
$env:CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS="1"
然后重新启动:
claude
2. 提示 Token 无效
检查:
Token 是否正确
Token 是否过期
是否拥有 Endpoint 权限
重点确认:
"ANTHROPIC_AUTH_TOKEN"
配置无误。
3. 提示连接失败
检查:
Databricks Workspace 是否正常
Endpoint 是否已启动
网络是否能够访问 Databricks
4. Claude 一直进入欢迎界面
检查:
"hasCompletedOnboarding": true
是否配置成功。
十、常用命令
查看版本:
claude --version
启动 Claude:
claude
进入项目目录:
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 的能力,又能统一接入企业模型网关,是目前比较成熟的落地方式之一。