1. Claude Code 装完却跑不起来问题出在哪Claude Code 是 Anthropic 推出的终端 AI 编程助手能直接在命令行里读写文件、执行命令、跑测试适合习惯在终端里干活的开发者。但很多人装完之后输入claude回车要么卡在登录引导要么直接报区域不可用根本进不了对话界面。这不是你装错了而是它默认连的是官方服务国内网络环境下走不通。解决办法是给它换一个能访问的模型后端。阿里云百炼提供了 Anthropic 兼容接口而且不少模型有免费额度正好拿来跑通第一个请求。这篇就聚焦 Claude Code 安装完成之后的那一步怎么通过settings.json把后端切到阿里云百炼怎么配环境变量以及怎么用一条最小对话确认免费额度真的生效了。整个路径分三块先确认 Claude Code 本身装好了再改配置文件指向百炼最后启动验证。如果你还没装 Claude Code用 npm 方式最稳npm install -g anthropic-ai/claude-code装完claude --version能看到版本号就行。下面默认你已经过了这一关。需要提前准备的东西不多一个阿里云账号、一个百炼的 API Key、以及 Claude Code 的安装目录位置。API Key 在百炼控制台里创建创建完先复制出来存好后面配置要用。2. 前置准备拿到百炼 API Key 并开启免费额度在动手改配置之前先把百炼这边的准备工作做完否则配置填对了也调不通。登录阿里云后进入百炼控制台找到 API Key 管理页面创建一个新的 Key。这个 Key 就是后面ANTHROPIC_AUTH_TOKEN的值相当于 Claude Code 和百炼之间的通行证。创建时注意复制完整关掉页面就看不到了。接着处理免费额度。百炼里很多模型提供免费试用 token但有个坑如果你不手动开启「免费额度用完即停」额度耗尽后会直接从账户余额扣费。开启方式有两种单个模型可以在模型详情页右侧找到开关模型多的话直接用批量开启一键把所有模型的用完即停都打开。选模型的时候留意一下兼容性。不是所有百炼模型都实现了 Anthropic 的 Messages 接口规范选错了会在对话时报错。实测下来deepseek-v4-pro这类是能正常对接的具体以百炼文档里标注支持 Anthropic 兼容的模型列表为准。选好模型名记下来配置里要填。如果你后续要在多个模型供应商之间来回切手动改settings.json会很烦。可以了解一下 CC Switch 这类切换工具它内置了主流供应商配置填个 API Key 就能切。不过第一次跑通建议还是先手动配把原理搞清楚。3. 可复制配置settings.json 骨架与环境变量写法Claude Code 的模型配置集中在用户主目录下的.claude/settings.json。不同系统路径不一样macOS / Linux 是~/.claude/settings.jsonWindows 是%USERPROFILE%\.claude\settings.json。文件不存在就手动创建一个注意.claude是目录settings.json是里面的文件。配置内容是一个 JSON 对象核心就三个字段放在env下面{ env: { ANTHROPIC_BASE_URL: https://dashscope.aliyuncs.com/apps/anthropic, ANTHROPIC_AUTH_TOKEN: 你的百炼API Key, ANTHROPIC_MODEL: deepseek-v4-pro } }三个字段的含义分别是ANTHROPIC_BASE_URL是百炼兼容 Anthropic 规范的基础地址固定填https://dashscope.aliyuncs.com/apps/anthropicANTHROPIC_AUTH_TOKEN填你刚创建的 API KeyANTHROPIC_MODEL填你选定的模型名。除了直接写死在 JSON 里也可以用环境变量方式适合不想把 Key 落盘的场景。在 shell 里导出export ANTHROPIC_BASE_URLhttps://dashscope.aliyuncs.com/apps/anthropic export ANTHROPIC_AUTH_TOKEN你的百炼API Key export ANTHROPIC_MODELdeepseek-v4-proWindows PowerShell 里对应写法$env:ANTHROPIC_BASE_URLhttps://dashscope.aliyuncs.com/apps/anthropic $env:ANTHROPIC_AUTH_TOKEN你的百炼API Key $env:ANTHROPIC_MODELdeepseek-v4-pro两种方式二选一即可settings.json优先级更高配了文件就不用再设环境变量。还有一个容易漏的步骤改.claude.json。这个文件在用户主目录下和.claude目录同级。Claude Code 启动时会检查新手引导状态没走完就会卡在登录或网络校验。在文件末尾追加一个字段hasCompletedOnboarding: true注意 JSON 格式追加前要在上一个字段末尾补一个英文逗号否则解析失败。改完大致长这样{ firstStartTime: 2026-05-11T08:36:03.501Z, migrationVersion: 13, hasCompletedOnboarding: true }这一步做完启动时就会跳过引导直接进工作模式。4. 验证请求一条最小对话确认额度生效配置改完新开一个终端窗口输入claude启动。第一次会问工作空间是否可信选 yes接着问是否使用自定义 API Key也选 yes。启动成功后输入/model应该能看到你配置的模型名说明配置被读到了。接下来发一条最小对话验证额度。别一上来就问复杂问题先用一句话确认链路通不通你好请回复配置成功四个字如果模型正常返回说明 Base URL、Key、模型名三项都对免费额度也在正常消耗。这时候可以去百炼控制台看用量统计确认 token 确实在扣免费额度而不是账户余额。如果返回报错先看错误类型。常见的是模型不支持 Anthropic 兼容换一个模型名再试。切换模型只需要改settings.json里的ANTHROPIC_MODEL然后exit退出 Claude 再重新启动配置才会重新加载。对话时有个小技巧把背景描述清楚对输出要求写具体。泛泛地问模型也就泛泛地答token 花了但没拿到有用结果。比如别问「帮我优化代码」而是贴出代码、说明语言和优化目标这样一次对话就能拿到能用的东西。5. 本篇常见错排查启动报区域不可用或卡在登录.claude.json里的hasCompletedOnboarding没设成true或者 JSON 格式错了漏逗号、多了逗号。用 JSON 校验工具过一遍。对话报模型不支持ANTHROPIC_MODEL填的模型没实现 Anthropic 兼容。换成百炼文档里明确标注兼容的模型比如deepseek-v4-pro。401 鉴权失败ANTHROPIC_AUTH_TOKEN填错或 Key 已失效。回百炼控制台重新创建一个注意别把 Key 前后的空格带进去。改了配置不生效Claude Code 启动时读一次配置改完必须exit退出再重新claude启动热改不生效。额度被扣了钱免费额度用完即停没开。回百炼控制台批量开启已经扣的没法退但能防止继续扣。npm 安装超时先设国内镜像npm config set registry https://registry.npmmirror.com/再重新装。Windows 下命令不兼容Claude Code 原生为 Linux/macOS 设计Windows 需要装 Git 做命令转换装完git -v能出版本号即可。排查顺序建议从鉴权到模型再到网络先确认 Key 有效再确认模型兼容最后看 Base URL 有没有写错。大部分问题出在前两步。6. 后续怎么走从跑通到日常用起来跑通第一个请求只是起点。日常用 Claude Code 干活token 消耗比想象中快100 万免费额度认真用几天就没了。所以免费额度用完即停一定要开着同时养成看用量统计的习惯。如果你要在多个模型之间切换比如写代码用这个、写文档用那个手动改settings.json效率太低。这时候可以上 CC Switch 这类工具它读取你已有的配置内置主流供应商模板填 Key 就能切。配置自定义供应商时必填的是 API Key、请求地址就是ANTHROPIC_BASE_URL和模型映射其他保持默认。想省事的话TaoToken 提供了统一的接入入口模型对话、Coding Plan、API Key 管理都有对应页面配置方式和本篇一致把 Base URL 和 Key 换掉即可。接入文档里有各模型的兼容说明排障时对照着看能少走弯路。最后提醒一句配置类文件改之前先备份尤其是.claude.json格式错了会导致启动失败。养成改完先校验 JSON 的习惯能省掉很多莫名其妙的报错。