企业官网建设流程全解析

1. 从源码构建 OpenCode 时，我踩过的第一个坑

OpenCode 是一个典型的 TypeScript/JavaScript 工程，它的 Agent 能力最终要落到「能稳定发起模型调用」这件事上。很多人第一次从源码构建时，卡点不在bun install，而在构建产物和运行入口对不上：dist/里生成了文件，但bun run或node启动时找不到入口，或者入口找到了却因为环境变量、配置文件路径不对，导致 Agent 一调用模型就报 401/404。

这篇就聚焦源码构建场景，把 TypeScript/JavaScript 的构建产物、运行入口、以及 TaoToken 统一 Key 的配置骨架一次讲清楚。适合已经拿到 OpenCode 源码、准备本地跑通 Agent 模型调用的同学。核心检索词：OpenCode 源码构建、TypeScript 构建产物、TaoToken 统一 Key、settings.json、config.toml。

我试过直接bun run dev能跑，但bun run build之后用node dist/index.js启动就挂，原因就是构建产物里对.toml和.json配置的读取路径是相对process.cwd()的，而不是相对产物目录。下面按步骤来。

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

在动构建之前，先把模型通道准备好。TaoToken 的作用是提供一个统一的 Key 和 API 入口，让 OpenCode 这类 Agent 不用为每个模型厂商单独配一套鉴权。官网入口：https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 基址是 https://taotoken.net/api （这个不加 UTM）。

你需要先拿到一个 API Key。登录后进控制台，在 API Keys 页面创建一个新 Key，复制出来。这个 Key 后面会写进 OpenCode 的配置骨架里。注意：Key 只显示一次，丢了就重建。

注意：不要把 Key 硬编码进源码再提交到 Git。建议用环境变量注入，配置文件里只写占位符或读取逻辑。

TaoToken 的 API 通道兼容常见的 OpenAI 风格请求格式，所以 OpenCode 里凡是走baseURL+apiKey的地方，都可以指向它。模型对话调试可以用模型对话页快速验证 Key 是否有效：https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。长期编码或 Agent 场景建议用 Coding Plan：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。

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

OpenCode 的配置分两层：一层是settings.json，管运行时的模型 provider、baseURL、apiKey 引用；另一层是config.toml，管 Agent 行为、工具开关、构建相关参数。下面给的是骨架，字段名以你本地源码版本为准，但结构通用。

先看settings.json：

{ "provider": { "taotoken": { "type": "openai-compatible", "baseURL": "https://taotoken.net/api", "apiKey": "${TAOTOKEN_API_KEY}", "models": { "default": "gpt-4o-mini", "coding": "claude-3-5-sonnet" } } }, "agent": { "defaultProvider": "taotoken", "timeoutMs": 60000, "maxRetries": 2 } }

这里${TAOTOKEN_API_KEY}是环境变量占位，运行时由 shell 注入。如果你用的 OpenCode 版本不支持${}语法，就改成读取process.env.TAOTOKEN_API_KEY的代码路径，或者直接在启动脚本里 export。

再看config.toml：

[build] entry = "src/index.ts" outdir = "dist" target = "node" minify = false sourcemap = true [agent] name = "opencode-agent" provider = "taotoken" model = "gpt-4o-mini" stream = true [tools] shell = true filesystem = true

entry指向 TypeScript 源码入口，outdir是构建产物目录。target = "node"表示产物给 Node 跑；如果你用 Bun 直接跑 TS，可以改成target = "bun"，产物形态会不一样。sourcemap = true方便排错，生产可以关。

环境变量注入示例：

export TAOTOKEN_API_KEY="sk-你的Key"

Windows PowerShell：

$env:TAOTOKEN_API_KEY="sk-你的Key"

4. 构建与验证：确认 Agent 能发起模型调用

配置放好后，先装依赖再构建。OpenCode 源码根目录执行：

bun install bun run build

构建完成后看dist/目录，确认入口文件存在：

ls -la dist/

正常应该能看到index.js和对应的.map。然后启动：

node dist/index.js

如果启动时报Cannot find module './config.toml'，说明产物读取配置的路径不对，把config.toml复制到dist/同级，或者改启动命令的cwd：

cd dist && node index.js

验证模型调用是否通，最直接的方式是发一个最小请求。OpenCode 一般有内置的agent run或chat子命令，用你的版本实际命令替换：

node dist/index.js agent run --prompt "用一句话说明什么是 TypeScript"

如果返回了模型输出，说明 Key、baseURL、provider 三者都对上了。如果报 401，检查TAOTOKEN_API_KEY是否真的注入到了当前 shell；如果报 404，检查baseURL是不是写成了https://taotoken.net/api/多带了斜杠，或者漏了/v1（以你实际通道为准）。

也可以直接用 curl 验证通道本身：

curl -s https://taotoken.net/api/v1/chat/completions \ -H "Authorization: Bearer $TAOTOKEN_API_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"gpt-4o-mini","messages":[{"role":"user","content":"ping"}]}'

curl 通了但 OpenCode 不通，问题就在 OpenCode 的配置读取或构建产物路径上，不在 Key。

5. 本篇常见错排查

错误一：bun run build成功但node dist/index.js报ERR_MODULE_NOT_FOUND。这是 ESM/CJS 混用问题。TypeScript 编译目标如果是ESNext，产物是 ESM，Node 需要package.json里"type": "module"，或者产物后缀改成.mjs。检查tsconfig.json的module字段。

错误二：Agent 启动后调用模型一直超时。先看timeoutMs是不是太小，再看网络是否能到taotoken.net。用上面的 curl 命令测通道，排除是 OpenCode 内部重试逻辑把错误吞了。

错误三：config.toml改了不生效。构建产物可能把配置内联了，或者读取的是dist/config.toml而不是根目录的。确认你改的是运行时实际读取的那份。用strace或加日志打印配置路径最快。

错误四：Key 明明 export 了，程序读不到。如果你用sudo或 systemd 启动，环境变量不会继承当前 shell。写进 service 文件的Environment=或启动脚本里。

错误五：模型名写错导致 400。settings.json里的models.default必须是 TaoToken 通道支持的模型名。不确定就先在模型对话页试一下：https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。

6. 接入文档与 Key 管理入口

构建和验证跑通后，建议把 Key 管理、接入文档、以及长期编码场景的配置固定下来。API Keys 管理页：https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。接入文档：https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。控制台：https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。

如果你用的是 Claude Code 或 Anthropic 风格接入，对应入口：https://taotoken.net/claudecode-anthropic?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。长期跑 Agent 任务、需要稳定额度和并发，走 Coding Plan 更合适：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。

最后补一个实用技巧：把TAOTOKEN_API_KEY写进.env并在启动脚本里source .env，比每次手动 export 稳。.env记得加进.gitignore。构建产物目录dist/也别提交，每次bun run build重新生成即可。这样你的 OpenCode 源码构建流程就是可复现的，换台机器只要装好 Bun、拉代码、配 Key、构建、跑验证命令，五步到位。