1. 先搞清楚 Claude Code 是什么以及为什么要在 settings 里改 Base URLClaude Code 是 Anthropic 推出的命令行编程助手跑在终端里能直接读写你本地的代码文件、执行 shell 命令、做多轮对话式重构。它和网页版聊天最大的区别是它把「当前项目目录」当成上下文你说「帮我把这个函数拆一下」它真的会去改文件而不是只给你一段代码让你自己复制。适合谁适合已经在用终端、写代码、想让 AI 直接动工程文件的人。普通用户第一次接触最容易卡在两步一是装不上二是装上了连不上模型。这篇教程面向首次接触 Claude Code 的普通用户把 Windows、Mac、Linux 三个平台从零安装到模型接入的完整路径走一遍重点演示 Windows 下 Git Bash 环境的配置流程。核心思路是Claude Code 本身只是一个客户端它需要一个「模型通道」来真正干活。默认它连的是 Anthropic 官方地址但很多国内用户会遇到网络不通、认证失败的问题。解决办法是把 Claude Code 的 settings 配置改到一个统一的 API 通道上比如 TaoToken用一套 Key 和 Base URL 就能调用多种模型。为什么要在 settings 里改因为 Claude Code 读取配置的优先级是环境变量 项目级 settings 用户级 settings。你只要在用户级配置文件里写死 Base URL 和 API Key之后每次启动claude都会自动走这个通道不用每次手动 export。这就是「把 settings 改到 TaoToken」的实际含义——不是改 Claude Code 的源码而是改它的配置文件让它把请求发到你指定的地址。我试过在 Windows 上用 PowerShell 直接装结果环境变量没生效claude命令找不到。后来换成 Git Bash 就顺了因为 Claude Code 的安装脚本本身是 shell 脚本Git Bash 提供了兼容的 Linux 命令环境。所以下面 Windows 部分会重点讲 Git Bash 这条路径。先明确三个平台的整体流程心里有个地图平台终端环境安装方式配置文件位置WindowsGit BashPowerShell 脚本或 npmC:\Users\你的用户名\.claude\settings.jsonMac自带 zshcurl 脚本或 npm~/.claude/settings.jsonLinuxbash/zshcurl 脚本或 npm~/.claude/settings.json三个平台的配置文件格式完全一样都是 JSON。区别只在安装命令和 PATH 环境变量的写法。你只要把配置文件写对模型通道就通了。还有一个概念要提前说清楚Claude Code 的「模型」和「通道」是两回事。模型是 Claude 系列本身通道是你请求模型时走的 API 地址。TaoToken 提供的是通道它兼容 Anthropic 的 API 格式所以你不需要改 Claude Code 的请求逻辑只要把 Base URL 指向它再填上它给你的 Key就能用。这也是为什么改 settings 就够了不用装插件、不用改代码。下面从安装开始一步步来。每个平台我都会给出可复制的命令你照着敲就行。装完之后统一讲 settings 配置因为三个平台配置方法一样放一起讲更清楚。2. 三平台安装 Claude CodeGit Bash、curl 脚本与 PATH 环境变量配置这一节把 Windows、Mac、Linux 的安装命令全部给全包括 Git Bash 的安装、Claude Code 的安装脚本、以及 PATH 环境变量的配置。装完之后claude命令能跑起来就算第一阶段成功。2.1 Windows先装 Git Bash再装 Claude CodeWindows 用户第一步不是装 Claude Code而是装 Git Bash。原因前面说了Claude Code 的安装脚本是 shell 脚本PowerShell 和 CMD 跑不了。Git Bash 提供了 Linux 命令环境装完之后你在这个终端里操作和 Mac/Linux 体验一致。Git Bash 官网下载地址https://git-scm.com/install/windows。打开后下载安装程序运行保持默认设置一路下一步即可。安装完成后在开始菜单里能找到「Git Bash」打开它。打开 Git Bash 后先验证一下环境git --version能输出版本号就说明 Git Bash 正常。接下来装 Claude Code。Windows 下有两种方式推荐第一种脚本安装curl -fsSL https://claude.ai/install.sh | bash如果你在 Git Bash 里 curl 不可用可以用 PowerShell 方式在 PowerShell 里执行irm https://claude.ai/install.ps1 | iex安装包大约 200MB时间取决于网络。脚本内容开源可查二进制文件从官方存储下载。装完之后Claude Code 的可执行文件通常在C:\Users\你的用户名\.local\bin\目录下。接下来配置 PATH 环境变量否则claude命令找不到。Windows 下有两种做法。第一种图形界面打开「系统环境变量设置」→ 在「系统变量」里找到Path→ 添加新路径C:\Users\你的用户名\.local\bin\→ 保存后重启终端。第二种在 Git Bash 里直接追加到配置文件echo export PATH$HOME/.local/bin:$PATH ~/.bashrc source ~/.bashrc验证安装claude --version能输出版本号就成功了。如果提示command not found说明 PATH 没生效检查上面的路径是否写对或者重开一个 Git Bash 窗口。2.2 Maccurl 脚本安装与 zsh 配置Mac 自带 zsh不需要额外装终端环境。直接打开「终端」应用执行安装脚本curl -fsSL https://claude.ai/install.sh | bash装完之后配置 PATH。Mac 默认 shell 是 zsh配置文件是~/.zshrcecho export PATH$HOME/.local/bin:$PATH ~/.zshrc source ~/.zshrc验证claude --version如果你用的是 bash把~/.zshrc换成~/.bash_profile即可。Mac 上一般不会遇到权限问题如果提示 permission denied检查~/.local/bin目录是否存在不存在就手动建一个mkdir -p ~/.local/bin2.3 Linuxcurl 脚本与 bash 配置Linux 和 Mac 流程几乎一样。打开终端执行curl -fsSL https://claude.ai/install.sh | bash配置 PATH根据你的 shell 选择配置文件。bash 用户echo export PATH$HOME/.local/bin:$PATH ~/.bashrc source ~/.bashrczsh 用户把~/.bashrc换成~/.zshrc。验证claude --versionLinux 上如果遇到curl: command not found先装 curl。Debian/Ubuntu 系sudo apt update sudo apt install -y curlCentOS/RHEL 系sudo yum install -y curl2.4 用 npm 安装的备选方案如果你机器上已经有 Node.js 环境也可以用 npm 全局安装三个平台通用npm install -g anthropic-ai/claude-code这种方式的好处是 PATH 一般由 npm 自动处理不用手动配。坏处是依赖 Node 版本建议 Node 18 以上。装完同样用claude --version验证。到这里三个平台的安装都完成了。下一步是配置 settings把模型通道指向 TaoToken。这一步三个平台完全一样所以放在下一节统一讲。3. 把 settings 改到 TaoToken可复制的 settings.json 与三件套参数这一节是核心。Claude Code 装好之后默认会尝试连 Anthropic 官方地址。我们要做的是改配置文件把 Base URL 和 API Key 换成 TaoToken 的。改完之后Claude Code 的所有请求都会走 TaoToken 通道。3.1 先拿到三件套Base URL、API Key、Model ID在配置之前你需要先准备好三个参数我称之为「三件套」Base URLhttps://taotoken.net/apiAPI Key在 TaoToken 控制台创建地址是https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentModel ID比如claude-sonnet-4-20250514或你账号里可用的模型名API Key 的创建入口在控制台的 API Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content。点进去新建一个 Key复制出来注意它只显示一次存好。Model ID 怎么确认可以在模型对话页面先试一下https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content。选一个模型发条消息能回就说明这个模型 ID 可用。把模型名记下来配置里要填。3.2 写 settings.json用户级配置文件Claude Code 的用户级配置文件路径WindowsC:\Users\你的用户名\.claude\settings.jsonMac/Linux~/.claude/settings.json如果.claude目录不存在先建mkdir -p ~/.claude然后创建或编辑settings.json内容如下{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的TaoToken密钥, ANTHROPIC_MODEL: claude-sonnet-4-20250514 } }这三个字段的含义ANTHROPIC_BASE_URL请求地址指向 TaoToken 的 API 入口ANTHROPIC_API_KEY你的 TaoToken Key替换成实际值ANTHROPIC_MODEL默认使用的模型 ID注意 JSON 格式字段名和值都要用双引号最后一项后面不能有逗号。写完之后保存。Windows 用户如果用的是 Git Bash路径里的~会自动展开成C:\Users\你的用户名。你也可以用记事本或 VS Code 直接打开这个文件编辑效果一样。3.3 用环境变量覆盖可选如果你不想写配置文件也可以在启动前用环境变量临时指定。Git Bash / Mac / Linuxexport ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEYsk-你的TaoToken密钥 export ANTHROPIC_MODELclaude-sonnet-4-20250514 claudeWindows PowerShell$env:ANTHROPIC_BASE_URLhttps://taotoken.net/api $env:ANTHROPIC_API_KEYsk-你的TaoToken密钥 $env:ANTHROPIC_MODELclaude-sonnet-4-20250514 claude环境变量的优先级高于 settings.json适合临时测试。但长期用还是建议写进 settings.json省得每次手动 export。3.4 如果你用 cc-switch 管理多渠道cc-switch 是一个渠道切换工具支持在多个模型渠道之间切换。如果你装了它配置逻辑是在 cc-switch 里添加一个渠道Base URL 填https://taotoken.net/apiKey 填你的 TaoToken Key模型名填 Model ID。然后指定当前使用这个渠道。cc-switch 会帮你写 Claude Code 的配置你就不用手动改 settings.json 了。三件套在 cc-switch 里的对应关系cc-switch 字段填写值Base URLhttps://taotoken.net/apiAPI Key你的 TaoToken KeyModelclaude-sonnet-4-20250514不管用哪种方式核心都是这三个参数。配置完成后下一步是验证。4. 验证请求从 claude 启动到模型成功返回的完整动作配置写完不代表通了必须实际发一次请求验证。这一节给出从启动到成功返回的完整动作以及每一步的预期结果。4.1 启动 Claude Code在终端里进入你的项目目录然后执行cd ~/your-project claude第一次启动会做一些初始化可能会提示你确认一些设置。如果之前遇到过Unable to connect to Anthropic services可以在~/.claude.json里加一个配置项{ hasCompletedOnboarding: true }这个文件在用户主目录下和.claude目录同级。加上之后重启 Claude Code。4.2 发一条测试消息启动后你会看到 Claude Code 的交互界面。直接输入一句话比如你好帮我看看当前目录下有哪些文件预期结果是Claude Code 会调用模型然后返回一段回复并且可能执行ls命令列出文件。如果它真的列出了文件说明模型通道通了而且工具调用也正常。如果它只回复文字但不执行命令可能是权限设置问题Claude Code 会询问你是否允许执行某个命令你确认即可。4.3 用 /context 查看上下文在会话里输入/context这会显示当前上下文的使用情况包括模型名、token 消耗等。如果这里显示的模型是你配置的 Model ID说明配置生效了。4.4 用 /resume 恢复历史对话输入/resume会列出之前的历史会话你可以选择恢复。这个功能验证的是本地会话存储是否正常和模型通道无关但能帮你确认 Claude Code 整体运行正常。4.5 验证成功的三个标志总结一下验证成功有三个标志第一claude命令能启动不报连接错误。第二发消息能收到模型回复且回复内容合理。第三/context里显示的模型名和你配置的一致。三个都满足说明安装和接入全部完成。接下来可以正常用 Claude Code 写代码了。如果某一步失败看下一节的排查。5. 常见报错排查401、local proxy failed、reading choices 与 OAuth 问题这一节列出实际使用中最容易遇到的报错以及对应的解决方法。每个报错我都给出真实错误信息和排查步骤。5.1 401 Unauthorized报错信息类似API Error: 401 Unauthorized原因API Key 不对或者 Key 没有正确传入。排查步骤第一检查settings.json里的ANTHROPIC_API_KEY是否填了完整的 Key有没有多余空格。第二确认 Key 没有过期或被删除去控制台 API Keys 页面看一眼https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content。第三检查环境变量里有没有旧的ANTHROPIC_API_KEY覆盖了配置文件用echo $ANTHROPIC_API_KEY看一下。如果 Key 是对的还报 401可能是 Base URL 写错了。确认是https://taotoken.net/api不要多加斜杠或路径。5.2 local proxy failed报错信息类似local proxy failed: connection refused原因Claude Code 尝试走本地代理但代理没启动或端口不对。排查检查你有没有设置HTTP_PROXY或HTTPS_PROXY环境变量如果有先 unsetunset HTTP_PROXY unset HTTPS_PROXY然后重启 Claude Code。如果你确实需要代理确保代理服务在运行端口正确。5.3 reading choices 相关报错报错信息类似error reading choices: unexpected end of JSON input原因API 返回的内容不是预期的 JSON 格式通常是 Base URL 指向了一个不兼容的接口。排查确认ANTHROPIC_BASE_URL是https://taotoken.net/api而不是网页地址。有些用户误填了控制台地址导致返回 HTML 而不是 JSON。另外检查 Model ID 是否正确。如果模型名不存在接口可能返回错误格式。去模型对话页面确认可用模型https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content。5.4 OAuth 相关报错报错信息类似OAuth error: invalid_grant原因Claude Code 尝试用 OAuth 登录 Anthropic 账号但你用的是 API Key 模式。排查确保没有同时配置 OAuth 和 API Key。如果你之前登录过 Anthropic 账号可能在~/.claude.json里存了 token和 API Key 冲突。可以删掉~/.claude.json里的 OAuth 相关字段或者直接删掉这个文件重新初始化注意会丢失历史会话记录。5.5 命令找不到claude: command not found原因PATH 没配好。排查确认~/.local/bin在 PATH 里用echo $PATH看。如果没有按第 2 节的步骤重新配置然后source一下配置文件或者重开终端。Windows 用户特别注意如果你在 PowerShell 里装完又跑到 Git Bash 里用PATH 可能不共享。建议统一在一个终端里操作推荐 Git Bash。5.6 模型不回复或一直转圈原因网络不通或者 Base URL 不可达。排查先用 curl 测一下接口连通性curl -I https://taotoken.net/api如果能返回 HTTP 状态码说明网络通。如果超时检查你的网络环境。注意不要使用任何违规的网络工具保持正常网络访问即可。如果接口通但模型不回复检查 Model ID 是否拼写正确以及账号余额是否充足。6. 装完之后怎么用会话管理、文件操作与长期编码的接入建议安装和接入跑通之后Claude Code 的日常使用其实很简单。这一节讲几个高频操作以及长期编码场景下的建议。启动就是claude进入交互界面。退出用/exit或 CtrlC。会话管理有三个常用命令/resume恢复历史对话/context查看上下文占用/compact压缩上下文。上下文快满的时候用/compact能把历史对话压缩成摘要腾出空间继续聊。文件操作是 Claude Code 的强项。你可以直接说「把 src/utils.js 里的 formatDate 函数改成支持时区」它会读文件、改文件、告诉你改了什么。执行命令也是说「跑一下测试」它会执行npm test并把结果贴给你。这种纯文本交互效率很高适合代码开发和问题排查。如果你打算长期用 Claude Code 做编码建议关注 Coding Plan 这类套餐比按量计费更划算适合高频使用。入口在https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content。它提供的是长期编码场景的额度方案配合 Claude Code 用比较合适。如果你还想在别的工具里用同一个通道比如 Cline、Codex 等它们的配置逻辑和 Claude Code 一样都是填 Base URL、API Key、Model ID 三件套。Base URL 统一用https://taotoken.net/apiKey 用同一个模型按需选。这样你一套 Key 就能在多个工具里复用不用每个工具单独申请。接入文档在https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content里面有各工具的详细配置示例遇到不确定的字段可以去查。最后说一个实用技巧把settings.json备份一份。因为 Claude Code 升级或者你换机器的时候这个文件是核心配置丢了就要重新填。备份之后新机器上装好 Claude Code把 settings.json 拷过去改一下路径就能直接用。整个流程走下来最花时间的其实是第一步装 Git Bash 和配 PATH配置本身五分钟就能搞定。装好之后Claude Code 就是一个随叫随到的编程助手你负责想清楚要做什么它负责动手改文件。