快速开始

创建 API Key，选择编程工具或 API 调用，完成第一次使用。

编程工具接入在 Claude Code、Codex、Cursor 等工具中直接使用API 调用用 OpenAI 或 Anthropic SDK 在自己的代码里调用

编程工具接入

1

获取 API Key

首先需要创建一个访问密钥来连接我们的服务。一个 Key 即可通用所有接入方式。

前往创建 API Key
2

选择开发工具

选择 Claude Code、Codex 桌面应用 / CLI，或其他编程工具。

还没有安装 Claude Code？查看安装与完整指南

纯前端页面，Key 只在你的浏览器本地拼出命令，不会上传。复制命令到终端运行，即可写好配置并跳过登录引导。

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
手动配置不运行命令，自己创建设置文件

① 把下面内容存为设置文件，把 sk-aidesk-YOUR_KEY 换成你的 Key：

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

② 设置文件路径：

macOS / Linux / WSL
~/.claude/settings.json
Windows PowerShell
$env:USERPROFILE\.claude\settings.json
Windows CMD
%USERPROFILE%\.claude\settings.json
首次运行 claude 若弹出登录 / 账号选择，别登录你自己的 Claude 账号（Key 已配好）。想跳过引导，可另建 ~/.claude.json 并写入 {"hasCompletedOnboarding": true}。
3

验证配置

配置完成后，输入命令 claude 启动 Claude Code，试着问它：「你现在用的模型名字是什么」

使用技巧

切换模型

  • 启动时：执行 claude --model <模型 ID>
  • 对话中：输入 /model <模型 ID>
  • 持久设定：编辑 ~/.claude/settings.json，直接粘贴完整配置，并把 sk-aidesk-YOUR_KEY 换成你的 API Key：
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-aidesk-YOUR_KEY",
    "ANTHROPIC_BASE_URL": "https://api.aideskapp.com",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "gpt-6-luna",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "gpt-6-astra",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "gpt-6.1-sol",
    "ANTHROPIC_MODEL": "gpt-6.1-sol",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

示例把 Opus / Sonnet / Haiku 三档分别映射到 GPT 的旗舰、主力和轻量模型。<模型 ID> 可取模型列表中的任意 ID，例如 gpt-6.1-sol、claude-opus-5-5 等。查看完整模型列表

验证配置

启动后在对话中输入 /status 查看 Base URL 和模型状态，确认配置生效。

Claude Code 完整指南常见问题

API 调用

1

获取 API Key

使用同一个 Key，即可自由切换 OpenAI 与 Anthropic 协议进行开发。

前往创建 API Key
2

选择 SDK 协议

支持 OpenAI SDK 与 Anthropic SDK 双协议，一个 Key 通用。

Base URL（带 /v1）
https://api.aideskapp.com/v1
from openai import OpenAI

client = OpenAI(
    base_url="https://api.aideskapp.com/v1",
    api_key="sk-aidesk-YOUR_KEY"
)

response = client.chat.completions.create(
    model="claude-opus-5-5",
    messages=[{"role": "user", "content": "你好"}]
)

print(response.choices[0].message.content)

完整参数见 Chat Completions API。