企业官网建设流程全解析

1. 从零跑通 Claude Code：Node.js 环境准备与 npm 安装避坑

Claude Code 是 Anthropic 推出的命令行 AI 编程助手，简单说就是你把需求用中文讲给它，它自己读文件、改代码、跑命令、修 bug。适合谁？适合刚接触命令行、想用 AI 辅助写代码但不想折腾复杂 IDE 插件的开发者。它跑在终端里，所以第一步不是装 Claude Code，而是把 Node.js 和 npm 准备好——因为 Claude Code 是通过 npm 分发的。

我见过太多人卡在第一步：终端里敲node --version提示「不是内部或外部命令」，或者 npm 装到一半卡死。这一节就把这些坑一次填平。

先检查你电脑上有没有 Node.js。打开终端（Windows 按 Win+R 输入 cmd，macOS 打开「终端」），输入：

node --version npm --version

如果输出类似v20.11.0和10.2.4，说明已经有了，直接跳到第 2 节。如果提示找不到命令，就按下面系统对应安装。

Windows 用户去 nodejs.org，点左边绿色的 LTS 按钮下载.msi安装包，双击一路 Next → Install → Finish。装完必须关掉终端重新开一个，否则 PATH 不生效。macOS 用户推荐用 Homebrew，一条命令搞定：

brew install node

没装过 Homebrew 的话先执行官方安装脚本。Linux（Ubuntu/Debian）用 NodeSource 源：

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt-get install -y nodejs

装完再验证一次node --version，看到版本号才算过关。

接下来装 Claude Code 本体：

npm install -g @anthropic-ai/claude-code

-g是全局安装，装完在任何目录都能用claude命令。验证：

claude --version

看到v2.x.x就成功了。如果 npm 下载慢或卡住，换国内镜像：

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

macOS/Linux 如果报EACCES权限错误，别急着加 sudo，更推荐改 npm 全局目录一劳永逸：

mkdir ~/.npm-global npm config set prefix '~/.npm-global' echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc source ~/.bashrc

然后重新执行安装命令。这一步做完，环境就齐了。很多人问「Claude Code 本地安装教程」到底难在哪，其实难点全在环境变量和 PATH 上，命令本身只有一行。

2. TaoToken 前置准备：API Key 获取与 Base URL 配置

Claude Code 装好了，但它还不知道该调用哪个模型。默认情况下它会找 Anthropic 官方接口，需要付费订阅。对国内开发者更友好的做法是走兼容 Anthropic 协议的 API 服务，TaoToken 就是这样一个入口，它提供统一的 Base URL 和 API Key，Claude Code 只要改两个环境变量就能接上。

先去官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 注册账号，登录后进入控制台。在左侧找到「API Keys」，点创建，复制那串sk-开头的密钥。这个 Key 只显示一次，先存到记事本里。

TaoToken 的 API 地址是 https://taotoken.net/api ，注意这个地址不带任何查询参数，直接作为 Base URL 使用。Claude Code 认的环境变量名是ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN，前者填 TaoToken 的 API 地址，后者填你刚复制的 Key。

这里有个关键点：Claude Code 会区分不同档位的模型（Haiku/Sonnet/Opus），你需要告诉它每个档位实际映射到哪个模型 ID。TaoToken 控制台的「模型对话」页面能看到当前可用的模型列表，把模型 ID 抄下来填进配置。如果你不确定填什么，先用一个通用模型 ID 跑通链路，后面再细化。

配置方式有两种：写配置文件，或者设系统环境变量。推荐写配置文件，因为 Claude Code 每次启动都会读~/.claude/settings.json，不用每次开终端都 export。Windows 用户注意路径是%USERPROFILE%\.claude\settings.json，macOS/Linux 是~/.claude/settings.json。

创建目录：

mkdir -p ~/.claude

Windows 在文件资源管理器地址栏输入%USERPROFILE%，新建.claude文件夹。然后在这个文件夹里新建settings.json，内容下一节给。这一步做完，Claude Code 就知道「去哪调用、用哪个 Key、用哪个模型」了。

顺便说一句，如果你后面要长期跑编码任务或 Agent 流程，可以了解下 Coding Plan，它针对高频调用做了额度优化，比按次计费更划算。入口在控制台里能找到。

3. 可复制配置：settings.json 完整片段与参数说明

这一节直接给可复制的配置。在~/.claude/settings.json里写入以下 JSON：

{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_AUTH_TOKEN": "sk-你的TaoToken密钥", "ANTHROPIC_MODEL": "你的主模型ID", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "你的轻量模型ID", "ANTHROPIC_DEFAULT_SONNET_MODEL": "你的中档模型ID", "ANTHROPIC_DEFAULT_OPUS_MODEL": "你的高档模型ID" } }

把sk-你的TaoToken密钥换成第 2 节复制的真实 Key，把四个模型 ID 换成 TaoToken 控制台里看到的实际值。四个模型字段的作用是：当你用/model haiku切换时，Claude Code 会去调ANTHROPIC_DEFAULT_HAIKU_MODEL指定的模型；不指定--model时用ANTHROPIC_MODEL。

如果你只想先跑通，可以四个字段填同一个模型 ID，等链路验证成功再细分。JSON 格式很严格：键和值都要双引号，最后一项后面不能有逗号。写完可以用在线 JSON 校验工具过一遍，或者直接让 Claude Code 自己检查。

Windows 用户如果不想写文件，也可以用 PowerShell 设环境变量：

setx ANTHROPIC_BASE_URL "https://taotoken.net/api" setx ANTHROPIC_AUTH_TOKEN "sk-你的TaoToken密钥"

但setx设置的是用户级环境变量，需要重开终端才生效，而且模型映射字段不好设，所以还是推荐 settings.json。

配置文件的路径必须准确。macOS/Linux 下~展开是/Users/你的用户名或/home/你的用户名；Windows 下是C:\Users\你的用户名。如果你把文件放错地方，Claude Code 读不到，就会报「未设置 ANTHROPIC_API_KEY」。

写完后可以快速检查文件是否存在：

cat ~/.claude/settings.json

Windows 用：

type %USERPROFILE%\.claude\settings.json

能看到内容就说明路径对了。这一步是整个接入的核心，配置对了后面就顺了。

4. 验证请求：最小对话与项目上下文读取实测

配置写完，先做最小验证。在终端输入：

claude -p "hello"

-p是 print 模式，问一句答一句就退出。如果返回一段问候语，说明 Base URL、Key、模型 ID 三者都通了。如果报错，先看第 5 节的排查表。

链路通了之后，验证它能不能读项目上下文。随便找个项目目录：

cd /你的项目路径 claude -p "帮我看看这个项目在做什么" --max-turns 5

--max-turns 5限制最多执行 5 轮操作，防止它跑飞。正常的话它会列出目录结构、读几个关键文件，然后给你一段项目概述。这一步验证的是 Claude Code 的工具调用能力——它不只是聊天，而是真的能读文件。

再试一个代码审查场景：

git diff | claude -p "帮我审查这些改动，重点看有没有 bug 和安全问题" --max-turns 1

把git diff的输出通过管道传给它，它就能针对改动给意见。这个用法在提交代码前特别实用。

最后验证 CLAUDE.md 是否生效。在项目根目录新建CLAUDE.md：

# 我的项目 ## 技术栈 - Python 3.12 + FastAPI + SQLAlchemy - PostgreSQL 数据库 ## 常用命令 - pytest 跑测试 - ruff check . 做代码检查 ## 代码规范 - Python 用 4 空格缩进 - 所有公开函数必须有类型标注 - 测试文件命名 test_*.py

然后问它：

claude -p "这个项目用什么测试命令？"

如果它回答pytest，说明 CLAUDE.md 被自动读取了。Claude Code 每次进入项目都会读这个文件，相当于给它的「项目记忆」。你可以在里面写技术栈、目录约定、禁止修改的文件、提交规范等，省得每次重复交代。

交互模式也值得试一下：

claude

直接回车进入 TUI 界面，可以多轮对话、用/model切模型、用/compact压缩上下文省 token、用/review审查改动、用/help看所有命令。按 Ctrl+D 退出。交互模式适合边聊边改代码，-p模式适合脚本化和一次性任务。

5. 常见报错排查：401、local proxy failed、reading choices 对照解决

这一节按真实报错对照排查。第一个高频错误是401 Unauthorized或authentication_error。原因通常是 Key 填错、Key 过期、或者 Base URL 写成了带路径的形式。检查settings.json里ANTHROPIC_AUTH_TOKEN是不是完整的sk-开头字符串，ANTHROPIC_BASE_URL是不是https://taotoken.net/api，末尾不要加/v1或斜杠。改完保存，重开终端再试。

第二个是local proxy failed或连接超时。这通常是网络层问题，不是配置问题。先确认能不能访问 Base URL：

curl -I https://taotoken.net/api

如果 curl 都连不上，说明本机网络到服务端不通，检查防火墙或公司网络策略。如果 curl 通但 Claude Code 报错，可能是代理环境变量干扰，检查HTTP_PROXY/HTTPS_PROXY是否设了奇怪的值，临时清掉再试。

第三个是reading choices或unexpected response format。这通常意味着返回的不是 Anthropic 兼容格式，多半是模型 ID 填错了，或者 Base URL 指向了非兼容端点。回 TaoToken 控制台的「模型对话」页面确认模型 ID 拼写，注意大小写。有些模型 ID 带版本号后缀，少一段就匹配不上。

第四个是OAuth相关报错，比如提示登录 Anthropic 账号。这说明 Claude Code 没读到你的 settings.json，走了默认官方认证流程。检查文件路径：macOS/Linux 是~/.claude/settings.json，Windows 是%USERPROFILE%\.claude\settings.json。注意.claude前面有个点，Windows 下创建时别被资源管理器吞掉。可以用dir %USERPROFILE%\.claude确认文件真的在。

第五个是claude: command not found。装完了但终端找不到命令，通常是 npm 全局 bin 目录不在 PATH 里。执行npm config get prefix看全局路径，把这个路径下的bin子目录加进 PATH。macOS/Linux 改~/.bashrc或~/.zshrc，Windows 在「系统属性 → 环境变量」里加。

第六个是 Windows 终端乱码。系统自带 cmd 对 UTF-8 支持差，换成 Windows Terminal（Microsoft Store 免费下载），或者在 cmd 里先执行chcp 65001切到 UTF-8。

如果你用的是 CC Switch 或 Cline MCP 这类工具管理多套配置，记住三件套必须齐全：Base URL、API Key、Model ID。缺任何一个都会报错。CC Switch 里切换配置后，确认它写进了正确的 settings.json 路径。

排查顺序建议：先claude -p "hello"确认链路，再claude --version确认安装，最后cat ~/.claude/settings.json确认配置。三步定位问题在哪一层。

6. 接入文档与后续进阶：从跑通到日常编码

链路跑通只是开始。日常用起来，claude -p适合一次性任务，交互模式适合复杂重构。几个实用参数值得记住：--allowedTools "Read,Edit"限制它只能用读和改，防止误执行命令；--output-format json输出结构化结果，方便接自动化脚本；-c继续上次对话，不用重新交代上下文；--dangerously-skip-permissions跳过确认弹窗，仅限 CI 或你完全信任的场景用。

CLAUDE.md 可以写得更细。除了技术栈和命令，还能写「不要修改 migrations 目录」「提交信息用中文」「新增依赖前先问我」这类约束。它每次进项目都会读，相当于给 AI 立规矩。项目大了可以拆成多个文件，用@引用。

如果你要长期跑编码任务或 Agent 流程，建议了解 Coding Plan，它针对高频调用做了额度优化。需要更多模型或查看完整参数，去模型对话页面实测；Key 管理在 API Keys 页面；完整接入说明看接入文档。遇到报错先把错误信息贴给 Claude Code 自己，它往往能直接告诉你哪配错了。

最后提醒一句：配置文件里的 Key 不要提交到 Git，~/.claude/目录本身在用户目录下，一般不会被项目仓库跟踪，但如果你把配置复制到了项目里，记得加进.gitignore。装好之后多用-p模式熟悉基本用法，再慢慢进阶到交互模式和项目级开发。