最近在体验各种 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 的能力，又能统一接入企业模型网关，是目前比较成熟的落地方式之一。