Claude Code 设置

配置 Claude Code CLI 使用 AIDesk API。

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

前置条件

  • 一个 AIDesk 账户和 API Key
  • macOS / Linux / WSL 使用系统终端；Windows 推荐在 Windows Terminal 中打开 PowerShell
前往创建 API Key

安装

如果你已经安装了 Node.js 18+，可以直接通过 npm 安装：

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

npm 包安装的是同一个原生二进制文件；请确保 npm 允许 optional dependencies，不要使用 sudo 安装。升级时运行 npm install -g @anthropic-ai/claude-code@latest。

验证安装：

claude --version

配置

配置写在 Claude Code 设置文件 settings.json 里：把 AIDesk 的接口地址和你的 API Key 填进去即可。推荐用「一键生成命令」，粘贴 Key 后按系统复制运行。

这是纯前端页面，Key 只用于在你的浏览器本地拼出命令，不会上传或保存到任何服务器。

选择系统，复制命令到终端运行：会自动写好 settings.json，并跳过首次启动的登录引导，直接就能用。

mkdir -p ~/.claude
cat > ~/.claude/settings.json << 'EOF'
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-aidesk-YOUR_KEY",
    "ANTHROPIC_BASE_URL": "https://api.aideskapp.com",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}
EOF
[ -f ~/.claude.json ] || echo '{"hasCompletedOnboarding": true}' > ~/.claude.json

验证配置

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

/status

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

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

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

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

常见问题

「无效的 API 密钥」错误
  • 前往控制台 → API Key 页面验证密钥是否正确
  • 确保环境变量中没有多余的空格或引号
  • 确认 ANTHROPIC_BASE_URL 设置为 https://api.aideskapp.com（不带 /v1）
「连接被拒绝」错误
  • 检查网络连接是否正常
  • 确认浏览器可以访问 https://api.aideskapp.com
  • 检查防火墙是否阻止了出站 HTTPS 连接
启动时要求登录
  • 首次启动时可以按提示完成初始化；如果不想走引导，再创建 ~/.claude.json 并在顶层加入 hasCompletedOnboarding
  • 不要把 hasCompletedOnboarding 写入 ~/.claude/settings.json；settings.json 只放 env 等设置
  • PowerShell 检查路径：$env:USERPROFILE\.claude.json；CMD 或资源管理器检查路径：%USERPROFILE%\.claude.json
找不到 claude 命令
  • Mac/Linux：运行 which claude 检查是否在 PATH 中
  • 如果未找到，在 ~/.zshrc 或 ~/.bashrc 中添加：export PATH="$HOME/.local/bin:$PATH"
  • Windows：确认 PATH 环境变量包含 %USERPROFILE%\.local\bin
  • 熟悉 Bash 的 Windows 用户也可参考 Claude Code 官方 Git Bash 路径，安装 Git for Windows 后使用。
修改配置后不生效
  • 确保已关闭所有 Claude Code 窗口和终端后再修改配置文件
  • 检查 settings.json 的 JSON 格式是否正确（多余的逗号、缺少引号等）
  • 如果仍不生效，删除 settings.json 后重新创建