1. 为什么第一次装 Claude Code CLI 总卡在环境这一步Claude Code CLI 是 Anthropic 推出的终端编程助手能在命令行里直接读写工程文件、跑测试、改代码适合习惯在终端里干活的开发者。但它不像普通 npm 包那样装完就能用前置依赖没配好后面每一步都会报错。我见过太多人卡在npm -v没反应、claude命令找不到、或者启动后一直转圈连不上模型。这篇面向第一次在本地搭 Claude Code CLI 的开发者把 Node.js、npm、git 三件套的环境准备、CLI 安装、settings 配置以及把 Base URL 改到 TaoToken 统一 Key 通道的完整流程走一遍。你跟着敲命令就行每一步都有预期结果对照。先说清楚它是什么、能做什么、适合谁。Claude Code CLI 本质是一个跑在终端里的 Agent它通过 API 调用大模型拿到指令后在你的工程目录里执行文件读写、命令执行等操作。适合谁适合已经会用命令行、想让 AI 直接改本地代码而不是复制粘贴到网页对话框的人。不适合完全没碰过终端的小白因为排障需要看报错。环境准备这块核心就三个Node.js 提供运行时npm 负责装包git 让 Claude Code 能感知代码变更。三者缺一不可。很多人只装了 Node.js 就急着npm install结果 git 没装Claude Code 启动后无法追踪文件改动行为会很怪。我实测下来最稳的路径是先用node -v和npm -v确认版本再装 git 并git --version验证最后才装 CLI。顺序反了容易出玄学问题。下面从环境准备开始一步步来。2. Node.js、npm、git 环境准备与 Claude Code CLI 安装全流程2.1 安装 Node.js 并验证 node 与 npm 版本去 Node.js 官网下载 LTS 版本Windows 选.msi安装包一路下一步即可。安装时勾选 Add to PATH否则命令行找不到 node。装完打开 cmd 或 PowerShell输入node -v npm -v正常会输出类似v24.16.0和11.13.0的版本号。如果提示 不是内部或外部命令说明 PATH 没配好重装并确认勾选 Add to PATH或者手动把 Node.js 安装目录加进系统环境变量。Node.js 版本建议 18 以上Claude Code CLI 对低版本支持不好。npm 是随 Node.js 一起装的不用单独装。验证通过后顺手把 npm 镜像源换成国内源下载会快很多npm config set registry https://registry.npmmirror.com换完可以用npm config get registry确认输出应该是https://registry.npmmirror.com/。2.2 安装 git 并确认命令行可用去 git 官网下载对应系统安装包Windows 装完后在开始菜单能找到 Git Bash。安装过程默认选项即可注意勾选 Git from the command line and also from 3rd-party software这样 cmd 和 PowerShell 里都能用 git。验证git --version输出git version 2.x.x就对了。git 的作用是让 Claude Code 能读取工程的版本状态、对比改动。没装 git 时Claude Code 虽然能启动但涉及文件变更追踪的功能会失效所以别跳过。2.3 用 npm 全局安装 Claude Code CLI环境齐了装 CLInpm install -g anthropic-ai/claude-code-g表示全局安装装完在任何目录都能调用claude命令。安装过程会拉取依赖国内源下通常一两分钟。装完验证claude --version能输出版本号就说明 CLI 装好了。2.4 PowerShell 安全策略报错的解决办法如果你在 PowerShell 里执行 npm 相关命令时报 无法加载文件 npm.ps1因为在此系统上禁止运行脚本这是 PowerShell 执行策略太严。解决办法是改当前用户的策略Set-ExecutionPolicy RemoteSigned -Scope CurrentUserRemoteSigned允许本地脚本运行网络下载的脚本仍需签名安全和便利平衡得比较好。-Scope CurrentUser只影响当前用户不动系统全局。执行后系统会提示确认输入Y回车。然后关掉当前 PowerShell重新开一个普通窗口再输npm -v能显示版本号就修好了。这一步踩过的坑是有人用管理员 PowerShell 改完策略却还在原来的窗口测试结果没生效。记住改完要重开窗口。3. 配置 settings.json 把 Base URL 指向 TaoToken 统一 Key3.1 获取 TaoToken API Key 与可用模型 IDClaude Code CLI 默认连 Anthropic 官方通道国内直连不稳定。更省事的做法是把 Base URL 改到 TaoToken 的统一 Key 通道一个 Key 调多种模型。先去控制台创建 API Keyhttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keys_configutm_campaignrewrite创建后复制 Key形如sk-xxxx。模型 ID 方面DeepSeek 系列可以用deepseek-chat具体以文档里的模型列表为准https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdoc_model_listutm_campaignrewrite3.2 写入 settings.json 的完整配置片段Claude Code CLI 的配置放在用户目录下的.claude/settings.json。Windows 路径是C:\Users\你的用户名\.claude\settings.jsonmacOS/Linux 是~/.claude/settings.json。没有这个文件就手动创建。配置内容如下把ANTHROPIC_BASE_URL指向 TaoToken 的 API 地址ANTHROPIC_AUTH_TOKEN填你刚创建的 Key{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: sk-你的TaoToken密钥, ANTHROPIC_MODEL: deepseek-chat } }三个字段缺一不可Base URL 决定请求发到哪Auth Token 是身份凭证Model 指定用哪个模型。如果你用 CC Switch 这类工具管理多套配置逻辑一样本质就是切换这三个值。Base URL 后面不要加/v1之类的后缀按上面写的来。注意Key 是敏感信息别提交到 git 仓库。settings.json 放在用户目录下天然不会被工程仓库追踪这点比放在项目里安全。3.3 用 CC Switch 管理多套 Key 的写法如果你要在多个通道之间切换可以用 CC Switch 这类配置管理工具。它的原理是维护多份 settings 配置切换时替换.claude/settings.json。手动管理也不难就是准备几个 JSON 文件需要哪个复制过去。核心三件套始终是 Base URL、Key、Model ID任何工具都绕不开这三个值。配置写完后建议用cat或记事本再确认一遍 JSON 格式没写错多一个逗号都会导致解析失败。4. 启动 Claude Code 并完成一次对话验证4.1 在工程目录启动 claude 命令配置就绪后进入你的工程目录在终端执行cd /path/to/your/project claude首次启动会让你选颜色主题按提示选一个即可。启动成功后进入交互界面底部会显示当前模型。4.2 用 /model 查看当前模型并分析示例文件在交互界面输入/model会显示当前使用的模型 ID确认是不是你在 settings.json 里配的那个。然后让它分析一个工程文件比如帮我看看 package.json 里有哪些依赖并说明这个项目是做什么的如果配置正确Claude Code 会读取文件并返回分析结果。这一步能跑通说明 Base URL、Key、Model 三件套全部生效。4.3 验证请求成功的判断标准成功的标志有三个一是启动时没有报连接错误二是/model能显示模型 ID三是提问后能正常返回内容而不是卡住或报 401。三者都满足接入就完成了。如果只满足前两个但提问报错多半是 Key 或模型 ID 有问题看下一节的排查。5. 常见报错排查401、local proxy failed 与 reading choices5.1 401 报错Key 无效或没带上报错长这样401 Unauthorized或invalid api key。原因通常是ANTHROPIC_AUTH_TOKEN填错、Key 过期、或者 JSON 里字段名写成了别的。检查三点Key 有没有复制完整前后别带空格、字段名是不是ANTHROPIC_AUTH_TOKEN、settings.json 是不是放在正确的用户目录下。改完配置要重启claude才生效。5.2 local proxy failedBase URL 或网络问题报错local proxy failed或连接超时一般是ANTHROPIC_BASE_URL写错或者本地网络到该地址不通。确认 Base URL 是https://taotoken.net/api不要多加路径。如果公司网络有出口限制换网络环境再试。5.3 reading choices 报错响应格式不匹配报错里出现reading choices或cannot read property of undefined通常是模型返回格式和 CLI 预期不一致多半是 Model ID 填错指向了一个不存在的模型。去文档确认模型 ID 拼写改成列表里存在的值。这类报错不会在启动时出现只在提问后触发所以验证动作一定要做。5.4 OAuth 相关报错误走了官方登录流程如果提示要 OAuth 登录或跳转浏览器授权说明 CLI 没读到你的 settings.json走了默认的官方认证流程。检查配置文件路径和文件名是否正确Windows 下是.claude\settings.json注意是隐藏文件夹。确认后重启终端。排障通用思路先看报错关键词401 查 Keyproxy 查 URLchoices 查 ModelOAuth 查配置文件是否被读取。四类覆盖了九成问题。6. 后续接入与长期使用建议环境跑通后日常使用就是进工程目录敲claude。如果你要长期用它做编码或跑 Agent 任务建议了解一下 Coding Plan额度更划算https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_plan_ctautm_campaignrewrite想先在网页里试试模型效果可以用模型对话https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chat_ctautm_campaignrewrite接入文档在这里模型列表和参数都以文档为准https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdoc_ctautm_campaignrewrite最后给个实用技巧把 settings.json 备份一份换机器或重装时直接复制过去省得重新配。Key 泄露了就去控制台重新生成一个旧 Key 作废即可。环境这块一次配好后面就是纯用别在配置上反复折腾。