Claude Code CLI 设置

学习如何配置 Claude Code CLI 使用 Aiberm 的 API。本指南涵盖 Windows、macOS 和 Linux 的安装和配置。

什么是 Claude Code?

Claude Code 是 Anthropic 的官方命令行界面(CLI)工具,将 AI 助手直接带到您的终端和代码编辑器中。通过配置它使用 Aiberm,您可以通过一个熟悉的界面访问多个 AI 模型。

前置条件

开始之前,请确保您拥有:

  • 一个 Aiberm 账户(在此注册
  • 一个 Aiberm API 密钥(获取密钥
  • 计算机上的终端/命令提示符访问权限

安装

选择您的操作系统以查看安装说明。

macOS 和 Linux

打开终端并运行:

curl -fsSL https://claude.ai/install.sh | sh

此安装脚本会自动处理所有依赖项——无需预先安装 Node.js 或 npm。

验证安装:

claude --version

Windows

  1. 管理员身份打开 PowerShell(右键单击 PowerShell → “以管理员身份运行”)

  2. 运行安装命令:

irm https://claude.ai/install.ps1 | iex
  1. 安装后,将 Claude Code 添加到您的 PATH:

    • Win + X 并选择”系统”
    • 点击”高级系统设置”
    • 点击”环境变量”
    • 在”系统变量”下,选择”Path”并点击”编辑”
    • 点击”新建”并添加:C:\Users\YourUsername\.claude\bin
    • 点击”确定”保存
  2. 重启终端并验证安装:

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(持久性):

  1. 以管理员身份打开 PowerShell
  2. 运行这些命令:
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', 'sk-your-aiberm-api-key', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://aiberm.com', 'User')
  1. 重启终端以应用更改

使用命令提示符(持久性):

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 后重启终端