注册账号

充值

添加令牌

前置条件

Claude Code 需要 Node.js 18+ 环境。检查是否已安装：

node -v

如果提示"命令找不到"，请先安装 Node.js。详见 Node.js 与 npm 说明

配置 npm 镜像（可选但推荐）

国内用户建议配置淘宝镜像，提升安装速度：

npm config set registry https://registry.npmmirror.com

验证配置：

npm config get registry

安装 Node.js

安装 Claude Code

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

配置环境变量

手动配置方式：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.owyun.cn/",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的令牌"
  }
}

PowerShell 执行策略（如遇问题）

如果遇到"禁止运行脚本"错误，以管理员身份运行 PowerShell：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

验证安装

claude --version

claude chat "hello"

常见问题

系统要求

• macOS 10.15 (Catalina) 或更高版本
• Node.js 18+

检查 Homebrew

macOS 推荐使用 Homebrew 管理软件。检查是否已安装：

brew --version

如果未安装，访问 brew.sh 安装。

安装步骤

1. 安装 Node.js

方法 1：使用 Homebrew（简单）

brew install node

方法 2：使用 nvm（推荐开发者，避免权限问题）

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# 重新加载配置
source ~/.zshrc  # 或 source ~/.bash_profile

# 安装 Node.js LTS
nvm install --lts
nvm use --lts

2. 配置 npm 镜像（可选但推荐）

国内用户建议配置淘宝镜像：

npm config set registry https://registry.npmmirror.com

3. 安装 Claude Code

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

4. 配置环境变量

Zsh 用户（macOS 默认）：

echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的令牌"' >> ~/.zshrc
echo 'export ANTHROPIC_BASE_URL="https://api.owyun.cn/"' >> ~/.zshrc
source ~/.zshrc

Bash 用户：

echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的令牌"' >> ~/.bash_profile
echo 'export ANTHROPIC_BASE_URL="https://api.owyun.cn/"' >> ~/.bash_profile
source ~/.bash_profile

验证安装

claude --version

claude chat "hello"

常见问题

系统要求

• Ubuntu 18.04+、CentOS 7+、Debian 9+、Fedora、Arch 等主流发行版
• Node.js 18+

安装步骤

1. 安装 Node.js

Ubuntu / Debian

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

CentOS / RHEL

curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash -
sudo yum install -y nodejs

Fedora

sudo dnf install -y nodejs npm

Arch Linux

sudo pacman -S nodejs npm

使用 nvm（推荐，避免权限问题）

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# 重新加载配置
source ~/.bashrc

# 安装 Node.js LTS
nvm install --lts
nvm use --lts

2. 配置 npm 镜像（可选但推荐）

国内用户建议配置淘宝镜像：

npm config set registry https://registry.npmmirror.com

3. 安装 Claude Code

使用 nvm（推荐）：

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

使用系统 Node.js（需要 sudo）：

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

4. 配置环境变量

echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的令牌"' >> ~/.bashrc
echo 'export ANTHROPIC_BASE_URL="https://api.owyun.cn/"' >> ~/.bashrc
source ~/.bashrc

如果使用 Zsh：

echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的令牌"' >> ~/.zshrc
echo 'export ANTHROPIC_BASE_URL="https://api.owyun.cn/"' >> ~/.zshrc
source ~/.zshrc

验证安装

claude --version

claude chat "hello"

常见问题

功能特点

• 一键切换 API 配置，在多个提供商之间快速切换
• 可视化配置管理，通过图形界面轻松管理
• MCP 服务器管理
• 系统托盘快捷操作

下载安装

访问 CC-Switch 下载页面，Windows 用户推荐下载 .msi 安装包。

配置 API

安装扩展

启动方式

常用命令

基础命令

会话管理

高级选项

接口地址

AI Tech Relay 提供 OpenAI 兼容的 API 接口，方便在各种应用中使用。

认证方式

所有 API 请求需要在请求头中包含 Authorization 字段：

Authorization: Bearer sk-你的令牌

cURL 示例

基础请求

curl https://api.owyun.cn/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的令牌" \
  -d '{
    "model": "claude-sonnet-4.5",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "Hello!"}
    ]
  }'

Python 示例

使用 openai 库

from openai import OpenAI

client = OpenAI(
    base_url="https://api.owyun.cn/v1",
    api_key="sk-你的令牌"
)

response = client.chat.completions.create(
    model="claude-sonnet-4.5",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Hello!"}
    ]
)

print(response.choices[0].message.content)

流式响应

通过设置 stream: true 可以获取流式响应：

curl https://api.owyun.cn/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的令牌" \
  -d '{
    "model": "claude-sonnet-4.5",
    "messages": [{"role": "user", "content": "讲个笑话"}],
    "stream": true
  }'

Python 流式处理

from openai import OpenAI

client = OpenAI(
    base_url="https://api.owyun.cn/v1",
    api_key="sk-你的令牌"
)

stream = client.chat.completions.create(
    model="claude-sonnet-4.5",
    messages=[{"role": "user", "content": "讲个笑话"}],
    stream=True
)

for chunk in stream:
    if chunk.choices[0].delta.content is not None:
        print(chunk.choices[0].delta.content, end="")

安装

npm install -g @openai/codex

配置

export OPENAI_API_KEY="sk-你的令牌"
export OPENAI_BASE_URL="https://api.owyun.cn/v1"

什么是 OpenClaw？

OpenClaw 是一个开源的多渠道 AI 网关，安装后可以通过网页 UI、命令行等方式使用 AI 模型。配合 MISSCU 中转站，无需科学上网即可使用 Claude、GPT 等顶级模型。

安装 OpenClaw

Windows 用户推荐使用一键安装器（已内置 Node.js、Git 和浏览器组件，无需额外配置）：

也可以手动通过 npm 安装：

npm install -g openclaw

配置 API（接入 MISSCU）

安装完成后，运行配置向导：

openclaw onboard

按以下步骤填写：

1. 选择 OpenAI 兼容模式（Custom / OpenAI Compatible）
2. 填入 API Base URL：https://api.owyun.cn/v1
3. 填入你的 API Key（在 MISSCU 控制台 → 令牌 页面复制，格式为 sk-xxxxxxxx）
4. 选择默认模型，例如 claude-sonnet-4-5

启动网页 UI

配置完成后运行：

openclaw ui

浏览器会自动打开 OpenClaw 网页界面，可以像使用 ChatGPT 一样与 AI 对话。

常用命令

openclaw onboard    # 初始化配置（首次使用必须先运行）
openclaw ui         # 打开网页 UI
openclaw           # 命令行对话模式
openclaw --version  # 查看版本号

安装

npm install -g @google/gemini-cli

配置

export GEMINI_API_KEY="sk-你的令牌"
export GEMINI_BASE_URL="https://api.owyun.cn/"

AI编程的核心优势

效率提升数据

实际应用场景

团队协作优势

ROI分析（投资回报率）

最佳实践建议

1. `claude` 命令找不到怎么办？

症状：'claude' 不是内部或外部命令 或 command not found: claude

解决方案：

• 关闭并重新打开终端（PATH 环境变量需要重启终端才能生效）
• 检查是否正确安装：npm list -g @anthropic-ai/claude-code
• 如果未安装，重新执行：npm install -g @anthropic-ai/claude-code

2. `node` 或 `npm` 命令不存在怎么办？

症状：command not found: node 或 command not found: npm

解决方案：

• Node.js 未安装，请参考 Node.js 与 npm 说明 安装
• Windows：重新安装时勾选"Add to PATH"
• macOS/Linux：检查 ~/.bashrc 或 ~/.zshrc 配置

3. npm 安装时提示权限错误（EACCES）？

症状：npm ERR! code EACCES

解决方案：

• Windows：以管理员身份运行 PowerShell
• macOS/Linux：推荐使用 nvm 管理 Node.js，避免权限问题

# macOS/Linux 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
nvm install --lts

4. 国内 npm 安装很慢怎么办？

症状：安装过程卡住或超时

解决方案：配置淘宝镜像

npm config set registry https://registry.npmmirror.com

5. 如何查看当前配置？

配置文件位置：

• Windows：%userprofile%\.claude\settings.json
• macOS/Linux：~/.claude/settings.json

查看 npm 配置：

npm config list

6. 如何更新 Claude Code？

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

查看当前版本：

claude --version

7. 如何卸载 Claude Code？

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

清理配置文件（可选）：

• Windows：删除 %userprofile%\.claude 文件夹
• macOS/Linux：删除 ~/.claude 文件夹

8. Token 和 Base URL 是什么？

• ANTHROPIC_AUTH_TOKEN：你的 API 令牌，格式为 sk-xxx...，在 AI Tech Relay 官网 创建
• ANTHROPIC_BASE_URL：API 服务地址，固定为 https://api.owyun.cn/

9. 为什么需要 Git？

虽然 Git 不是 Claude Code 的必需依赖，但：

• 很多开发教程和工具都会用到 Git
• Git Bash 提供了更好的命令行体验（Windows）
• 版本控制是现代开发的标准实践

10. M1/M2 Mac 能用吗？

完全兼容！Node.js 和 Claude Code 都支持 Apple Silicon (ARM 架构)，无需特殊配置。

无法连接到服务

如果出现连接错误：

解决方案（Windows）

powershell -Command "$f='%USERPROFILE%\.claude.json';$j=Get-Content $f|ConvertFrom-Json;$j|Add-Member -NotePropertyName 'hasCompletedOnboarding' -NotePropertyValue $true -Force;$j|ConvertTo-Json|Set-Content $f"

令牌无效或余额不足

• 检查令牌是否正确复制（包含 sk- 前缀）
• 登录平台检查账户余额
• 确认令牌分组是否支持你使用的模型

响应速度慢

• 检查网络连接是否稳定
• 尝试切换到速度更快的模型（如 Gemini Flash）
• 减少单次请求的上下文长度

常用模型推荐

分组说明

• Claude Max 号池：由 Claude Max 账号组成，稳定性高
• Codex 分组：支持 OpenAI 系模型
• Gemini 分组：支持 Google 系模型
• AWS Bedrock 分组：使用 AWS 官方服务，响应快

什么是缓存？

缓存是一种优化机制：

• 首次请求：发送内容时会创建缓存（有额外费用）
• 命中缓存：后续相似请求从缓存读取，价格极低
• 缓存时长：5 分钟适合频繁切换，1 小时适合专注同一项目

什么是上下文？

上下文是模型能处理的内容长度：

• 默认上下文：200K-256K tokens
• 特价分组：上下文可能更短
• 1M 上下文：适合处理超长内容

充值倍率说明

充值倍率是指人民币与平台额度之间的兑换比例。了解倍率帮助你计算实际使用成本。

不同分组的价格换算

费用计算示例

省钱技巧