如果你是第一次在机器上装 Claude Code我建议你先别急着敲npm install -g anthropic-ai/claude-code因为装完很可能迎面就是一堆玄学报错。这个命令行 AI 编程助手确实好用但它的安装和初始化链条比普通工具长很多要装 Node、配权限、登录授权、还可能遇到连不上 Anthropic 服务、权限不足、VSCode 里模型切不过来等各种乱七八糟的问题。这篇文章把我从 Windows、macOS 到 VSCode 插件、多模型切换的整套安装实战经验整理出来踩过的坑和最后采用的解法都在里面适合所有准备上 Claude Code 的开发者参考。1. 环境准备先把版本、终端、网络这三件事理顺我见过不少人卡在安装第一步其实问题不是命令敲错而是底子没打好。Claude Code 依赖 Node.js 环境而它的安装器对 Node 版本有硬性要求很多人用的是旧版 Node 或者系统自带的 Python 版 Node装完直接报错。另外它在不同系统上的权限模型完全不一样macOS 要处理“完全访问权限”Windows 要处理终端执行策略和 PATH这些不做提前准备后面每一步都像踩地雷。1.1 安装前必须确认的三个前置条件第一是 Node.js 版本。Claude Code 官方要求 Node 18 以上我实际测试下来 Node 20 LTS 和 Node 22 LTS 最稳。如果你机器上版本很低我强烈建议你用 nvm 管理 Node而不是直接下载安装包覆盖系统因为后面多模型切换时你可能需要切换 Node 版本来测兼容性。macOS 和 Linux 用curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bashWindows 用 nvm-windows 的安装包装完记得重启终端。第二是终端环境。macOS 上首选自带 Terminal 或者 iTerm2Windows 上千万别用老旧的 CMD 或者 PowerShell 5.1建议安装 Windows Terminal同时把执行策略调整一下否则后面运行claude命令很容易被脚本安全策略挡住。执行这个命令就行Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser选 Y 确认。第三是网络连通性。Claude Code 安装本身走 npm 源但初始化登录和实际请求都要访问 Anthropic 的服务。如果你所在网络访问不太稳定安装时就可能卡在下载阶段。这种事不用慌先确认网络本身是正常的再给 npm 配一个镜像源加速官方包的体积不大但拉不下来确实让人抓狂。1.2 macOS 和 Windows 在权限模型上的关键差异macOS 上 Claude Code 要读取你的代码文件、执行终端命令这涉及到系统级的“完全磁盘访问权限”。很多人在 macOS 上装完 Claude Code启动后能运行但无法读取项目文件就是因为在“系统设置 - 隐私与安全性 - 完全磁盘访问权限”里没有把终端程序或者 iTerm2勾上。这个权限没开AI 看到的项目结构和内容就是空的但它不会直接报错看起来一切正常实际干活时完全没反应。Windows 上没有这个磁盘权限概念但会遇到另一类问题npm 的全局安装路径常常不在系统 PATH 里。npm 全局包默认安装在%APPDATA%\npm目录如果你不是通过官方安装包而是通过其他方式装的 Node这个目录可能没有自动加入 PATH结果就是你安装成功但敲claude提示“不是内部或外部命令”。这种情况不用重新安装手动把路径加进系统环境变量就行。权限问题还有一个隐藏点Claude Code 启动后会要求你给它“完全访问权限”这个不是系统权限而是工具内部的授权机制。它默认每个操作都会弹一次确认如果你不希望每次都手动确认可以通过配置文件设置 allow 规则这部分我后面专门写一节因为很多人第一次用就被这个交互烦到弃坑。2. 安装与初始化从 npm 命令到授权登录的完整链路环境准备好之后安装过程本身其实很简短但有几个关键节点特别容易出问题。我在这里把每个步骤的预期输出和异常表现都写清楚你照着走能省不少排查时间。2.1 全局安装、版本验证与常见 npm 报错安装命令就一条npm install -g anthropic-ai/claude-code。如果你 npm 默认源比较慢可以先设置镜像源再安装npm config set registry https://registry.npmmirror.com装完再切回来或者保留都行不影响 Claude Code 本身的运行。安装完成后用claude --version验证能看到版本号说明核心命令已经落地了安装过程通常在一分钟以内。如果你在这一步遇到EACCES: permission denied报错这通常是权限问题而不是软件问题。macOS 上可以给 npm 全局目录改权限sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}Windows 上则检查是否用了管理员权限。还有一类报错是npm ERR! code EINTEGRITY这是下载包校验失败清一下 npm 缓存再重试npm cache clean --force。注意不要为了省事直接sudo npm install -g这会把全局模块的所有权搞乱后面升级和卸载都会遇到权限障碍。用 chown 修正目录归属才是干净的方案。2.2 登录授权、macOS 完全访问权限配置第一次运行claude它会提示登录 Anthropic 账号。命令会生成一个一次性授权码同时自动打开浏览器你在页面上确认之后回到终端就能进入交互界面。这里有个小技巧如果你在远程服务器上操作浏览器没法自动打开可以用命令输出的授权链接配合手动复制到本地浏览器完成授权授权码有效时间大概是 5 分钟别拖太久。macOS 用户在这一步还会面临完全磁盘访问权限的问题。我建议你在第一次启动 Claude Code 之前就直接去“系统设置 - 隐私与安全性 - 完全磁盘访问权限”把你用的终端程序Terminal、iTerm2、或者 VSCode打开开关。否则 Claude Code 初始化时会尝试读取用户目录下的配置文件明明文件存在却读不到表现出来就是登录正常但/status里显示的项目状态异常或者模型回答的上下文不完整。这个开关改完需要重启终端一定要记住。登录成功后会看到类似欢迎页的界面输入/status能看到当前账号信息和权限状态这里显示正常再开始正式使用。另外我在初始化阶段还做过一个小验证随便打开一个项目目录让 Claude Code 读一下package.json确认它能看得到文件内容再进入实际开发。这一步也就十秒钟但能提前暴露权限问题避免干到一半才发现 AI 看不到代码。3. 多模型配置接 DeepSeek、GLM 以及 CC Switch 切换工具Claude Code 最大的吸引力之一在于它不只绑死 Anthropic 的模型可以通过环境变量或工具链接入其他模型服务商。这一点让它在国内的实用性大幅提升。不过这里面的配置细节坑特别多配置错一个字段工具就直接无法连接服务而且报错信息往往看不出明确的错误原因。3.1 通过环境变量配置 DeepSeek 和 GLM 的两种路径Claude Code 默认读取三个关键环境变量ANTHROPIC_MODEL设置模型、ANTHROPIC_BASE_URL设置接口地址、ANTHROPIC_AUTH_TOKEN设置认证令牌。当你把ANTHROPIC_BASE_URL指向 DeepSeek 或 GLM 兼容接口时Claude Code 就会把请求发到对应服务器而不是 Anthropic 官方。以 DeepSeek 为例我用的配置是这样的在终端中临时设置export ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropic export ANTHROPIC_AUTH_TOKEN你的DeepSeek_API_Key export ANTHROPIC_MODELdeepseek-chatGLM 的接入方式类似export ANTHROPIC_BASE_URLhttps://open.bigmodel.cn/api/anthropic export ANTHROPIC_AUTH_TOKEN你的GLM_API_Key export ANTHROPIC_MODELglm-4.6这两组 URL 要以服务商官方文档为准不同时间可能调整路径。设置完后运行claude对话时用/status或者--model参数确认当前实际请求的模型名称很多人在这一步发现工具还是连接 Anthropic就是因为环境变量在终端会话里没有生效。3.2 用 CC Switch 管理多套配置避免反复改环境变量如果你跟我一样要在 Anthropic、DeepSeek、GLM 之间来回切换手动改环境变量非常容易出错。更常见的是你设置了 DeepSeek 的变量换回 Anthropic 时忘了取消结果所有请求都报错。我用的是 CC Switch 这类配置切换工具它可以管理多套 provider 配置一键切换。CC Switch 的主要逻辑是把每套配置Provider 名称、Base URL、API Key、默认模型存成一个 profile切换时自动注入到 Claude Code 的启动环境中。我个人的配置思路是建三个 profileAnthropic 官方baseUrl 默认值key 填官方订阅或 API Keymodel 用 sonnetDeepSeek 平替baseUrl 指向 DeepSeekkey 填 DeepSeek APImodel 用 deepseek-chatGLM 备选baseUrl 指向 GLMkey 填 GLM APImodel 用 glm-4.6切到 DeepSeek 跑一轮和切到 Anthropic 跑一轮对话历史会保留但模型记忆不共享这个要心里有数。另外配置完成后我第一次切换遇到一个问题工具显示已切换但实际请求还是走原来的 provider。排查后发现是配置文件里的 provider id 冲突每个 provider 的 id 必须唯一不能把两个都写成anthropic否则切换脚本匹配错了直接跳过。3.3 在 VSCode 插件中同时配置多个模型的实操方案VSCode 里安装 Claude Code 扩展后可以通过工作区设置settings.json来配置多个模型。这个场景特别适合同时需要 DeepSeek 和 GLM 对比测试的人。我采用的做法是创建一个.vscode/settings.json在里面预设两个 profile配合扩展提供的模型切换下拉框{ claude-code.baseUrl: https://api.deepseek.com/anthropic, claude-code.apiKey: 你的DeepSeek_API_Key, claude-code.model: deepseek-chat }换另一个 model 时把这几个字段整体替换成 GLM 的配置。因为 VSCode 扩展读取的是当前工作区的设置不同项目可以配置不同的模型这个特性非常适合按项目类型分流。不过要注意如果你在系统环境变量里也设置了ANTHROPIC_BASE_URLVSCode 扩展有可能会优先读取环境变量导致工作区设置不生效。我踩过这个坑解决方法是把全局环境变量清掉完全依靠 VSCode 的 settings.json 来管理。4. 桌面版与 CLI 的协同WebUI、可视化和客户端选择很多人不知道 Claude Code 其实有两套交互形态一套是纯命令行界面另一套是桌面客户端。命令行适合深度嵌入开发流程桌面版适合可视化查看文件变更和对话上下文。两者可以共用同一套配置文件和登录凭据不必重复配置但前提是你对它们的配置目录关系了解清楚。4.1 桌面版的安装位置与配置文件关系Claude Code Desktop 是独立客户端安装包下载后直接拖进应用程序目录即可。macOS 上打开后它会自动读取~/.claude目录下的配置包括你的登录凭据和 API Key 设置。也就是说如果你的 CLI 已经登录过桌面版启动后可以免登录直接使用这一点官方没有特别强调但实际体验确实如此。桌面版比较适合的场景是看长对话的上下文管理和文件状态追踪。它有一个比较直观的变更视图AI 改动的文件会分门别类列出来这对 review 代码很有帮助。命令行做不到这种可视化只能靠git diff自己看。不过桌面版在模型切换上跟 CLI 走同一套环境变量如果你用 CC Switch 切到 DeepSeek桌面版也会跟着生效这一点实测下来是同步的。4.2 WebUI 模式不装客户端的轻量方案如果你不想装任何客户端又想体验图形界面可以用 Claude Code 自带的 WebUI 模式。在项目目录直接运行claude --webui它会启动一个本地服务并在浏览器打开交互页面。这个方案的优点是零安装、界面干净同时支持文件浏览和对话输入。缺点是本地服务占用端口如果你同时开很多项目端口冲突会比较烦。我遇到过的一个典型报错是EADDRINUSE提示端口被占。解决方式很简单找到占用进程杀掉或者让 Claude Code 换一个端口启动。WebUI 模式适合快速演示和临时用一下日常开发我还是推荐命令行或者桌面版因为和终端工作流结合得更紧密。5. 高频报错排查与卸载重装实战这个章节是重点中的重点。我整理了自己和社群朋友们在安装和配置 Claude Code 时最容易踩的几个问题每一个都给了明确的排查顺序和最终解法。如果你按照上面的安装流程走还会出问题大概率能在这一节找到答案。5.1 无法连接 Anthropic 服务网络排查顺序Unable to connect to Anthropic services是安装和登录阶段最常见的错误表现形式是命令行提示连接失败、超时或者初始化时直接闪退。很多人的第一反应是重装但重装往往没用因为问题根本不在 Claude Code而在网络和 DNS 解析链路。我的排查顺序是第一步检查 Node 版本用node -v确认是 18 以上版本过低直接可能导致请求库异常第二步清理系统 DNS 缓存macOS 执行sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponderWindows 执行ipconfig /flushdns很多连接失败是缓存了错误解析结果导致的第三步是给 Node 设置 IPv4 优先解析某些网络环境对 IPv6 支持不完整导致请求发起后一直等待执行NODE_OPTIONS--dns-result-orderipv4first基本能解决第四步检查系统时间证书校验对时间敏感系统时间偏移超过几分钟就会拒绝连接。注意如果你同时开了多个模型提供方配置确认当前环境变量里ANTHROPIC_BASE_URL没有被历史配置污染。我遇到过claude一直连不上 Anthropic最后发现是之前测试 DeepSeek 时设置的ANTHROPIC_BASE_URL还在环境变量里没清除。5.2 权限相关Permission denied、EPERM、无法读取文件权限问题分三层。第一层是系统权限macOS 上要检查“完全磁盘访问权限”Windows 上检查终端是否用管理员身份运行第二层是 npm 全局目录权限报EPERM或者EACCES时用前面说的 chown 修复第三层是 Claude Code 内部权限它默认对 Bash 命令、文件读写都有一层确认机制如果你不想每次都手动确认可以在配置文件~/.claude/settings.json里设置权限规则{ permissions: { allow: [ Bash(npm run *), Bash(git *), Read(**), Edit(**), Write(**) ], deny: [] } }设置完重启 Claude Code允许列表里的操作就不会再弹确认框了。这里要提醒一句Edit(**)和Write(**)意味着 AI 可以改你整个项目的所有文件建议只在信任的项目目录下开启。我个人的配置方式是 deny 列表里加入Bash(rm -rf *)这类高危命令给 AI 留个保险丝。5.3 完整卸载与清理残留推荐的可复现步骤卸载 Claude Code 不是简单删一个命令。很多人卸载后重新安装发现配置还在或者旧版本的行为还在就是因为没有清理用户级配置文件。推荐按这个顺序执行全局卸载命令npm uninstall -g anthropic-ai/claude-code会移除命令行程序。删除配置文件目录rm -rf ~/.claude和rm -rf ~/.config/claude-code会清空登录凭据和自定义配置。如果你装过桌面版还要把~/Library/Application Support/Claude-Code目录一并删除。检查环境变量清掉ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_MODEL等残留项。最后在终端运行which claude确认命令已不存在。重新安装时按这个顺序走一遍就能得到一个完全干净的环境。特别是那些反复报Unable to connect的疑难杂症很多其实是旧配置里某个错误 URL 一直在生效清理后重装直接就好了。5.4 常见问题速查表我总结一张速查表覆盖安装配置阶段最高频的十来个问题方便你遇到异常时直接对号入座现象可能原因推荐解法npm install 报 EACCESnpm 全局目录权限不足chown 修正目录归属避免 sudo 安装claude 命令找不到npm 全局目录不在 PATH手动将%APPDATA%\npm加入环境变量启动报 Unable to connectDNS 缓存或 IPv6 异常清理 DNS 缓存设置 IPv4 优先启动报 EADDRINUSEWebUI 端口冲突换端口或关闭占用进程macOS 读取不到文件完全磁盘访问权限未开启系统设置中给终端开权限并重启每次操作都弹确认框工具内部权限未配置在 settings.json 中配置 permissions allow切模型后仍走旧模型profile id 冲突检查配置中每个 provider 的 id 唯一性VSCode 插件配置不生效环境变量覆盖工作区设置清除全局环境变量只保留 settings.json登录授权后白屏网络或时间偏差检查系统时间准确性刷新授权页面升级失败残留旧版本未清理配置目录按卸载流程清理后重新安装6. 我实际用下来的几个建议多次安装和配置下来我最大的感受是不要迷信“一条命令安装完成”的流程描述。Claude Code 的安装链路过长任何一个环节的健康度都会影响最终结果。建议第一次上手时先用一个空目录或者临时项目跑通全流程确认 CLI、权限、模型都能正常工作再进入真实项目。这样如果把某个项目配置搞坏了也不会牵连正式环境。在模型选择上我的个人经验是不同模型在代码生成质量上的差异很大。Anthropic 官方模型对复杂项目结构和多文件重构的理解更稳但 DeepSeek 在中文语境和代码解释上有自己的优势GLM 则在文档生成场景表现不错。建议按任务类型来切换模型架构设计用官方模型写测试用例和注释用 DeepSeek代码 review 说明用 GLM。这种组合拳比我一开始只用一个模型时的效率提升明显。多模型切换还有一个隐藏的好处就是你对模型能力边界会有更清晰的感知。用 CC Switch 同时保留三套配置日常切换几乎零成本一旦某个模型出问题一键切到另一个继续干活不会让开发流程中断。最后再分享一个小技巧如果你在 VSCode 里同时装了其他 AI 插件建议把 Claude Code 的快捷键单独设置一组避免跟其他插件冲突。我因为这个问题花了半小时排查为什么快捷键调不出来结果只是两个插件占用了同一个组合键。工具链越复杂越需要给自己留出一点整理配置的时间这个时间花得很值。
Claude Code安装配置实战：环境准备、多模型切换与高频报错排查
如果你是第一次在机器上装 Claude Code我建议你先别急着敲npm install -g anthropic-ai/claude-code因为装完很可能迎面就是一堆玄学报错。这个命令行 AI 编程助手确实好用但它的安装和初始化链条比普通工具长很多要装 Node、配权限、登录授权、还可能遇到连不上 Anthropic 服务、权限不足、VSCode 里模型切不过来等各种乱七八糟的问题。这篇文章把我从 Windows、macOS 到 VSCode 插件、多模型切换的整套安装实战经验整理出来踩过的坑和最后采用的解法都在里面适合所有准备上 Claude Code 的开发者参考。1. 环境准备先把版本、终端、网络这三件事理顺我见过不少人卡在安装第一步其实问题不是命令敲错而是底子没打好。Claude Code 依赖 Node.js 环境而它的安装器对 Node 版本有硬性要求很多人用的是旧版 Node 或者系统自带的 Python 版 Node装完直接报错。另外它在不同系统上的权限模型完全不一样macOS 要处理“完全访问权限”Windows 要处理终端执行策略和 PATH这些不做提前准备后面每一步都像踩地雷。1.1 安装前必须确认的三个前置条件第一是 Node.js 版本。Claude Code 官方要求 Node 18 以上我实际测试下来 Node 20 LTS 和 Node 22 LTS 最稳。如果你机器上版本很低我强烈建议你用 nvm 管理 Node而不是直接下载安装包覆盖系统因为后面多模型切换时你可能需要切换 Node 版本来测兼容性。macOS 和 Linux 用curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bashWindows 用 nvm-windows 的安装包装完记得重启终端。第二是终端环境。macOS 上首选自带 Terminal 或者 iTerm2Windows 上千万别用老旧的 CMD 或者 PowerShell 5.1建议安装 Windows Terminal同时把执行策略调整一下否则后面运行claude命令很容易被脚本安全策略挡住。执行这个命令就行Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser选 Y 确认。第三是网络连通性。Claude Code 安装本身走 npm 源但初始化登录和实际请求都要访问 Anthropic 的服务。如果你所在网络访问不太稳定安装时就可能卡在下载阶段。这种事不用慌先确认网络本身是正常的再给 npm 配一个镜像源加速官方包的体积不大但拉不下来确实让人抓狂。1.2 macOS 和 Windows 在权限模型上的关键差异macOS 上 Claude Code 要读取你的代码文件、执行终端命令这涉及到系统级的“完全磁盘访问权限”。很多人在 macOS 上装完 Claude Code启动后能运行但无法读取项目文件就是因为在“系统设置 - 隐私与安全性 - 完全磁盘访问权限”里没有把终端程序或者 iTerm2勾上。这个权限没开AI 看到的项目结构和内容就是空的但它不会直接报错看起来一切正常实际干活时完全没反应。Windows 上没有这个磁盘权限概念但会遇到另一类问题npm 的全局安装路径常常不在系统 PATH 里。npm 全局包默认安装在%APPDATA%\npm目录如果你不是通过官方安装包而是通过其他方式装的 Node这个目录可能没有自动加入 PATH结果就是你安装成功但敲claude提示“不是内部或外部命令”。这种情况不用重新安装手动把路径加进系统环境变量就行。权限问题还有一个隐藏点Claude Code 启动后会要求你给它“完全访问权限”这个不是系统权限而是工具内部的授权机制。它默认每个操作都会弹一次确认如果你不希望每次都手动确认可以通过配置文件设置 allow 规则这部分我后面专门写一节因为很多人第一次用就被这个交互烦到弃坑。2. 安装与初始化从 npm 命令到授权登录的完整链路环境准备好之后安装过程本身其实很简短但有几个关键节点特别容易出问题。我在这里把每个步骤的预期输出和异常表现都写清楚你照着走能省不少排查时间。2.1 全局安装、版本验证与常见 npm 报错安装命令就一条npm install -g anthropic-ai/claude-code。如果你 npm 默认源比较慢可以先设置镜像源再安装npm config set registry https://registry.npmmirror.com装完再切回来或者保留都行不影响 Claude Code 本身的运行。安装完成后用claude --version验证能看到版本号说明核心命令已经落地了安装过程通常在一分钟以内。如果你在这一步遇到EACCES: permission denied报错这通常是权限问题而不是软件问题。macOS 上可以给 npm 全局目录改权限sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}Windows 上则检查是否用了管理员权限。还有一类报错是npm ERR! code EINTEGRITY这是下载包校验失败清一下 npm 缓存再重试npm cache clean --force。注意不要为了省事直接sudo npm install -g这会把全局模块的所有权搞乱后面升级和卸载都会遇到权限障碍。用 chown 修正目录归属才是干净的方案。2.2 登录授权、macOS 完全访问权限配置第一次运行claude它会提示登录 Anthropic 账号。命令会生成一个一次性授权码同时自动打开浏览器你在页面上确认之后回到终端就能进入交互界面。这里有个小技巧如果你在远程服务器上操作浏览器没法自动打开可以用命令输出的授权链接配合手动复制到本地浏览器完成授权授权码有效时间大概是 5 分钟别拖太久。macOS 用户在这一步还会面临完全磁盘访问权限的问题。我建议你在第一次启动 Claude Code 之前就直接去“系统设置 - 隐私与安全性 - 完全磁盘访问权限”把你用的终端程序Terminal、iTerm2、或者 VSCode打开开关。否则 Claude Code 初始化时会尝试读取用户目录下的配置文件明明文件存在却读不到表现出来就是登录正常但/status里显示的项目状态异常或者模型回答的上下文不完整。这个开关改完需要重启终端一定要记住。登录成功后会看到类似欢迎页的界面输入/status能看到当前账号信息和权限状态这里显示正常再开始正式使用。另外我在初始化阶段还做过一个小验证随便打开一个项目目录让 Claude Code 读一下package.json确认它能看得到文件内容再进入实际开发。这一步也就十秒钟但能提前暴露权限问题避免干到一半才发现 AI 看不到代码。3. 多模型配置接 DeepSeek、GLM 以及 CC Switch 切换工具Claude Code 最大的吸引力之一在于它不只绑死 Anthropic 的模型可以通过环境变量或工具链接入其他模型服务商。这一点让它在国内的实用性大幅提升。不过这里面的配置细节坑特别多配置错一个字段工具就直接无法连接服务而且报错信息往往看不出明确的错误原因。3.1 通过环境变量配置 DeepSeek 和 GLM 的两种路径Claude Code 默认读取三个关键环境变量ANTHROPIC_MODEL设置模型、ANTHROPIC_BASE_URL设置接口地址、ANTHROPIC_AUTH_TOKEN设置认证令牌。当你把ANTHROPIC_BASE_URL指向 DeepSeek 或 GLM 兼容接口时Claude Code 就会把请求发到对应服务器而不是 Anthropic 官方。以 DeepSeek 为例我用的配置是这样的在终端中临时设置export ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropic export ANTHROPIC_AUTH_TOKEN你的DeepSeek_API_Key export ANTHROPIC_MODELdeepseek-chatGLM 的接入方式类似export ANTHROPIC_BASE_URLhttps://open.bigmodel.cn/api/anthropic export ANTHROPIC_AUTH_TOKEN你的GLM_API_Key export ANTHROPIC_MODELglm-4.6这两组 URL 要以服务商官方文档为准不同时间可能调整路径。设置完后运行claude对话时用/status或者--model参数确认当前实际请求的模型名称很多人在这一步发现工具还是连接 Anthropic就是因为环境变量在终端会话里没有生效。3.2 用 CC Switch 管理多套配置避免反复改环境变量如果你跟我一样要在 Anthropic、DeepSeek、GLM 之间来回切换手动改环境变量非常容易出错。更常见的是你设置了 DeepSeek 的变量换回 Anthropic 时忘了取消结果所有请求都报错。我用的是 CC Switch 这类配置切换工具它可以管理多套 provider 配置一键切换。CC Switch 的主要逻辑是把每套配置Provider 名称、Base URL、API Key、默认模型存成一个 profile切换时自动注入到 Claude Code 的启动环境中。我个人的配置思路是建三个 profileAnthropic 官方baseUrl 默认值key 填官方订阅或 API Keymodel 用 sonnetDeepSeek 平替baseUrl 指向 DeepSeekkey 填 DeepSeek APImodel 用 deepseek-chatGLM 备选baseUrl 指向 GLMkey 填 GLM APImodel 用 glm-4.6切到 DeepSeek 跑一轮和切到 Anthropic 跑一轮对话历史会保留但模型记忆不共享这个要心里有数。另外配置完成后我第一次切换遇到一个问题工具显示已切换但实际请求还是走原来的 provider。排查后发现是配置文件里的 provider id 冲突每个 provider 的 id 必须唯一不能把两个都写成anthropic否则切换脚本匹配错了直接跳过。3.3 在 VSCode 插件中同时配置多个模型的实操方案VSCode 里安装 Claude Code 扩展后可以通过工作区设置settings.json来配置多个模型。这个场景特别适合同时需要 DeepSeek 和 GLM 对比测试的人。我采用的做法是创建一个.vscode/settings.json在里面预设两个 profile配合扩展提供的模型切换下拉框{ claude-code.baseUrl: https://api.deepseek.com/anthropic, claude-code.apiKey: 你的DeepSeek_API_Key, claude-code.model: deepseek-chat }换另一个 model 时把这几个字段整体替换成 GLM 的配置。因为 VSCode 扩展读取的是当前工作区的设置不同项目可以配置不同的模型这个特性非常适合按项目类型分流。不过要注意如果你在系统环境变量里也设置了ANTHROPIC_BASE_URLVSCode 扩展有可能会优先读取环境变量导致工作区设置不生效。我踩过这个坑解决方法是把全局环境变量清掉完全依靠 VSCode 的 settings.json 来管理。4. 桌面版与 CLI 的协同WebUI、可视化和客户端选择很多人不知道 Claude Code 其实有两套交互形态一套是纯命令行界面另一套是桌面客户端。命令行适合深度嵌入开发流程桌面版适合可视化查看文件变更和对话上下文。两者可以共用同一套配置文件和登录凭据不必重复配置但前提是你对它们的配置目录关系了解清楚。4.1 桌面版的安装位置与配置文件关系Claude Code Desktop 是独立客户端安装包下载后直接拖进应用程序目录即可。macOS 上打开后它会自动读取~/.claude目录下的配置包括你的登录凭据和 API Key 设置。也就是说如果你的 CLI 已经登录过桌面版启动后可以免登录直接使用这一点官方没有特别强调但实际体验确实如此。桌面版比较适合的场景是看长对话的上下文管理和文件状态追踪。它有一个比较直观的变更视图AI 改动的文件会分门别类列出来这对 review 代码很有帮助。命令行做不到这种可视化只能靠git diff自己看。不过桌面版在模型切换上跟 CLI 走同一套环境变量如果你用 CC Switch 切到 DeepSeek桌面版也会跟着生效这一点实测下来是同步的。4.2 WebUI 模式不装客户端的轻量方案如果你不想装任何客户端又想体验图形界面可以用 Claude Code 自带的 WebUI 模式。在项目目录直接运行claude --webui它会启动一个本地服务并在浏览器打开交互页面。这个方案的优点是零安装、界面干净同时支持文件浏览和对话输入。缺点是本地服务占用端口如果你同时开很多项目端口冲突会比较烦。我遇到过的一个典型报错是EADDRINUSE提示端口被占。解决方式很简单找到占用进程杀掉或者让 Claude Code 换一个端口启动。WebUI 模式适合快速演示和临时用一下日常开发我还是推荐命令行或者桌面版因为和终端工作流结合得更紧密。5. 高频报错排查与卸载重装实战这个章节是重点中的重点。我整理了自己和社群朋友们在安装和配置 Claude Code 时最容易踩的几个问题每一个都给了明确的排查顺序和最终解法。如果你按照上面的安装流程走还会出问题大概率能在这一节找到答案。5.1 无法连接 Anthropic 服务网络排查顺序Unable to connect to Anthropic services是安装和登录阶段最常见的错误表现形式是命令行提示连接失败、超时或者初始化时直接闪退。很多人的第一反应是重装但重装往往没用因为问题根本不在 Claude Code而在网络和 DNS 解析链路。我的排查顺序是第一步检查 Node 版本用node -v确认是 18 以上版本过低直接可能导致请求库异常第二步清理系统 DNS 缓存macOS 执行sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponderWindows 执行ipconfig /flushdns很多连接失败是缓存了错误解析结果导致的第三步是给 Node 设置 IPv4 优先解析某些网络环境对 IPv6 支持不完整导致请求发起后一直等待执行NODE_OPTIONS--dns-result-orderipv4first基本能解决第四步检查系统时间证书校验对时间敏感系统时间偏移超过几分钟就会拒绝连接。注意如果你同时开了多个模型提供方配置确认当前环境变量里ANTHROPIC_BASE_URL没有被历史配置污染。我遇到过claude一直连不上 Anthropic最后发现是之前测试 DeepSeek 时设置的ANTHROPIC_BASE_URL还在环境变量里没清除。5.2 权限相关Permission denied、EPERM、无法读取文件权限问题分三层。第一层是系统权限macOS 上要检查“完全磁盘访问权限”Windows 上检查终端是否用管理员身份运行第二层是 npm 全局目录权限报EPERM或者EACCES时用前面说的 chown 修复第三层是 Claude Code 内部权限它默认对 Bash 命令、文件读写都有一层确认机制如果你不想每次都手动确认可以在配置文件~/.claude/settings.json里设置权限规则{ permissions: { allow: [ Bash(npm run *), Bash(git *), Read(**), Edit(**), Write(**) ], deny: [] } }设置完重启 Claude Code允许列表里的操作就不会再弹确认框了。这里要提醒一句Edit(**)和Write(**)意味着 AI 可以改你整个项目的所有文件建议只在信任的项目目录下开启。我个人的配置方式是 deny 列表里加入Bash(rm -rf *)这类高危命令给 AI 留个保险丝。5.3 完整卸载与清理残留推荐的可复现步骤卸载 Claude Code 不是简单删一个命令。很多人卸载后重新安装发现配置还在或者旧版本的行为还在就是因为没有清理用户级配置文件。推荐按这个顺序执行全局卸载命令npm uninstall -g anthropic-ai/claude-code会移除命令行程序。删除配置文件目录rm -rf ~/.claude和rm -rf ~/.config/claude-code会清空登录凭据和自定义配置。如果你装过桌面版还要把~/Library/Application Support/Claude-Code目录一并删除。检查环境变量清掉ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_MODEL等残留项。最后在终端运行which claude确认命令已不存在。重新安装时按这个顺序走一遍就能得到一个完全干净的环境。特别是那些反复报Unable to connect的疑难杂症很多其实是旧配置里某个错误 URL 一直在生效清理后重装直接就好了。5.4 常见问题速查表我总结一张速查表覆盖安装配置阶段最高频的十来个问题方便你遇到异常时直接对号入座现象可能原因推荐解法npm install 报 EACCESnpm 全局目录权限不足chown 修正目录归属避免 sudo 安装claude 命令找不到npm 全局目录不在 PATH手动将%APPDATA%\npm加入环境变量启动报 Unable to connectDNS 缓存或 IPv6 异常清理 DNS 缓存设置 IPv4 优先启动报 EADDRINUSEWebUI 端口冲突换端口或关闭占用进程macOS 读取不到文件完全磁盘访问权限未开启系统设置中给终端开权限并重启每次操作都弹确认框工具内部权限未配置在 settings.json 中配置 permissions allow切模型后仍走旧模型profile id 冲突检查配置中每个 provider 的 id 唯一性VSCode 插件配置不生效环境变量覆盖工作区设置清除全局环境变量只保留 settings.json登录授权后白屏网络或时间偏差检查系统时间准确性刷新授权页面升级失败残留旧版本未清理配置目录按卸载流程清理后重新安装6. 我实际用下来的几个建议多次安装和配置下来我最大的感受是不要迷信“一条命令安装完成”的流程描述。Claude Code 的安装链路过长任何一个环节的健康度都会影响最终结果。建议第一次上手时先用一个空目录或者临时项目跑通全流程确认 CLI、权限、模型都能正常工作再进入真实项目。这样如果把某个项目配置搞坏了也不会牵连正式环境。在模型选择上我的个人经验是不同模型在代码生成质量上的差异很大。Anthropic 官方模型对复杂项目结构和多文件重构的理解更稳但 DeepSeek 在中文语境和代码解释上有自己的优势GLM 则在文档生成场景表现不错。建议按任务类型来切换模型架构设计用官方模型写测试用例和注释用 DeepSeek代码 review 说明用 GLM。这种组合拳比我一开始只用一个模型时的效率提升明显。多模型切换还有一个隐藏的好处就是你对模型能力边界会有更清晰的感知。用 CC Switch 同时保留三套配置日常切换几乎零成本一旦某个模型出问题一键切到另一个继续干活不会让开发流程中断。最后再分享一个小技巧如果你在 VSCode 里同时装了其他 AI 插件建议把 Claude Code 的快捷键单独设置一组避免跟其他插件冲突。我因为这个问题花了半小时排查为什么快捷键调不出来结果只是两个插件占用了同一个组合键。工具链越复杂越需要给自己留出一点整理配置的时间这个时间花得很值。
