使用教程 - OpenCaty

配置

CC Switch 配置教程

配置 CC Switch 工具，快速切换不同的 AI 模型服务。

下载并安装 CC Switch
配置 OpenCaty API 端点
设置 API Key 和模型
测试连接和切换

查看详细教程 →

配置

Claude Code 配置教程

在 Claude Code 中配置 OpenCaty，支持 Windows、Linux、macOS。

安装 Claude Code
配置 API 端点
设置环境变量
验证配置

查看详细教程 →

配置

Codex 配置教程

在 Codex 编辑器中配置 OpenCaty，跨平台支持。

安装 Codex 插件
配置 API 设置
选择模型和参数
开始使用

查看详细教程 →

CC Switch 配置教程

Windows 配置步骤

1. 下载并安装

从官网下载 CC Switch Windows 版本并安装。

# 使用 PowerShell 安装
winget install ccswitch

2. 配置文件位置

配置文件位于：%USERPROFILE%\.ccswitch\config.json

3. 编辑配置文件

{
  "api_endpoint": "https://api.opencaty.ai/v1",
  "api_key": "your-api-key-here",
  "default_model": "gpt-4",
  "timeout": 30
}

4. 测试连接

ccswitch test

Linux 配置步骤

1. 下载并安装

# Ubuntu/Debian
sudo apt update
sudo apt install ccswitch

# Fedora/RHEL
sudo dnf install ccswitch

# Arch Linux
sudo pacman -S ccswitch

2. 配置文件位置

配置文件位于：~/.config/ccswitch/config.json

3. 编辑配置文件

nano ~/.config/ccswitch/config.json

{
  "api_endpoint": "https://api.opencaty.ai/v1",
  "api_key": "your-api-key-here",
  "default_model": "gpt-4",
  "timeout": 30
}

4. 设置权限并测试

chmod 600 ~/.config/ccswitch/config.json
ccswitch test

macOS 配置步骤

1. 使用 Homebrew 安装

brew install ccswitch

2. 配置文件位置

配置文件位于：~/.config/ccswitch/config.json

3. 编辑配置文件

nano ~/.config/ccswitch/config.json

{
  "api_endpoint": "https://api.opencaty.ai/v1",
  "api_key": "your-api-key-here",
  "default_model": "gpt-4",
  "timeout": 30
}

4. 测试连接

ccswitch test

Claude Code 配置教程

Windows 配置步骤

1. 安装 Claude Code

从官网下载并安装 Claude Code Windows 版本。

2. 配置环境变量

打开 PowerShell 并设置环境变量：

# 临时设置（当前会话）
$env:ANTHROPIC_API_KEY = "your-api-key-here"
$env:ANTHROPIC_BASE_URL = "https://api.opencaty.ai/v1"

# 永久设置（系统环境变量）
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY', 'your-api-key-here', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://api.opencaty.ai/v1', 'User')

3. 配置文件方式

编辑配置文件：%USERPROFILE%\.claude\config.json

{
  "api": {
    "base_url": "https://api.opencaty.ai/v1",
    "api_key": "your-api-key-here",
    "model": "claude-3-opus-20240229"
  }
}

4. 验证配置

claude --version
claude test

Linux 配置步骤

1. 安装 Claude Code

# 使用 curl 安装
curl -fsSL https://claude.ai/install.sh | sh

# 或使用包管理器
sudo apt install claude-code  # Ubuntu/Debian
sudo dnf install claude-code  # Fedora/RHEL

2. 配置环境变量

编辑 ~/.bashrc 或 ~/.zshrc：

export ANTHROPIC_API_KEY="your-api-key-here"
export ANTHROPIC_BASE_URL="https://api.opencaty.ai/v1"

# 应用配置
source ~/.bashrc  # 或 source ~/.zshrc

3. 配置文件方式

创建配置文件：~/.config/claude/config.json

mkdir -p ~/.config/claude
nano ~/.config/claude/config.json

{
  "api": {
    "base_url": "https://api.opencaty.ai/v1",
    "api_key": "your-api-key-here",
    "model": "claude-3-opus-20240229"
  }
}

4. 验证配置

claude --version
claude test

macOS 配置步骤

1. 使用 Homebrew 安装

brew install claude-code

2. 配置环境变量

编辑 ~/.zshrc 或 ~/.bash_profile：

export ANTHROPIC_API_KEY="your-api-key-here"
export ANTHROPIC_BASE_URL="https://api.opencaty.ai/v1"

# 应用配置
source ~/.zshrc  # 或 source ~/.bash_profile

3. 配置文件方式

创建配置文件：~/.config/claude/config.json

mkdir -p ~/.config/claude
nano ~/.config/claude/config.json

{
  "api": {
    "base_url": "https://api.opencaty.ai/v1",
    "api_key": "your-api-key-here",
    "model": "claude-3-opus-20240229"
  }
}

4. 验证配置

claude --version
claude test

Codex 配置教程

Windows 配置步骤

1. 安装 Codex

从 VS Code 扩展市场安装 Codex 插件，或下载独立版本。

# 使用 VS Code 命令行
code --install-extension codex.codex-ai

2. 打开设置

在 VS Code 中：文件 > 首选项 > 设置，搜索 "Codex"

3. 配置 API 设置

在设置中填写以下信息：

API Endpoint: https://api.opencaty.ai/v1
API Key: 您的 OpenCaty API Key
Model: gpt-4 或其他支持的模型

4. 配置文件方式（可选）

编辑 %APPDATA%\Code\User\settings.json：

{
  "codex.apiEndpoint": "https://api.opencaty.ai/v1",
  "codex.apiKey": "your-api-key-here",
  "codex.model": "gpt-4",
  "codex.temperature": 0.7
}

5. 测试配置

按 Ctrl+Shift+P，输入 "Codex: Test Connection"

Linux 配置步骤

1. 安装 Codex

# 使用 VS Code 命令行
code --install-extension codex.codex-ai

# 或使用包管理器安装独立版本
sudo apt install codex-editor  # Ubuntu/Debian
sudo dnf install codex-editor  # Fedora/RHEL

2. 配置文件位置

配置文件位于：~/.config/Code/User/settings.json

3. 编辑配置文件

nano ~/.config/Code/User/settings.json

{
  "codex.apiEndpoint": "https://api.opencaty.ai/v1",
  "codex.apiKey": "your-api-key-here",
  "codex.model": "gpt-4",
  "codex.temperature": 0.7
}

4. 环境变量方式（可选）

编辑 ~/.bashrc：

export CODEX_API_ENDPOINT="https://api.opencaty.ai/v1"
export CODEX_API_KEY="your-api-key-here"

source ~/.bashrc

5. 测试配置

按 Ctrl+Shift+P，输入 "Codex: Test Connection"

macOS 配置步骤

1. 安装 Codex

# 使用 Homebrew
brew install --cask codex

# 或在 VS Code 中安装插件
code --install-extension codex.codex-ai

2. 配置文件位置

配置文件位于：~/Library/Application Support/Code/User/settings.json

3. 编辑配置文件

nano ~/Library/Application\ Support/Code/User/settings.json

{
  "codex.apiEndpoint": "https://api.opencaty.ai/v1",
  "codex.apiKey": "your-api-key-here",
  "codex.model": "gpt-4",
  "codex.temperature": 0.7
}

4. 环境变量方式（可选）

编辑 ~/.zshrc：

export CODEX_API_ENDPOINT="https://api.opencaty.ai/v1"
export CODEX_API_KEY="your-api-key-here"

source ~/.zshrc

5. 测试配置

按 Cmd+Shift+P，输入 "Codex: Test Connection"