接入指南

选择你的工具，按步骤配置即可开始使用

🤖 OpenAI 接口协议

https://cli.15code.com/v1

🧠 Anthropic 接口协议

https://claude.15code.com

模型与多模态能力

文本模型：gpt-5.5、gpt-5.6-terra、gpt-5.6-sol、gpt-5.6-luna、claude-sonnet-5、claude-opus-5、glm-5.3、deepseek-v4-pro、qwen3.8。

DeepSeek V4 Pro 的工具调用以及各模型的上下文限制，均以 /v1/models 和账户目录为准。gpt-image-2 是独立 Images API 模型：使用 /v1/images/generations / /v1/images/edits，不等同于文本模型的视觉能力；图片按图片计费。

💻 Codex

🤖 Claude Code

🪟 Windows WSL

📝 OpenCode

🧠 OpenClaw

💻 Codex CLI 配置指南

OpenAI 官方命令行编程助手，推荐使用 GPT-5.6 Terra；高质量任务可切换 GPT-5.6 Sol

安装 Node.js（如已安装可跳过）

Codex 需要 Node.js 18+ 版本

MacOS / Linux

# 使用 Homebrew 安装（Mac）
brew install node

# 或使用 apt 安装（Linux/Ubuntu）
sudo apt update && sudo apt install nodejs npm -y

# 验证安装
node --version  # 应显示 v18.x 或更高

Windows

# 下载安装包
# 访问 https://nodejs.org/ 下载 LTS 版本安装

# 或使用 PowerShell（需先安装 winget）
winget install OpenJS.NodeJS.LTS

# 验证安装
node --version

安装 Codex CLI

MacOS / Linux / Windows（通用）

npm install -g @openai/codex

# 验证安装
codex --version

💡 如果 npm 安装慢，可以使用国内镜像：
npm install -g @openai/codex --registry=https://registry.npmmirror.com

配置 API 密钥

MacOS / Linux（终端）

# 设置环境变量（临时，关闭终端后失效）
export OPENAI_API_KEY=sk-your-api-key-here
export OPENAI_BASE_URL=https://cli.15code.com/v1

# 永久设置（写入配置文件）
echo 'export OPENAI_API_KEY=sk-your-api-key-here' >> ~/.bashrc
echo 'export OPENAI_BASE_URL=https://cli.15code.com/v1' >> ~/.bashrc
source ~/.bashrc

Windows PowerShell

# 临时设置（当前窗口）
$env:OPENAI_API_KEY="sk-your-api-key-here"
$env:OPENAI_BASE_URL="https://cli.15code.com/v1"

# 永久设置（写入用户配置）
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "sk-your-api-key-here", "User")
[Environment]::SetEnvironmentVariable("OPENAI_BASE_URL", "https://cli.15code.com/v1", "User")

# 重新打开 PowerShell 生效

配置文件方式（推荐）

# 创建配置文件
mkdir -p ~/.codex
cat > ~/.codex/config.toml << EOF
model_provider = "15code"
model = "gpt-5.6-terra"

[model_providers.15code]
name = "15code"
base_url = "https://cli.15code.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
requires_openai_auth = false
EOF

测试连接

# 启动 Codex
codex

# 或指定工作目录
codex --cwd /path/to/your/project

# 测试简单命令
codex "创建一个 hello.py 文件"

✅ 如果看到 Codex 开始执行任务，说明配置成功！

常用命令

# 交互模式（推荐）
codex

# 单次执行
codex "帮我重构这个函数"

# 指定模型
codex --model gpt-5.6-terra "优化代码性能"

# 查看帮助
codex --help

启用图片生成与编辑插件

15code Image 插件会把生成或编辑后的图片保存到当前工作区。它使用单独的 OPENAI_API_KEY_15CODE 环境变量，不要把真实 Key 写入项目文件或提交到 Git。

Linux / macOS / WSL / Android Termux

export OPENAI_API_KEY_15CODE="你的15code API Key"
curl -fsSL https://15code.com/install/15code-image.sh | bash

Windows PowerShell

[Environment]::SetEnvironmentVariable("OPENAI_API_KEY_15CODE", "你的15code API Key", "User")
irm https://15code.com/install/15code-image.ps1 | iex

重新打开 Codex 后，直接说“生成一张图片”或“编辑这张图片”。安装包和 SHA-256 请前往下载中心。

⚠️ 注意：API Key 要保密，不要上传到 GitHub 或分享给他人

🤖 Claude Code 配置指南

Anthropic 官方命令行工具，支持 Claude Sonnet 5 模型

安装 Node.js（如已安装可跳过）

Claude Code 需要 Node.js 18+ 版本

MacOS / Linux

# 使用 Homebrew 安装（Mac）
brew install node

# 或使用 apt 安装（Linux）
sudo apt update && sudo apt install nodejs npm -y

# 验证安装
node --version

Windows — 需装 2 个：Node.js + Git for Windows

Claude Code 运行时会调用 bash（执行命令、编辑文件等），Windows 下必须通过 Git Bash 提供 bash 环境。npm install 本身在 PowerShell/CMD 里也能跑，但运行 claude 必须在 Git Bash 里。

🇨🇳 方式 A · 浏览器下载（国内最稳）

Node.js LTS → nodejs.org/zh-cn/download（Windows .msi）
国内慢？镜像 npmmirror.com/mirrors/node
Git for Windows（含 Git Bash）→ git-scm.com/download/win
国内慢？镜像 mirrors.huaweicloud.com/git-for-windows
两个安装器保留默认选项 Next 到底

🌍 方式 B · winget（海外稳定，国内常超时）

winget install OpenJS.NodeJS.LTS
winget install Git.Git

winget 如报 "0x8a15000f 未找到源" 或超时，用方式 A。

装完之后：开始菜单搜 Git Bash → 打开（蓝色 G 图标）。从下一步开始所有命令都在 Git Bash 里跑。

在 Git Bash 里验证（每行应显示版本号）：

node --version
npm --version
git --version
bash --version

⚠️ Windows 用户常见误区：装完 Node 直接在 PowerShell 里跑 claude，会遇到 "bash: command not found" 或工具调用失败 —— Claude Code 需要 bash shell 来执行它的内置工具（文件编辑、命令执行），没有 Git Bash 根本跑不起来。

安装 Claude Code

macOS / Linux 终端或 Windows Git Bash

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

🇨🇳 国内用户（可能需要镜像）

# 使用国内 npm 镜像加速
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

# 或永久切镜像
npm config set registry https://registry.npmmirror.com
npm install -g @anthropic-ai/claude-code

💡 如果 claude --version 提示 "command not found"：
• macOS/Linux: 确认 npm 全局路径在 PATH（npm config get prefix 看一下）
• Windows Git Bash: 关闭 Git Bash 后重新打开（让 PATH 生效）

配置环境变量（关键步骤）

💡 原理：设置 ANTHROPIC_BASE_URL + ANTHROPIC_AUTH_TOKEN 后，Claude Code 会自动用这两个值调 API，**无需** OAuth 登录，也**不需要** --bare、--print 之类的参数。

macOS / Linux / Windows Git Bash 统一流程

把 sk-u-你的key 替换成 Dashboard 里的真实 Key，整段粘贴到终端：

cat >> ~/.bashrc << 'EOF'
export ANTHROPIC_BASE_URL="https://claude.15code.com"
export ANTHROPIC_AUTH_TOKEN="sk-u-你的key"
export ANTHROPIC_API_KEY="sk-u-你的key"
EOF
source ~/.bashrc
claude

macOS：默认 zsh，把 ~/.bashrc 改成 ~/.zshrc（不确定先跑 echo $SHELL）
Windows Git Bash：默认读 ~/.bashrc，直接用即可
Linux：默认 ~/.bashrc

⚠️ Windows 用户请确认此刻窗口标题是 "MINGW64" 或命令提示符是 $（而非 >）—— 是 → Git Bash ✓；不是 → 你在 PowerShell/CMD，请关掉，打开 Git Bash 重来。

📝 配置文件方式（跨终端通用，推荐进阶用户）

# 在项目目录创建 .env 文件（用 direnv 或 dotenv-cli 加载）
cat > .env << 'EOF'
ANTHROPIC_BASE_URL=https://claude.15code.com
ANTHROPIC_AUTH_TOKEN=sk-u-你的key
ANTHROPIC_API_KEY=sk-u-你的key
EOF

# 或 ~/.claude/settings.json
mkdir -p ~/.claude
cat > ~/.claude/settings.json << 'EOF'
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://claude.15code.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-u-你的key"
  }
}
EOF

⚠️ 为什么设两个变量？
不同版本 Claude Code 读的 key 变量名不同：老版本读 ANTHROPIC_API_KEY，新版本（1.x+）优先读 ANTHROPIC_AUTH_TOKEN。**两个都设**最保险。

💡 如果以前跑过 /login 走过官方 OAuth，需要清理缓存：
• macOS/Linux: rm -rf ~/.claude/auth.json ~/.claude/credentials
• Windows: 删 %USERPROFILE%\.claude\auth.json
否则 Claude Code 会优先用 OAuth token，忽略你设的 env。

启动 & 常用命令

# 交互模式（最常用）
claude

# 指定模型
claude --model claude-opus-5-0    # 最强旗舰
claude --model claude-sonnet-5  # 平衡推荐

# 单次执行（print 模式，用于脚本/管道）
claude -p "帮我审核这段代码" < main.py

# 查看帮助
claude --help

✅ 看到 > 提示符 + Claude 开始响应 = 成功！

⚠️ 常见问题排查

❌ "Not logged in" / OAuth 相关错误

先确认 3 个环境变量都生效（每行都应该有输出）：

echo "$ANTHROPIC_BASE_URL $ANTHROPIC_AUTH_TOKEN $ANTHROPIC_API_KEY"

如果有残留 OAuth 凭证（以前跑过 claude /login），清掉：

rm -rf ~/.claude/auth.json ~/.claude/credentials

Windows CMD 用：del "%USERPROFILE%\.claude\auth.json"

❌ 401 Unauthorized

新建的 key 有 1-2 秒同步延迟，稍等再试。超过 10 秒仍 401，去 Dashboard 确认 Key 没被禁用、完整复制（以 sk-u 开头）。

❌ 连接超时 / network error

测试 endpoint 可达性（应返回 JSON 模型列表）：

curl -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" https://claude.15code.com/v1/models

🪟 Windows WSL 安装：Codex 与 Claude Code

推荐在 WSL2 的 Ubuntu 中运行两个 CLI：Git、Node.js、文件和 shell 都在同一个 Linux 环境，避免 PowerShell、Git Bash 和 Windows Node.js 混用。

在 Windows PowerShell 安装 WSL2 与 Ubuntu

以下命令只在 Windows PowerShell（建议以管理员身份）运行；不要在 Ubuntu/WSL 终端中运行。完成后按提示重启，首次打开 Ubuntu 时创建 Linux 用户名和密码。

Windows PowerShell

wsl --install -d Ubuntu

# 重启后检查 Ubuntu 是否为 WSL 2
wsl --status
wsl -l -v

若 wsl -l -v 显示 Ubuntu 的 VERSION 不是 2，在 PowerShell 运行 wsl --set-version Ubuntu 2，再重新打开 Ubuntu。

在 Ubuntu WSL 中准备基础环境和 Node.js 22 LTS

从这里开始，所有命令都在Ubuntu（WSL）终端运行。可从开始菜单打开 Ubuntu，或在普通 PowerShell 输入 wsl 进入。Claude Code 需要 Node.js 22 或更高版本。

Ubuntu / WSL shell

sudo apt update
sudo apt install -y ca-certificates curl git build-essential

# 使用 nvm 将 Node 安装到当前 Linux 用户目录，不需要 sudo npm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"
nvm install 22
nvm alias default 22

node --version
npm --version
git --version

winget 只属于 Windows PowerShell；apt 和 nvm 只属于 Ubuntu。不要把 Windows 版 Node.js 的路径或 npm 与 WSL 混用。

安装 Codex 与 Claude Code CLI

Ubuntu / WSL shell

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

codex --version
claude --version

npm 下载较慢时，可为这一次安装添加 --registry=https://registry.npmmirror.com。若提示 command not found，重新打开 Ubuntu；仍无效时，重新执行上一步的 NVM_DIR 和 nvm.sh 两行加载命令。

配置 15code 环境变量并持久化

先在 15code Dashboard 创建 API Key。YOUR_15CODE_API_KEY 是占位符，必须替换为你自己的 Key；不要把真实 Key 发到聊天、提交 Git，或写入项目的 .env。

Ubuntu / WSL shell

install -d -m 700 "$HOME/.config/15code"
cat > "$HOME/.config/15code/env.sh" <<'EOF'
export OPENAI_API_KEY="YOUR_15CODE_API_KEY"
export ANTHROPIC_BASE_URL="https://claude.15code.com"
export ANTHROPIC_AUTH_TOKEN="YOUR_15CODE_API_KEY"
export ANTHROPIC_API_KEY="YOUR_15CODE_API_KEY"
EOF
chmod 600 "$HOME/.config/15code/env.sh"
grep -qxF 'source "$HOME/.config/15code/env.sh"' "$HOME/.bashrc" || echo 'source "$HOME/.config/15code/env.sh"' >> "$HOME/.bashrc"
source "$HOME/.config/15code/env.sh"

Codex 配置文件（Ubuntu / WSL shell）

mkdir -p "$HOME/.codex"
cat > "$HOME/.codex/config.toml" <<'EOF'
model_provider = "15code"
model = "gpt-5.6-terra"

[model_providers.15code]
name = "15code"
base_url = "https://cli.15code.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
requires_openai_auth = false
EOF

每次打开 Ubuntu 时，~/.bashrc 会自动载入变量。Ubuntu 默认 shell 是 bash；若你改用其他 shell，请写入该 shell 的启动文件。

验证连接并启动

Ubuntu / WSL shell

# 不打印密钥，只检查变量是否已载入
test -n "${OPENAI_API_KEY:-}" && echo "OPENAI_API_KEY 已设置"
test -n "${ANTHROPIC_AUTH_TOKEN:-}" && echo "ANTHROPIC_AUTH_TOKEN 已设置"

# 两个端点应返回模型 JSON
curl -fsS -H "Authorization: Bearer $OPENAI_API_KEY" https://cli.15code.com/v1/models
curl -fsS -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" https://claude.15code.com/v1/models

# 建议在 Linux 家目录创建项目，而不是 /mnt/c/...
mkdir -p ~/projects/demo && cd ~/projects/demo

# 以下两条启动命令分别运行；退出一个客户端后再启动另一个
codex
claude --bare --model claude-sonnet-5

✅ Codex 能进入交互界面、Claude Code 能在 --bare 模式下响应，即表示 WSL 配置完成。

常见问题

wsl / winget 找不到：回到 Windows PowerShell，执行步骤 1；它们不是 Ubuntu 命令。

apt / nvm 找不到：你不在 Ubuntu WSL；从开始菜单打开 Ubuntu，或先在 PowerShell 输入 wsl。

新开 Ubuntu 后变量为空：运行 source ~/.bashrc，确认 ~/.config/15code/env.sh 已替换占位符；不要用会打印 Key 的命令排查。

Claude 出现 OAuth 或 system message 错误：确认使用 claude --bare，并已设置 ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN。

在 Windows 编辑 WSL 项目：进入项目后运行 code .（需 VS Code WSL 扩展），不要混用 Windows npm 与 WSL npm。

🔐 API Key 只应保存在 WSL 用户目录；示例文件权限为 600。不要上传 ~/.config/15code/env.sh、包含 Key 的配置文件或截图到 GitHub。

📝 OpenCode 配置指南

开源 AI 编程助手，支持多种模型，完全本地化控制

安装 Node.js（如已安装可跳过）

# MacOS/Linux
brew install node || sudo apt install nodejs npm -y

# Windows
# 访问 https://nodejs.org/ 下载安装

# 验证
node --version  # 需要 v18+

安装 OpenCode

npm install -g opencode

# 或从源码安装（最新版）
git clone https://github.com/opencode-ai/opencode
cd opencode && npm install && npm link

# 验证
opencode --version

配置 API

环境变量方式

# MacOS / Linux
export OPENCODE_API_KEY=sk-your-api-key-here
export OPENCODE_BASE_URL=https://cli.15code.com/v1

# 永久设置
echo 'export OPENCODE_API_KEY=sk-your-api-key-here' >> ~/.bashrc
echo 'export OPENCODE_BASE_URL=https://cli.15code.com/v1' >> ~/.bashrc
source ~/.bashrc

Windows PowerShell

$env:OPENCODE_API_KEY="sk-your-api-key-here"
$env:OPENCODE_BASE_URL="https://cli.15code.com/v1"

# 永久设置
[Environment]::SetEnvironmentVariable("OPENCODE_API_KEY", "sk-your-api-key-here", "User")
[Environment]::SetEnvironmentVariable("OPENCODE_BASE_URL", "https://cli.15code.com/v1", "User")

配置文件方式（推荐）

# 创建 ~/.opencode/config.yaml
api_key: sk-your-api-key-here
base_url: https://cli.15code.com/v1
model: gpt-5.6-terra

测试连接

# 启动 OpenCode
opencode

# 测试命令
opencode "创建一个简单的 HTTP 服务器"

✅ 看到响应即配置成功

🧠 OpenClaw 配置指南

强大的 AI 助手框架，支持 Discord/Telegram/Signal 等多平台

安装 OpenClaw

MacOS / Linux

# 使用 npm 安装
npm install -g openclaw

# 或使用 Docker（推荐）
docker pull openclaw/openclaw:latest
docker run -d -v ~/.openclaw:/root/.openclaw openclaw/openclaw

# 验证
openclaw --version

Windows

# npm 安装
npm install -g openclaw

# 或下载预编译版本
# https://github.com/openclaw/openclaw/releases

配置 API

OpenClaw 使用配置文件管理 API

创建配置文件 ~/.openclaw/openclaw.json

# 创建配置目录
mkdir -p ~/.openclaw

# 编辑配置文件
cat > ~/.openclaw/openclaw.json << 'EOF'
{
  "gateway": {
    "remote": {
      "url": "https://cli.15code.com/v1",
      "token": "sk-your-api-key-here"
    }
  },
  "models": {
    "default": "gpt-5.6-terra",
    "fallback": "gpt-5.6-sol"
  }
}
EOF

💡 配置文件说明：
- gateway.remote.url: API 服务器地址
- gateway.remote.token: 你的 API Key
- models.default: 默认使用的模型

配置消息平台（可选）

OpenClaw 支持多平台接入

Discord 配置示例

# 在 ~/.openclaw/openclaw.json 中添加
{
  "plugins": {
    "entries": {
      "discord": {
        "enabled": true,
        "config": {
          "token": "your-discord-bot-token",
          "clientId": "your-client-id"
        }
      }
    }
  }
}

Telegram 配置示例

{
  "plugins": {
    "entries": {
      "telegram": {
        "enabled": true,
        "config": {
          "token": "your-telegram-bot-token"
        }
      }
    }
  }
}

启动 OpenClaw

# 启动 Gateway 服务
openclaw gateway start

# 查看状态
openclaw gateway status

# TUI 交互模式
openclaw tui

✅ Gateway 运行后即可在各平台使用 AI 助手

ACP 模式（Claude Code 控制）

OpenClaw 可以作为 Claude Code/Pi 的控制器

# 配置 ACP harness
cat > ~/.openclaw/openclaw.json << 'EOF'
{
  "acp": {
    "defaultAgent": "claude-code",
    "agents": {
      "claude-code": {
        "command": "claude",
        "args": ["--print", "--permission-mode", "bypassPermissions"]
      }
    }
  }
}
EOF

# 使用 ACP 模式
openclaw acp run "帮我重构这个项目"