Skip to Content

Claude Code

Claude Code 是 Anthropic 推出的命令行 AI 编程助手，支持在终端中直接与 Claude 模型交互完成代码编写、调试和重构等任务。通过 AcceleAI 接入，你可以灵活选择多种 Claude 模型。

安装

macOS：

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

Windows：

irm https://claude.ai/install.ps1 | iex

通过 npm 安装（需要 Node.js 18+）：

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

安装完成后，如果出现 command not found 的情况，需要将安装目录添加到 PATH：

echo 'export PATH="$HOME/.claude/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

环境变量配置

Claude Code 通过环境变量连接 AcceleAI 服务。你需要设置以下三个关键变量：

变量名说明
ANTHROPIC_BASE_URLAcceleAI 的 API 地址
ANTHROPIC_AUTH_TOKEN你的 AcceleAI API Key
ANTHROPIC_MODEL默认使用的模型

前往 AcceleAI 控制台  获取 API Key。

macOS / Linux

将以下内容添加到 ~/.zshrc（或 ~/.bashrc）：

export ANTHROPIC_BASE_URL="https://api.acceleai.cn"
export ANTHROPIC_AUTH_TOKEN="<ACCELE_AI_API_KEY>"
export ANTHROPIC_MODEL="claude-sonnet-4-5"

执行生效：

source ~/.zshrc

Windows CMD

setx ANTHROPIC_AUTH_TOKEN "<ACCELE_AI_API_KEY>"
setx ANTHROPIC_BASE_URL "https://api.acceleai.cn"
setx ANTHROPIC_MODEL "claude-sonnet-4-5"

Windows PowerShell

[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "<ACCELE_AI_API_KEY>", [EnvironmentVariableTarget]::User)
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.acceleai.cn", [EnvironmentVariableTarget]::User)
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-sonnet-4-5", [EnvironmentVariableTarget]::User)

设置完成后需要重新打开终端窗口。

模型分层配置

Claude Code 支持按任务复杂度分配不同模型，通过环境变量设置三个层级：

# 复杂推理任务（如架构设计）
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4"
 
# 日常开发任务（如编码、调试）
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-5"
 
# 简单任务（如格式化、补全）
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-3-5"

模型选择的优先级从高到低依次为：

  1. 会话内切换：在 Claude Code 终端中输入 /model claude-sonnet-4-5
  2. 启动参数：claude --model claude-sonnet-4-5
  3. 环境变量：上述 ANTHROPIC_DEFAULT_*_MODEL 配置
  4. settings.json 文件

跳过引导流程

首次使用 Claude Code 会进入引导流程。如果你已经熟悉操作，可以直接跳过。

编辑 ~/.claude.json（Windows 下为 C:\Users\%USERNAME%\.claude.json）：

{
  "hasCompletedOnboarding": true
}

VS Code 集成

在 VS Code 中，你可以通过 settings.json 配置 Claude Code 插件的环境变量，无需在系统层面设置：

{
  "claudeCode.environmentVariables": {
    "ANTHROPIC_BASE_URL": "https://api.acceleai.cn",
    "ANTHROPIC_AUTH_TOKEN": "<ACCELE_AI_API_KEY>",
    "ANTHROPIC_MODEL": "claude-sonnet-4-5"
  }
}

在 VS Code 中按 Ctrl + Shift + P（macOS 为 Cmd + Shift + P），搜索 Preferences: Open User Settings (JSON) 打开配置文件并添加上述内容。

常见问题

401 Token 认证失败

在 Claude Code 终端中输入 /config，检查 “Use custom API key” 下方的 Token 是否正确填写。

注意：环境变量名为 ANTHROPIC_AUTH_TOKEN，而非 ANTHROPIC_API_KEY。如果你此前使用了错误的变量名，请修正后重新加载配置。

连接超时或无法访问

  1. 确认 ANTHROPIC_BASE_URL 设置为 https://api.acceleai.cn（末尾不含斜杠）
  2. 检查网络连接是否正常
  3. 前往 AcceleAI Dashboard  确认账户余额充足

macOS 找不到 claude 命令

将 Claude Code 安装目录添加到 PATH：

echo 'export PATH="$HOME/.claude/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
AlmaOpenCode