Claude Code 设置

配置 Claude Code CLI 使用 AIDESK API。

Claude Code 是 Anthropic 的官方命令行工具，将 AI 助手直接带到终端和代码编辑器中。配置使用 AIDESK 后，即可通过统一接口访问多种 AI 模型。

前置条件

  • 一个 AIDESK 账户和 API Key
  • 终端 / 命令提示符访问权限
前往创建 API Key

安装

打开终端并运行：

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

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

验证安装：

claude --version

配置

需要设置两个环境变量：ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL。选择以下任一方式配置。

创建或编辑 ~/.claude/settings.json：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-aidesk-YOUR_KEY",
    "ANTHROPIC_BASE_URL": "https://api.aideskapp.com",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

然后创建或编辑全局配置文件，跳过登录验证：

Mac/Linux：~/.claude.json ·  Windows：C:\Users\你的用户名\.claude.json

{
  "hasCompletedOnboarding": true
}

⚠ 此步骤不可省略，否则启动时会要求登录。

Mac/Linux，添加到 shell 配置文件（~/.zshrc 或 ~/.bashrc）：

export ANTHROPIC_AUTH_TOKEN="sk-aidesk-YOUR_KEY"
export ANTHROPIC_BASE_URL="https://api.aideskapp.com"

Windows PowerShell（管理员）：

[System.Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', 'sk-aidesk-YOUR_KEY', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://api.aideskapp.com', 'User')

配置后重启终端以生效。同样需要设置 ~/.claude.json 跳过登录（见方法 1）。

Mac/Linux：

export ANTHROPIC_AUTH_TOKEN="sk-aidesk-YOUR_KEY"
export ANTHROPIC_BASE_URL="https://api.aideskapp.com"
claude

Windows PowerShell：

$env:ANTHROPIC_AUTH_TOKEN="sk-aidesk-YOUR_KEY"
$env:ANTHROPIC_BASE_URL="https://api.aideskapp.com"
claude

关闭终端后失效，适合快速测试。

CC Switch 提供图形化界面来管理多个 API 供应商配置。

  1. 运行 CC Switch 打开配置界面
  2. 关闭顶部的 Live 代理开关（无需开启）
  3. 添加新供应商，填写以下信息：
供应商名称AIDESK
API Key您的 AIDESK API 密钥
请求地址https://api.aideskapp.com
API 格式Anthropic Messages (原生)
主模型claude-sonnet-4-6
Haiku 默认模型claude-haiku-4-5-20251001
Sonnet 默认模型claude-sonnet-4-6
Opus 默认模型claude-opus-4-7

验证配置

启动 Claude Code 后，输入以下命令查看配置状态：

/status

如果看到以下信息，说明配置成功：

Anthropic base URL: https://api.aideskapp.com

也可以直接发送消息测试：

claude "你好，你现在用的模型名字是什么？"

常见问题

  • 前往控制台 → API 密钥 页面验证密钥是否正确
  • 确保环境变量中没有多余的空格或引号
  • 确认 ANTHROPIC_BASE_URL 设置为 https://api.aideskapp.com（不带 /v1）
  • 检查网络连接是否正常
  • 确认浏览器可以访问 https://api.aideskapp.com
  • 检查防火墙是否阻止了出站 HTTPS 连接
  • 确保已创建 ~/.claude.json 文件，内容为 {"hasCompletedOnboarding": true}
  • Windows 用户检查路径：C:\Users\你的用户名\.claude.json
  • Mac/Linux：运行 which claude 检查是否在 PATH 中
  • 如果未找到，在 ~/.zshrc 或 ~/.bashrc 中添加：export PATH="$HOME/.claude/bin:$PATH"
  • Windows：确认 PATH 环境变量包含 C:\Users\你的用户名\.claude\bin
  • 确保已关闭所有 Claude Code 窗口和终端后再修改配置文件
  • 检查 settings.json 的 JSON 格式是否正确（多余的逗号、缺少引号等）
  • 如果仍不生效，删除 settings.json 后重新创建