1. Windows 下 Claude Code 安装初体验从 PowerShell 启动到 settings 指向 TaoTokenClaude Code 是 Anthropic 推出的命令行编程助手能在终端里直接读写项目文件、执行命令、生成修改计划。对 Windows 用户来说它最大的价值是把「AI 改代码」这件事从网页聊天搬进了本地工程目录——它能看见你的真实文件结构而不是靠你手动粘贴代码片段。这篇记录适合两类人一是第一次在 Windows 上装 Claude Code、被 PowerShell 和配置文件绕晕的新手二是已经装好但请求发不出去、想把它统一接到 TaoToken 通道的老用户。我会把安装、启动、settings.json改写、验证请求这条链路完整走一遍每一步都给可复制的命令和配置。先说清楚它和普通代码补全的区别。Claude Code 不是 IDE 插件而是一个独立 CLI。你在项目目录里敲claude它会先做一次目录安全检查确认你信任当前文件夹然后进入交互界面。之后你可以用/init让它扫描整个项目生成上下文说明也可以直接描述需求让它给出修改计划。计划生成后有三个选项自动接受全部修改、逐步手动确认、或者打回让它重做。生产项目我建议永远选手动确认因为自动接受在生产环境里风险太高。Windows 上的安装路径和 macOS/Linux 略有不同主要坑集中在两处一是 PowerShell 的执行策略二是配置文件的存放位置。很多人装完发现claude命令能跑但一发请求就报401或者local proxy failed八成是settings.json没写对或者环境变量没生效。下面按顺序来。2. 前置准备Node 环境、TaoToken Key 与 Windows 终端选择在装 Claude Code 之前先把地基打好。它依赖 Node.js 运行所以第一步是确认 Node 版本。打开 PowerShell输入node -v npm -v如果提示「无法将 node 识别为 cmdlet」说明 Node 没装或没进 PATH。去 Node 官网下 LTS 版本安装时勾选「Add to PATH」。装完重开一个 PowerShell 窗口再验证。Node 版本建议 18 以上太低会在安装阶段报引擎不兼容。第二步是准备 TaoToken 的 API Key。访问 https://taotoken.net/api 对应的控制台入口在 API Keys 页面创建一个新 Key。创建后立刻复制保存因为页面刷新后就不再完整显示。这个 Key 就是后面settings.json里的核心凭证。第三步是选终端。Windows 上我实测下来原生 PowerShell 和 Windows Terminal 都能跑但 Windows Terminal 的字体渲染和快捷键体验更好。如果你用 VS Code直接用它内置的终端也行好处是工作目录自动跟着项目走。三种启动方式对应不同习惯启动方式操作适用场景PowerShell 手动 cd打开 PowerShellcd到项目目录再敲claude习惯命令行、路径明确文件夹右键在目标文件夹按住 Shift 右键选「在此处打开 PowerShell」快速进入当前目录VS Code 终端打开项目后按 Ctrl 调出终端敲claude边看代码边对话这里有个容易忽略的点Claude Code 的工作目录就是你的当前目录它会读取这个目录下的文件。所以启动前一定确认cd到了正确的项目根目录别在C:\Users\你的名字这种地方直接启动否则它会去扫描一堆无关文件。关于 TaoToken 的定位它是一个统一的 API 通道把请求转发到后端模型。你不需要在本地配任何网络层的东西只要把 Base URL 和 Key 填进配置文件即可。这一点对 Windows 用户特别友好因为省去了折腾环境变量的麻烦。3. 可复制配置把 settings.json 改到 TaoToken 通道这是全文最关键的一步。Claude Code 读取配置的位置在用户目录下的.claude文件夹里。Windows 上的完整路径是C:\Users\你的用户名\.claude\settings.json如果这个文件不存在手动创建。注意.claude是隐藏文件夹在文件资源管理器里需要开启「显示隐藏项目」才能看到或者直接在 PowerShell 里用命令创建# 创建目录已存在不会报错 New-Item -ItemType Directory -Force -Path $env:USERPROFILE\.claude # 用记事本打开或创建 settings.json notepad $env:USERPROFILE\.claude\settings.json然后在打开的记事本里粘贴下面这段配置。把sk-你的TaoToken密钥替换成你在控制台创建的真实 Key{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: sk-你的TaoToken密钥, ANTHROPIC_MODEL: claude-sonnet-4-20250514 } }保存后关闭记事本。这里三个字段各有作用别漏ANTHROPIC_BASE_URL请求发往的地址指向 TaoToken 的 API 入口。注意这里不带任何查询参数就是干净的https://taotoken.net/api。ANTHROPIC_AUTH_TOKEN你的身份凭证就是刚才创建的 Key。ANTHROPIC_MODEL默认使用的模型 ID。如果你不确定该填哪个可以先留空或者填一个你账号可用的模型名启动后用/model命令切换。如果你更习惯用系统环境变量而不是配置文件也可以在 PowerShell 里临时设置$env:ANTHROPIC_BASE_URL https://taotoken.net/api $env:ANTHROPIC_AUTH_TOKEN sk-你的TaoToken密钥但这种方式只对当前窗口生效关掉就没了。所以长期使用还是推荐写进settings.json一劳永逸。配置写完后还有一个验证动作确认 JSON 格式没写错。JSON 对逗号和引号极其敏感多一个逗号就会导致整个文件解析失败表现就是 Claude Code 启动后请求全部报错。可以用 PowerShell 快速校验Get-Content $env:USERPROFILE\.claude\settings.json | ConvertFrom-Json如果这条命令没报错说明 JSON 合法。如果报「无效的 JSON 原语」之类回去检查引号和逗号。4. 验证请求从 claude 启动到确认请求正常发出配置就绪后进入验证环节。先cd到一个测试项目目录然后敲claude第一次启动会看到安全检查界面大意是问你是否信任当前文件夹。这是 Claude Code 的安全机制防止它在不可信目录里乱动文件。选项有两个1. Yes, I trust this folder和2. No, exit。选 1 继续。接着进入欢迎界面。此时先别急着让它改代码用最简单的对话验证请求是否真的发出去了。直接输入一句你好请回复连接正常四个字如果配置正确你会看到它正常返回内容。这一步验证的是「请求能到达 TaoToken 并拿到响应」。如果这里就卡住或者报错说明配置有问题直接跳到第 5 节排查。请求通了之后可以试试/init命令。它的作用是让 Claude Code 扫描当前项目生成一份项目结构说明后续对话它就能理解整个工程。对于文件多、结构复杂的项目这一步能省掉大量手动文件的操作。执行后它会读取目录、分析文件然后输出一份摘要。这个过程本身也是一次完整的请求验证——如果/init能跑完说明读写链路都正常。再进一步可以测试计划模式。随便描述一个小需求比如「在当前目录新建一个 hello.txt内容写 test」。它会生成一个修改计划然后弹出三个选项1. Yes, auto-accept edits 2. Yes, manually approve edits 3. Tell Claude what to change选 2手动确认每一步。你会看到它请求创建文件的确认同意后才真正执行。这个流程走通说明从对话到文件操作的完整链路都没问题。验证阶段还有一个实用技巧观察终端的输出。正常请求会有加载动画然后返回结果如果 Base URL 或 Key 有问题通常会立刻报错而不是卡住。所以「秒报错」和「长时间无响应」指向的是不同问题前者多半是配置错误后者可能是网络或模型侧的问题。5. 常见报错排查401、local proxy failed 与 JSON 解析失败这一节按真实报错来对照。我在 Windows 上踩过的坑基本集中在这几类报错一401 UnauthorizedAPI Error: 401 - {error:{message:Invalid API key}}原因通常是 Key 写错、复制时带了空格、或者 Key 已失效。排查步骤打开settings.json确认ANTHROPIC_AUTH_TOKEN的值是完整的sk-开头字符串前后没有多余空格或换行。然后回 TaoToken 控制台确认这个 Key 还在有效期内。如果刚创建就报 401试试重新生成一个 Key。报错二local proxy failed / connection refusedError: connect ECONNREFUSED 127.0.0.1:xxxx这个报错说明请求被发到了本地某个端口而不是 TaoToken。原因一般是ANTHROPIC_BASE_URL没生效Claude Code 回退到了默认的本地代理设置。检查两点一是settings.json里的env字段拼写是否正确必须是env不是environment二是确认没有其他地方比如系统环境变量覆盖了这个值。可以在 PowerShell 里查一下echo $env:ANTHROPIC_BASE_URL如果输出为空或者不是https://taotoken.net/api说明配置文件没被读到。确认文件路径是C:\Users\你的用户名\.claude\settings.json注意用户名要换成你自己的。报错三reading choices / JSON 解析错误Error: Unexpected token } in JSON at position xxx这是settings.json格式错误。最常见的是最后一个字段后面多了逗号或者引号用了中文引号。JSON 不允许尾随逗号也不认中文标点。用第 3 节的ConvertFrom-Json命令校验它会告诉你具体哪里出错。报错四OAuth 相关提示如果看到要求登录 Anthropic 账号的 OAuth 流程说明配置没生效Claude Code 以为你要用官方账号登录。这时候不要走 OAuth回去检查settings.json是否被正确读取。用 TaoToken 通道时不需要任何 OAuth 登录。报错五模型不存在model: xxx not foundANTHROPIC_MODEL填了一个账号里没有的模型 ID。解决办法是启动后用/model命令列出可用模型选一个再写回配置。排查时有个通用思路先确认配置文件被读到再确认 Key 有效最后确认模型可用。这三层任何一层出问题都会报错但报错信息不同按上面的对照表基本能定位。6. 后续使用建议与接入文档入口配置跑通之后日常使用就是cd到项目目录、敲claude、开始对话。几个提升效率的习惯项目第一次用先跑/init建立上下文改代码前用计划模式看清楚它要动哪些文件生产项目永远选手动确认。如果你经常在多个项目间切换可以把settings.json里的模型 ID 固定成一个你常用的省得每次切换。需要长期做编码和 Agent 任务的话可以了解下 Coding Plan 这类方案适合高频使用的场景。模型对话入口可以用来单独验证某个模型是否可用接入文档则覆盖了更多参数和高级配置。这几个入口分别是模型对话验证https://taotoken.net/api接入文档https://taotoken.net/apiAPI Keys 管理https://taotoken.net/apiWindows 上这套流程走下来最花时间的其实是配置文件那一步。只要settings.json写对后面启动和验证都很顺。我自己的习惯是把配置模板存一份换机器时直接复制省得重新踩一遍 JSON 格式的坑。
Claude Code Windows 安装初体验：把 settings 改到 TaoToken 的完整记录
1. Windows 下 Claude Code 安装初体验从 PowerShell 启动到 settings 指向 TaoTokenClaude Code 是 Anthropic 推出的命令行编程助手能在终端里直接读写项目文件、执行命令、生成修改计划。对 Windows 用户来说它最大的价值是把「AI 改代码」这件事从网页聊天搬进了本地工程目录——它能看见你的真实文件结构而不是靠你手动粘贴代码片段。这篇记录适合两类人一是第一次在 Windows 上装 Claude Code、被 PowerShell 和配置文件绕晕的新手二是已经装好但请求发不出去、想把它统一接到 TaoToken 通道的老用户。我会把安装、启动、settings.json改写、验证请求这条链路完整走一遍每一步都给可复制的命令和配置。先说清楚它和普通代码补全的区别。Claude Code 不是 IDE 插件而是一个独立 CLI。你在项目目录里敲claude它会先做一次目录安全检查确认你信任当前文件夹然后进入交互界面。之后你可以用/init让它扫描整个项目生成上下文说明也可以直接描述需求让它给出修改计划。计划生成后有三个选项自动接受全部修改、逐步手动确认、或者打回让它重做。生产项目我建议永远选手动确认因为自动接受在生产环境里风险太高。Windows 上的安装路径和 macOS/Linux 略有不同主要坑集中在两处一是 PowerShell 的执行策略二是配置文件的存放位置。很多人装完发现claude命令能跑但一发请求就报401或者local proxy failed八成是settings.json没写对或者环境变量没生效。下面按顺序来。2. 前置准备Node 环境、TaoToken Key 与 Windows 终端选择在装 Claude Code 之前先把地基打好。它依赖 Node.js 运行所以第一步是确认 Node 版本。打开 PowerShell输入node -v npm -v如果提示「无法将 node 识别为 cmdlet」说明 Node 没装或没进 PATH。去 Node 官网下 LTS 版本安装时勾选「Add to PATH」。装完重开一个 PowerShell 窗口再验证。Node 版本建议 18 以上太低会在安装阶段报引擎不兼容。第二步是准备 TaoToken 的 API Key。访问 https://taotoken.net/api 对应的控制台入口在 API Keys 页面创建一个新 Key。创建后立刻复制保存因为页面刷新后就不再完整显示。这个 Key 就是后面settings.json里的核心凭证。第三步是选终端。Windows 上我实测下来原生 PowerShell 和 Windows Terminal 都能跑但 Windows Terminal 的字体渲染和快捷键体验更好。如果你用 VS Code直接用它内置的终端也行好处是工作目录自动跟着项目走。三种启动方式对应不同习惯启动方式操作适用场景PowerShell 手动 cd打开 PowerShellcd到项目目录再敲claude习惯命令行、路径明确文件夹右键在目标文件夹按住 Shift 右键选「在此处打开 PowerShell」快速进入当前目录VS Code 终端打开项目后按 Ctrl 调出终端敲claude边看代码边对话这里有个容易忽略的点Claude Code 的工作目录就是你的当前目录它会读取这个目录下的文件。所以启动前一定确认cd到了正确的项目根目录别在C:\Users\你的名字这种地方直接启动否则它会去扫描一堆无关文件。关于 TaoToken 的定位它是一个统一的 API 通道把请求转发到后端模型。你不需要在本地配任何网络层的东西只要把 Base URL 和 Key 填进配置文件即可。这一点对 Windows 用户特别友好因为省去了折腾环境变量的麻烦。3. 可复制配置把 settings.json 改到 TaoToken 通道这是全文最关键的一步。Claude Code 读取配置的位置在用户目录下的.claude文件夹里。Windows 上的完整路径是C:\Users\你的用户名\.claude\settings.json如果这个文件不存在手动创建。注意.claude是隐藏文件夹在文件资源管理器里需要开启「显示隐藏项目」才能看到或者直接在 PowerShell 里用命令创建# 创建目录已存在不会报错 New-Item -ItemType Directory -Force -Path $env:USERPROFILE\.claude # 用记事本打开或创建 settings.json notepad $env:USERPROFILE\.claude\settings.json然后在打开的记事本里粘贴下面这段配置。把sk-你的TaoToken密钥替换成你在控制台创建的真实 Key{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: sk-你的TaoToken密钥, ANTHROPIC_MODEL: claude-sonnet-4-20250514 } }保存后关闭记事本。这里三个字段各有作用别漏ANTHROPIC_BASE_URL请求发往的地址指向 TaoToken 的 API 入口。注意这里不带任何查询参数就是干净的https://taotoken.net/api。ANTHROPIC_AUTH_TOKEN你的身份凭证就是刚才创建的 Key。ANTHROPIC_MODEL默认使用的模型 ID。如果你不确定该填哪个可以先留空或者填一个你账号可用的模型名启动后用/model命令切换。如果你更习惯用系统环境变量而不是配置文件也可以在 PowerShell 里临时设置$env:ANTHROPIC_BASE_URL https://taotoken.net/api $env:ANTHROPIC_AUTH_TOKEN sk-你的TaoToken密钥但这种方式只对当前窗口生效关掉就没了。所以长期使用还是推荐写进settings.json一劳永逸。配置写完后还有一个验证动作确认 JSON 格式没写错。JSON 对逗号和引号极其敏感多一个逗号就会导致整个文件解析失败表现就是 Claude Code 启动后请求全部报错。可以用 PowerShell 快速校验Get-Content $env:USERPROFILE\.claude\settings.json | ConvertFrom-Json如果这条命令没报错说明 JSON 合法。如果报「无效的 JSON 原语」之类回去检查引号和逗号。4. 验证请求从 claude 启动到确认请求正常发出配置就绪后进入验证环节。先cd到一个测试项目目录然后敲claude第一次启动会看到安全检查界面大意是问你是否信任当前文件夹。这是 Claude Code 的安全机制防止它在不可信目录里乱动文件。选项有两个1. Yes, I trust this folder和2. No, exit。选 1 继续。接着进入欢迎界面。此时先别急着让它改代码用最简单的对话验证请求是否真的发出去了。直接输入一句你好请回复连接正常四个字如果配置正确你会看到它正常返回内容。这一步验证的是「请求能到达 TaoToken 并拿到响应」。如果这里就卡住或者报错说明配置有问题直接跳到第 5 节排查。请求通了之后可以试试/init命令。它的作用是让 Claude Code 扫描当前项目生成一份项目结构说明后续对话它就能理解整个工程。对于文件多、结构复杂的项目这一步能省掉大量手动文件的操作。执行后它会读取目录、分析文件然后输出一份摘要。这个过程本身也是一次完整的请求验证——如果/init能跑完说明读写链路都正常。再进一步可以测试计划模式。随便描述一个小需求比如「在当前目录新建一个 hello.txt内容写 test」。它会生成一个修改计划然后弹出三个选项1. Yes, auto-accept edits 2. Yes, manually approve edits 3. Tell Claude what to change选 2手动确认每一步。你会看到它请求创建文件的确认同意后才真正执行。这个流程走通说明从对话到文件操作的完整链路都没问题。验证阶段还有一个实用技巧观察终端的输出。正常请求会有加载动画然后返回结果如果 Base URL 或 Key 有问题通常会立刻报错而不是卡住。所以「秒报错」和「长时间无响应」指向的是不同问题前者多半是配置错误后者可能是网络或模型侧的问题。5. 常见报错排查401、local proxy failed 与 JSON 解析失败这一节按真实报错来对照。我在 Windows 上踩过的坑基本集中在这几类报错一401 UnauthorizedAPI Error: 401 - {error:{message:Invalid API key}}原因通常是 Key 写错、复制时带了空格、或者 Key 已失效。排查步骤打开settings.json确认ANTHROPIC_AUTH_TOKEN的值是完整的sk-开头字符串前后没有多余空格或换行。然后回 TaoToken 控制台确认这个 Key 还在有效期内。如果刚创建就报 401试试重新生成一个 Key。报错二local proxy failed / connection refusedError: connect ECONNREFUSED 127.0.0.1:xxxx这个报错说明请求被发到了本地某个端口而不是 TaoToken。原因一般是ANTHROPIC_BASE_URL没生效Claude Code 回退到了默认的本地代理设置。检查两点一是settings.json里的env字段拼写是否正确必须是env不是environment二是确认没有其他地方比如系统环境变量覆盖了这个值。可以在 PowerShell 里查一下echo $env:ANTHROPIC_BASE_URL如果输出为空或者不是https://taotoken.net/api说明配置文件没被读到。确认文件路径是C:\Users\你的用户名\.claude\settings.json注意用户名要换成你自己的。报错三reading choices / JSON 解析错误Error: Unexpected token } in JSON at position xxx这是settings.json格式错误。最常见的是最后一个字段后面多了逗号或者引号用了中文引号。JSON 不允许尾随逗号也不认中文标点。用第 3 节的ConvertFrom-Json命令校验它会告诉你具体哪里出错。报错四OAuth 相关提示如果看到要求登录 Anthropic 账号的 OAuth 流程说明配置没生效Claude Code 以为你要用官方账号登录。这时候不要走 OAuth回去检查settings.json是否被正确读取。用 TaoToken 通道时不需要任何 OAuth 登录。报错五模型不存在model: xxx not foundANTHROPIC_MODEL填了一个账号里没有的模型 ID。解决办法是启动后用/model命令列出可用模型选一个再写回配置。排查时有个通用思路先确认配置文件被读到再确认 Key 有效最后确认模型可用。这三层任何一层出问题都会报错但报错信息不同按上面的对照表基本能定位。6. 后续使用建议与接入文档入口配置跑通之后日常使用就是cd到项目目录、敲claude、开始对话。几个提升效率的习惯项目第一次用先跑/init建立上下文改代码前用计划模式看清楚它要动哪些文件生产项目永远选手动确认。如果你经常在多个项目间切换可以把settings.json里的模型 ID 固定成一个你常用的省得每次切换。需要长期做编码和 Agent 任务的话可以了解下 Coding Plan 这类方案适合高频使用的场景。模型对话入口可以用来单独验证某个模型是否可用接入文档则覆盖了更多参数和高级配置。这几个入口分别是模型对话验证https://taotoken.net/api接入文档https://taotoken.net/apiAPI Keys 管理https://taotoken.net/apiWindows 上这套流程走下来最花时间的其实是配置文件那一步。只要settings.json写对后面启动和验证都很顺。我自己的习惯是把配置模板存一份换机器时直接复制省得重新踩一遍 JSON 格式的坑。