1. 为什么 Claude Code 第一步必须先把 Git 装明白很多人第一次配 AI 编程工具卡住的地方往往不是模型本身而是 Git 没装好。Claude Code 这类命令行 AI 编程助手底层要频繁调用 Git 来读取仓库状态、生成 diff、提交变更、切换分支。如果 Git 缺失或者版本太旧你会看到一堆莫名其妙的报错比如git: command not found、fatal: not a git repository甚至 Claude Code 启动后直接提示环境不满足。所以这篇是「Claude Code 安装」系列的第一篇专门解决 Windows 和 macOS 下的 Git 安装全流程以及接入 TaoToken 统一 Key 之前的环境前置检查。适合谁看第一次配置 AI 编程工具、对命令行不太熟、但又想跟着步骤一步步做下来的开发者。你不需要提前懂 Git 原理只要照着敲命令、核对版本号就行。我试过在几台全新系统上从零配置发现最容易出问题的三个点一是 Windows 上 PATH 没配好装完 Git 但终端里调不到二是默认分支名还是老的master和现在主流仓库不一致三是 macOS 上没装 Xcode Command Line Tools导致git命令指向一个空壳。这篇会把这三个坑都提前填掉。装完 Git 之后下一步才是通过 TaoToken 的统一 Key 和 API 通道接入 Claude Code。所以本文除了 Git 安装还会给你一份环境变量检查清单以及后续在配置文件里填 Base URL、Key、Model ID 的位置说明。这样你装完 Git 不会停在半路能直接衔接到接入环节。核心检索词先明确Git 安装、Claude Code 环境准备、TaoToken 统一 Key 接入。这三个词贯穿全文你按顺序做下来就能得到一个可用的 AI 编程环境。2. Windows 与 macOS 安装 Git 的完整命令与验证动作2.1 Windows 图形化安装从下载到 PATH 勾选Windows 上最稳的方式是走官方安装包。打开浏览器访问 Git 官方下载页点击Click here to download下载 exe 文件。下载速度可能有点慢耐心等它完成即可。下载完成后双击 exe 进入安装向导。第一步是选择安装位置点Browse改到你习惯的盘符然后Next。接下来是组件选择页这里有两个推荐勾选项Check daily for Git for Windows updates每日检查更新保持版本新鲜。Add a Git Bash Profile to Windows Terminal把 Git Bash 加进 Windows Terminal 配置文件之后可以直接在 Windows Terminal 里开 Git Bash。自主勾选项里Additional icons On the Desktop看你要不要在桌面放快捷方式。然后一路Next中间几个关键页面这样选默认编辑器页面选你顺手的即可情怀角度可以选 vim。设置新仓库默认分支名页面推荐选第二个选项main这样新仓库默认分支就是main和现在主流平台一致。后续如果还想全局切换可以用命令git config --global init.defaultBranch main调整 PATH 环境变量页面选第二个Git from the command line and also from 3rd-party software这样 Git 才能在任何终端里被调用。SSH 可执行文件、HTTPS 传输后端、行尾符转换、Git Bash 终端模拟器、git pull默认行为、凭据助手这几页全部保持默认继续Next。最后到额外选项页取消第二个勾选勾选第一个启动点Install。安装完成后按WinR呼出运行输入cmd按住CtrlShift再回车以管理员身份打开命令提示符。输入git -v如果输出类似git version 2.4x.x.windows.1说明安装成功且 PATH 已生效。2.2 macOS 安装两种路径与版本核对macOS 上装 Git 有两条路。第一条是装 Xcode Command Line Tools它会自带 Gitxcode-select --install弹窗点安装等它跑完。第二条是用 Homebrewbrew install git装完后同样验证git -v如果你之前从没装过命令行工具直接敲git -v可能会触发系统提示安装 Command Line Tools跟着走也行。macOS 上还要注意一点系统自带的/usr/bin/git有时候是个占位壳真正生效的是 Homebrew 装的/opt/homebrew/bin/git或/usr/local/bin/git。用which git确认一下路径which git输出应该是 Homebrew 路径而不是/usr/bin/git。如果不是把 Homebrew 的 bin 目录加到 PATH 前面。2.3 环境变量检查清单装完 Git 只是第一步接入 TaoToken 之前还要核对几个环境项。下面这份清单你可以逐条打勾检查项命令期望结果Git 版本git -v2.30 以上Git 路径which gitmacOS/where gitWindows指向真实安装路径默认分支git config --global init.defaultBranchmain用户名git config --global user.name你的名字邮箱git config --global user.email你的邮箱Node 版本node -v18 以上Claude Code 依赖用户名和邮箱如果没配用这两条补上git config --global user.name 你的名字 git config --global user.email 你的邮箱Node.js 是 Claude Code 的运行依赖如果node -v报错先去装 Node.js LTS 版本。这一步别跳过否则后面接入时会卡在启动阶段。3. TaoToken 统一 Key 接入前的配置文件准备Git 和 Node 都就绪后就进入接入环节。TaoToken 的作用是提供一个统一的 Key 和 API 通道让你不用在多个模型供应商之间来回切换配置。官网地址是https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 入口是https://taotoken.net/api。接入前你需要先拿到 Key。打开 API Keys 管理页https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite创建一个新 Key 并复制保存。这个 Key 就是后面配置文件里的核心凭证。Claude Code 的配置通常放在用户目录下的 settings 文件里。Windows 路径一般是C:\Users\你的用户名\.claude\settings.jsonmacOS 是~/.claude/settings.json。如果目录不存在手动创建即可。下面是一份可复制的 JSON 配置片段把占位符替换成你自己的值{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: 你的TaoToken Key, ANTHROPIC_MODEL: claude-sonnet-4-20250514 } }这里三个字段要写全也就是接入三件套Base URL、Key、Model ID。Base URL 固定用https://taotoken.net/api不要加多余路径。Key 填你刚创建的那串。Model ID 填你要用的模型标识具体可用列表可以在模型对话页确认https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite。如果你用的是 Codex 这类工具配置位置在~/.codex/auth.json结构类似同样需要 Base URL、Key、Model ID 三件套。Cline 的 MCP 配置则在扩展设置里填同样的三项。不管哪个工具核心逻辑一致把请求指向 TaoToken 的 API 通道用统一 Key 鉴权指定模型 ID。注意配置文件里的 Key 不要提交到 Git 仓库也不要截图发到公开渠道。建议把 settings 文件加进.gitignore。配置写完后先别急着启动 Claude Code回到终端做一次环境变量核对echo $ANTHROPIC_BASE_URL echo $ANTHROPIC_AUTH_TOKENWindows 上用echo %ANTHROPIC_BASE_URL%。如果输出为空说明配置文件没被读取检查路径和 JSON 格式是否正确。JSON 里多一个逗号都会导致解析失败。4. 验证请求与成功结果从启动到首次对话配置就绪后启动 Claude Code。在终端进入你的项目目录运行claude第一次启动会读取 settings.json 里的环境变量。如果一切正常你会看到 Claude Code 的交互界面可以输入问题。为了验证请求真的走通了 TaoToken 通道可以问一个简单问题比如「帮我看看当前目录的 Git 状态」。它会调用 Git 命令并返回结果。更直接的验证方式是发一个最小请求确认 API 通道连通。你可以用 curl 测一下curl https://taotoken.net/api/v1/messages \ -H Authorization: Bearer 你的TaoToken Key \ -H Content-Type: application/json \ -d {model:claude-sonnet-4-20250514,max_tokens:50,messages:[{role:user,content:ping}]}如果返回包含content字段的 JSON说明 Key 和通道都正常。如果返回 401说明 Key 无效或没带上。如果返回模型不存在说明 Model ID 写错了回模型对话页核对。成功的结果长这样终端里 Claude Code 正常响应Git 命令能被执行diff 能生成。这时候你的环境就算搭好了。整个过程里Git 负责版本控制Node 负责运行时TaoToken 负责模型通道三者缺一不可。实测下来最容易忽略的是 Node 版本。Claude Code 对 Node 18 以下不友好会出现启动即退出。所以node -v这一步一定要确认。5. 本篇常见报错排查401、local proxy failed 与 reading choices接入过程中会遇到几类典型报错这里逐个对照排查。第一类401 Unauthorized。原因通常是 Key 没填对、Key 已失效、或者请求头没带上。检查 settings.json 里的ANTHROPIC_AUTH_TOKEN是否和 API Keys 页面创建的一致。注意不要有多余空格。如果用的是 curl 测试确认Authorization: Bearer后面跟的是完整 Key。第二类local proxy failed。这个报错一般出现在工具尝试走本地代理但配置不完整时。检查你的 Base URL 是否写成了https://taotoken.net/api不要写成带/v1或其他后缀的地址。同时确认没有在环境里残留旧的代理变量比如HTTP_PROXY、HTTPS_PROXY。如果有先清掉unset HTTP_PROXY unset HTTPS_PROXYWindows 上用set HTTP_PROXY清空。第三类reading choices相关报错。这通常出现在响应解析阶段说明返回的 JSON 结构不符合预期。常见原因是 Model ID 写错导致服务端返回了错误结构。回模型对话页确认可用模型列表把ANTHROPIC_MODEL改成正确的 ID。另外检查请求是否被中间层改写Base URL 必须是https://taotoken.net/api。第四类OAuth 相关报错。如果你之前登录过其他账号本地可能残留了旧的 OAuth 凭证和新的 Key 冲突。清理方式删除~/.claude下的缓存文件或者直接重命名整个目录备份然后重新写 settings.json。第五类git: command not found。这说明 Git 没装好或 PATH 没生效。回第 2 节重新核对git -v和which git。Windows 上如果 PATH 选错了重装 Git 时选第二个 PATH 选项。提示排查时先看报错关键词再对照上面五类。大部分问题集中在 Key、Base URL、Model ID 这三项把三件套核对一遍能解决八成故障。如果排查完还是不通可以去接入文档页看最新说明https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite。文档里会同步最新的配置格式和可用模型。6. 装完 Git 之后把环境接到 TaoToken 统一通道Git 装好、Node 就绪、settings.json 写完这三步做完你的 Claude Code 环境就具备了接入条件。接下来要做的就是把请求真正指向 TaoToken 的统一 Key 通道。如果你打算长期用 AI 编程建议直接上 Coding Plan省去每次单独配 Key 的麻烦https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite。对于只是临时验证模型的场景用模型对话页就够了https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite。而如果你要管理多个 Key、查看用量去控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite。回到环境本身最后再确认一次三件套是否写全Base URL 是https://taotoken.net/apiKey 来自 API Keys 页面Model ID 来自模型列表。这三项在 Claude Code、Codex、Cline MCP 里的位置不同但内容一致。写完后启动claude发一条消息能收到回复就说明整条链路通了。一个实用技巧把 settings.json 里的配置做成模板换机器时直接复制只改 Key 就行。这样下次在新环境里配 Claude Code你只需要装 Git、装 Node、填 Key 三步十分钟内能跑起来。Git 安装这一篇是整个系列的地基地基打牢了后面的接入和调优才顺。
1. 为什么 Claude Code 第一步必须先把 Git 装明白很多人第一次配 AI 编程工具卡住的地方往往不是模型本身而是 Git 没装好。Claude Code 这类命令行 AI 编程助手底层要频繁调用 Git 来读取仓库状态、生成 diff、提交变更、切换分支。如果 Git 缺失或者版本太旧你会看到一堆莫名其妙的报错比如git: command not found、fatal: not a git repository甚至 Claude Code 启动后直接提示环境不满足。所以这篇是「Claude Code 安装」系列的第一篇专门解决 Windows 和 macOS 下的 Git 安装全流程以及接入 TaoToken 统一 Key 之前的环境前置检查。适合谁看第一次配置 AI 编程工具、对命令行不太熟、但又想跟着步骤一步步做下来的开发者。你不需要提前懂 Git 原理只要照着敲命令、核对版本号就行。我试过在几台全新系统上从零配置发现最容易出问题的三个点一是 Windows 上 PATH 没配好装完 Git 但终端里调不到二是默认分支名还是老的master和现在主流仓库不一致三是 macOS 上没装 Xcode Command Line Tools导致git命令指向一个空壳。这篇会把这三个坑都提前填掉。装完 Git 之后下一步才是通过 TaoToken 的统一 Key 和 API 通道接入 Claude Code。所以本文除了 Git 安装还会给你一份环境变量检查清单以及后续在配置文件里填 Base URL、Key、Model ID 的位置说明。这样你装完 Git 不会停在半路能直接衔接到接入环节。核心检索词先明确Git 安装、Claude Code 环境准备、TaoToken 统一 Key 接入。这三个词贯穿全文你按顺序做下来就能得到一个可用的 AI 编程环境。2. Windows 与 macOS 安装 Git 的完整命令与验证动作2.1 Windows 图形化安装从下载到 PATH 勾选Windows 上最稳的方式是走官方安装包。打开浏览器访问 Git 官方下载页点击Click here to download下载 exe 文件。下载速度可能有点慢耐心等它完成即可。下载完成后双击 exe 进入安装向导。第一步是选择安装位置点Browse改到你习惯的盘符然后Next。接下来是组件选择页这里有两个推荐勾选项Check daily for Git for Windows updates每日检查更新保持版本新鲜。Add a Git Bash Profile to Windows Terminal把 Git Bash 加进 Windows Terminal 配置文件之后可以直接在 Windows Terminal 里开 Git Bash。自主勾选项里Additional icons On the Desktop看你要不要在桌面放快捷方式。然后一路Next中间几个关键页面这样选默认编辑器页面选你顺手的即可情怀角度可以选 vim。设置新仓库默认分支名页面推荐选第二个选项main这样新仓库默认分支就是main和现在主流平台一致。后续如果还想全局切换可以用命令git config --global init.defaultBranch main调整 PATH 环境变量页面选第二个Git from the command line and also from 3rd-party software这样 Git 才能在任何终端里被调用。SSH 可执行文件、HTTPS 传输后端、行尾符转换、Git Bash 终端模拟器、git pull默认行为、凭据助手这几页全部保持默认继续Next。最后到额外选项页取消第二个勾选勾选第一个启动点Install。安装完成后按WinR呼出运行输入cmd按住CtrlShift再回车以管理员身份打开命令提示符。输入git -v如果输出类似git version 2.4x.x.windows.1说明安装成功且 PATH 已生效。2.2 macOS 安装两种路径与版本核对macOS 上装 Git 有两条路。第一条是装 Xcode Command Line Tools它会自带 Gitxcode-select --install弹窗点安装等它跑完。第二条是用 Homebrewbrew install git装完后同样验证git -v如果你之前从没装过命令行工具直接敲git -v可能会触发系统提示安装 Command Line Tools跟着走也行。macOS 上还要注意一点系统自带的/usr/bin/git有时候是个占位壳真正生效的是 Homebrew 装的/opt/homebrew/bin/git或/usr/local/bin/git。用which git确认一下路径which git输出应该是 Homebrew 路径而不是/usr/bin/git。如果不是把 Homebrew 的 bin 目录加到 PATH 前面。2.3 环境变量检查清单装完 Git 只是第一步接入 TaoToken 之前还要核对几个环境项。下面这份清单你可以逐条打勾检查项命令期望结果Git 版本git -v2.30 以上Git 路径which gitmacOS/where gitWindows指向真实安装路径默认分支git config --global init.defaultBranchmain用户名git config --global user.name你的名字邮箱git config --global user.email你的邮箱Node 版本node -v18 以上Claude Code 依赖用户名和邮箱如果没配用这两条补上git config --global user.name 你的名字 git config --global user.email 你的邮箱Node.js 是 Claude Code 的运行依赖如果node -v报错先去装 Node.js LTS 版本。这一步别跳过否则后面接入时会卡在启动阶段。3. TaoToken 统一 Key 接入前的配置文件准备Git 和 Node 都就绪后就进入接入环节。TaoToken 的作用是提供一个统一的 Key 和 API 通道让你不用在多个模型供应商之间来回切换配置。官网地址是https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 入口是https://taotoken.net/api。接入前你需要先拿到 Key。打开 API Keys 管理页https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite创建一个新 Key 并复制保存。这个 Key 就是后面配置文件里的核心凭证。Claude Code 的配置通常放在用户目录下的 settings 文件里。Windows 路径一般是C:\Users\你的用户名\.claude\settings.jsonmacOS 是~/.claude/settings.json。如果目录不存在手动创建即可。下面是一份可复制的 JSON 配置片段把占位符替换成你自己的值{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: 你的TaoToken Key, ANTHROPIC_MODEL: claude-sonnet-4-20250514 } }这里三个字段要写全也就是接入三件套Base URL、Key、Model ID。Base URL 固定用https://taotoken.net/api不要加多余路径。Key 填你刚创建的那串。Model ID 填你要用的模型标识具体可用列表可以在模型对话页确认https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite。如果你用的是 Codex 这类工具配置位置在~/.codex/auth.json结构类似同样需要 Base URL、Key、Model ID 三件套。Cline 的 MCP 配置则在扩展设置里填同样的三项。不管哪个工具核心逻辑一致把请求指向 TaoToken 的 API 通道用统一 Key 鉴权指定模型 ID。注意配置文件里的 Key 不要提交到 Git 仓库也不要截图发到公开渠道。建议把 settings 文件加进.gitignore。配置写完后先别急着启动 Claude Code回到终端做一次环境变量核对echo $ANTHROPIC_BASE_URL echo $ANTHROPIC_AUTH_TOKENWindows 上用echo %ANTHROPIC_BASE_URL%。如果输出为空说明配置文件没被读取检查路径和 JSON 格式是否正确。JSON 里多一个逗号都会导致解析失败。4. 验证请求与成功结果从启动到首次对话配置就绪后启动 Claude Code。在终端进入你的项目目录运行claude第一次启动会读取 settings.json 里的环境变量。如果一切正常你会看到 Claude Code 的交互界面可以输入问题。为了验证请求真的走通了 TaoToken 通道可以问一个简单问题比如「帮我看看当前目录的 Git 状态」。它会调用 Git 命令并返回结果。更直接的验证方式是发一个最小请求确认 API 通道连通。你可以用 curl 测一下curl https://taotoken.net/api/v1/messages \ -H Authorization: Bearer 你的TaoToken Key \ -H Content-Type: application/json \ -d {model:claude-sonnet-4-20250514,max_tokens:50,messages:[{role:user,content:ping}]}如果返回包含content字段的 JSON说明 Key 和通道都正常。如果返回 401说明 Key 无效或没带上。如果返回模型不存在说明 Model ID 写错了回模型对话页核对。成功的结果长这样终端里 Claude Code 正常响应Git 命令能被执行diff 能生成。这时候你的环境就算搭好了。整个过程里Git 负责版本控制Node 负责运行时TaoToken 负责模型通道三者缺一不可。实测下来最容易忽略的是 Node 版本。Claude Code 对 Node 18 以下不友好会出现启动即退出。所以node -v这一步一定要确认。5. 本篇常见报错排查401、local proxy failed 与 reading choices接入过程中会遇到几类典型报错这里逐个对照排查。第一类401 Unauthorized。原因通常是 Key 没填对、Key 已失效、或者请求头没带上。检查 settings.json 里的ANTHROPIC_AUTH_TOKEN是否和 API Keys 页面创建的一致。注意不要有多余空格。如果用的是 curl 测试确认Authorization: Bearer后面跟的是完整 Key。第二类local proxy failed。这个报错一般出现在工具尝试走本地代理但配置不完整时。检查你的 Base URL 是否写成了https://taotoken.net/api不要写成带/v1或其他后缀的地址。同时确认没有在环境里残留旧的代理变量比如HTTP_PROXY、HTTPS_PROXY。如果有先清掉unset HTTP_PROXY unset HTTPS_PROXYWindows 上用set HTTP_PROXY清空。第三类reading choices相关报错。这通常出现在响应解析阶段说明返回的 JSON 结构不符合预期。常见原因是 Model ID 写错导致服务端返回了错误结构。回模型对话页确认可用模型列表把ANTHROPIC_MODEL改成正确的 ID。另外检查请求是否被中间层改写Base URL 必须是https://taotoken.net/api。第四类OAuth 相关报错。如果你之前登录过其他账号本地可能残留了旧的 OAuth 凭证和新的 Key 冲突。清理方式删除~/.claude下的缓存文件或者直接重命名整个目录备份然后重新写 settings.json。第五类git: command not found。这说明 Git 没装好或 PATH 没生效。回第 2 节重新核对git -v和which git。Windows 上如果 PATH 选错了重装 Git 时选第二个 PATH 选项。提示排查时先看报错关键词再对照上面五类。大部分问题集中在 Key、Base URL、Model ID 这三项把三件套核对一遍能解决八成故障。如果排查完还是不通可以去接入文档页看最新说明https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite。文档里会同步最新的配置格式和可用模型。6. 装完 Git 之后把环境接到 TaoToken 统一通道Git 装好、Node 就绪、settings.json 写完这三步做完你的 Claude Code 环境就具备了接入条件。接下来要做的就是把请求真正指向 TaoToken 的统一 Key 通道。如果你打算长期用 AI 编程建议直接上 Coding Plan省去每次单独配 Key 的麻烦https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite。对于只是临时验证模型的场景用模型对话页就够了https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite。而如果你要管理多个 Key、查看用量去控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite。回到环境本身最后再确认一次三件套是否写全Base URL 是https://taotoken.net/apiKey 来自 API Keys 页面Model ID 来自模型列表。这三项在 Claude Code、Codex、Cline MCP 里的位置不同但内容一致。写完后启动claude发一条消息能收到回复就说明整条链路通了。一个实用技巧把 settings.json 里的配置做成模板换机器时直接复制只改 Key 就行。这样下次在新环境里配 Claude Code你只需要装 Git、装 Node、填 Key 三步十分钟内能跑起来。Git 安装这一篇是整个系列的地基地基打牢了后面的接入和调优才顺。
