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 的 Claude 插件支持两种配置方式，根据需求选择其一。

方式一：全局生效（推荐）

将环境变量写入 ~/.zshrc，对系统内所有工具和插件全局生效，登录方式显示为 Claude Console。

macOS / Linux

1. 打开终端，用 nano 编辑 ~/.zshrc：

nano ~/.zshrc

2. 在文件末尾粘贴以下内容：

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

3. 保存并退出 nano：

  • Ctrl + O — 写入文件，按 Enter 确认
  • Ctrl + X — 退出 nano

4. 使配置立即生效：

source ~/.zshrc

5. 从终端启动 VS Code：

code .

[!IMPORTANT] macOS 上必须从终端启动 VS Code，插件才能继承 shell 环境变量。从 Dock 或 Spotlight 打开不会读取 ~/.zshrc。

Windows

1. 打开 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)

2. 完全关闭并重新打开 VS Code。

Windows 用户级环境变量对所有启动方式生效，无需从命令行启动。

方式二：仅限 VS Code（不影响全局）

在 VS Code 的 settings.json 中配置，仅对当前 VS Code 实例生效。

打开 settings.json，添加以下内容：

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

常见问题

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
VS CodeOpenCode