接入指南

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

🤖 OpenAI 接口协议

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

🧠 Anthropic 接口协议

https://claude.15code.com

💻 Codex

🤖 Claude Code

📝 OpenCode

🧠 OpenClaw

💻 Codex CLI 配置指南

OpenAI 官方命令行编程助手，支持 GPT-5.3-codex 模型

安装 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.yaml << EOF
api_key: sk-your-api-key-here
base_url: https://cli.15code.com/v1
model: gpt-5.3-codex
EOF

测试连接

# 启动 Codex
codex

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

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

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

常用命令

# 交互模式（推荐）
codex

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

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

# 查看帮助
codex --help

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

🤖 Claude Code 配置指南

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

安装 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-4-7    # 最强旗舰
claude --model claude-sonnet-4-6  # 平衡推荐

# 单次执行（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

📝 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: glm-5

测试连接

# 启动 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": "glm-5",
    "fallback": "glm-5"
  }
}
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 "帮我重构这个项目"