企业官网建设流程全解析

1. Ubuntu 上跑 Claude Code 到底卡在哪：Node.js、git、npm 环境一次配好

很多人第一次在 Ubuntu 上装 Claude Code，卡住的地方往往不是 Claude Code 本身，而是它依赖的那套 Node.js 工具链。Claude Code 是一个终端原生的 AI 编程助手，通过 npm 全局安装，运行时要调用 Node.js 运行时、要能读写 git 仓库、还要能发起 HTTPS 请求。这四件事里任何一环没配好，你看到的就不是「欢迎使用」，而是一串让人头大的报错。

这篇教程面向 Ubuntu 新手，从零把 Node.js、npm、git 三个基础环境确认到位，再装 Claude Code CLI，最后把 API 请求改到 TaoToken 统一通道，确保你装完能真的发起一次对话请求。整个过程我会给出可以直接复制的命令、环境变量配置片段，以及每一步的验证动作。你不需要提前懂 Node.js，只要会开终端、会复制粘贴就行。

先说清楚这套环境适合谁：如果你在 Ubuntu 上做后端开发、写脚本、维护项目，或者只是想让 AI 帮你读代码库、定位 Bug、跑 git 流程，那 Claude Code 的终端形态会比网页版顺手很多。它直接在你当前目录里工作，能跨文件理解项目结构，不用来回切窗口。而 Ubuntu 作为 Linux 发行版，对这类终端工具的兼容性天然就好，装起来轻量、启动快。

我实测下来，整个流程最容易被忽略的是三件事：Node.js 版本太旧导致 npm 装包失败、全局安装后命令找不到（PATH 问题）、以及权限报错。下面按顺序一个个解决。

2. 装 Claude Code 前先把 Node.js、npm、git 版本确认清楚

Claude Code 通过 npm 分发，所以第一步不是急着装它，而是确认你的 Node.js 和 npm 版本够不够新。版本太旧会出现各种奇怪的依赖报错，与其装完再回头排查，不如一开始就对齐。

先更新系统包索引，这一步能避免后面 apt 装东西时找不到源：

sudo apt update && sudo apt upgrade -y

然后检查当前 Node.js 和 npm 版本：

node -v npm -v git --version

如果node -v输出的是 v18 以下，或者直接提示 command not found，那就需要装一个新版本。Ubuntu 自带的 apt 源里 Node.js 版本通常偏旧，推荐用 NodeSource 的源装 22.x：

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

装完再验证一次：

node -v npm -v

正常应该看到类似v22.x.x和10.x.x的输出。npm 是随 Node.js 一起装的，不用单独装。

接下来装 git。Claude Code 很多能力依赖 git，比如读取仓库状态、生成提交信息、对比改动，所以 git 必须就位：

sudo apt install -y git git --version

看到git version 2.x.x就说明好了。如果你之前已经装过，这一步会提示已是最新，直接跳过即可。

这里有个新手常踩的坑：用sudo npm install -g装全局包时，如果 Node.js 是通过 apt 装的，全局目录权限可能归 root，普通用户写入会报 EACCES。解决办法有两个，一是全局安装时加 sudo，二是把 npm 的全局目录改到用户目录下。我更推荐后者，避免以后每次装全局包都要 sudo：

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

这段做完，npm install -g就会装到你的用户目录，PATH 也自动带上，不会再出现「装完了但命令找不到」的情况。

3. 安装 Claude Code CLI 并配置 settings.json 指向 TaoToken

环境确认完，就可以装 Claude Code 本体了：

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

装完验证命令是否存在：

claude --version

如果提示 command not found，八成是 PATH 没生效，回到上一节检查~/.npm-global/bin有没有加进 PATH，或者重新source ~/.bashrc。

接下来是核心步骤：配置 Claude Code 的 API 请求地址和密钥。Claude Code 默认会去请求官方端点，我们要把它改到 TaoToken 统一通道，这样密钥和模型都在一个地方管理。配置文件放在~/.claude/settings.json，先建目录：

mkdir -p ~/.claude nano ~/.claude/settings.json

把下面这段 JSON 粘进去，注意把sk-xxx换成你在 TaoToken 控制台拿到的真实 Key：

{ "env": { "ANTHROPIC_AUTH_TOKEN": "sk-xxx", "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "API_TIMEOUT_MS": "3000000", "ANTHROPIC_MODEL": "claude-haiku-4-5-20251001" } }

这里四个字段各有作用，别漏：

保存退出后，可以顺手确认文件内容没写错：

cat ~/.claude/settings.json

如果你用的是 zsh 而不是 bash，PATH 那行要写进~/.zshrc，其余配置一样。Key 的获取入口在 TaoToken 控制台的 API Keys 页面，模型 ID 可以在模型对话页面确认当前可用的型号，接入细节看接入文档。

注意：ANTHROPIC_BASE_URL 一定要写成https://taotoken.net/api，不要多加路径或斜杠，否则请求会 404。

4. 验证请求：在 Ubuntu 终端发起第一次 Claude Code 对话

配置写完，最关键的一步是验证它真的能跑通。别急着开大项目，先在一个空目录里做一次最小对话请求。

新建一个测试目录并进入：

mkdir -p ~/claude-test && cd ~/claude-test

然后启动 Claude Code：

claude

第一次启动它会做一些初始化，可能会问你是否信任当前目录，按提示确认即可。进入交互界面后，直接输入一句简单的话，比如：

你好，帮我确认一下当前环境是否正常

如果配置正确，你会看到模型正常返回内容，说明请求已经通过 TaoToken 通道发出并拿到响应。这一步成功，就代表 Node.js、npm、git、Claude Code、API 通道整条链路都通了。

你也可以用非交互方式快速验证一次，适合写脚本或排查：

claude -p "用一句话说明当前目录里有什么"

-p是 print 模式，直接把结果打到终端，不进入交互界面。如果这条命令能返回内容，说明配置完全没问题。

再补一个 git 相关的验证，确认 Claude Code 能感知仓库状态。在测试目录里初始化一个 git 仓库：

git init echo "hello" > test.txt git add test.txt git commit -m "init"

然后回到 Claude Code 里问它「当前仓库有哪些改动」，它能读到 git 状态就说明 git 集成正常。这一步对后面用它做代码审查、生成提交信息很关键。

实测下来，只要第一次对话能返回，后面基本不会再有环境层面的问题。真正需要花时间的是怎么把它用进你的日常开发流程，比如让它读整个项目、跨文件重构、跑自动化 git 操作。

5. 常见报错排查：401、local proxy failed、reading choices、OAuth

装的过程中遇到报错很正常，下面按真实会碰到的几类逐个拆。

401 未授权：最常见的原因是 Key 填错或过期。先确认~/.claude/settings.json里的ANTHROPIC_AUTH_TOKEN是不是完整的sk-开头字符串，有没有多余空格或换行。然后去 TaoToken 控制台的 API Keys 页面核对这个 Key 是否还有效、额度是否够。改完配置后要重启 Claude Code 才生效。

local proxy failed / 连接失败：这类报错通常是ANTHROPIC_BASE_URL写错了。检查是不是写成了https://taotoken.net/api/（多了斜杠），或者写成了别的路径。正确写法就是https://taotoken.net/api。另外确认你的网络能正常访问这个地址，可以用 curl 测一下：

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

能返回 HTTP 状态码就说明网络通。

reading choices / 响应解析失败：这个报错一般是模型 ID 填错了，或者该模型当前不可用。回到settings.json检查ANTHROPIC_MODEL字段，去 TaoToken 的模型对话页面确认这个模型 ID 是否在可用列表里。模型 ID 要一字不差，大小写和日期后缀都不能错。

OAuth 相关报错：如果你之前登录过官方账号，本地可能残留了旧的凭证，和新的 Token 配置冲突。可以清理一下 Claude Code 的缓存目录再重试：

rm -rf ~/.claude/cache

然后重新启动claude。如果还报 OAuth 错误，检查环境变量里有没有残留的ANTHROPIC_API_KEY，有的话先 unset 掉：

unset ANTHROPIC_API_KEY

命令找不到（command not found）：回到第 2 节的 PATH 配置，确认~/.npm-global/bin在 PATH 里，用echo $PATH看一眼。改完.bashrc记得source一下，或者重开终端。

权限报错 EACCES：如果你没改 npm 全局目录，用 sudo 装全局包又遇到权限问题，最省事的做法还是按第 2 节把 prefix 改到用户目录，一劳永逸。

排查时有个通用思路：先确认命令本身能跑（claude --version），再确认配置能读（cat ~/.claude/settings.json），最后确认网络能通（curl 测地址）。三层都过，问题基本就定位到了。

6. 把 Claude Code 用进日常：从一次对话到长期编码

环境配好只是起点，真正提升效率的是把它用进日常流程。如果你只是偶尔问几句，用模型对话页面就够了；但如果你打算长期在 Ubuntu 上用它做编码、重构、Agent 类任务，建议了解一下 Coding Plan，它在长上下文和连续任务上更划算。

日常使用上，我习惯在项目根目录直接启动claude，让它先读一遍代码库结构，再让它做具体的事，比如「找出这个模块里所有未处理的异常」「把这三个文件的重复逻辑抽成一个工具函数」。因为它能跨文件理解，这类任务比手动翻文件快很多。

git 流程也能交给它：改完代码让它生成提交信息、对比改动、甚至帮你写 PR 描述。前提是 git 环境配好了，也就是第 2 节那步。

最后提醒一句，配置文件和 Key 属于敏感信息，别提交到 git 仓库里。~/.claude/settings.json在用户目录下，正常不会被项目仓库跟踪，但如果你手动复制到项目里，记得加进.gitignore。

整套流程走下来，从 apt 更新到第一次对话返回，顺利的话十几分钟能搞定。卡住的地方基本都在版本、PATH、配置格式这三处，对照第 5 节排查就行。装完之后，你就可以在 Ubuntu 终端里随时唤起 Claude Code，让它帮你读代码、改 Bug、跑 git，把重复劳动交出去。