常见问题与使用教程

AI API 中转站（也叫 API 中转、API 代理平台）把 Claude、GPT、Gemini 等大模型的官方接口统一成一个地址和一把密钥。你不用分别去各家官网注册账号、绑定海外信用卡、处理网络问题，只要在 Claude Code、Codex、Cherry Studio 这类工具里填上中转站的地址和密钥，就能直接调用这些模型。

费用按实际用量结算，用多少扣多少，不用每月固定付订阅费。

一次请求大致经过这几步：

1. 你的工具（例如 Claude Code）把问题发到中转站地址，并带上你的 API 密钥。
2. 中转站校验密钥和余额，按密钥所在的「分组」选择对应的官方模型通道。
3. 请求按官方协议转发给模型，模型生成回答。
4. 回答原样流式返回给你的工具；中转站按这次实际消耗的 Token 数计费，记到「使用记录」里。

所以对你的工具来说，中转站就像官方接口一样：协议相同，只是地址和密钥换成了中转站的。

Trans（trans86.com）是一个独立的第三方 AI API 接入平台，不是 Anthropic、OpenAI 或 Google 的官方服务。Claude、GPT、Gemini 是各自所有者的商标。

Trans 提供统一的 API 地址和密钥，支持 Anthropic 协议和 OpenAI 兼容协议，可以接入 Claude Code、Codex、CC-Switch、Cherry Studio、Kimi Code、ZCode、OpenCode 等工具。

可以直接用官方，但对国内用户通常有几道门槛：

• 官方注册和付款一般需要海外手机号、海外信用卡。
• 官方按美元计费，需要自己处理换汇和充值。
• 部分地区访问官方接口需要额外的网络环境。

中转站把这些都处理好：人民币充值、国内网络直接访问、一把密钥切换多个模型。

调用模型不需要。 Trans 的地址国内可以直接访问，配置好以后请关掉 VPN 和代理再用，否则反而容易连接超时。

只有下载部分海外客户端（例如 Codex、OpenCode 的官方安装包）时，官方下载页可能需要额外的网络环境。Claude Code 和 CC-Switch 本站提供国内可直接下载的安装方式，见首页「简易教程」。

官方订阅是按月付费，在官方网页、App 里用，有使用次数或额度上限；API 是按 Token 计费，给开发工具和程序调用。两者是两套系统。

中转站提供的是 API。好处是不用订阅、用多少付多少，能接入各种第三方工具；需要注意的是 claude.ai 网页版、Claude 手机 App 这类只认官方账号的产品，填不了中转站的地址。

目前已接入 Claude 全系列，包括 Fable 5.1、Opus 5.5、Sonnet 5.5、Haiku 5.5 以及 Opus 5、Sonnet 5、Opus 4.8 等上一代模型。

GPT（OpenAI）、Gemini（Google）、Grok（xAI）、GLM（智谱）、Qwen（通义千问）、DeepSeek 正在陆续接入。每个模型是否可用、价格多少，以首页定价显示为准。

Trans 只记录计费需要的信息：时间、模型、Token 数量和费用，你可以在「使用记录」里看到完整明细。对话内容不会保存在使用记录里。

需要注意的是任何中转服务都要经手你的请求，所以请不要把密码、身份证号、公司机密这类敏感信息直接发给模型；处理代码时也建议先去掉密钥、数据库密码等配置。

Trans 按官方协议把请求转发给对应的官方模型，模型名称和官方一致，计费也按官方价格的 Token 数计算。你可以在「使用记录」里核对每次请求用的模型和 Token 数。

• 想用 Claude Code、Codex 写代码，但没有海外支付方式的开发者。
• 想在 Cherry Studio、Kimi Code、ZCode 等工具里用 Claude 的写作、办公用户。
• 需要在自己的程序、脚本里调用大模型 API 的团队。
• 用量不固定，不想每月付订阅费的人。

1. 打开 Trans 首页，点「Sign up」注册并登录。
2. 在控制台「充值」页面充值余额（先小额试用即可）。
3. 左侧菜单点「API 密钥」→「创建密钥」，分组选 Claude 的分组，复制 sk- 开头的密钥。
4. 把地址 https://trans86.com 和密钥填进你的工具（Claude Code、CC-Switch、Cherry Studio 等），开始对话。

图文版步骤见首页的简易教程，下面「使用教程」一节有每个工具的详细配置。

在首页点「Sign up」，用邮箱注册。注册后登录进入控制台，就能充值和创建密钥。

登录后进入控制台「充值」页面，选择金额并按页面提示付款，到账后余额会立即更新。余额以人民币显示。

充值遇到问题、需要大额充值或开票，可以直接联系客服。

1. 登录后在左侧菜单点「API 密钥」。
2. 点右上角「创建密钥」，名称随便填（例如「我的电脑」）。
3. 选择分组：分组决定这把密钥能用哪些模型、按什么价格计费。用 Claude 就选 Claude 的分组。
4. 点「创建」，再点密钥旁边的复制图标，把 sk- 开头的完整密钥复制下来。

选错分组也没关系，再创建一把新的即可。密钥列表只显示开头和结尾几位，随时点复制图标都能拿到完整密钥。

Trans 的地址是 https://trans86.com。是否加 /v1 看工具使用的协议：

• Anthropic 协议（Claude Code、VS Code / JetBrains 插件、Anthropic SDK、CC-Switch 的 Claude Code 供应商）：填 https://trans86.com，不加 /v1。
• OpenAI 兼容协议（Codex、Cursor、OpenAI SDK、Cherry Studio / Chatbox 的 OpenAI 类型）：填 https://trans86.com/v1。

密钥都是同一把。

• 想写代码：Claude Code + CC-Switch。CC-Switch 能从「API 密钥」页一键导入地址和密钥，不用手动改配置文件。
• 想聊天、写作、办公：Cherry Studio，图形界面，在设置里填入地址和密钥即可，不需要 CC-Switch。
• 国内 IDE 用户：Kimi Code、ZCode，在各自的设置里填入密钥即可。

最直接的办法：发一句「你好」，能收到回复就说明通了。

在 Claude Code 里还可以输入 /status 回车，「Anthropic base URL」一行显示 https://trans86.com 就说明请求走的是 Trans。之后到控制台「使用记录」能看到这次请求的模型和费用。

可以。命令行版 Claude Code 只会用一种身份：如果之前登录过官方账号，先运行 claude，输入 /logout 退出官方登录，再按教程填入 Trans 的地址和密钥。用 CC-Switch 可以在官方和 Trans 之间一键切换。

最省事：一键安装。 Windows 10 / 11 在首页「简易教程」里下载一键安装包，双击运行；macOS 打开「终端」粘贴下面的命令回车，约 1～3 分钟装好：

curl -fsSL https://trans86.com/install/claude-code.sh | bash

Windows 也可以在 PowerShell 里运行：

irm https://trans86.com/install/claude-code.ps1 | iex

用 npm 安装：先装 Node.js 22 或更高版本（Windows 另外装 Git for Windows），然后运行：

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

装完重新打开终端，输入 claude --version 能看到版本号就装好了。

推荐写进配置文件，一次配置永久有效。打开（没有就新建）用户目录下的 .claude/settings.json：Windows 是 %USERPROFILE%\.claude\settings.json，macOS / Linux 是 ~/.claude/settings.json，内容替换为：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://trans86.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的密钥",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

保存后重新打开终端，进入项目文件夹输入 claude，发一句「你好」验证。

只想临时试用，也可以在当前终端设置环境变量（关掉窗口就失效）：

$env:ANTHROPIC_BASE_URL="https://trans86.com"
$env:ANTHROPIC_AUTH_TOKEN="sk-你的密钥"
claude

export ANTHROPIC_BASE_URL="https://trans86.com"
export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"
claude

JSON 格式很严格，引号、逗号不能少，最后一项后面不能有逗号。Windows 上注意文件不要被存成 settings.json.txt。

在 Claude Code 里输入 /model 回车，用方向键选 Opus（最强）、Sonnet（日常推荐）或 Haiku（最快最省），回车切换。也可以启动时指定：claude --model sonnet。

如果选了以后提示 model not found，说明分组里没有这个别名默认对应的版本，可以在 settings.json 里把三个别名指定成分组里有的模型 ID：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://trans86.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的密钥",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5"
  }
}

1. 在扩展面板搜索「Claude Code」，安装发布者为 Anthropic 的插件。插件自带 Claude Code，不用另装命令行版。
2. 按 Ctrl + Shift + P（macOS 为 Command + Shift + P），选择「Preferences: Open User Settings (JSON)」。
3. 在最外层大括号里加入下面的设置，保存。
4. 完全退出并重新打开 VS Code，点 Claude 图标打开对话面板，发「你好」验证。

{
  "claudeCode.disableLoginPrompt": true,
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://trans86.com" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-你的密钥" }
  ]
}

插件启动时只检查这里的设置，所以只改 ~/.claude/settings.json 不够，插件仍可能弹出登录。

JetBrains 插件不自带 Claude Code，它调用的是命令行版。先按上面的方法装好 Claude Code 并写好 settings.json，确认终端里能正常对话；然后在 Settings → Plugins → Marketplace 搜索「Claude Code」安装、重启 IDE，按 Ctrl + Esc（macOS 为 Command + Esc）打开即可，插件会自动使用同一份配置。

提示「Cannot launch Claude Code」时，到 Settings → Tools → Claude Code 里把 Claude command 填成完整路径：Windows 通常是 %APPDATA%\npm\claude.cmd，macOS 在终端运行 which claude 查看。

先安装：npm install -g @openai/codex。运行一次 codex 生成配置目录，看到官方登录提示按 Ctrl + C 退出。然后在用户目录的 .codex 文件夹里写两个文件：

model_provider = "OpenAI"
model = "填你分组里可用的模型 ID"

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://trans86.com/v1"
wire_api = "responses"
requires_openai_auth = true

{
  "OPENAI_API_KEY": "sk-你的密钥"
}

model 要填你的密钥分组里真实存在的模型 ID，否则会报 model not found。重新打开终端运行 codex，不再出现登录提示、能正常回复就成功了。用 CC-Switch 配置 Codex 时，请求地址同样要填带 /v1 的地址。

CC-Switch 是开源免费的桌面小工具，可以一键在多个供应商之间切换 Claude Code、Codex 的配置，不用手动改文件。首页「简易教程」的最后一步提供国内可直接下载的安装包。

1. 安装 CC-Switch 并至少打开一次。
2. 登录 Trans，进入「API 密钥」，在要用的密钥右侧点「导入到 CCS」。
3. 浏览器询问是否打开 CC-Switch 时点「打开」，在 CC-Switch 里确认导入。
4. 在列表里找到 Trans 这一行，点右侧的 ▷ 启用，显示「使用中」后重启终端或客户端即可。

点了没反应时，先确认 CC-Switch 已安装并打开过，再刷新密钥页重试；也可以手动「添加供应商 → 自定义配置」，请求地址填 https://trans86.com（Codex 填 https://trans86.com/v1），API Key 粘贴密钥。

1. 打开设置里的「模型服务 / 模型提供商」，点「添加」。
2. 类型选 Anthropic，API 地址填 https://trans86.com；或者类型选 OpenAI，地址填 https://trans86.com/v1。API 密钥填你的 sk- 密钥。
3. 点「管理模型」获取模型列表，或手动添加分组里的模型 ID（例如 claude-sonnet-5-5），回到对话窗口选中它即可。

Cherry Studio、Kimi Code、ZCode 都不需要 CC-Switch，在各自设置里填入地址和密钥就能用。

可以用于 Chat 对话：在 Cursor Settings → Models 里填入 OpenAI API Key（你的 Trans 密钥），勾选「Override OpenAI Base URL」并填 https://trans86.com/v1，再添加分组里可用的模型 ID。

Cursor 的 Tab 补全和部分 Agent 功能只走 Cursor 自家服务器，不支持第三方地址。想在 Cursor 里完整使用 Claude，推荐安装 Claude Code 插件（配置方法同 VS Code）。

Anthropic SDK（pip install anthropic），注意地址不加 /v1：

import anthropic

client = anthropic.Anthropic(
    api_key="sk-你的密钥",
    base_url="https://trans86.com",  # Anthropic 协议的地址不加 /v1
)

msg = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好，用一句话介绍你自己"}],
)
print(msg.content[0].text)

OpenAI SDK（pip install openai）走 OpenAI 兼容协议，地址加 /v1：

from openai import OpenAI

client = OpenAI(api_key="sk-你的密钥", base_url="https://trans86.com/v1")

resp = client.chat.completions.create(
    model="claude-sonnet-5-5",  # 换成你分组里可用的模型 ID
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

Node.js 用法相同：new Anthropic({ apiKey, baseURL }) 或 new OpenAI({ apiKey, baseURL })。

在 macOS / Linux 终端（或 Windows 的 Git Bash）运行：

curl https://trans86.com/v1/messages \
  -H "x-api-key: sk-你的密钥" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5-5","max_tokens":256,"messages":[{"role":"user","content":"你好"}]}'

返回一段包含 "content" 的 JSON 就说明密钥可用；返回 401 是密钥不对，403 是分组或余额问题。

不能。 这些产品只能登录 Anthropic 官方账号，没有填写自定义地址或 API 密钥的地方；Claude 桌面版的 Code 标签在登录官方账号时也会忽略自定义地址。

想要图形界面，可以用 VS Code / Cursor 的 Claude Code 插件，或者 Cherry Studio。

没有绝对的谁更好，看你用来做什么：

• 写代码、长时间的 Agent 任务：Claude（尤其是 Opus、Sonnet 配合 Claude Code）是很多开发者的首选，擅长读懂大型项目、连续多步修改代码。
• 中文写作、长文档：Claude 的文风自然、结构清晰，长上下文处理稳定。
• 多模态和 OpenAI 生态工具：GPT 系列在 ChatGPT、Codex 等 OpenAI 自家产品里集成度高。

最好的办法是用同一个任务分别试一下。中转站的好处是一把密钥就能切换不同模型，按量付费，试错成本很低。

这是 Claude 每一代的三个档位：

• Opus：旗舰，推理最强，适合复杂架构设计、疑难 Bug、长链路任务，单价最高。
• Sonnet：均衡，速度和能力兼顾，日常写代码、写作的性价比之选。
• Haiku：最快最便宜，适合简单问答、分类、批量处理。

同一代里 Opus 的单价明显高于 Sonnet。建议日常用 Sonnet，遇到难题再切 Opus。

Opus 5.5 是 Anthropic 于 2026 年 9 月发布的旗舰模型，是 Claude 5.5 系列的第一款，模型 ID 为 claude-opus-5-5。

按 Anthropic 公布的信息：Opus 5.5 的官方单价低于上一代 Opus 5，默认设置下常见任务的综合成本可降低约四成；多数任务的表现接近更高端的 Fable 5.1；回答也比 Opus 5 更简洁。它默认开启自适应思考，会根据问题难度自动决定思考多久。

所以对大多数复杂编程、写作和分析任务，Opus 5.5 是目前 Claude 里性价比很高的旗舰选择。本站价格见首页定价。

Fable 5.1 是 Anthropic 面向公众开放的 Mythos 架构模型（Fable 5 的升级版），定位在 Opus 之上，用来应对最艰巨的任务，支持超长上下文，单价也是 Claude 系列里最高的。

怎么选：日常的复杂任务先用 Opus 5.5，成本低很多、效果接近；遇到 Opus 也啃不动的超大型重构、复杂研究、超长文档分析，再换 Fable 5.1。

Sonnet 5.5 适合大部分日常工作：写代码、改 Bug、写文档、翻译、总结，速度快、价格适中，是 Claude Code 里最常用的模型。

Haiku 5.5 适合对速度和成本敏感的场景：客服问答、文本分类、信息提取、大批量处理。Claude Code 也会在后台用 Haiku 做会话标题、上下文压缩等辅助工作。

据公开报道，OpenAI 于 2026 年 9 月底发布 GPT-6.1 Sol，定位是 GPT-6 系列的小版本更新：性能接近更高端的 GPT-6 Astra，价格更低，并已在 Codex 中提供。各家评测数据不尽相同，建议以你自己的实际任务为准。

本站的 GPT 系列正在接入，开放后会在首页定价里显示，届时用同一把密钥（选对应分组）即可调用。

• 日常开发：Sonnet 5.5，又快又省。
• 复杂功能、疑难 Bug、架构设计：Opus 5.5。
• 超大型项目重构、长时间自主任务：Fable 5.1。
• 简单脚本、批量改名、格式转换：Haiku 5.5。

工具推荐用 Claude Code：它能读整个项目、自己运行命令和测试，比在网页里复制粘贴代码高效得多。

一般的文案、邮件、翻译用 Sonnet 5.5 就足够好；长篇小说、深度报告、需要严谨推理的分析可以用 Opus 5.5。图形界面推荐 Cherry Studio，填入密钥就能像聊天软件一样使用。

Token 是模型计费和计算长度的单位，模型把文字切成一个个小片段来处理。英文大约 3～4 个字母一个 Token；中文因模型的分词方式不同，一个汉字大约是 1～2 个 Token。

费用 = 输入 Token（你发过去的内容，包括历史对话和文件）+ 输出 Token（模型的回答）分别按单价计算。输出单价通常是输入的数倍。

上下文窗口是模型一次能「看到」的最大内容长度，包括系统提示、历史对话、你上传的文件和它的回答。窗口越大，能一次处理的代码和文档就越多。

注意：每一轮对话都会把之前的内容一起发给模型，所以对话越长，每次请求的输入 Token 越多、越贵。话题换了就新开对话（Claude Code 里用 /clear）。

思考模式让模型在回答前先进行一段内部推理，适合数学、复杂编程、多步骤分析这类难题，答案更可靠，但会多消耗一些输出 Token、响应也更慢。

Opus 5.5 默认开启自适应思考，会根据问题难度自动决定思考的深度，简单问题几乎不思考，难题会想得更久。

常用的 Claude 模型 ID：claude-fable-5-1、claude-opus-5-5、claude-sonnet-5-5、claude-haiku-5-5。具体能用哪些，以你的密钥分组为准；填了分组里没有的 ID 会报 model not found。

大模型生成文字时带有一定随机性，这是正常的。想要更稳定的结果：把要求写得更具体（格式、字数、语气），给出示例，或者在代码调用时调低 temperature 参数。

每个模型都有「知识截止时间」，之后发生的事它不知道，除非你的工具提供了联网搜索，或你把资料直接发给它。问最新的价格、政策、新闻时，最好附上资料让它分析，而不是让它凭记忆回答。

按量计费：每次请求按官方价格计算这次消耗的 Token 费用，再按本站的比例从你的人民币余额里扣除。不用就不花钱，没有月费。

当前比例（官方消耗 1 美元，本站收多少元）显示在首页定价。每次请求的模型、Token 数和费用都能在「使用记录」里查到。

在 Trans 不需要订阅 Claude Pro / Max，充值余额、创建密钥，就能在 Claude Code 等工具里调用 Claude 全系列模型，按实际用量付费。

官方的 Claude Pro / Max 订阅只能在官方网页、App 和官方账号登录的工具里使用，付款一般需要海外支付方式。如果你主要是在 Claude Code 里写代码，或者在第三方工具里使用，用 API 按量付费通常更灵活。

控制台开放订阅套餐时，可以在「订阅」相关页面按月购买，额度按官方价格计算，具体以页面显示为准。

官方的 Codex 包含在 ChatGPT 的付费订阅里，需要 OpenAI 账号和对应的付款方式。

通过 Trans，Codex 命令行可以用 API 方式接入：按上面「Codex 怎么接入中转站」配置地址和密钥即可，按用量付费，不用订阅 ChatGPT。可用的模型以你的密钥分组为准。

Claude Code 每一轮都会把完整的对话历史、读到的代码文件和命令输出一起发给模型，输入 Token 远多于普通聊天；长时间连续工作时消耗会明显更快。

建议先小额充值，在「使用记录」里看看一天大概花多少，再决定充值金额。

• 日常用 Sonnet，难题再切 Opus，简单任务用 Haiku。
• 换话题就开新对话（Claude Code 里 /clear），对话太长时用 /compact 压缩上下文。
• 只让模型读需要的文件，别一次把整个项目或超大日志丢给它。
• 把要求一次说清楚，减少来回返工。
• 大额长期使用可以联系客服咨询优惠。

这是提示词缓存（Prompt Caching）。Claude Code 等工具会把反复发送的长内容（系统提示、项目文件、历史对话）缓存起来，后续请求命中缓存的部分按更低的单价计费，能明显降低长对话的成本。所以在使用记录里看到缓存相关的 Token 是正常的，而且是在帮你省钱。

这是正常的。Claude Code 会在后台用更便宜的小模型（例如 Haiku）生成会话标题、压缩上下文、判断命令等，费用很低。在配置里加上 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 可以关掉其中不必要的部分。

登录后点左侧「使用记录」，能按密钥、按日期看每次请求的模型、Token 数和费用；控制台首页有余额和今日消耗。不想登录，也可以用「密钥用量查询」页面，粘贴密钥查询这把密钥的消耗。

余额以人民币显示和扣费。使用记录里同时会显示按官方价格计算的美元消耗，方便你和官方价格对比。

可以，请联系客服，提供充值记录和开票信息。

Claude 模型本身输出的是文字和代码，并不会像视频生成模型那样直接「画」出视频。它能做视频，靠的是写代码来生成视频：

• 用 HTML / CSS / Canvas 写动画，或者用 Remotion（用 React 写视频的框架）把每一帧画出来，再渲染成 MP4。
• 用 Manim 做数学、科普类动画，用 FFmpeg 剪辑、拼接、加字幕和背景音乐。
• 在 Claude Code 里，它可以自己安装这些工具、写脚本、运行渲染、检查截图，发现问题再修改，直到成片。

Opus 5.5 这类旗舰模型规划能力强、能连续执行很多步骤，所以能从一句需求开始，把文案、分镜、动画代码和渲染一路做完。适合做产品宣传片、数据可视化动画、文字动效、讲解视频；不适合生成真人实拍效果的画面。

1. 按本页教程装好 Claude Code 并接入 Trans，电脑上安装 Node.js 和 FFmpeg（不会装可以直接让 Claude 教你或帮你装）。
2. 新建一个空文件夹，在里面运行 claude。
3. 把需求说清楚：时长（例如 15 秒）、画面比例（抖音 / 小红书用 9:16）、风格、每个镜头的文案、品牌颜色和 Logo、是否要背景音乐。
4. 让它「用 Remotion 做这个视频，并渲染成 MP4」，它会搭好项目、写动画、执行渲染。
5. 打开生成的视频看效果，把要改的地方告诉它（例如「第二个镜头字太小」「节奏再快一点」），反复几轮直到满意。

配音可以用你自己录好的音频，或其他配音工具生成后交给它合成进视频。复杂视频建议用 Opus 5.5，简单的文字动效用 Sonnet 5.5 更省钱。

Claude 不能直接生成照片类图片。但它可以写 SVG 矢量图、用 HTML / CSS 做海报、图标、信息图、图表，再导出成图片；也能写代码调用绘图库生成数据图表。

反过来，Claude 很擅长看图：可以识别截图里的文字、分析图表、根据设计稿写网页、找出界面上的问题。

可以。在 Claude Code 里让它「把这份资料做成 10 页 PPT」，它会写代码生成 .pptx 文件，或者做成网页版幻灯片。你可以指定页数、配色、每页要点，生成后再让它逐页调整。

能。在 Claude Code 里把文件放进项目文件夹，告诉它文件名即可；在 Cherry Studio 等客户端里可以直接上传。它可以总结长文档、提取表格数据、对比合同条款、分析 Excel 里的数据并画图。

可以。在 Claude Code 里用中文描述你想要的网站或工具（页面有哪些部分、按钮做什么），它会写好全部代码并告诉你怎么在本机打开预览，不满意就继续描述修改。个人主页、活动落地页、记账表、批量改文件名的小脚本，都是很常见的用法。

Agent 是能自己规划步骤、调用工具、根据结果继续行动的 AI。普通聊天是「你问一句它答一句」；Agent 是你给目标，它自己读文件、运行命令、查资料、修改结果，直到完成。Claude Code、Codex 就是面向编程的 Agent。

MCP（Model Context Protocol，模型上下文协议）是一种让 AI 连接外部工具和数据的开放标准。给 Claude Code 装上 MCP 服务后，它就能操作浏览器、读写数据库、访问你的文档库等。通过 Trans 使用 Claude Code 时，MCP 功能照常可用。

• 读懂整个项目，解释代码、画出结构。
• 写新功能、修 Bug、写测试并自己运行验证。
• 重构代码、升级依赖、批量修改文件。
• 写文档、写提交说明、审查代码改动。
• 处理数据、生成报表、做视频和 PPT 等非编程任务。

密钥不对或者没带上。检查：① 密钥是否完整复制（sk- 开头，前后没有空格）；② 配置文件里的引号、逗号是否完整；③ 改的是不是正确的文件（Claude Code 读的是 ~/.claude/settings.json）。改完重新打开终端再试。

两种情况：账户余额不足，或者这把密钥的分组没有你请求的模型。登录控制台看余额，再到「API 密钥」页看密钥的分组；余额不够先充值，分组不对就新建一把对应分组的密钥。

请求太快或并发太多。稍等几十秒再试；脚本批量调用时加上重试和间隔。频繁出现可以联系客服。

填的模型 ID 不在这把密钥的分组里。核对模型 ID 的大小写和横线（例如 claude-sonnet-5-5），或者换一把对应分组的密钥。Claude Code 里可以按上面「切换模型」一节指定别名对应的模型 ID。

这是上游模型暂时繁忙，通常几秒到几分钟就会恢复。稍后重试即可，Claude Code 会自动重试。

使用 Trans 不需要 VPN 或代理。先关掉 VPN、代理软件和系统代理，重新打开终端再试；如果终端里设置过 HTTP_PROXY / HTTPS_PROXY 环境变量，也要清掉。

单次请求生成时间过长时，网络链路可能中断。直接让工具重试或继续即可；把大任务拆成几个小步骤，也能减少这种情况。

命令行版：确认 ~/.claude/settings.json 里填了 ANTHROPIC_AUTH_TOKEN，并且没有同时登录着官方账号（运行 claude 后输入 /logout）。VS Code 插件：密钥要填在 VS Code 自己的用户设置里，见上面插件一节。改完重启终端或编辑器。

多半是装完 Node.js 后没有重新打开终端。关掉所有终端窗口再开一个新的；还不行就重新运行 Node.js 安装包选「修复」，然后重启电脑。

这是 PowerShell 的执行策略限制。在 PowerShell 里运行 Set-ExecutionPolicy -Scope CurrentUser RemoteSigned，输入 Y 回车，然后重新打开终端。

没有安装 Git for Windows。安装时保持默认选项，装好后关掉终端重新打开，再运行 claude。

可以换成国内镜像：运行 npm config set registry https://registry.npmmirror.com，再执行安装命令。也可以直接用首页「简易教程」里的一键安装方式。

多半是文件实际叫 settings.json.txt，因为 Windows 默认隐藏扩展名。在资源管理器顶部「查看」里勾选「文件扩展名」，把多出来的 .txt 删掉。

按 Win + R 输入 intl.cpl 回车 →「管理」→「更改系统区域设置」→ 勾选「Beta 版：使用 Unicode UTF-8 提供全球语言支持」→ 确定并重启电脑。

这是桌面版的设计：登录官方账号时，Code 标签会忽略自定义地址。桌面版目前用不了 Trans，请在终端、VS Code 或 JetBrains 里使用 Claude Code。

立刻到「API 密钥」页面删除这把密钥（删除后立即失效），再创建一把新的换到各个工具里。然后到「使用记录」检查有没有异常消耗，有疑问联系客服。

进入「API 密钥」：点「创建密钥」生成新的，再点旧密钥右侧的删除图标。删除后旧密钥立刻失效，记得把工具里的密钥换成新的。

可以。不过建议每台设备、每个项目各建一把密钥并起好名字，这样在使用记录里能分清是哪里花的钱，某一把泄露时也只需要删掉那一把。

为了账户安全，控制台闲置 30 分钟会自动退出，每次登录最长保持 24 小时。这只影响网页控制台的登录，不影响 API 密钥，你的 Claude Code 等工具照常可用。

不会。客服不会主动索要完整密钥或登录密码。排查问题时，提供密钥的前 8 位和报错截图就够了。

充值、开票、接入问题都可以找我们，通常几分钟内回复。建议附上报错截图和你用的工具名称（例如 Claude Code / Cherry Studio）。

• 微信：66476118 或 TransAIAPI
• QQ：66476118
• 邮箱：ljceng@icloud.com