企业官网建设流程全解析

1. Claude Code 装完却跑不起来，问题多半卡在这三处

Claude Code 是 Anthropic 推出的终端 AI 编程助手，能直接在命令行里读写项目文件、执行命令、按自然语言改代码，适合习惯在终端里干活的开发者。它的安装本身不复杂，一条 npm 命令就能搞定，但真正让新手卡住的往往不是安装，而是装完之后的三道坎：Node.js 环境没配好、Windows 下 PowerShell 脚本策略拦截、以及最关键的——API 通道和 Token 没接上，导致claude一启动就报连接错误。

这篇就按「装环境 → 装 Claude Code → 拿 Token → 写 settings.json → 验证首次调用」的顺序走一遍，重点放在可复制的配置和排障上。Token 这块我用 TaoToken 的统一 API 通道来演示，它把模型调用收敛到一个 Key 和一个 Base URL 上，省得你在多个平台之间来回切换。整套流程在 Windows 的 PowerShell 或 CMD 里都能跑，macOS 和 Linux 用户把路径换成~/.claude即可，命令逻辑一致。

读完之后你应该能做到：在终端敲下claude，看到对话界面，输入一句话拿到模型回复。下面开始。

2. 前置准备：Node.js、npm 与 TaoToken 通道

2.1 Node.js 与 npm 环境确认

Claude Code 是 npm 包，所以第一步是确认 Node.js 和 npm 都在。已经装过的可以跳过，直接验证版本：

node --version npm --version

两条命令都能打印出版本号（Node.js 建议 18 及以上），说明环境没问题。如果提示「不是内部或外部命令」，就去 Node.js 官网下载 LTS 版本安装，安装时勾选「Add to PATH」，装完重开一个终端再验证。

Windows 上有个高频报错值得提前说：

npm : 无法加载文件 C:\Program Files\nodejs\npm.ps1，因为在此系统上禁止运行脚本。

这是 PowerShell 执行策略默认设为 Restricted 导致的，npm 在 Windows 上带了一个npm.ps1脚本，被策略拦住了。解决办法是以管理员身份打开 PowerShell，执行：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

输入Y确认即可。这条命令只影响当前用户，不会动系统全局策略，相对安全。

2.2 切换 npm 镜像并安装 Claude Code

国内网络直连 npm 官方源有时会慢或超时，先切到国内镜像：

npm config set registry https://registry.npmmirror.com

然后全局安装：

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

安装完成后输入claude --version，能打印版本号就说明二进制已经就位。

2.3 TaoToken 统一 API 通道是什么

TaoToken 做的事情可以理解成一个「统一收口」：你不需要为每个模型单独申请 Key、记不同的 Base URL，而是用同一个令牌走同一个入口去调用不同模型。对 Claude Code 这种需要填ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN的工具来说，这种统一通道能省掉大量配置切换的麻烦。

你需要准备两样东西：一个 API Key，以及对应的接入地址。Key 在控制台的 API Keys 页面创建，接入文档里有各工具的填写示例。官网入口是 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 根地址是 https://taotoken.net/api 。创建 Key 的页面在 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite ，接入说明在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 。先把 Key 复制到剪贴板备用，下一步就要用。

3. 可复制配置：settings.json 骨架与字段说明

3.1 找到并创建配置文件

Claude Code 读取的配置文件放在用户目录下的.claude文件夹里。Windows 上按Win + R，输入：

%userprofile%\.claude

回车后会打开这个目录。如果里面没有settings.json，就手动新建一个文本文件，命名为settings.json（注意扩展名是 json，不是 txt）。macOS / Linux 用户对应路径是~/.claude/settings.json。

3.2 settings.json 完整骨架

把下面这段填进去，替换掉令牌占位符：

{ "env": { "ANTHROPIC_AUTH_TOKEN": "你的TaoToken令牌", "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_MODEL": "claude-sonnet-4-5" }, "includeCoAuthoredBy": false }

几个字段的作用对照如下：

注意：ANTHROPIC_BASE_URL只写到/api这一层，不要自己拼/v1之类的后缀，具体路径由客户端处理。模型名以接入文档里列出的为准，写错会直接报模型不存在。

3.3 Windows 首次启动的 onboarding 处理

Windows 上第一次运行claude，有时会卡在引导流程或直接报错退出。可以先用一条命令把 onboarding 标记为已完成：

powershell -Command "$f='%USERPROFILE%\.claude.json';$j=Get-Content $f|ConvertFrom-Json;$j|Add-Member -NotePropertyName 'hasCompletedOnboarding' -NotePropertyValue $true -Force;$j|ConvertTo-Json|Set-Content $f"

这条命令的作用是往.claude.json里补一个hasCompletedOnboarding: true字段，跳过首次引导。执行完再运行claude，出现选项时选第一个Yes回车即可。

4. 验证请求：跑通 Claude Code 首次调用

配置写好后，在终端里启动：

claude

如果配置正确，会进入对话界面。这时输入一句测试，比如：

用一句话解释什么是闭包

能正常收到回复，就说明 Token、Base URL、模型三处都通了。想更直接地验证通道本身，也可以先用 curl 打一发请求，把问题定位在配置层还是网络层：

curl https://taotoken.net/api/v1/messages \ -H "Authorization: Bearer 你的TaoToken令牌" \ -H "Content-Type: application/json" \ -d '{ "model": "claude-sonnet-4-5", "max_tokens": 128, "messages": [{"role": "user", "content": "ping"}] }'

返回里带content字段且内容是正常文本，说明通道没问题，那 Claude Code 里再报错就基本是 settings.json 的格式或路径问题。如果 curl 就失败，先看返回的错误码：401 是令牌不对，404 是模型名或路径写错，超时则检查网络。

验证通过后，你就可以在项目目录里直接让 Claude Code 干活了，比如：

cd 你的项目目录 claude

然后在对话里说「读一下 package.json，告诉我依赖里有没有过期的包」，它会自己去读文件并回答。

5. 本篇常见错误排查

5.1 npm 脚本被禁止运行

前面提过的npm.ps1报错，根因是 PowerShell 执行策略。用管理员 PowerShell 执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser即可。如果公司电脑有组策略限制改不了，可以改用 CMD 而不是 PowerShell 来跑 npm 命令，绕开.ps1脚本。

5.2 settings.json 不生效

最常见的原因是文件放错位置或 JSON 格式错误。检查三点：文件确实在%userprofile%\.claude\下；文件名是settings.json而不是settings.json.txt；JSON 里没有多余的逗号、引号是英文半角。可以用在线 JSON 校验工具贴进去看一眼，能省很多时间。

5.3 启动报连接错误或 401

先确认ANTHROPIC_AUTH_TOKEN填的是完整令牌，没有多余空格或换行。再确认ANTHROPIC_BASE_URL是https://taotoken.net/api，没有多写路径。如果令牌是从网页复制的，注意别把前后的引号一起复制进去。改完配置后要完全退出 Claude Code 再重启，配置是启动时读取的。

5.4 模型名报错

ANTHROPIC_MODEL填的模型名必须和接入文档里列出的完全一致，大小写、连字符都不能差。不确定就先不写这个字段，让客户端用默认模型，跑通之后再指定。

5.5 安装成功但命令找不到

npm install -g之后claude提示找不到命令，通常是 npm 全局 bin 目录不在 PATH 里。执行npm config get prefix看全局目录在哪，把这个目录下的 bin 加进系统环境变量 PATH，重开终端再试。

6. 后续怎么用：把通道固定下来

跑通首次调用之后，日常使用其实就三件事：保持 settings.json 不动、需要换模型时改ANTHROPIC_MODEL、需要管理或轮换令牌时去控制台操作。如果你打算长期在终端里用 AI 辅助编码，或者要接 Agent 类工作流，可以考虑用 Coding Plan 把用量和通道固定下来，入口在 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite 。只是想先验证模型对话效果，用模型对话页面更轻量：https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=models&utm_campaign=rewrite 。令牌管理和新建 Key 都在 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite ，接入细节和字段说明以 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 为准。

最后留一个我踩过的坑：改完 settings.json 一定要完全退出 Claude Code 进程再重启，光在对话里输入/exit有时不会重读配置，会让人误以为配置没生效，白白排查半天。