Claude Code 配置指南

1前置条件 & 安装

使用 Claude Code 前，请确保：

Node.js 18+ — 运行 node -v 检查版本
你的 API Key — 在密钥查询页获取

安装 Claude Code

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

安装完成后运行 claude --version 确认。Mac/Linux 权限不足加 sudo，Windows 以管理员身份运行终端。

2配置环境变量（手动方式）

Claude Code 使用 Anthropic 协议，Base URL 为 https://claudeapilink.com（不带 /v1）。Cursor 使用 OpenAI 协议，URL 为 https://claudeapilink.com/v1。请按对应工具填写。

macOS / Linux

# 设置 API 地址和密钥
export ANTHROPIC_BASE_URL=https://claudeapilink.com
export ANTHROPIC_API_KEY=你的API_Key

# 启动
claude

建议写入 ~/.bashrc 或 ~/.zshrc，每次打开终端自动生效。

Windows PowerShell

# 设置 API 地址和密钥
$env:ANTHROPIC_BASE_URL="https://claudeapilink.com"
$env:ANTHROPIC_API_KEY="你的API_Key"

# 启动
claude

每次新开终端都需重新设置！要永久生效请写入系统环境变量或 PowerShell Profile。

PowerShell Profile 永久生效

# 打开 Profile 文件
notepad $PROFILE

# 添加以下两行，保存后重启终端
$env:ANTHROPIC_BASE_URL="https://claudeapilink.com"
$env:ANTHROPIC_API_KEY="你的API_Key"

3cc-switch 管理工具（推荐）

管理多个 API Key 或频繁切换环境变量，推荐 cc-switch — 可视化管理工具，交互简单方便。

GitHub：https://github.com/farion1231/cc-switch

🍎 macOS 安装包 .zip 🪟 Windows 安装包 .msi

Mac 安装（Homebrew）

brew tap farion1231/ccswitch
brew install --cask cc-switch

Mac 首次打开可能被拦截：系统设置 → 隐私与安全 → 安全性，点「仍要打开」。

配置步骤

打开 cc-switch
创建供应商，名称填 ClaudeApiLink
填入配置：

export ANTHROPIC_BASE_URL="https://claudeapilink.com"
export ANTHROPIC_API_KEY="你的API_Key"

配置完成后选择 ClaudeApiLink 即可一键切换。

4支持的模型列表

以下模型均可直接使用，填入对应模型名称即可：

claude-opus-4-6旗舰

claude-sonnet-4-6均衡

claude-haiku-4-5-20251001快速

常见错误：模型名不是 claude sonnet 4.5，必须用精确 ID 如 claude-sonnet-4-6。

5常见问题 & 避坑

Q1：模型名称填错了

❌ claude sonnet4.5（错误）
✅ claude-sonnet-4-6（正确）

Q2：Mac 安全模式拦截软件

系统设置 → 隐私与安全 → 安全性，点「仍要打开」。

Q3：环境变量每次都要重新设

Mac/Linux：写入 ~/.zshrc 或 ~/.bashrc
Windows：写入 PowerShell Profile
推荐：用 cc-switch 工具管理

Q4：Auth conflict 认证冲突

同时有 claude.ai 登录和 API Key 会冲突。只用 API Key 的话运行 claude /logout 退出。

Q5：Unable to connect / ERR_BAD_REQUEST

没设置 ANTHROPIC_BASE_URL，默认连 api.anthropic.com（国内不通）。确保设置了：

export ANTHROPIC_BASE_URL=https://claudeapilink.com

6最佳实践建议

对 AI Coding 环境分层使用，大幅提升性价比：

日常开发：用 Sonnet 4.6 或 Haiku 4.5，速度快、成本低
复杂任务：切换 Opus 4.6，处理架构设计、疑难 Bug
多 Key 管理：用 cc-switch 按场景一键切换

好钢用在刀刃上 — 日常用轻量模型，关键时刻上旗舰，整体成本降低 60% 以上。

🚀 准备开始？

获取你的 API Key，立即体验纯血 Claude 的强大能力

前往查询密钥 →

遇到问题？联系客服

QQ：3849099304 闲鱼：Zoe朱 X：@DevonHe83456881