Claude Code 接入
- 在主站创建 API 密钥,确认所属分组包含要用的模型。
- 在启动 Claude Code 的同一个终端设置:
bash
export ANTHROPIC_BASE_URL="https://api.nekocloud.vip"
export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"
claude验证与排查
发送一条简短消息。401 先检查环境变量是否传入及密钥是否有效;模型不可用则检查密钥分组。持久化配置请参考 Claude Code 配置说明,不要在截图或工单中附真实密钥。Anthropic Base URL 是域名根路径,不要加 /v1。
模型与配置冲突
先从广场复制当前 Key 分组可用的完整模型 ID,不要默认所有 Claude 型号都可用。启动时可使用 claude --model REPLACE_WITH_MODEL_ID 指定模型,再通过客户端模型选择界面核对。
检查当前终端是否残留其他供应商的 ANTHROPIC_API_KEY、Base URL 或启动脚本;不要混用多个认证来源。修改前备份配置,先在独立终端使用一种认证方式对照,不直接删除原有登录信息。
安全输入与持久化
Bash 可隐藏输入,避免真实 Key 写入命令历史:
bash
export ANTHROPIC_BASE_URL="https://api.nekocloud.vip"
read -rsp 'API Key: ' ANTHROPIC_AUTH_TOKEN
printf '\n'
export ANTHROPIC_AUTH_TOKEN
claude --model REPLACE_WITH_MODEL_ID临时变量只影响该终端及新启动的子进程;桌面启动、Remote SSH 或编辑器插件应核对实际运行位置。修改变量后重新启动客户端,不是重启主机。持久化到 Shell 文件或客户端配置属于明文存储,需限制权限并保护备份。
接入成功的判断
发送短消息,确认正常返回,再核对主站使用记录。工具调用能力需要单独验收,不能用一次聊天成功代替。遇 401 先看具体错误码;404 检查路径;429 减少频率和并发。超时或断流先核对记录,详见故障排查。
工具链验收
在隔离小项目中要求读取一个非敏感文件并总结,确认工具请求、结果回传及最终回答均成功。聊天成功不等于工具链、图片或长上下文全部通过。保留权限审批,测试可能收费。