Skip to main content

​
获取 Ace Data Cloud API Key

  1. 打开 控制台 → 应用列表，完成登录。
  2. 按计费方式选择应用：使用 Coding Plan 时进入 Coding Application；按量使用时选择有对应服务权限的通用/服务应用。Coding 套餐与通用余额分别管理。
  3. 复制该应用的 API Key / API Token，不要复制 Application ID 或 platform- 管理 Token。下文 API Key 字段只填写密钥本身，不含 Bearer 前缀。
  4. 确认应用有效且有额度。活动和免费额度以控制台实时显示为准。
用同一把 Key 查询模型目录：
PowerShell 环境变量写法为 $env:ACEDATACLOUD_API_KEY = "YOUR_ACEDATACLOUD_API_KEY"；使用 Windows 自带 curl 时写 curl.exe。/v1/models 是模型发现入口，目录中出现某个模型不等于当前 Key 有对应 API 权限。还要核对所选协议、应用范围和客户端能力。 下文 MODEL_ID 必须替换为具体模型 ID。不要把真实 Key 提交到 Git、贴进日志或截图。

​
安装

按 官方安装说明 选择系统的原生安装器。macOS/Linux/WSL：
Windows 原生安装按官方 PowerShell 指引执行，并满足 Git for Windows 等系统依赖。仍使用 npm 安装的用户注意：2026-09-07 的 @anthropic-ai/claude-code@2.1.263 要求 Node.js 22+，旧教程中的 Node 18 已不适用。

​
配置 Anthropic Messages

在用户级 ~/.claude/settings.json 合并以下内容（Windows 对应 %USERPROFILE%\.claude\settings.json）：
将占位符替换为应用 Key 本身。ANTHROPIC_BASE_URL 不带 /v1，最终 Messages 请求是 /v1/messages。模型 ID 为示例，先确认应用可用模型。不要抄写超大上下文或自动压缩窗口参数；这些参数不能扩大模型或套餐本身的限制。 也可仅在启动进程的终端提供变量：
两种方式择一维护。若已有另一个供应商的 ANTHROPIC_API_KEY，在启动环境中取消旧值，避免凭据竞争。项目共享的 .claude/settings.json 不应保存密钥；单项目需要本地配置时用 .claude/settings.local.json 并确认未跟踪入库。

​
首次使用

进入测试项目运行 claude，用 /status 核对模型与 Provider；先进行只读验证：
模型回复成功后再做下方文件任务。不要把截图上的旧版本号或旧模型名单当作必须安装的版本。

​
实战与验收

先新建一个测试目录，在 fixture.txt 写入 hello from Ace Data Cloud，然后让客户端执行：
读取 fixture.txt，逐字引用其内容并解释文件用途。不要修改任何文件。
检查是否真的读取文件、是否引用正确内容；然后到 平台使用历史 按时间核对请求。对不支持文件工具的聊天模式，先附加该文件，再提同样的问题。不要用一次简单聊天成功推断编辑、图片、工具、自动补全全部可用。

​
核对依据

配置于 2026-09-07 对照下列官方资料核对；除明确列出的实测外，不把所有系统与客户端版本都标为已跑通。 返回 Coding Plan 配置中心。