Claude Code安装与配置图文详解教程：从Windows Terminal到settings.json

Claude Code安装与配置图文详解教程：从Windows Terminal到settings.json

发布时间：2026/10/8 22:02:33
Claude Code安装与配置图文详解教程：从Windows Terminal到settings.json 1. Windows 下跑 Claude Code 到底卡在哪npm 全局安装与终端环境那些坑很多人第一次在 Windows 上装 Claude Code卡住的地方往往不是命令本身而是环境没理顺。Claude Code 是一个跑在终端里的命令行工具它依赖 Node.js 的 npm 生态来分发所以你的 Windows 上必须先有一个能正常工作的 Node 环境再谈安装。我见过太多人直接复制npm install -g anthropic-ai/claude-code就回车结果报一堆EACCES、command not found或者claude 不是内部或外部命令本质上都是环境链路没打通。先说清楚 Claude Code 是什么、能做什么、适合谁。它是一个终端里的 AI 编程助手你可以在命令行里直接跟它对话让它读你的项目文件、改代码、跑命令、解释报错。适合的人包括习惯用命令行干活的开发者、想在自己项目目录里让 AI 直接操作文件的同学、以及想把模型调用接进本地工作流的人。它不是一个图形界面软件所以你得接受在终端里敲字交互。Windows 环境下的完整链路大致是这样先装一个顺手的终端Windows Terminal 是目前体验最好的选择再确认 Node.js 和 npm 可用然后用 npm 全局安装 Claude Code接着在用户目录下创建.claude/settings.json配置文件把模型接入参数写进去最后在终端里跑claude验证调用是否生效。这条链路里任何一环出问题后面都会连锁报错。我实测下来最容易翻车的三个点第一是 npm 默认源在国内下载慢甚至超时导致安装中断第二是全局安装路径没进 PATH装完了却找不到命令第三是 settings.json 的路径或 JSON 格式写错Claude Code 启动时读不到配置直接报认证失败。这篇就按这条链路一步步走把每个环节的命令、配置和验证都写清楚你照着做就能在本地跑通。关于模型接入Claude Code 本身支持通过环境变量把请求指向兼容 Anthropic 接口的服务。你可以用官方接口也可以接入其他兼容服务。本文会以接入 DeepSeek 为例演示配置写法同时说明如果你想用 TaoToken 这类聚合服务配置结构是完全一样的只是 Base URL 和 Key 换成对应的即可。这样你不管用哪家配置方法都能复用。2. 装 Claude Code 前的前置准备Node、npm 镜像与 TaoToken 接入位在敲安装命令之前先把地基打好。Claude Code 依赖 Node.js 18 及以上版本npm 会随 Node 一起装上。你可以先打开 Windows Terminal执行node -v和npm -v看版本。如果提示找不到命令说明 Node 还没装或者没进 PATH去 Node 官网下载 LTS 版本安装包安装时记得勾选“Add to PATH”。Node 装好后第一件事是换 npm 镜像源。默认源在国内访问经常慢到超时安装大包时尤其明显。执行下面这条命令把源切到国内镜像npm config set registry https://registry.npmmirror.com执行完可以用npm config get registry确认是否生效输出应该是你刚设置的那个地址。这一步能显著提升后续安装的成功率别跳过。接下来是 TaoToken 的接入位。TaoToken 是一个模型调用聚合服务提供兼容 Anthropic 接口的 Base URL你可以把它理解成一个“统一入口”把 Claude Code 的请求转发到你想用的模型上。它的 API 地址是https://taotoken.net/api你需要在控制台里创建一个 API Key后面写进 settings.json。如果你还没账号可以先到官网了解https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。注册后在控制台的 API Keys 页面生成一个 Key复制保存好这个 Key 只会完整显示一次。这里要强调一个概念Claude Code 通过环境变量ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN来决定请求发往哪里、用什么凭证。所以不管你接哪家服务本质都是改这两个值。TaoToken 的 Base URL 填https://taotoken.net/apiKey 填你刚生成的那串。模型 ID 则根据你在 TaoToken 里想调用的模型来填比如你想用 Claude 系列就填对应的模型名想用 DeepSeek 就填 DeepSeek 的模型 ID。如果你打算长期用 Claude Code 做编码或 Agent 任务可以考虑 TaoToken 的 Coding Plan它在持续调用场景下更划算入口在 https://taotoken.net/api 相关页面里能找到。不过这一步不是必须的先用按量计费跑通也行。前置准备清单Node 18 已装且进 PATH、npm 镜像已切换、TaoToken 账号和 API Key 已就绪、Windows Terminal 已安装。这四样齐了再往下走就不会卡在环境上。3. 可复制配置settings.json 核心参数与 DeepSeek/TaoToken 接入写法这一节是全文的核心配置写对了后面基本就顺了。Claude Code 读取配置的默认路径是C:\Users\你的用户名\.claude\settings.json。注意.claude是个隐藏文件夹如果不存在就手动创建然后在里面新建settings.json文件。用记事本或 VS Code 打开都行但保存时确保编码是 UTF-8避免中文乱码。先给一份接入 DeepSeek 的完整配置你可以直接复制把 Key 换成自己的{ env: { ANTHROPIC_BASE_URL: https://api.deepseek.com/anthropic, ANTHROPIC_AUTH_TOKEN: 你的DeepSeek API Key, ANTHROPIC_MODEL: deepseek-v4-pro[1m], ANTHROPIC_DEFAULT_OPUS_MODEL: deepseek-v4-pro[1m], ANTHROPIC_DEFAULT_SONNET_MODEL: deepseek-v4-pro[1m], ANTHROPIC_DEFAULT_HAIKU_MODEL: deepseek-v4-flash[1m], CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: 1, CLAUDE_CODE_EFFORT_LEVEL: max } }逐字段说明一下。ANTHROPIC_BASE_URL是请求地址接 DeepSeek 就填它的 Anthropic 兼容端点。ANTHROPIC_AUTH_TOKEN是你的凭证注意这里用的是 AUTH_TOKEN 而不是 API_KEY两者在 Claude Code 里语义不同填错会报 401。ANTHROPIC_MODEL是默认模型ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODEL分别对应 Claude Code 内部按任务复杂度分级的模型槽位你可以都指向同一个模型也可以按需分配。CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC设为 1 可以关掉非必要的遥测请求减少干扰。CLAUDE_CODE_EFFORT_LEVEL控制推理投入程度max 表示尽量用足。如果你要用 TaoToken 接入配置结构完全一样只改 Base URL 和 Key模型 ID 换成 TaoToken 支持的模型名{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: 你的TaoToken API Key, ANTHROPIC_MODEL: 你的模型ID, ANTHROPIC_DEFAULT_OPUS_MODEL: 你的模型ID, ANTHROPIC_DEFAULT_SONNET_MODEL: 你的模型ID, ANTHROPIC_DEFAULT_HAIKU_MODEL: 你的模型ID, CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: 1, CLAUDE_CODE_EFFORT_LEVEL: max } }这里的三件套要记牢Base URL、Key、Model ID。任何一家兼容服务你都得把这三个值填对。Base URL 决定请求去哪Key 决定你有没有权限Model ID 决定实际调用哪个模型。三者缺一不可错一个就会报错。注意settings.json 必须是合法 JSON不能有注释、不能有多余逗号。写完可以用在线 JSON 校验工具过一遍或者用node -e JSON.parse(require(fs).readFileSync(C:/Users/你的用户名/.claude/settings.json,utf8))验证。另外如果你之前用过 Claude Code 的登录流程可能会在.claude目录下留下 OAuth 相关的凭证文件这些和 settings.json 里的 AUTH_TOKEN 可能冲突。如果配置后仍报认证错误检查一下目录里有没有旧的凭证缓存必要时清理掉再试。配置写完后Claude Code 启动时会自动读取这个文件。你也可以通过环境变量临时覆盖但在 Windows 上持久化配置还是推荐写进 settings.json省得每次开终端都要设一遍。4. 安装与验证npm 全局安装命令、终端启动与模型调用确认配置就绪后回到 Windows Terminal 执行安装。先确认镜像源已切换然后跑全局安装npm install -g anthropic-ai/claude-code安装过程会拉取依赖包网络正常的话一两分钟能完成。如果卡住不动多半是源的问题回头检查npm config get registry。安装完成后验证版本claude --version能打印出版本号就说明命令已进 PATH。如果提示claude 不是内部或外部命令说明 npm 全局 bin 目录没进 PATH。你可以用npm config get prefix查到全局路径然后把这个路径加到系统环境变量 Path 里重启终端再试。接下来启动 Claude Code。先切到你的项目目录比如cd D:\projects\demo然后输入claude首次启动会进入一个交互界面可能会让你选择终端匹配模式用光标选1.Auto(match terminal)回车即可。之后它会读取 settings.json 里的配置尝试连接你设置的 Base URL。如果配置正确你会看到它进入对话状态可以开始输入问题。验证模型调用是否真的生效最直接的办法是问一个它能回答的问题比如“用一句话解释什么是递归”。如果它正常返回内容说明请求已经打到模型并拿到响应。如果报错重点看错误信息401 通常是 Key 或 AUTH_TOKEN 的问题连接超时多半是 Base URL 写错或网络不通reading choices之类的报错往往和响应格式或模型 ID 不匹配有关。你也可以用一条更明确的命令来测试非交互模式比如让它解释一个文件claude 解释一下当前目录下 package.json 的作用如果它能读取文件并给出解释说明文件访问和模型调用都正常。这一步跑通整个链路就算打通了。提示如果你在 TaoToken 控制台想确认调用记录可以到模型对话页面发一条测试消息对照返回结果和 Claude Code 里的输出是否一致这样能快速定位是配置问题还是服务问题。实测下来验证环节最值得花时间。很多人装完就以为好了结果真正用的时候才发现模型没调通。花两分钟做一次明确的调用测试比后面debug半天划算得多。5. 常见报错排查401、local proxy failed、reading choices 与 OAuth 冲突这一节把几个高频报错拆开讲你遇到时可以对号入座。401 认证失败。这是最常见的。原因通常是ANTHROPIC_AUTH_TOKEN填错、Key 过期、或者把 API_KEY 和 AUTH_TOKEN 搞混了。检查方法确认 settings.json 里的 Key 和你复制的一致没有多余空格或换行。如果你用的是 TaoToken去控制台 API Keys 页面确认这个 Key 还在有效期内。另外注意有些服务要求请求头用x-api-key而 Claude Code 用的是Authorization: Bearer如果你接的服务不兼容这种鉴权方式也会报 401。TaoToken 的接口是兼容 Anthropic 鉴权格式的正常填 AUTH_TOKEN 即可。local proxy failed。这个报错通常出现在你配置了本地代理或者 Base URL 指向了本地地址但服务没起来的情况。检查ANTHROPIC_BASE_URL是不是写成了http://localhost:xxxx之类如果你没有在本地跑代理服务就不要填本地地址。另外如果你系统里设了全局 HTTP 代理环境变量Claude Code 可能会尝试走代理导致失败检查一下HTTP_PROXY、HTTPS_PROXY这些变量必要时清掉。reading choices 相关报错。这类错误一般和响应结构有关常见于模型 ID 填错、或者接入的服务返回格式和 Anthropic 接口不一致。先确认ANTHROPIC_MODEL填的是服务方真实支持的模型 ID大小写和连字符都要对。如果模型 ID 没问题检查 Base URL 是否指向了正确的兼容端点有些服务需要特定的路径后缀。OAuth 冲突。如果你之前用官方登录方式登录过 Claude Code.claude目录下可能存有 OAuth token 文件。当你改用 AUTH_TOKEN 配置后Claude Code 可能优先读取旧的 OAuth 凭证导致认证走错路径。解决办法是找到并清理旧的凭证缓存文件或者确保 settings.json 里的配置优先级生效。具体文件名因版本而异一般在.claude目录下你可以先备份再删除然后重启 Claude Code。命令找不到。claude命令报“不是内部或外部命令”说明全局 bin 没进 PATH。用npm config get prefix找到路径加到系统 Path重启终端。JSON 解析失败。settings.json 格式错误会导致启动直接报错。用 JSON 校验工具检查重点看有没有多余逗号、引号是否配对、有没有不小心写了注释。排查时有个通用思路先确认配置文件能被正确读取再确认网络能通到 Base URL最后确认 Key 和模型 ID 正确。按这个顺序查大部分问题都能定位。6. 把 Claude Code 接进日常工作流从验证到长期使用的建议跑通之后怎么把它用起来才是关键。Claude Code 的价值在于它能直接操作你的项目文件所以建议你在具体项目目录里启动它而不是在用户主目录。这样它能读到项目上下文回答和改动都更贴合实际。日常使用中你可以让它做这些事解释一段看不懂的代码、根据报错定位问题、批量重命名变量、生成单元测试、把某个函数重构成更清晰的写法。它的交互是对话式的你可以连续追问它会记住当前会话的上下文。如果你打算长期高频使用建议关注调用成本。按量计费适合偶尔用长期编码或跑 Agent 任务的话TaoToken 的 Coding Plan 会更合适具体可以在 https://taotoken.net/api 相关页面了解。另外把常用的模型 ID 和配置固定下来别频繁改省得每次都要重新验证。还有个小技巧settings.json 里的模型槽位可以按任务分配。比如把 Haiku 槽位指向一个更快的轻量模型处理简单问答把 Opus 槽位指向更强的模型处理复杂重构。这样能在成本和效果之间取得平衡。最后配置文件和 Key 要保管好别提交到 Git 仓库。可以在项目里加.gitignore排除.claude目录或者把 Key 放在环境变量里而不是明文写进文件。安全习惯养成了后面用起来才省心。