1. 服务器 SSH 配置 Git 并接入 TaoToken 的完整实践远程服务器上做开发最怕的就是每次git push都要输密码或者拉代码时卡在鉴权上。我平时用一台 2C4G 的云主机跑定时任务和几个小服务代码托管在 Git 仓库里本地写完推上去服务器再拉下来。这套流程要跑顺核心就两件事SSH 免密打通 Git 仓库以及把模型 API 请求统一收敛到 TaoToken避免在服务器上散落一堆不同厂商的 Key。先说清楚这篇适合谁如果你手上有一台 Linux 服务器Ubuntu、Debian、CentOS 都行想在上面用 Git 管理代码同时希望服务器上的 AI 相关请求走一个统一的入口那这篇就是给你写的。全程只需要终端操作不需要图形界面。我会把每一步的命令、参数含义、以及我实际踩过的坑都写出来你照着敲就能跑通。为什么要在服务器上单独配 Git因为服务器环境和本地不一样。本地你可能已经配好了 SSH key但服务器是另一台机器它有自己的~/.ssh目录和独立的 Git 配置。很多人第一次在服务器上git clone私有仓库时会遇到Permission denied (publickey)本质就是服务器上没有对应的密钥或者密钥没被 agent 加载。另一个常见问题是服务器上跑脚本调用模型接口时Key 写死在代码里换机器就得改一遍维护起来很烦。把 API 请求统一改到 TaoToken 之后只需要维护一个 Base URL 和一个 Key代码里不用再关心底层是哪家模型。这篇的节奏是这样先把服务器上的 Git 身份和 SSH key 配好验证能连上代码仓库然后配置 TaoToken 的接入信息让服务器上的请求走统一入口接着给出可复制的配置片段和验证命令最后把几个高频报错拆开讲。你不需要一次全看完可以边看边在服务器上操作。2. 服务器端 Git 身份与 SSH 密钥的前置配置这一章解决的是「服务器能不能证明它是你」的问题。Git 提交需要知道你是谁SSH 连接需要证明你有权限访问仓库。这两件事都在服务器上独立完成和本地配置互不影响。先配 Git 的全局身份。这里的用户名和邮箱建议和你代码托管平台上的账号保持一致否则提交记录里的作者信息会对不上。git config --global user.name yourName git config --global user.email yourEmail--global表示对当前用户的所有仓库生效。如果你在服务器上有多个用户比如deploy和root那每个用户都要单独配一遍。这一点很关键我后面排错章节会专门讲。接下来生成 SSH 密钥。推荐用 ed25519比默认的 RSA 更短更安全兼容性也够用。ssh-keygen -t ed25519 -C yourEmail执行后会问你保存路径直接回车用默认的~/.ssh/id_ed25519就行。然后会问你要不要设 passphrase服务器上跑自动化任务的话建议留空否则每次拉代码都要输密码脚本没法无人值守。如果你确实需要密码保护那就得配合ssh-agent使用。生成完检查一下文件ls -la ~/.ssh/你应该能看到id_ed25519私钥和id_ed25519.pub公钥。私钥权限必须是 600如果不对就手动改chmod 600 ~/.ssh/id_ed25519 chmod 700 ~/.ssh然后把公钥内容打印出来复制到代码托管平台的 SSH Keys 设置里cat ~/.ssh/id_ed25519.pub复制的时候注意从ssh-ed25519开头一直到最后的邮箱整行都要别漏了结尾。粘贴到平台的 SSH key 添加页面保存即可。如果你用的是 RSA 密钥有些老平台只认 RSA命令换成ssh-keygen -t rsa -b 4096 -C yourEmail对应的私钥文件是~/.ssh/id_rsa后面所有命令里的路径都要跟着改。配完密钥后启动 ssh-agent 并加载私钥。这一步在服务器上经常被忽略尤其是通过某些 CI 或脚本环境登录时agent 可能没自动起来。eval $(ssh-agent -s) ssh-add ~/.ssh/id_ed25519eval $(ssh-agent -s)会启动 agent 并设置环境变量ssh-add把私钥加进去。如果你改了密钥路径这里也要同步改。最后验证 SSH 连接。以 GitHub 为例ssh -T gitgithub.com第一次连接会问你是否信任这个主机输入yes回车。如果看到Hi xxx! Youve successfully authenticated说明 SSH 通道打通了。如果用的是 GitLab 或 Gitee把域名换掉即可比如ssh -T gitgitee.com。这里有个细节ssh -T只是测试认证不会给你 shell 访问权限所以看到successfully authenticated后面跟着一句「but shell access is not provided」是正常的不用管。到这一步服务器已经具备了访问 Git 仓库的身份。但如果你还要在服务器上调用模型 API光有 Git 配置还不够下一章讲怎么把 API 请求统一到 TaoToken。3. 可复制的 TaoToken 接入配置与 Git remote 设置这一章是整篇的核心操作区。我会给出可以直接复制的配置片段包括 Git remote 的切换以及 TaoToken 的接入参数。你按顺序做基本不会出错。先说 Git remote。如果你之前用 HTTPS 方式克隆的仓库remote 地址是https://...格式这种方式每次推送都要输账号密码或 token。改成 SSH 格式后走的就是上一章配好的密钥。查看当前 remotegit remote -v如果输出是https://github.com/xxx/yyy.git改成 SSHgit remote set-url origin gitgithub.com:xxx/yyy.git注意格式是git域名:用户名/仓库名.git冒号不是斜杠。这个细节很多人第一次会写错写成gitgithub.com/xxx/yyy.git就报错。改完后用git ls-remote验证连通性这个命令只读取远端引用不会改动任何东西很适合做连通性测试git ls-remote origin如果能看到一串 commit hash 和分支名说明 SSH 通道和 remote 都正常。如果报Permission denied (publickey)回到上一章检查密钥和 agent。接下来配置 TaoToken 的接入。TaoToken 的 API 入口是https://taotoken.net/api你需要在控制台创建一个 API Key。创建入口在控制台的 API Keys 页面登录后就能看到。拿到 Key 之后服务器上建议用环境变量管理不要硬编码在代码里。在~/.bashrc或~/.profile里加一行export TAOTOKEN_API_KEYsk-你的key然后source ~/.bashrc生效。这样所有当前用户的进程都能读到这个变量。如果你用的是 Python 项目可以在代码里这样读import os from openai import OpenAI client OpenAI( base_urlhttps://taotoken.net/api, api_keyos.environ[TAOTOKEN_API_KEY], ) resp client.chat.completions.create( modelclaude-sonnet-4-5, messages[{role: user, content: 用一句话解释什么是 SSH}], ) print(resp.choices[0].message.content)注意base_url后面不要多加/v1TaoToken 的入口就是https://taotoken.net/apiSDK 会自己拼接路径。这一点和某些平台不一样写错了会报 404。如果你用的是 Node.js 项目配置类似import OpenAI from openai; const client new OpenAI({ baseURL: https://taotoken.net/api, apiKey: process.env.TAOTOKEN_API_KEY, }); const resp await client.chat.completions.create({ model: claude-sonnet-4-5, messages: [{ role: user, content: hello }], }); console.log(resp.choices[0].message.content);对于 Claude Code 这类工具配置方式是通过环境变量指定 Base URL 和 Key。在服务器上编辑~/.claude/settings.json加入{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的key } }如果你用的是 Codex配置文件在~/.codex/auth.json需要写全三件套Base URL、Key、Model ID。{ base_url: https://taotoken.net/api, api_key: sk-你的key, model: claude-sonnet-4-5 }这里强调一下不管用哪种工具接入信息都是三件套Base URL 填https://taotoken.net/apiKey 填你创建的那串Model ID 填你要用的模型名。三个缺一不可少一个就会报鉴权或模型不存在的错。配置完成后建议把 Git 的提交和 API 调用分开验证避免混在一起排查。Git 用git ls-remoteAPI 用一次简单的 curlcurl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d {model:claude-sonnet-4-5,messages:[{role:user,content:ping}]}如果返回里有choices字段说明 API 通道正常。注意 curl 这里路径带了/v1因为这是直接调 HTTP 接口和 SDK 的 base_url 拼接规则不同。SDK 里 base_url 不带/v1curl 里要带这个差异记住就行。4. 验证请求与真实 push 的完整过程配置写完不代表能用必须跑一遍真实流程。这一章我把验证动作拆成两步先验证 Git 推送再验证 API 请求每步都给出预期输出。先做 Git 的完整验证。找一个测试仓库或者用你现有的项目。在服务器上进入仓库目录cd /path/to/your/repo git status确认工作区干净后做一次真实的 push。如果你只是想测试可以创建一个空提交git commit --allow-empty -m test: verify ssh push from server git push origin main预期输出会显示对象计数和写入进度最后一行类似To github.com:xxx/yyy.git abc1234..def5678 main - main看到这个就说明 SSH 推送完全打通了。如果卡在Writing objects很久通常是网络问题不是配置问题。如果报Permission denied回到第 2 章检查密钥。再验证一次拉取git pull origin main预期是Already up to date.或者显示更新的文件列表。拉取走的是同一套 SSH 通道能拉就能推。接下来验证 TaoToken 的 API 请求。用第 3 章的 curl 命令跑一次观察返回。正常返回是一个 JSON结构里包含id、choices、usage等字段。choices[0].message.content就是模型回复的内容。如果你在服务器上跑的是 Python 脚本直接执行脚本看是否打印出模型回复。我实测下来第一次调用可能会有几百毫秒的延迟属于正常范围。如果超过 30 秒没返回检查服务器出网是否正常curl -I https://taotoken.net/api预期返回HTTP/2 200或401未带 Key 时。如果连不上说明服务器网络层有问题和配置无关。还有一个验证技巧把 Git 和 API 的验证分开做不要在一个脚本里混着调。因为 Git 走的是 22 端口SSHAPI 走的是 443 端口HTTPS两者故障原因完全不同。混在一起排查会浪费时间。如果你用的是 Claude Code验证方式是直接在服务器上启动它然后问一个简单问题。启动命令就是claude如果配置正确它会直接回复不会提示你登录或输入 Key。如果提示鉴权失败检查~/.claude/settings.json里的ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY是否都填了。对于 Codex验证方式是运行一次codex命令看它是否能正常对话。如果报OAuth相关错误说明auth.json里的字段没写全重点检查base_url和api_key是否都在。到这里Git 和 API 两条链路都验证完了。下一章把常见的报错集中拆解你遇到问题时可以直接对照。5. 常见报错排查401、local proxy failed、reading choices、OAuth这一章按报错信息来组织你遇到哪条就查哪条。每条我都给出原因和修复动作。401 Unauthorized这是最常见的鉴权失败。可能原因有三个Key 没填、Key 填错、Key 对应的环境变量没生效。先检查环境变量echo $TAOTOKEN_API_KEY如果输出为空说明~/.bashrc没 source或者你改的是别的用户的配置。执行source ~/.bashrc后重试。如果输出有值但调用还是 401检查 Key 是否复制完整有没有多余空格。TaoToken 的 Key 以sk-开头复制时注意别漏字符。还有一种情况你在root用户下配了环境变量但脚本是用www-data用户跑的那自然读不到。解决办法是在对应用户的配置里也加一份或者用 systemd 的Environment指令注入。local proxy failed这个报错通常出现在服务器有代理设置的情况下。检查环境变量env | grep -i proxy如果有http_proxy或https_proxy而代理又不可用就会报这个错。临时取消unset http_proxy https_proxy然后重试。如果确实需要代理才能出网那要确保代理地址正确且服务在运行。注意这里说的是服务器本地的网络代理配置和任何网络工具无关纯粹是环境变量层面的问题。reading choices 相关报错典型信息是Cannot read properties of undefined (reading choices)或 Python 里的KeyError: choices。这说明返回的 JSON 里没有choices字段通常是请求本身失败了返回的是错误信息。排查方法把原始返回打印出来。Python 里resp client.chat.completions.create(...) print(resp)如果返回里是{error: {...}}看 error 的 message。常见的是模型名写错比如把claude-sonnet-4-5写成了别的。检查 Model ID 是否和平台文档一致。另一个原因是base_url写错了。如果你写成了https://taotoken.net/api/v1SDK 再拼一次/v1路径就变成了/api/v1/v1/...自然 404。记住 SDK 的 base_url 不带/v1。OAuth 相关报错Codex 用户容易遇到。报错信息里带OAuth或authentication字样说明~/.codex/auth.json格式不对或字段缺失。检查文件内容cat ~/.codex/auth.json确保三个字段都在base_url、api_key、model。base_url必须是https://taotoken.net/api不要带/v1。api_key是sk-开头的那串。model填你要用的模型 ID。如果文件格式没问题但还是报错检查文件权限确保当前用户可读chmod 600 ~/.codex/auth.jsonPermission denied (publickey)这是 Git 侧的报错不是 API 侧。原因通常是密钥没加载或没添加到平台。检查ssh-add -l如果输出The agent has no identities说明私钥没加载执行ssh-add ~/.ssh/id_ed25519。如果加载了但还是报错检查平台上的公钥是否和服务器上的id_ed25519.pub一致。有时候你本地和服务器各生成了一次密钥复制错了。还有一个容易忽略的点如果你在服务器上用的是sudo git push那走的是 root 用户的 SSH 配置而不是当前用户的。解决办法是别用 sudo或者给 root 也配一套。模型不存在或 model not found检查 Model ID 拼写。不同模型的 ID 不一样比如claude-sonnet-4-5和claude-opus-4-1是两个不同的值。去平台的模型列表页确认一下当前可用的 ID别凭记忆写。排查完这些基本能覆盖 90% 的服务器端配置问题。剩下的 10% 通常是网络层或平台侧临时波动重试一次往往就好了。6. 把服务器端配置沉淀成可复用流程配置跑通之后建议把关键步骤固化成脚本下次换服务器直接执行。我自己的做法是写一个setup.sh把 Git 身份、SSH key 生成、agent 加载、TaoToken 环境变量这几步串起来。注意脚本里不要硬编码 Key而是从参数或已有的环境变量读取。对于多用户服务器每个用户都要独立配置。你可以把公共部分抽出来比如 SSH key 的生成逻辑但 Git 身份和 API Key 必须按用户隔离。这样既安全也避免互相干扰。日常使用中git ls-remote是我最常用的连通性检查命令它比git fetch轻量不会改动本地状态。API 侧我习惯用一次 curl 做健康检查确认通道正常后再跑正式任务。如果你在服务器上跑的是长期任务建议把 TaoToken 的 Key 放在 systemd 的EnvironmentFile里而不是~/.bashrc。因为 systemd 服务不读用户的 shell 配置放在~/.bashrc里服务启动时读不到。具体做法是创建一个/etc/taotoken.env里面写TAOTOKEN_API_KEYsk-xxx然后在 service 文件里加EnvironmentFile/etc/taotoken.env。最后提醒一点服务器上的私钥文件权限一定要收紧~/.ssh目录 700私钥 600。权限不对的话 SSH 会直接拒绝使用这个密钥报错信息还不明显容易排查半天。养成配完就ls -la看一眼的习惯能省很多事。