Claude Code CLI 设置
学习如何配置 Claude Code CLI 使用 Aiberm 的 API。本指南涵盖 Windows、macOS 和 Linux 的安装和配置。
什么是 Claude Code?
Claude Code 是 Anthropic 的官方命令行界面(CLI)工具,将 AI 助手直接带到您的终端和代码编辑器中。通过配置它使用 Aiberm,您可以通过一个熟悉的界面访问多个 AI 模型。
前置条件
开始之前,请确保您拥有:
安装
选择您的操作系统以查看安装说明。
macOS 和 Linux
打开终端并运行:
curl -fsSL https://claude.ai/install.sh | sh
此安装脚本会自动处理所有依赖项——无需预先安装 Node.js 或 npm。
验证安装:
claude --version
Windows
-
以管理员身份打开 PowerShell(右键单击 PowerShell → “以管理员身份运行”)
-
运行安装命令:
irm https://claude.ai/install.ps1 | iex
-
安装后,将 Claude Code 添加到您的 PATH:
- 按
Win + X并选择”系统” - 点击”高级系统设置”
- 点击”环境变量”
- 在”系统变量”下,选择”Path”并点击”编辑”
- 点击”新建”并添加:
C:\Users\YourUsername\.claude\bin - 点击”确定”保存
- 按
-
重启终端并验证安装:
claude --version
配置
要在 Claude Code 中使用 Aiberm,您需要设置两个环境变量:
ANTHROPIC_AUTH_TOKEN— 您的 Aiberm API 密钥ANTHROPIC_BASE_URL— Aiberm 的 API 端点(https://aiberm.com)
选择以下配置方法之一:
方法 1:永久配置(推荐)
此方法可以安全地保存您的 API 密钥并在会话之间保持。
macOS 和 Linux
将这些行添加到您的 shell 配置文件中:
对于 Bash(~/.bashrc 或 ~/.bash_profile):
export ANTHROPIC_AUTH_TOKEN="sk-your-aiberm-api-key"
export ANTHROPIC_BASE_URL="https://aiberm.com"
对于 Zsh(~/.zshrc):
export ANTHROPIC_AUTH_TOKEN="sk-your-aiberm-api-key"
export ANTHROPIC_BASE_URL="https://aiberm.com"
应用更改:
source ~/.zshrc # 或 source ~/.bashrc
Windows
使用 PowerShell(持久性):
- 以管理员身份打开 PowerShell
- 运行这些命令:
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', 'sk-your-aiberm-api-key', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://aiberm.com', 'User')
- 重启终端以应用更改
使用命令提示符(持久性):
setx ANTHROPIC_AUTH_TOKEN "sk-your-aiberm-api-key"
setx ANTHROPIC_BASE_URL "https://aiberm.com"
方法 2:临时配置(仅当前会话)
macOS 和 Linux
export ANTHROPIC_AUTH_TOKEN="sk-your-aiberm-api-key"
export ANTHROPIC_BASE_URL="https://aiberm.com"
Windows PowerShell
$env:ANTHROPIC_AUTH_TOKEN="sk-your-aiberm-api-key"
$env:ANTHROPIC_BASE_URL="https://aiberm.com"
Windows 命令提示符
set ANTHROPIC_AUTH_TOKEN=sk-your-aiberm-api-key
set ANTHROPIC_BASE_URL=https://aiberm.com
方法 3:使用 Claude Code 设置
创建或编辑 ~/.claude/settings.json:
{
"api": {
"baseUrl": "https://aiberm.com",
"token": "sk-your-aiberm-api-key"
}
}
方法 4:使用 CC Switch(图形界面)
CC Switch 是一个 Claude Code 供应商切换工具,提供图形化界面来管理多个 API 供应商配置。安装方法请参考仓库说明。
配置 Aiberm 供应商:
- 运行 CC Switch 打开配置界面
- 关闭顶部的 Live 代理开关(该开关会让请求走 CC Switch 自己的代理,没有必要开启)
- 添加新供应商,填写以下信息:
- 供应商名称:
Aiberm - 备注:
Aiberm - 官网链接:
https://aiberm.com - API Key:您的 Aiberm API 密钥
- 请求地址:
https://aiberm.com(不要以斜杠结尾) - API 格式:
Anthropic Messages (原生) - 主模型:
claude-opus-4-6 - 推理模型 (Thinking):
claude-opus-4-6-thinking - Haiku 默认模型:
claude-haiku-4-5-20251001 - Sonnet 默认模型:
claude-sonnet-4-5-20250929 - Opus 默认模型:
claude-opus-4-6
- 供应商名称:
- 点击”保存”按钮
验证配置
启动 Claude Code 后,输入 /status 命令查看配置状态。如果看到以下信息,说明配置成功:
Anthropic base URL: https://aiberm.com
也可以发送消息测试:
claude "Hi"
如果配置正确,Claude Code 应该使用 Aiberm 的 API 进行响应。
检查环境变量:
macOS/Linux:
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN
Windows PowerShell:
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN
故障排除
”无效的 API 密钥”错误
- 验证您的 API 密钥是否正确:控制台 → API 密钥
- 确保环境变量中没有额外的空格
- 检查
ANTHROPIC_BASE_URL是否设置为https://aiberm.com(不带/v1)
“连接被拒绝”错误
- 验证您的互联网连接
- 检查您是否可以在浏览器中访问 https://aiberm.com
- 确保您的防火墙允许出站 HTTPS 连接
找不到 Claude Code
macOS/Linux:
# 检查 Claude Code 是否在您的 PATH 中
which claude
# 如果未找到,在 ~/.zshrc 或 ~/.bashrc 中添加到 PATH:
export PATH="$HOME/.claude/bin:$PATH"
Windows:
- 验证 PATH 环境变量是否包含
C:\Users\YourUsername\.claude\bin - 添加到 PATH 后重启终端