AI 编程助手配置教程

🧩

按工具分类

直接选你正在用的客户端，不需要在长文里自己找路径。

📋

可直接复制

命令、JSON 配置和模型名都能一键复制，少手打，少出错。

🛠️

尽量少踩坑

把常见前置条件、端点格式和易错选项提前标出来。

选择你的客户端

先选工具，再按步骤配置即可。

建议：先获取 API Key，再开始配置

Claude Code 接入教程

适合终端重度用户、开发者、本地代码库协作场景。

推荐给写代码最多的人

检查 Node.js / npm 前置条件

Claude Code 需要 Node.js 18+。如果已经装过，可以先快速检查版本：

node -v && npm -v

Windows

macOS

Linux

推荐直接用 winget 安装最新版 LTS：

winget install OpenJS.NodeJS.LTS

💡 安装完成后请重新打开 PowerShell。Windows 用户一般还建议顺手装一下 Git for Windows。

如果你已经装了 Homebrew，直接执行：

brew install node

Ubuntu / Debian 常用方式：

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

安装 Claude Code CLI

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

claude --version

✅ 能看到版本号，就说明 CLI 已安装成功。

配置 API 地址和 Key

找到或创建 ~/.claude/settings.json，填入下面内容，然后把 sk-你的API Key 换成你自己的 Key：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-你的API Key",
    "ANTHROPIC_BASE_URL": "https://api.xdedm.top",
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "64000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "permissions": {
    "allow": [],
    "deny": []
  },
  "alwaysThinkingEnabled": false
}

另外确保 ~/.claude.json 至少包含：

{
  "hasCompletedOnboarding": true
}

🔑 API Key 可在 api.xdedm.top 控制台获取。

启动使用

cd your-project
claude

✔/model：切换模型

✔/compact：压缩上下文

✔/clear：清空当前会话

Codex 接入教程

适合习惯 OpenAI 工具链、命令行工作流、希望直接在终端里调用模型的人。

适合 OpenAI 生态用户

检查 Node.js / npm 前置条件

Codex CLI 同样建议先确认 Node.js 环境正常：

node -v && npm -v

Windows

macOS

Linux

推荐直接用 winget 安装最新版 LTS：

winget install OpenJS.NodeJS.LTS

如果你已经装了 Homebrew，直接执行：

brew install node

Ubuntu / Debian 常用方式：

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

安装 Codex CLI

npm install -g @openai/codex

codex --version

✅ 能看到版本号，就说明 CLI 已安装成功。

分平台配置 API 地址、Key 和 config.toml

这一段别混着抄。Codex 在不同平台下，环境变量写法和配置文件位置不一样，按你自己的系统选一种就行。

Windows

macOS / zsh

Linux / bash

临时生效（当前 PowerShell 会话）：

$env:OPENAI_API_KEY = "sk-你的API Key"
$env:OPENAI_BASE_URL = "https://api.xdedm.top/v1"

长期生效（写入用户环境变量）：

[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "sk-你的API Key", "User")
[Environment]::SetEnvironmentVariable("OPENAI_BASE_URL", "https://api.xdedm.top/v1", "User")

设置完成后，重新打开 PowerShell 或 Windows Terminal 再执行 codex。

Windows 下 Codex 配置目录通常在：

%USERPROFILE%\.codex\

如果你后面换了 API Key，也记得同步检查：

%USERPROFILE%\.codex\auth.json

临时生效（当前终端会话）：

export OPENAI_API_KEY="sk-你的API Key"
export OPENAI_BASE_URL="https://api.xdedm.top/v1"

长期生效（推荐写入 ~/.zshrc）：

echo 'export OPENAI_API_KEY="sk-你的API Key"' >> ~/.zshrc
echo 'export OPENAI_BASE_URL="https://api.xdedm.top/v1"' >> ~/.zshrc
source ~/.zshrc

macOS 下 Codex 配置目录通常在：

~/.codex/

如果你后面换了 API Key，也记得同步检查：

~/.codex/auth.json

临时生效（当前终端会话）：

export OPENAI_API_KEY="sk-你的API Key"
export OPENAI_BASE_URL="https://api.xdedm.top/v1"

长期生效（常见写入 ~/.bashrc）：

echo 'export OPENAI_API_KEY="sk-你的API Key"' >> ~/.bashrc
echo 'export OPENAI_BASE_URL="https://api.xdedm.top/v1"' >> ~/.bashrc
source ~/.bashrc

Linux 下 Codex 配置目录通常在：

~/.codex/

如果你后面换了 API Key，也记得同步检查：

~/.codex/auth.json

另外建议在 Codex 的 config.toml 里补上模型窗口、自动压缩阈值和推理强度，例如：

model_context_window = 1000000
model_auto_compact_token_limit = 900000
model_reasoning_effort = "high"

常见位置参考：

Windows: %USERPROFILE%\.codex\config.toml
macOS:   ~/.codex/config.toml
Linux:   ~/.codex/config.toml

🔑 API Key 可在 api.xdedm.top 控制台获取。

⚠️ 如果你改了环境变量但 Codex 还是走旧 Key，优先检查 auth.json 里有没有缓存旧值，再重开一个新终端。

启动使用

cd your-project
codex

codex --model gpt-5.4

✔先在项目目录里启动，方便直接读写当前代码仓库

✔如果你的 Codex CLI 支持参数指定模型，可用 --model 切换

✔如果连不上，优先检查 Base URL 是否写成了 https://api.xdedm.top/v1

OpenClaw 接入教程

适合想把 AI 接到终端、聊天渠道、自动化工作流的人。

适合多渠道 / 自动化玩家

安装 OpenClaw 需要 Node.js ≥ 22

npm install -g openclaw@latest

运行初始化向导

初始化时，按提示选择 Custom Provider，并填入你的 API 地址、模型和 Key：

openclaw onboard --install-daemon

# 配置参考
# Model/auth provider: Custom Provider
# API Base URL: https://api.xdedm.top/v1
# Endpoint compatibility: Anthropic-compatible (Uses /messages)
# Model ID: claude-sonnet-4-6

优化模型配置（可选）

如果你想把上下文和输出上限写明确，可以编辑 ~/.openclaw/openclaw.json：

{
  "models": {
    "providers": {
      "custom-api-xdedm-top": {
        "baseUrl": "https://api.xdedm.top",
        "models": [{
          "contextWindow": 200000,
          "maxTokens": 8192
        }]
      }
    }
  }
}

💡 配好后如果没有立即生效，重启一下 gateway 会更稳。

☁️

腾讯云 OpenClaw 自定义配置

适用于腾讯云版 OpenClaw 客户端，使用 Custom Provider 接入

在 OpenClaw 设置中选择 Custom Provider。如果你要接入 Claude 系模型，可使用 Anthropic 兼容配置；如果要接入 GPT-5.4，则按下面的 OpenAI Responses 配置填写。

Claude / Anthropic 兼容示例：

{
  "provider": "xdedm",
  "base_url": "https://api.xdedm.top/",
  "api": "anthropic-messages",
  "api_key": "sk-你的API Key",
  "model": {
    "id": "claude-sonnet-4-6",
    "name": "claude-sonnet-4-6"
  }
}

OpenClaw 使用 GPT-5.4 配置示例：

{
  "provider": "xdedm-gpt",
  "base_url": "https://api.xdedm.top/v1",
  "api": "openai-responses",
  "api_key": "",
  "model": {
    "id": "gpt-5.4",
    "name": "gpt-5.4"
  }
}

💡 api_key 替换成你在控制台获取的 Key。Claude 配置里的 api 使用 anthropic-messages；GPT-5.4 配置里的 api 使用 openai-responses。

验证是否接通

openclaw status

如果状态正常、模型能识别，说明已经可用了。API Key 同样在控制台获取。

Cherry Studio 接入教程

适合喜欢桌面 GUI、想快速切模型聊天和管理工作流的人。

最适合不想折腾命令行的人

下载安装 Cherry Studio

支持 Windows / macOS / Linux：

📥 下载地址：cherry-ai.com/download

获取 API Key

💡 免费模型通常选 default 分组；高阶模型按你后台分组来选，比如 vip。

添加服务商配置

打开 Cherry Studio → 设置 → 模型服务，填入以下信息：

API 地址:   https://api.xdedm.top
API Key:    sk-你的API Key
端点类型:   OpenAI-Response

⚠️ 端点类型请选择 OpenAI-Response，不要误选 Anthropic 原生格式。

添加模型并开始用

保存后在模型列表里添加你想用的模型，例如：

claude-sonnet-4-6
claude-opus-4-6

常见问题

一些最容易卡住的地方，我先替你问了。

1. API 地址到底填哪个？

大多数客户端直接填 https://api.xdedm.top 就行；如果工具要求写到 v1 或 messages 路径，再按该工具提示补充。

2. 配好了但还是报认证失败？

先检查 API Key 是否复制完整、有没有多空格、有没有用错分组；其次确认客户端保存配置后已经重启或重新加载。

3. 哪个客户端最适合我？

重度代码协作：Claude Code；偏好 OpenAI 工具链/终端体验：Codex；想做聊天机器人或自动化：OpenClaw；偏好桌面可视化界面：Cherry Studio。

把你的 AI 编程助手，接到 api.xdedm.top

按工具分类

可直接复制

尽量少踩坑

选择你的客户端

Claude Code 接入教程

检查 Node.js / npm 前置条件

安装 Claude Code CLI

配置 API 地址和 Key

启动使用

Codex 接入教程

检查 Node.js / npm 前置条件

安装 Codex CLI

分平台配置 API 地址、Key 和 config.toml

启动使用

OpenClaw 接入教程

安装 OpenClaw 需要 Node.js ≥ 22

运行初始化向导

优化模型配置（可选）

腾讯云 OpenClaw 自定义配置

验证是否接通

Cherry Studio 接入教程

下载安装 Cherry Studio

获取 API Key

添加服务商配置

添加模型并开始用

常见问题

1. API 地址到底填哪个？

2. 配好了但还是报认证失败？

3. 哪个客户端最适合我？

把你的 AI 编程助手，
接到 api.xdedm.top