企业官网建设流程全解析

1. 为什么我决定用 AI Agent 部署 WordPress

先说结论：如果你有一个网站想法，但不想花两天时间啃 Linux 命令、配 PHP 环境、调 MySQL 权限，那 AI Agent 自动部署是目前最省事的路径。我自己试过从零手动装 WordPress，光是 Nginx 和 PHP-FPM 的 socket 权限就折腾了一个下午。后来换成让 Agent 通过 SSH 执行命令，整个过程压缩到十几分钟。

这篇要解决的核心问题其实不是「怎么装 WordPress」——网上教程一抓一大把。真正的卡点在于：AI Agent 需要一个稳定、统一的大模型 API 通道。你不可能给每个工具单独配一套 Key，那样管理成本太高，而且切换模型时到处改配置。所以本文的重点是：用 TaoToken 作为统一 Key/API 通道，把 Trae（或其他支持 Agent 模式的 IDE）接进来，然后让 Agent 自动完成 WordPress 的全套部署。

适合谁看：想快速搭 MVP 验证想法的创业者、想学部署但不想被环境配置劝退的学生、需要临时站点做活动页的运营同学。只要你会在浏览器里复制粘贴，就能跟着做完。

整篇会交付三样东西：可复制的settings.json和config.toml骨架、TaoToken 统一 Key 的配置步骤、以及部署后验证站点可访问性的具体动作。下面按顺序来。

2. TaoToken 前置：统一 Key 与 API 通道配置

2.1 为什么需要统一 Key

AI Agent 在执行部署任务时，会频繁调用大模型来「思考下一步做什么」。比如它要判断当前系统是 Ubuntu 还是 CentOS、要决定用 apt 还是 yum、要分析报错日志。这些调用如果每次都走不同的 API 端点、用不同的 Key，配置会非常散。

TaoToken 的作用就是提供一个统一的 API 入口。你只需要在 TaoToken 控制台创建一个 Key，然后在各个 AI 工具里填同一个地址和 Key，就能调用多种模型。切换模型时只改一个模型 ID，不用动其他配置。

2.2 获取 API Key

访问 TaoToken 控制台（https://taotoken.net/console），登录后进入 API Keys 页面，点击创建。建议给这个 Key 起个能识别的名字，比如wp-deploy-agent，方便后续排查是哪个工具在调用。

创建完成后立即复制 Key，页面刷新后就看不到了。这个 Key 的格式通常是一串以sk-开头的字符串。

注意：不要把 Key 直接写进会提交到 Git 的配置文件里。本地测试可以用环境变量，或者放在.gitignore覆盖的目录中。

2.3 API 地址说明

TaoToken 的 API 基础地址是https://taotoken.net/api。注意这个地址不带任何查询参数，是干净的端点。在配置模型时，通常需要补全到/v1/chat/completions这样的路径，具体取决于你用的工具要求。

如果你用的是 Claude Code 这类工具，它有自己的 Anthropic 兼容端点，配置方式略有不同，可以参考接入文档（https://taotoken.net/doc）里的说明。

3. 可复制配置：settings.json 与 config.toml 骨架

3.1 Trae / VS Code 系工具的 settings.json

Trae 和很多 VS Code 衍生工具都支持通过settings.json配置自定义模型。下面是一个骨架，你需要把YOUR_TAOTOKEN_KEY替换成实际 Key：

{ "ai.providers": { "taotoken": { "baseUrl": "https://taotoken.net/api/v1", "apiKey": "YOUR_TAOTOKEN_KEY", "models": [ { "id": "claude-sonnet-4-20250514", "name": "Claude Sonnet 4", "maxTokens": 8192 }, { "id": "deepseek-v3", "name": "DeepSeek V3", "maxTokens": 8192 } ] } }, "ai.defaultProvider": "taotoken", "ai.defaultModel": "claude-sonnet-4-20250514" }

这个配置的意思是：定义一个叫taotoken的 provider，基础地址指向 TaoToken 的 API，下面挂两个模型。默认用 Claude Sonnet 4，需要切换时改defaultModel即可。

3.2 Claude Code 的 config.toml

如果你用的是 Claude Code（Anthropic 的命令行工具），它读取的是~/.claude/config.toml或项目根目录的配置文件。骨架如下：

[api] provider = "anthropic" base_url = "https://taotoken.net/api" api_key = "YOUR_TAOTOKEN_KEY" [model] name = "claude-sonnet-4-20250514" max_tokens = 8192 temperature = 0.3 [agent] auto_approve_readonly = true confirm_dangerous = true

temperature设成 0.3 是因为部署任务需要确定性，不需要模型发挥创意。confirm_dangerous = true保证高危命令（比如rm -rf）会二次确认，避免 Agent 误操作。

3.3 环境变量方式（推荐）

如果你不想把 Key 写进文件，可以用环境变量。在~/.bashrc或~/.zshrc里加：

export TAOTOKEN_API_KEY="sk-你的实际key" export TAOTOKEN_BASE_URL="https://taotoken.net/api"

然后在settings.json里用${env:TAOTOKEN_API_KEY}引用。这样即使配置文件被分享出去，Key 也不会泄露。

4. 验证请求：确认 API 通道连通

配置写完后，别急着让 Agent 去部署。先发一条测试请求，确认通道是通的。这一步能帮你排除 90% 的「Agent 不响应」问题。

4.1 用 curl 测试

打开终端，执行：

curl -X POST https://taotoken.net/api/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $TAOTOKEN_API_KEY" \ -d '{ "model": "claude-sonnet-4-20250514", "messages": [{"role": "user", "content": "回复 OK 两个字母"}], "max_tokens": 10 }'

如果返回的 JSON 里有"content": "OK"或类似内容，说明通道正常。如果返回 401，检查 Key 是否复制完整；返回 404，检查 base URL 是否多了或少了/v1。

4.2 在 Trae 里测试

回到 Trae，打开 Agent 对话框，输入「你好，请回复当前可用的模型名称」。如果 Agent 能正常回复，说明 IDE 侧的配置也生效了。

4.3 让 Agent 执行一条只读命令

在正式部署前，先让 Agent 做一件无害的事，比如：

请通过 SSH 连接到我的服务器，执行 uname -a 和 df -h，把结果告诉我。

这一步验证的是 Agent 的 SSH 执行能力。如果它能正确返回服务器信息，说明「自然语言 → 模型分析 → SSH 执行 → 返回结果」这条链路是通的。我踩过的坑是：SSH 密钥没配好，Agent 一直卡在密码输入环节。建议提前把公钥传到服务器，或者用sshpass配合密码（仅测试环境）。

5. 本篇常见错排查

5.1 Agent 报「模型不可用」或一直转圈

最常见的原因是 base URL 写错了。TaoToken 的地址是https://taotoken.net/api，有些工具需要你在后面补/v1，有些不需要。先看工具的文档要求，再用 curl 确认哪个路径能通。

另一个原因是模型 ID 写错。比如你写claude-4，但实际可用的 ID 是claude-sonnet-4-20250514。去 TaoToken 的模型列表页确认准确的 ID。

5.2 SSH 连接失败

如果 Agent 提示Permission denied或Connection refused，按顺序检查：服务器安全组是否放行了 22 端口、IP 是否写对、用户名是否正确（Ubuntu 系统默认是ubuntu，不是root）。如果是密码登录，确认密码里没有特殊字符被 shell 转义。

5.3 WordPress 装完了但访问显示 502

这通常是 PHP-FPM 没起来，或者 Nginx 的fastcgi_pass指向了错误的 socket。让 Agent 执行：

sudo systemctl status php*-fpm sudo nginx -t

根据输出让 Agent 修复。常见修复动作是重启 PHP-FPM：sudo systemctl restart php8.1-fpm（版本号按实际来）。

5.4 数据库连接错误

WordPress 报「Error establishing a database connection」时，检查wp-config.php里的DB_NAME、DB_USER、DB_PASSWORD是否和 MySQL 里创建的一致。让 Agent 执行：

mysql -u root -p -e "SHOW DATABASES;"

确认数据库存在。如果不存在，让 Agent 重新创建。

5.5 Agent 执行到一半停了

有时候 Agent 会因为 token 消耗达到上限而中断。去 TaoToken 控制台看用量，如果接近限额，充值或换一个额度更高的 Key。另外，把max_tokens设得太小也会导致回复被截断，建议至少 4096。

6. 部署完成后的验证与后续

6.1 验证站点可访问

部署完成后，Agent 通常会返回访问地址。你在浏览器打开http://你的服务器IP，应该能看到 WordPress 的默认首页或你指定的主题页面。后台地址是http://你的服务器IP/wp-admin，用 Agent 提供的账号密码登录。

如果页面能打开但样式错乱，检查 Nginx 的root指令是否指向了 WordPress 目录（通常是/var/www/html或/data/wordpress）。

6.2 绑定域名（可选）

在域名 DNS 解析里加一条 A 记录，指向服务器 IP。然后在 Nginx 配置里把server_name改成你的域名，重启 Nginx。SSL 证书可以用 Let's Encrypt 的certbot自动申请，让 Agent 执行：

sudo certbot --nginx -d yourdomain.com

6.3 长期编码与 Agent 任务

如果你打算长期用 Agent 做开发任务（不只是部署），建议配置 Coding Plan。它针对代码场景做了优化，调用更稳定。具体可以在 TaoToken 的 coding-plan 页面查看。

6.4 安全建议

部署完成后，至少做三件事：改掉 WordPress 后台的默认管理员密码、安装一个安全插件（比如 Wordfence）、关闭服务器上不必要的端口。Agent 部署虽然快，但安全配置不能省。

如果你在配置过程中遇到 API 通道的问题，优先检查 API Keys 页面里的 Key 状态和用量。接入文档里有各工具的详细配置示例，对照着改通常能解决大部分问题。模型对话功能可以用来快速测试某个模型是否可用，不用每次都写 curl 命令。