1. Windows 上第一次跑 Claude Code五个卡点一次说清Claude Code 是 Anthropic 出的命令行编程助手能在终端里读你的项目、改代码、跑命令。它适合已经习惯用命令行、又想让 AI 直接动工程文件的开发者。但在 Windows 上第一次上手很多人会连续撞上五堵墙环境变量CLAUDE_CODE_GIT_BASH_PATH没配导致启动直接报错、想换模型却不知道启动参数、截图想粘进去发现没反应、想让它只看某个文件却不会引用、以及文档写不进doc_cursor目录。这篇就把这五个问题按顺序拆开每个都给可复制的配置和验证动作。我试过在 Windows 11 Git Bash 的组合下从零配一遍下面这套流程走完五个卡点基本都能过。核心思路是先用一个统一的 Key/API 通道把模型接进来再逐项解决环境、模型、图片、文件引用和 gitignore 的问题。2. 前置用 TaoToken 统一 Key 和 API 通道Claude Code 默认走 Anthropic 官方接口国内直连经常超时。更省事的做法是接一个兼容 Anthropic 协议的通道把 Key 和 Base URL 统一管起来。TaoToken 就是干这个的官网在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 。先去控制台建一个 Key控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewriteAPI Keys 管理https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite建完 Key 后Claude Code 需要两个环境变量ANTHROPIC_BASE_URL指向 TaoToken 的 API 地址ANTHROPIC_AUTH_TOKEN填你刚建的 Key。这样后面不管换哪个模型都只改一个模型名不用再动 Key。注意Key 只存在本地环境变量或配置文件里别写进会提交到 Git 的文件。后面第 6 节会讲 gitignore 怎么兜底。3. 可复制配置settings.json 与 config.toml 骨架Claude Code 的配置分两层一层是环境变量管 Key、Base URL、Git Bash 路径一层是项目级或用户级的 settings。下面给两份骨架按需改路径和模型名。3.1 环境变量与 CLAUDE_CODE_GIT_BASH_PATHWindows 上 Claude Code 依赖 Git Bash 来执行 shell 命令。如果它找不到 bash启动就会报错典型提示是找不到bash.exe或直接退出。解决办法是显式告诉它 Git Bash 在哪。先确认你的 Git Bash 路径一般是# 在 PowerShell 里查一下 git 装在哪 where.exe git # 常见结果C:\Program Files\Git\cmd\git.exe # 那么 bash 就在C:\Program Files\Git\bin\bash.exe然后在 PowerShell 里设环境变量当前会话$env:CLAUDE_CODE_GIT_BASH_PATH C:\Program Files\Git\bin\bash.exe想永久生效用系统环境变量界面加一条或者[Environment]::SetEnvironmentVariable(CLAUDE_CODE_GIT_BASH_PATH, C:\Program Files\Git\bin\bash.exe, User)同时把 TaoToken 的两个变量也设上$env:ANTHROPIC_BASE_URL https://taotoken.net/api $env:ANTHROPIC_AUTH_TOKEN 你的_TaoToken_Key3.2 settings.json 骨架Claude Code 的用户级配置一般放在~/.claude/settings.jsonWindows 下是C:\Users\你的用户名\.claude\settings.json。项目级放在项目根的.claude/settings.json。骨架如下{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: 你的_TaoToken_Key, CLAUDE_CODE_GIT_BASH_PATH: C:\\Program Files\\Git\\bin\\bash.exe }, model: claude-sonnet-4-5-20250929, permissions: { allow: [ Read, Edit, Bash(git status), Bash(git diff) ] } }注意 JSON 里 Windows 路径的反斜杠要写成双反斜杠\\否则解析会出错。这是很多人第一次配就踩的坑。3.3 config.toml 骨架如果你用的是带 TOML 配置的封装工具或自建脚本可以这样写[api] base_url https://taotoken.net/api auth_token 你的_TaoToken_Key [claude] model claude-sonnet-4-5-20250929 git_bash_path C:\\Program Files\\Git\\bin\\bash.exe [permissions] allow [Read, Edit, Bash(git status)]两份配置二选一即可别同时改同一个值不然排查时容易懵。4. 启动时指定模型、粘贴图片、引入指定文件配好环境后进项目目录启动。下面三个操作是日常最高频的。4.1 启动时指定模型直接敲claude会用配置里的默认模型。想临时换模型用--model参数claude --model claude-sonnet-4-5-20250929如果你在终端里已经启动过按上方向键可以调出上次的命令改模型名就行。想确认当前用的是哪个模型进去后问一句「你现在是什么模型」它会自报。模型列表和可用性可以在模型对话页确认模型对话https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite4.2 粘贴图片Claude Code 支持把截图直接粘进对话。Windows 下操作是先截图到剪贴板WinShiftS然后在 Claude Code 输入框里按CtrlV。如果没反应检查两点一是终端本身是否支持粘贴图片Windows Terminal 比老版 cmd 好二是你用的通道是否支持多模态输入。粘成功后输入框会显示一个图片占位标记再补一句「看这张图帮我改这个报错」。4.3 引入指定文件的代码不想让它全项目乱翻就用引用具体文件。输入后它会列出项目里可导入的文件用上下键选中回车。比如src/utils/parse.ts 这个文件的 parseDate 函数有 bug帮我看看这样它只会聚焦这个文件省 token 也更准。引用多个文件就多打几个。5. 验证请求确认通道和模型都通了配完别急着写业务先做三步验证。第一步确认环境变量生效echo $ANTHROPIC_BASE_URL echo $CLAUDE_CODE_GIT_BASH_PATH在 Git Bash 里应该分别输出https://taotoken.net/api和你的 bash 路径。如果为空说明变量没设进当前 shell。第二步发一个最小请求。启动claude后输入请只回复两个字通了如果几秒内返回「通了」说明 Key、Base URL、模型三者都正常。第三步验证文件读写。让它读一个已知文件README.md 用一句话总结这个文件能正确总结说明文件引用和读取权限没问题。三步都过再进正式开发。6. 常见错排查文档写不进 doc_cursor 与 gitignore6.1 doc_cursor 写不进去现象是让 Claude Code 把文档写到doc_cursor/目录它要么说没权限要么写完文件不见了。原因通常是这个目录被 gitignore 忽略了或者权限配置里没放行写入。先看 gitignore。如果里面有类似doc_cursor/**的规则Git 会忽略它但 Claude Code 写文件本身不受 gitignore 影响——真正的问题是有些工具会跳过被忽略的目录。解决办法是在.gitignore里加例外doc_cursor/** !doc_cursor/ !doc_cursor/**这两行的意思是先忽略doc_cursor下所有内容再把doc_cursor目录本身和里面的文件重新纳入跟踪。注意!例外要写在忽略规则之后顺序反了不生效。如果加了例外还是写不进检查 settings.json 的 permissions 里有没有放行写操作。至少要允许Edit和对应路径的Write。有些配置只给了Read那自然写不进去。6.2 gitignore 排查清单按这个顺序过一遍基本能定位确认.gitignore里doc_cursor相关规则的位置例外规则必须在忽略规则后面。用git check-ignore -v doc_cursor/test.md看是哪条规则在拦输出会直接告诉你文件和行号。确认 Claude Code 的工作目录就是项目根不是子目录。确认 settings.json 里 permissions 放行了写操作。如果文件写出来了但git status看不到多半还是 gitignore 的例外没生效回到第一条。6.3 其他高频报错启动报bash not found就是CLAUDE_CODE_GIT_BASH_PATH没配或路径写错回去看 3.1。请求一直转圈或超时先echo $ANTHROPIC_BASE_URL确认指向 TaoToken再确认 Key 没过期。粘贴图片没反应换 Windows Terminal 试并确认通道支持多模态。7. 长期编码和 Agent 场景怎么接如果你只是偶尔问几句上面这套够了。但如果你打算把 Claude Code 当日常编码主力或者跑长时间 Agent 任务建议用 Coding Plan 把额度、模型和并发统一管起来省得每次手动换 KeyCoding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite接入文档在这里遇到协议或参数问题直接查接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewriteClaude Code 相关的专项说明Claude Code / Anthropic 接入https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecodeutm_campaignrewrite最后留一个我踩过的坑Windows 路径里的反斜杠在 JSON 里必须转义成双反斜杠我第一次配 settings.json 就是漏了这个启动一直报解析错误查了半小时才发现。配完记得用git check-ignore -v验一下 doc_cursor比肉眼翻 gitignore 快得多。