摘要

配置 Claude Code 的自定义接入其实只有两个关键动作：把请求地址指向接入节点、把密钥换成接入平台发放的 Key。本文提供一份从零到能用的完整教程，覆盖环境变量设置（Windows PowerShell 与 macOS/Linux 两种写法）、验证连通、常见尾部路径坑点。按步骤走完，你就能让 Claude Code 稳定跑在这条通道上。文中以jiekou.vip为例说明拿密钥的流程。

第一步：拿到接入平台的密钥

配置之前，你需要在接入平台注册并生成一个 API Key。以 jiekou.vip为例，登录后台后在密钥管理里新建一个 Key，复制备用。这个 Key 就是后面 ANTHROPIC_API_KEY 要填的值，请妥善保管，不要提交到 Git 仓库。

同时记下平台用于 Claude Code 的 Anthropic 原生协议地址。Claude Code 走的是 Anthropic 原生协议，对应的 base_url 形如：

https://<平台文档给出的接入地址>/anthropic

注意：base_url 的域名不等于门户域名。jiekou.vip是你注册、管理密钥和查用量的门户，实际请求走的是平台文档里给出的那个 API 域名，按文档填即可。

第二步：设置环境变量

Claude Code 通过 ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY 两个环境变量识别请求出口和身份。下面给出两大平台的写法。

macOS / Linux（bash / zsh）

临时设置（当前终端会话有效）：

export ANTHROPIC_BASE_URL="https://<平台文档给出的接入地址>/anthropic"
export ANTHROPIC_API_KEY="你的平台密钥"

想永久生效，把上面两行写进 ~/.bashrc 或 ~/.zshrc，然后执行 source ~/.zshrc 重新加载。

Windows PowerShell

临时设置（当前窗口有效）：

$env:ANTHROPIC_BASE_URL = "https://<平台文档给出的接入地址>/anthropic"
$env:ANTHROPIC_API_KEY = "你的平台密钥"

想永久生效，用 setx 写入用户环境变量（写完需要重开终端）：

setx ANTHROPIC_BASE_URL "https://<平台文档给出的接入地址>/anthropic"
setx ANTHROPIC_API_KEY "你的平台密钥"

第三步：启动并验证

设置好环境变量后，在项目目录里直接运行：

claude

如果配置正确，Claude Code 会正常进入交互界面。随便发一句"你好，介绍下自己"，能得到正常回复就说明这条接入通道已经打通。你也可以让它读一个文件、改一行代码，确认工具调用链路完整。

关于尾部 /v1 的重要提醒

这是新手最容易踩的坑：如果启动后遇到 404，绝大多数情况是 base_url 尾部的路径拼错了。不同工具在拼接请求路径时逻辑不同——有的会自动补 /v1，有的不会。

排查方法很简单：如果当前地址报 404，试着检查 URL 尾部是否多写或少写了 /v1。Claude Code 走 Anthropic 原生协议时，通常直接用到 /anthropic 这一级即可，无需手动再加 /v1。记住原则——404 先看尾部路径，这一步能解决大多数配置期报错。

第四步：把配置固化下来（可选）

如果你在多个项目里都用 Claude Code，建议把环境变量做成永久配置，避免每次开终端重设。团队协作时，可以在 jiekou.vip 后台为不同成员分发独立密钥，既方便按人核算用量，也便于出问题时单独吊销某个 Key，不影响他人。

小结

配置 Claude Code 自定义接入的核心就三件事：按平台文档填对 base_url、换上平台密钥、遇 404 检查尾部 /v1。两个环境变量搞定，Claude Code 就能稳定跑在这条通道上。密钥的申请和用量管理都在 jiekou.vip 完成，配置一次，长期受用。