1. 为什么新手第一次跑 Claude Code 总卡在 settings.json 和 bash 上Claude Code 是 Anthropic 推出的终端 AI 编程助手能直接读写你本机项目文件、执行 bash 命令、跑 git 提交。它适合谁适合已经会一点命令行、想让 AI 帮自己从零搭一个小项目的人。但新手第一次跑十有八九会卡在三个地方settings.json 不知道写在哪、bash.exe 找不到导致命令全红、CLAUDE.md 不知道写什么规则。我自己第一次装完 Claude Code输入一句话让它建个 HTML 页面结果它回我一句bash: command not found然后整个会话就僵在那里。后来才发现是 Windows 上没告诉它 bash 在哪。这类问题不是模型笨是环境没配好。这篇就按「30 分钟从零到可用」的路径走先配 settings.json 接上模型再解决 bash 路径然后写 CLAUDE.md 定规则最后用 git 验证改动真的落盘了。全程给可直接复制的配置和命令你跟着敲就行。核心检索词先摆出来Claude Code 的 settings.json 配置、bash 路径设置、CLAUDE.md 项目规则、git 提交验证这四件事串起来就是一个最小闭环。下面每一步我都会说清楚「为什么这么配」和「配完怎么确认生效」避免你配完不知道对不对。先说清楚一个前提Claude Code 本身是个客户端它需要背后有一个模型服务来响应。你可以用官方账号也可以用兼容 Anthropic 接口的第三方服务。本文演示用 TaoToken 这类兼容服务来接入因为它把 Base URL、Key、Model ID 三件套讲得很清楚新手不容易懵。地址在 https://taotoken.net/api 后面配置里会用到。2. TaoToken 前置准备拿到 Base URL、Key 和 Model ID 三件套在动 settings.json 之前你得先有三样东西Base URL、API Key、Model ID。这三个缺一个Claude Code 启动后要么 401要么 reading choices 报错。我试过只填 Key 不填 Base URL结果它默认去连官方地址直接超时。第一步打开 https://taotoken.net/api-keys 这个页面deep link 是 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 登录后创建一个新的 API Key。创建完立刻复制页面刷新后就看不全了。这个 Key 长得像sk-开头的一长串字符。第二步确认 Base URL。TaoToken 的接口地址是https://taotoken.net/api注意结尾不要多加斜杠也不要写成/v1Claude Code 会自己拼路径。很多人 401 就是因为 Base URL 多写了一段。第三步选 Model ID。这个取决于你在 TaoToken 控制台里开通了哪些模型。常见的有claude-sonnet-4-5、claude-opus-4-1这类。你可以在 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 控制台里看到可用模型列表复制其中一个准确的 ID。把这三样记在一个临时文本里格式像这样Base URL: https://taotoken.net/api API Key: sk-你的key Model ID: claude-sonnet-4-5注意API Key 等同于密码不要提交到 git 仓库也不要贴到公开聊天里。后面我们会把它写进用户目录下的配置文件而不是项目目录就是为了避免误提交。如果你还没决定用哪个模型可以先在 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 模型对话页面里试几句确认这个模型能正常回你再去配 Claude Code。这样能排除「是模型服务的问题还是客户端配置的问题」。三件套齐了之后别急着开 Claude Code先把 settings.json 写好。下一节就是完整可复制的配置。3. 可复制配置settings.json 完整片段与 bash 路径设置Claude Code 读配置有两个位置用户级和项目级。用户级在 Windows 上是C:\Users\你的用户名\.claude\settings.jsonmacOS/Linux 是~/.claude/settings.json。项目级是项目根目录下的.claude/settings.json。新手建议先配用户级一次配好全局生效。先创建目录如果不存在。Windows 在 PowerShell 里执行mkdir $env:USERPROFILE\.claude -ForcemacOS/Linuxmkdir -p ~/.claude然后创建settings.json内容如下。把sk-你的key和 Model ID 换成你自己的{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: sk-你的key, ANTHROPIC_MODEL: claude-sonnet-4-5, CLAUDE_CODE_GIT_BASH_PATH: D:\\Program Files\\Git\\bin\\bash.exe } }这里四个字段逐个说。ANTHROPIC_BASE_URL指向 TaoToken 的接口地址注意是https://taotoken.net/api不带 UTM 参数也不带结尾斜杠。ANTHROPIC_AUTH_TOKEN就是你的 Key。ANTHROPIC_MODEL是 Model ID。CLAUDE_CODE_GIT_BASH_PATH是 Windows 专属告诉 Claude Code 去哪找 bash.exe。bash 路径怎么找先确认你装了 Git for Windows。在终端里执行where git它会输出类似D:\Program Files\Git\cmd\git.exe。把cmd\git.exe换成bin\bash.exe就是 bash 的路径。注意 JSON 里反斜杠要写成双反斜杠\\否则解析会报错。这是新手最容易踩的坑之一单反斜杠会让 JSON 直接失效。macOS/Linux 用户不需要CLAUDE_CODE_GIT_BASH_PATH系统自带 bash删掉这一行即可。配完保存然后在终端里验证一下环境变量有没有被读到。启动 Claude Codeclaude进去之后输入/status它会显示当前用的 Base URL 和 Model。如果显示的是你配的地址和模型说明 settings.json 生效了。如果还是官方地址检查文件路径对不对以及 JSON 有没有语法错误可以用在线 JSON 校验器过一遍。提示如果你同时配了用户级和项目级 settings.json项目级会覆盖用户级的同名字段。调试阶段建议只留用户级减少变量。配置这一步做完Claude Code 已经能连上模型了。但如果你在 Windows 上让它执行 bash 命令可能还是会报bash: command not found。下一节我们用实际请求验证顺便把 bash 和 git 的闭环跑通。4. 验证请求与成功结果跑通 bash、CLAUDE.md 与 git 提交现在开一个空目录当项目验证整条链路。先建目录并进入mkdir claude-demo cd claude-demo启动 Claude Codeclaude第一件事让它初始化项目并生成 CLAUDE.md。输入/init这个命令会让 Claude Code 扫描当前目录生成一份基础的 CLAUDE.md。因为目录是空的它会写一个通用模板。生成后你可以用/memory查看内容。第二件事验证 bash 能跑。直接输入一句帮我执行 ls -la 并把结果贴出来如果 bash 路径配对了它会正常返回文件列表。如果报bash: command not found或者local proxy failed回到第 3 节检查CLAUDE_CODE_GIT_BASH_PATH。Windows 上路径写错、Git 没装、或者 JSON 里用了单反斜杠都会导致这个错。第三件事写 CLAUDE.md 规则。CLAUDE.md 是 Claude Code 的「项目记忆」每次会话它都会读。你可以手动编辑也可以让 AI 写。手动编辑的话在项目根目录建CLAUDE.md内容示例# 项目规则 ## 语言 - 所有回复必须使用简体中文。 ## 代码规范 - HTML 使用语义化标签。 - CSS 类名用 kebab-case。 - 每个功能模块完成后必须写测试步骤。 ## 汇报要求 - 每次报告任务完成时必须附带证据命令输出或文件路径。 - 不允许在未验证的情况下声称完成。这份规则里最关键的是最后两条。AI 有个毛病叫「虚假工作成果」就是没干完却说干完了。你把「必须附带证据」写进 CLAUDE.md它每次汇报就会老实贴命令输出。第四件事初始化 git 并验证改动落盘。在 Claude Code 里输入帮我初始化 git 仓库不使用远程仓库。用户名你的名字email你的邮箱它会执行git init、git config等命令。中途可能问你确认选 yes。完成后让它建一个文件并提交创建一个 index.html内容是一个标题为 Hello 的页面然后 git add 并 commit等它做完你在终端里另开一个窗口执行git log --oneline如果能看到一条提交记录说明 AI 的改动真的写到了磁盘并被 git 追踪了。这一步就是「用 git 验证改动是否生效」的核心动作。很多人以为 AI 说完成就完成了其实文件可能根本没写。git log 和 git status 是最诚实的检查器。再执行git show --stat HEAD它会列出这次提交改了哪些文件。如果index.html在里面闭环就跑通了。到这里你已经完成了 settings.json 配置、bash 调用、CLAUDE.md 规则、git 提交验证四件事。5. 本篇常见报错排查401、local proxy failed、reading choices、OAuth这一节把新手最常撞的四个报错逐个拆。每个都给你现象、原因、修法。401 Unauthorized。现象是 Claude Code 启动后一提问就返回 401。原因通常是 Key 错了、Key 过期、或者 Base URL 和 Key 不匹配。修法先确认ANTHROPIC_AUTH_TOKEN是完整的sk-开头字符串没有多余空格。再确认ANTHROPIC_BASE_URL是https://taotoken.net/api没有多写/v1。如果还不行去 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 重新生成一个 Key 换上。local proxy failed。现象是执行 bash 命令时报代理失败。原因多半是 settings.json 里残留了HTTP_PROXY或HTTPS_PROXY字段但那个地址已经不可用。修法把这两个字段从 settings.json 里删掉。如果你确实需要走本地网络配置确认地址和端口正确后再加回来。新手阶段建议先不加减少变量。reading choices 报错。现象是模型返回的内容解析失败提示读取 choices 出错。原因通常是 Model ID 写错了或者这个模型在你的账号下没开通。修法去 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 控制台核对可用模型列表把ANTHROPIC_MODEL改成列表里存在的 ID。注意大小写和连字符要完全一致。OAuth 相关报错。现象是提示需要登录或 OAuth 失败。原因是你可能同时配了官方登录态和第三方 Key两者冲突。修法确认 settings.json 里用的是ANTHROPIC_AUTH_TOKEN而不是 OAuth 相关字段。如果之前登录过官方账号执行claude logout清掉登录态再重启。除了这四个还有一个隐蔽的坑JSON 语法错误。settings.json 里多一个逗号、少一个引号Claude Code 会静默忽略整个文件然后回退到默认配置。表现就是「我明明配了但没生效」。修法把 settings.json 贴到任意 JSON 校验器里过一遍确认无语法错误。注意排查时养成看日志的习惯。Claude Code 启动时可以加--debug参数它会打印详细的请求和响应过程能快速定位是配置问题还是网络问题。把上面这些对照着查基本能覆盖 90% 的新手报错。剩下 10% 多半是环境差异比如 Windows 路径空格、权限不足等逐个排除即可。6. 语义一致 CTA把闭环跑顺之后往哪走跑通上面这套流程后你手里就有了一个能用的 Claude Code 环境settings.json 接上了模型bash 能执行命令CLAUDE.md 定了规则git 能验证改动。接下来往哪走取决于你的目标。如果你主要想验证模型能力、试不同模型的回答质量可以直接去 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 模型对话页面那里不用配环境就能直接聊适合快速对比。如果你打算长期用 Claude Code 写代码、跑 Agent 任务建议了解一下 Coding Plan地址是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。它针对长时间编码场景做了额度优化比按次调用更划算。如果你在排查接入问题时需要查文档接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有各客户端的配置示例。API Keys 管理页还是 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite Key 丢了或要轮换就去那里。最后说个实用技巧把 CLAUDE.md 当成活的文件。每次你发现 AI 犯了同样的错就把那条规则补进去。比如它老是忘记跑测试你就加一条「每个模块完成后必须执行测试命令并贴出输出」。用不了多久你的 CLAUDE.md 就会变成一份贴合自己项目习惯的规则集AI 的表现也会越来越稳。这比每次在对话里重复交代要省事得多。