Claude Code 是一款强大的 AI 编程助手，能让开发者直接在终端中与 AI 协作编程，大幅提升开发效率。极智API（https://api.jizhiai.top/）作为专业的大模型中转平台，全面兼容Claude生态与协议，可实现Claude Code的低成本、高稳定调用，本文将详细讲解二者的对接配置步骤。
一、系统要求
对接 Claude Code 并适配极智API平台，需满足以下基础环境，确保后续操作顺利执行：
Node.js 版本：≥ 18.0（若已安装可跳过后续“安装Node.js”步骤）
支持操作系统：macOS、Linux、Windows（需通过 WSL 运行，Windows 原生暂不支持）
二、快速开始
1. 安装 Node.js（基础环境准备）
根据使用的操作系统选择对应安装方式，安装完成后需验证版本是否达标。
Ubuntu / Debian 用户
# 1. 配置 Node.js LTS 版本源 curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo bash - # 2. 安装 Node.js sudo apt-get install -y nodejs # 3. 验证安装（需显示 v18.0.0 及以上版本） node --versionmacOS 用户
# 1. 安装 Xcode 命令行工具（若未安装） sudo xcode-select --install # 2. 安装 Homebrew（包管理工具，若未安装） /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" # 3. 通过 Homebrew 安装 Node.js brew install node # 4. 验证安装（需显示 v18.0.0 及以上版本） node --versionWindows 用户（通过 WSL）
先在 Windows 系统中启用 WSL 并安装 Ubuntu 子系统（参考 微软官方教程）；
打开 Ubuntu 子系统终端，执行上述“Ubuntu / Debian 用户”的安装命令。
2. 安装 Claude Code（AI编程助手）
使用 npm（Node.js 自带包管理器）全局安装 Claude Code，安装后验证是否成功。
# 1. 全局安装 Claude Code npm install -g @anthropic-ai/claude-code # 2. 验证安装（需显示 Claude Code 版本号，如 vx.x.x） claude --version3. 配置极智API平台信息（核心对接步骤）
极智API平台支持零改造接入Claude生态，只需在平台获取API认证令牌，即可实现Claude Code的正常通信，这也是二者对接的核心步骤。
步骤1：获取极智API平台配置信息
前往极智API网站完成注册并登录，进入控制台的API令牌页面，点击添加令牌生成以sk-开头的API认证令牌；极智API为Claude Code提供的专属API服务地址固定为平台官方域名，即https://api.jizhiai.top/。
核心配置项信息如下：
配置项 | 说明 | 极智API平台获取方式 |
|---|---|---|
ANTHROPIC_AUTH_TOKEN | API 认证令牌（必填） | 1. 访问极智API官网：https://api.jizhiai.top/<br>2. 完成注册并登录<br>3. 进入“API令牌”页面，点击“添加令牌”生成（令牌以 |
ANTHROPIC_BASE_URL | API 服务地址（固定） | 直接使用极智API平台地址： |
步骤2：生成令牌的建议设置
为确保Claude Code的使用体验，在极智API平台生成令牌时建议按以下配置：
名称：自定义（如“Claude Code专属令牌”，便于识别和管理）
额度：建议设置为“无限额度”（避免开发过程中频繁出现额度不足的情况）
其他选项：保持默认即可
4. 启动 Claude Code
进入项目开发目录，通过环境变量关联极智API平台的配置信息，随后启动 Claude Code 即可完成对接。
# 1. 进入您的项目目录（替换为实际开发路径） cd your-project-folder # 2. 设置环境变量（关联极智API平台配置） export ANTHROPIC_AUTH_TOKEN=sk-xxxxxx # 替换为您在极智API生成的令牌（以sk-开头） export ANTHROPIC_BASE_URL=https://api.jizhiai.top/ # 极智API平台固定地址 # 3. 启动 Claude Code（对接极智API平台） claude5. 初次运行配置（Claude Code 初始化）
启动Claude Code后会自动进入初始化配置流程，按以下步骤操作即可完成全部设置：
选择主题：通过上下方向键选择喜欢的界面主题，按 Enter 确认；
安全须知：阅读相关安全提示后直接按 Enter 确认；
Terminal 配置：使用系统默认配置，按 Enter 确认；
工作目录信任：选择“信任当前目录”，按 Enter 确认。
✅ 完成以上步骤后，恭喜！现在你可以通过极智API平台使用Claude Code，与AI编程搭档一起高效写代码了。
三、常见问题（极智API平台适配版）
Q1：提示“Invalid API Key · Please run /login”怎么办？
A：该问题表示极智API平台的令牌未被识别，需依次检查：
环境变量
ANTHROPIC_AUTH_TOKEN是否为极智API平台生成的、以sk-开头的令牌；环境变量
ANTHROPIC_BASE_URL是否正确填写为https://api.jizhiai.top/。
若已设置永久环境变量，需重启终端使配置生效（或重新执行环境变量设置命令）。
Q2：显示“offline”状态是否影响使用？
A：“offline”是 Claude Code 检测 Google 网络的提示，与极智API平台的连接无关，不会影响Claude Code的正常使用；若需改善该检测状态，可开启全局代理。
Q3：浏览网页时 Fetch 失败，或提示“fetch failed”？
A：出现该问题可按以下步骤排查：
检查本地网络是否稳定，确保能正常访问极智API平台https://api.jizhiai.top/；
若网络稳定仍失败，尝试开启全局代理（极智API兼容主流代理工具）；
若问题持续，可通过极智API平台的客服邮箱或微信客服进行问题排查。
Q4：API 报错（如“转发失败”）怎么办？
A：可按以下步骤快速解决：
按 Ctrl+C 退出当前运行的 Claude Code；
重新执行
claude命令重启程序；若反复报错，可稍作等待后重试，或联系极智API平台客服处理。
四、注意事项
极智API平台仅为Claude Code提供合规的API流量转发服务，确保对接过程符合平台使用规范；
请妥善保管在极智API平台获取的API令牌，避免令牌泄露导致的账号安全问题和不必要的成本损失；
极智API平台支持按量计费，使用Claude Code过程中可在平台控制台查看令牌的使用统计和资源消耗情况。
