支持接入 Codex CLI、Claude Code 和 OpenClaw,请先选择你要使用的教程类型。
支持 Codex CLI、OpenClaw 和 Claude Code 接入;Claude Code 入口可继续按系统查看安装步骤。
Claude Code 需要 Node.js 环境才能运行。
https://nodejs.org/.msi 文件如果你安装了 Chocolatey 或 Scoop,可以使用命令行安装:
# 使用 Chocolatey
choco install nodejs
# 或使用 Scoop
scoop install nodejs
安装完成后,打开 PowerShell 或 CMD,输入以下命令:
node --version
npm --version
如果显示版本号,说明安装成功了!
打开 PowerShell 或 CMD,运行以下命令:
# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code
这个命令会从 npm 官方仓库下载并安装最新版本的 Claude Code。
安装完成后,输入以下命令检查是否安装成功:
claude --version
如果显示版本号,恭喜你!Claude Code 已经成功安装了。
在使用 Claude Code 之前,你需要先获取一个 API 密钥。
在浏览器中访问以下地址:
https://api.jdctools.com.cn
创建成功后,系统会显示你的 API 密钥(以 sk- 开头)。
⚠️ 重要:请立即复制并妥善保存这个密钥,它只会显示一次!
为了让 Claude Code 连接到你的中转服务,需要设置两个环境变量:
在 PowerShell 中运行以下命令:
$env:ANTHROPIC_BASE_URL = "https://api.jdctools.com.cn"
$env:ANTHROPIC_API_KEY = "你的API密钥"
$env:ANTHROPIC_AUTH_TOKEN = "你的API密钥"
💡 记得将 "你的API密钥" 替换为实际的密钥。
在 PowerShell 中运行以下命令设置用户级环境变量:
# 设置用户级环境变量(永久生效)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.jdctools.com.cn", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "你的API密钥", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的API密钥", [System.EnvironmentVariableTarget]::User)
查看已设置的环境变量:
# 查看用户级环境变量
[System.Environment]::GetEnvironmentVariable("ANTHROPIC_BASE_URL", [System.EnvironmentVariableTarget]::User)
[System.Environment]::GetEnvironmentVariable("ANTHROPIC_API_KEY", [System.EnvironmentVariableTarget]::User)
[System.Environment]::GetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", [System.EnvironmentVariableTarget]::User)
💡 设置后需要重新打开 PowerShell 窗口才能生效。
如果使用 VSCode 的 Claude 插件,需要在配置文件中进行设置:
配置文件位置:C:\Users\你的用户名\.claude\config.json
💡 如果该文件不存在,请手动创建。
{
"primaryApiKey": "crs"
}
设置完环境变量后,可以通过以下命令验证是否设置成功:
在 PowerShell 中验证:
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_API_KEY
echo $env:ANTHROPIC_AUTH_TOKEN
在 CMD 中验证:
echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_API_KEY%
echo %ANTHROPIC_AUTH_TOKEN%
预期输出示例:
https://api.jdctools.com.cn
sk-xxxxxxxxxxxxxxxxxx
💡 如果输出为空或显示变量名本身,说明环境变量设置失败,请重新设置。
现在你可以开始使用 Claude Code 了!
claude
# 进入你的项目目录
cd C:\path\to\your\project
# 启动 Claude Code
claude
这通常是权限问题,尝试以下解决方法:
npm config set prefix %APPDATA%\npm如果遇到执行策略限制,运行:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
设置永久环境变量后需要:
echo $env:ANTHROPIC_BASE_URLClaude Code 需要 Node.js 环境才能运行。
如果你已经安装了 Homebrew,使用它安装 Node.js 会更方便:
# 更新 Homebrew
brew update
# 安装 Node.js
brew install node
https://nodejs.org/.pkg 文件sudo安装完成后,打开 Terminal,输入以下命令:
node --version
npm --version
如果显示版本号,说明安装成功了!
打开 Terminal,运行以下命令:
# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code
如果遇到权限问题,可以使用 sudo:
sudo npm install -g @anthropic-ai/claude-code
安装完成后,输入以下命令检查是否安装成功:
claude --version
如果显示版本号,恭喜你!Claude Code 已经成功安装了。
在使用 Claude Code 之前,你需要先获取一个 API 密钥。
在浏览器中访问以下地址:
https://api.jdctools.com.cn
创建成功后,系统会显示你的 API 密钥(以 sk- 开头)。
⚠️ 重要:请立即复制并妥善保存这个密钥,它只会显示一次!
为了让 Claude Code 连接到你的中转服务,需要设置两个环境变量:
在 Terminal 中运行以下命令:
export ANTHROPIC_BASE_URL="https://api.jdctools.com.cn"
export ANTHROPIC_API_KEY="你的API密钥"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"
💡 记得将 "你的API密钥" 替换为实际的密钥。
编辑你的 shell 配置文件(根据你使用的 shell):
# 对于 zsh (默认)
echo 'export ANTHROPIC_BASE_URL="https://api.jdctools.com.cn"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="你的API密钥"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.zshrc
source ~/.zshrc
# 对于 bash
echo 'export ANTHROPIC_BASE_URL="https://api.jdctools.com.cn"' >> ~/.bash_profile
echo 'export ANTHROPIC_API_KEY="你的API密钥"' >> ~/.bash_profile
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.bash_profile
source ~/.bash_profile
如果使用 VSCode 的 Claude 插件,需要在配置文件中进行设置:
配置文件位置:~/.claude/config.json
💡 如果该文件不存在,请手动创建。
{
"primaryApiKey": "crs"
}
现在你可以开始使用 Claude Code 了!
claude
# 进入你的项目目录
cd /path/to/your/project
# 启动 Claude Code
claude
尝试以下解决方法:
sudo npm install -g @anthropic-ai/claude-codenpm config set prefix ~/.npm-global如果系统阻止运行 Claude Code:
sudo spctl --master-disable检查以下几点:
echo $ANTHROPIC_BASE_URLClaude Code 需要 Node.js 环境才能运行。
# 添加 NodeSource 仓库
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
# 安装 Node.js
sudo apt-get install -y nodejs
虽然版本可能不是最新的,但对于基本使用已经足够:
# Ubuntu/Debian
sudo apt update
sudo apt install nodejs npm
# CentOS/RHEL/Fedora
sudo dnf install nodejs npm
sudo安装完成后,打开终端,输入以下命令:
node --version
npm --version
如果显示版本号,说明安装成功了!
打开终端,运行以下命令:
# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code
如果遇到权限问题,可以使用 sudo:
sudo npm install -g @anthropic-ai/claude-code
安装完成后,输入以下命令检查是否安装成功:
claude --version
如果显示版本号,恭喜你!Claude Code 已经成功安装了。
在使用 Claude Code 之前,你需要先获取一个 API 密钥。
在浏览器中访问以下地址:
https://api.jdctools.com.cn
创建成功后,系统会显示你的 API 密钥(以 sk- 开头)。
⚠️ 重要:请立即复制并妥善保存这个密钥,它只会显示一次!
为了让 Claude Code 连接到你的中转服务,需要设置两个环境变量:
在终端中运行以下命令:
export ANTHROPIC_BASE_URL="https://api.jdctools.com.cn"
export ANTHROPIC_API_KEY="你的API密钥"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"
💡 记得将 "你的API密钥" 替换为实际的密钥。
编辑你的 shell 配置文件:
# 对于 bash (默认)
echo 'export ANTHROPIC_BASE_URL="https://api.jdctools.com.cn"' >> ~/.bashrc
echo 'export ANTHROPIC_API_KEY="你的API密钥"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.bashrc
source ~/.bashrc
# 对于 zsh
echo 'export ANTHROPIC_BASE_URL="https://api.jdctools.com.cn"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="你的API密钥"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.zshrc
source ~/.zshrc
现在你可以开始使用 Claude Code 了!
claude
# 进入你的项目目录
cd /path/to/your/project
# 启动 Claude Code
claude
尝试以下解决方法:
sudo npm install -g @anthropic-ai/claude-codenpm config set prefix ~/.npm-globalexport PATH=~/.npm-global/bin:$PATH某些 Linux 发行版需要安装额外依赖:
# Ubuntu/Debian
sudo apt install build-essential
# CentOS/RHEL
sudo dnf groupinstall "Development Tools"
检查以下几点:
source ~/.bashrcecho $ANTHROPIC_BASE_URL你已经成功安装并配置了 Claude Code,现在可以开始享受 AI 编程助手带来的便利了。
如果在使用过程中遇到任何问题,点击「加入群聊」即可获取帮助。
你当前查看的是 Codex CLI 专属教程。Windows / macOS / Linux 标签页内容为 Claude Code 教程。
运行 npm install -g @openai/codex
写入 ~/.codex/config.toml 与 ~/.codex/auth.json,并设置 JDC_OAI_KEY
在项目目录执行 codex
Codex CLI 是 OpenAI 推出的命令行 AI 编程助手,需要 Node.js 环境。
打开终端,运行以下命令:
# 全局安装 Codex CLI
npm install -g @openai/codex
sudo npm install -g @openai/codex安装完成后,输入以下命令检查是否安装成功:
codex --version
如果显示版本号,说明安装成功了!
在使用 Codex CLI 之前,你需要先获取一个 API 密钥。
在浏览器中访问以下地址:
https://api.jdctools.com.cn
创建成功后,系统会显示你的 API 密钥(以 sk- 开头)。
⚠️ 重要:请立即复制并妥善保存这个密钥,它只会显示一次!
Codex CLI 需要配置两个文件来连接中转服务。
创建或编辑配置文件,将以下内容添加到文件开头:
# ~/.codex/config.toml
model_provider = "jdc"
model = "gpt-5.3-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"
[model_providers.jdc]
name = "jdc"
base_url = "https://api.jdctools.com.cn/v1"
wire_api = "responses"
requires_openai_auth = true
env_key = "JDC_OAI_KEY"
创建或编辑认证文件,写入以下内容:
{
"OPENAI_API_KEY": null
}
这个文件用于禁用默认的 OpenAI 认证,让 Codex 使用我们配置的中转服务。
~/.codex/config.toml 和 ~/.codex/auth.jsonC:\Users\你的用户名\.codex\config.toml 和 C:\Users\你的用户名\.codex\auth.json.codex 目录不存在,请手动创建设置 JDC_OAI_KEY 环境变量,让 Codex CLI 使用你的 API 密钥。
# 临时设置(当前会话)
export JDC_OAI_KEY="你的API密钥"
# 永久设置 - zsh (macOS 默认)
echo 'export JDC_OAI_KEY="你的API密钥"' >> ~/.zshrc
source ~/.zshrc
# 永久设置 - bash (Linux 默认)
echo 'export JDC_OAI_KEY="你的API密钥"' >> ~/.bashrc
source ~/.bashrc
# PowerShell 临时设置
$env:JDC_OAI_KEY = "你的API密钥"
# PowerShell 永久设置
[System.Environment]::SetEnvironmentVariable("JDC_OAI_KEY", "你的API密钥", [System.EnvironmentVariableTarget]::User)
💡 永久设置后需要重新打开 PowerShell 窗口才能生效。
💡 记得将 "你的API密钥" 替换为第二步中获取的实际密钥。
现在你可以开始使用 Codex CLI 了!
codex
# 进入你的项目目录
cd /path/to/your/project
# 启动 Codex CLI
codex
# 指定推理强度
codex --reasoning-effort high
# 直接提问
codex "帮我写一个 hello world"
检查以下几点:
JDC_OAI_KEY 环境变量已正确设置~/.codex/auth.json 文件内容为 {"OPENAI_API_KEY": null}~/.codex/config.toml 中的 env_key 值为 "JDC_OAI_KEY"echo $JDC_OAI_KEY(macOS/Linux)或 echo $env:JDC_OAI_KEY(PowerShell)尝试以下解决方法:
config.toml 中的 base_url 为 https://api.jdctools.com.cn/v1https://api.jdctools.com.cn 确认服务可用检查以下几点:
.codex 目录在用户主目录下C:\Users\你的用户名\.codex\config.tomlWindows 不允许在资源管理器中直接创建以点开头的文件夹,可以使用命令行:
# PowerShell
mkdir $HOME\.codex
你已经成功安装并配置了 Codex CLI,现在可以开始享受 AI 编程助手带来的便利了。
如果在使用过程中遇到任何问题,点击「加入群聊」即可获取帮助。
OpenClaw 的接入重点是修改 openclaw.json,把模型提供商替换成我们站点的 jdctools 配置。
OpenClaw 的配置文件在用户目录下的 .openclaw 文件夹里,工作空间目录通常也在这个目录下面。
通常在当前用户目录下的 .openclaw 文件夹里:
C:\你的用户名\.openclaw\openclaw.json
常见工作空间目录类似:C:\你的用户名\.openclaw\clawd
通常在用户主目录下:
~/.openclaw/openclaw.json
常见工作空间目录类似:~/.openclaw/clawd
通常也在用户主目录下:
~/.openclaw/openclaw.json
常见工作空间目录类似:~/.openclaw/clawd
.openclaw/openclaw.json.openclaw 目录下,比如 .openclaw/clawd.openclaw 目录结构为准将原有内容整体替换为下面这份配置。里面有两个值需要你自己填写:API Key 和工作空间。
{
"meta": {
"lastTouchedVersion": "2026.2.2",
"lastTouchedAt": "2026-02-28T11:11:01.596Z"
},
"models": {
"mode": "merge",
"providers": {
"jdctools": {
"baseUrl": "https://api.jdctools.com.cn/v1",
"apiKey": "你的API密钥",
"api": "openai-completions",
"models": [
{
"id": "gpt-5.4",
"name": "gpt-5.4",
"reasoning": false,
"input": [
"text",
"image"
],
"cost": {
"input": 0,
"output": 0,
"cacheRead": 0,
"cacheWrite": 0
},
"contextWindow": 128000,
"maxTokens": 32000
}
]
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "jdctools/gpt-5.4"
},
"workspace": "你自己的工作空间",
"maxConcurrent": 4,
"subagents": {
"maxConcurrent": 8
}
}
},
"messages": {
"ackReactionScope": "group-mentions"
},
"commands": {
"native": "auto",
"nativeSkills": "auto"
},
"channels": {
"feishu": {
"enabled": true,
"dmPolicy": "pairing",
"accounts": {
"main": {
"appId": "cli_a92b9bba17b89bd3",
"appSecret": "VWEfEtB6WGxF1bxbfipCVeMgQWTV4BtL",
"botName": "OpenClaw助手",
"domain": "feishu"
}
}
}
},
"gateway": {
"port": 18789,
"mode": "local",
"auth": {
"token": "my-secret-token-12345"
}
},
"plugins": {
"entries": {
"feishu": {
"enabled": true
}
}
}
}
"apiKey": "你的API密钥":替换成你自己的 jdctools 密钥"workspace": "你自己的工作空间":替换成你自己的项目目录workspace 建议直接填写 OpenClaw 默认工作目录,通常就在 .openclaw 目录下的 clawd。
C:\你的用户名\.openclaw\clawd
~/.openclaw/clawd
~/.openclaw/clawd
配置文件保存后,重启 OpenClaw 进程或服务,让新配置生效。
baseUrl 是 https://api.jdctools.com.cn/v1api 是 openai-completionsjdctools/gpt-5.4C:\你的用户名\.openclaw\openclaw.json~/.openclaw/openclaw.json.openclaw/clawdhttps://api.jdctools.com.cn/v1jdctools/gpt-5.4你已经完成 OpenClaw 的 jdctools 接入配置,现在可以开始使用了。
如果在使用过程中遇到任何问题,点击「加入群聊」即可获取帮助。