一个为所有人的API使用指南
返回官网 ↗
使用指南工具接入教程

Claude Code

这里讲的是 Claude Code,不是 Claude 网页聊天。用平台的 Messages 接口配置本机 CLI;想用图形界面可走 CC Switch。

开始前,把三样信息放在手边

已经装好工具即可继续。打开官网「自助服务」,登录后创建或查看自己的 API 密钥,并复制页面提供的 API 地址;从「模型与价格」复制完整模型 ID。别把官网首页、登录密码或模型的宣传名称填进去。确认账户和密钥都有可用额度。

下面的 API_HOST、YOUR_API_KEY、YOUR_MODEL_ID 都是占位文字,使用前逐个换成你的实际信息。地址里 /v1 是否保留,要看本篇要求;不要追加 /chat/completions 或 /responses。示例不会自动连接,也不会自动带入你的密钥。

1. 先确认模型和协议

先确认平台当前为目标 Claude 模型提供 Anthropic Messages。OpenAI 的 Chat Completions 或 Responses 地址不能直接填给 Claude Code;也不要因为某个模型能聊天就认定能接入它。

2. 打开个人设置文件

macOS / Linux 打开 ~/.claude/settings.json,Windows 打开 %USERPROFILE%\.claude\settings.json。把示例的 env 项合并进现有文件;保留成对的引号、逗号和括号。不要把个人密钥写入与别人共享的项目设置。

3. 填地址、密钥和模型

ANTHROPIC_BASE_URL 填平台提供的 Messages 根地址。若平台提供的是 https://API_HOST/v1,则本篇根地址是 https://API_HOST;有额外路径时按平台说明保留。客户端会追加 /v1/messages。ANTHROPIC_AUTH_TOKEN 填本人平台密钥,ANTHROPIC_MODEL 填支持 Messages 的完整模型 ID。

字段示意 · 非软件截图
ANTHROPIC_BASE_URL
https://API_HOST
ANTHROPIC_AUTH_TOKEN
YOUR_API_KEY
ANTHROPIC_MODEL
YOUR_MODEL_ID
API format
Anthropic Messages
配置示例

修改配置前先保留原文件。已有同名项目时修改对应值,不要再重复添加一份;保留其他设置。配置中若有真实密钥,不要分享文件或截图。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://API_HOST",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_MODEL": "YOUR_MODEL_ID"
  }
}

4. 启动并检查实际配置

在测试文件夹的终端运行 claude,输入 /status 查看当前地址和凭证来源;再用 /model 确认模型。若仍显示旧订阅或旧服务,核对个人设置、终端变量及 CC Switch 当前配置,别反复覆盖整个文件。

5. 选择思考强度

支持调节的 Claude 模型可在 /model 中查看并选择努力程度;也可按官方说明使用 /effort(支持此命令的版本)。没有入口时,先核对模型、版本和网关支持,不要把 Harness 的“思考档位”勾选设置照搬过来。

验证一:收到第一条回复

新建一个空的测试文件夹,在工具中选择它作为工作区,再新开一个会话。确认当前选中的是刚添加的提供方和模型,发送下面这句话。收到正常回复且没有错误,才说明基本连接成功;它不能证明所有工具都已接通。测试会产生正常的 API 用量。

请只回复:连接成功。

预期:工具显示模型回复「连接成功」。若是登录页、报错或一直转圈,先查看下方排查表,不要反复发送。

验证二:让它实际读取一个文件

在刚才的测试文件夹里,用文本编辑器新建 hello.txt,内容写「API connection test 27」。保存后发送下面的要求;出现读取权限提示时,只允许访问这个测试文件夹。

请使用文件读取工具打开当前工作区的 hello.txt,告诉我文件内容,不要修改任何文件。

预期:能看到读取 hello.txt 的工具执行记录,回答包含 API connection test 27。只有一段口头回复、没有读取记录,不算工具调用验证成功。确认结束后,可以自行删除这个测试文件夹。

遇到问题,先按现象检查

401 / Invalid API key

确认地址和密钥来自同一个平台,密钥完整、未过期或被禁用。不要把完整密钥发给客服。

404 / model not found

先核对地址是否多写或少写 /v1,再核对模型 ID 和协议;模型列表可见也不代表所有协议都能使用。

429 / quota / balance

查看账户余额、密钥额度和请求频率,按错误提示处理;提高思考强度不能解决额度问题。

能聊天,不能读文件

确认模型支持工具调用、软件给了工作区读取权限,且工具执行过程没有报错。

没有思考强度选项

先检查模型能力声明,再检查当前模型与客户端版本是否支持可调档位。模型支持思考,不一定支持多个强度。

官方说明与适用范围

配置说明核对于 2026-11-08。工具更新后菜单可能变化,以下官方资料可用于核对;教程中的 API 信息始终以本平台当前提供的内容为准。