企业官网建设流程全解析

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_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite ），登录后创建一个新的 API Key。创建完立刻复制，页面刷新后就看不全了。这个 Key 长得像sk-开头的一长串字符。

第二步，确认 Base URL。TaoToken 的接口地址是https://taotoken.net/api，注意结尾不要多加斜杠，也不要写成/v1，Claude Code 会自己拼路径。很多人 401 就是因为 Base URL 多写了一段。

第三步，选 Model ID。这个取决于你在 TaoToken 控制台里开通了哪些模型。常见的有claude-sonnet-4-5、claude-opus-4-1这类。你可以在 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite 控制台里看到可用模型列表，复制其中一个准确的 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_source=taotoken_aicg_blog_end&utm_content=model_chat&utm_campaign=rewrite 模型对话页面里试几句，确认这个模型能正常回你，再去配 Claude Code。这样能排除「是模型服务的问题还是客户端配置的问题」。

三件套齐了之后，别急着开 Claude Code，先把 settings.json 写好。下一节就是完整可复制的配置。

3. 可复制配置：settings.json 完整片段与 bash 路径设置

Claude Code 读配置有两个位置：用户级和项目级。用户级在 Windows 上是C:\Users\你的用户名\.claude\settings.json，macOS/Linux 是~/.claude/settings.json。项目级是项目根目录下的.claude/settings.json。新手建议先配用户级，一次配好全局生效。

先创建目录（如果不存在）。Windows 在 PowerShell 里执行：

mkdir $env:USERPROFILE\.claude -Force

macOS/Linux：

mkdir -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 Code：

claude

进去之后输入/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 Code：

claude

第一件事，让它初始化项目并生成 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_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite 重新生成一个 Key 换上。

local proxy failed。现象是执行 bash 命令时报代理失败。原因多半是 settings.json 里残留了HTTP_PROXY或HTTPS_PROXY字段，但那个地址已经不可用。修法：把这两个字段从 settings.json 里删掉。如果你确实需要走本地网络配置，确认地址和端口正确后再加回来。新手阶段建议先不加，减少变量。

reading choices 报错。现象是模型返回的内容解析失败，提示读取 choices 出错。原因通常是 Model ID 写错了，或者这个模型在你的账号下没开通。修法：去 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite 控制台核对可用模型列表，把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_source=taotoken_aicg_blog_end&utm_content=model_chat&utm_campaign=rewrite 模型对话页面，那里不用配环境就能直接聊，适合快速对比。

如果你打算长期用 Claude Code 写代码、跑 Agent 任务，建议了解一下 Coding Plan，地址是 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite 。它针对长时间编码场景做了额度优化，比按次调用更划算。

如果你在排查接入问题时需要查文档，接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite ，里面有各客户端的配置示例。API Keys 管理页还是 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite ，Key 丢了或要轮换就去那里。

最后说个实用技巧：把 CLAUDE.md 当成活的文件。每次你发现 AI 犯了同样的错，就把那条规则补进去。比如它老是忘记跑测试，你就加一条「每个模块完成后必须执行测试命令并贴出输出」。用不了多久，你的 CLAUDE.md 就会变成一份贴合自己项目习惯的规则集，AI 的表现也会越来越稳。这比每次在对话里重复交代要省事得多。