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"
}
}
验证配置
通过运行以下命令测试您的设置:
claude "你好!你能确认你已连接到 Aiberm 吗?"
如果配置正确,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 后重启终端