獲取 API Key
🎉 AIOneGate 統一接入多種 AI 工具,一個 API Key 搞定一切。   立即獲取 API Key →

Claude Code 快速接入

1

安裝 CLI

使用 npm 全局安裝 Claude Code CLI 工具

2

修改設定檔

配置 ~/.claude/settings.json,填入 API Key 和 AIOneGate 地址

3

啟動

終端執行 claude 命令即可開始使用

推薦使用一鍵配置工具 cc-switch,自動填入所有設定

cc-switch →
settings.json
# Step 1: 安裝
npm install -g @anthropic-ai/claude-code

# Step 2: 配置 ~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-your-api-key",
    "ANTHROPIC_BASE_URL": "你的AIOneGate地址",
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "64000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "permissions": { "allow": [], "deny": [] },
  "alwaysThinkingEnabled": false
}

# Step 3: 配置 ~/.claude.json
{ "hasCompletedOnboarding": true }

# Step 4: 啟動
claude

Roo Code 快速接入

1

安裝插件

在 VS Code 擴展市場搜索並安裝 Roo Code

2

配置 API 提供商

選擇 Anthropic,分組選 cc5 或 cc7

3

設置自定義 URL

勾選 Use custom base URL,不勾選 Anthropic 標頭和 1M 上下文

4

選擇模型

選擇 claude-opus-4-6 開始使用

Roo Code 配置
# Roo Code 配置參數

API Provider: Anthropic
API Key: sk-your-api-key
分組: cc5 或 cc7
Use custom base URL: ✅ 勾選
Base URL: 你的AIOneGate地址
Model: claude-opus-4-6

# ⚠ 以下兩項不要勾選:
Send as Anthropic header: ❌ 不勾選
Enable 1M context: ❌ 不勾選

OpenCode 快速接入

1

安裝 OpenCode

使用安裝腳本或 npm 安裝

2

註冊自定義服務商

opencode auth login → other → ID: aionegate

3

修改配置文件

編輯 ~/.config/opencode/opencode.json

4

啟動使用

執行 opencode,/models 選擇模型

opencode.json
# Step 1: 安裝
curl -fsSL https://opencode.ai/install | bash
# 或 npm 安裝
npm i -g opencode-ai@latest

# Step 2: 註冊服務商
opencode auth login
# → 選擇 other → 輸入 ID: aionegate
# → 輸入 AIOneGate 的 API Key

# Step 3: ~/.config/opencode/opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "aionegate": {
      "npm": "@ai-sdk/anthropic",
      "name": "AIOneGate",
      "options": { "baseURL": "你的AIOneGate地址/v1" },
      "models": {
        "claude-opus-4-6": { "name": "claude opus 4.6" },
        "claude-sonnet-4-5": { "name": "claude-sonnet-4-5" }
      }
    },
    "aionegate-gpt": {
      "npm": "@ai-sdk/openai",
      "name": "AIOneGate-GPT",
      "options": {
        "baseURL": "你的AIOneGate地址/v1",
        "apiKey": "sk-your-gpt-api-key"
      },
      "models": {
        "gpt-5.3-codex": { "name": "gpt-5.3-codex" },
        "gpt-5.3-codex-spark": { "name": "gpt-5.3-codex-spark" }
      }
    }
  }
}

# Step 4: 啟動
opencode

CodeX 快速接入

1

安裝 CodeX

終端版 npm 安裝,或 VS Code / Cursor 插件版

2

打開 cc-switch

使用一鍵配置工具 cc-switch

3

填寫配置信息

填入 API Key 和 AIOneGate 地址

4

重啟並使用

重啟終端後執行 codex

CodeX 配置
# Step 1: 安裝(終端版)
npm install -g @openai/codex

# Step 2: 一鍵配置工具 cc-switch
# https://github.com/farion1231/cc-switch

# Step 3: 獲取 API Key
# 1. 訪問 AIOneGate 註冊
# 2. 兌換額度:/console/topup
# 3. 創建令牌:/console/token
# 4. 在 cc-switch 中填入配置

# Step 4: 重啟終端後啟動
codex

OpenClaw 快速接入

1

安裝 OpenClaw

Node.js ≥ 22,npm install -g openclaw@latest

2

初始化配置

openclaw onboard --install-daemon → Custom Provider

3

獲取 API Key

AIOneGate 控制台,cc7 或 cc5 分組

4

優化配置文件

設置 contextWindow:200000, maxTokens:8192

OpenClaw 配置
# Step 1: 安裝 OpenClaw
npm install -g openclaw@latest

# Step 2: 初始化
openclaw onboard --install-daemon

# 配置選項:
# - Onboarding mode: 選第一個
# - Model/auth provider: Custom Provider
#   (Any OpenAI or Anthropic compatible endpoint)
# - API Base URL: 你的AIOneGate地址/v1
# - Endpoint compatibility: Anthropic-compatible
# - Model ID: claude-opus-4-6-thinking

# Step 3: 優化 ~/.openclaw/openclaw.json
{
  "models": {
    "providers": {
      "custom-aionegate": {
        "baseUrl": "你的AIOneGate地址",
        "apiKey": "sk-your-api-key",
        "api": "anthropic-messages",
        "models": [{
          "id": "claude-opus-4-6-thinking",
          "contextWindow": 200000,
          "maxTokens": 8192
        }]
      }
    }
  }
}

Cherry Studio 快速接入

1

下載 Cherry Studio

官網下載,支持 Win / Mac / Linux

2

獲取 API Key

Claude → cc7 分組,GPT → gpt 分組

3

配置服務商

端點類型選 OpenAI-Response

Cherry Studio 配置
# Step 1: 下載安裝
# https://www.cherry-ai.com/download

# Step 2: 獲取 API Key
# AIOneGate 控制台創建令牌
# Claude 模型 → 選 cc7 分組
# GPT 模型 → 選 gpt 分組

# Step 3: Cherry Studio 設置
API 地址: 你的AIOneGate地址
API Key: sk-your-api-key
端點類型: OpenAI-Response

Claude Code 完整教程

⏱ 閱讀時間約 10 分鐘 📅 2025

什麼是 Claude Code?

Claude Code 是 Anthropic 官方推出的終端原生 AI 編碼助手,可直接在命令行中完成複雜的軟件工程任務。

🧠
智能代碼理解
深度理解整個代碼庫的結構、依賴和上下文
💬
自然語言交互
用自然語言描述需求,自動完成代碼修改
⌨️
終端原生體驗
無需離開終端,seamlessly 整合開發工作流
📂
多文件編輯
跨多文件同步修改,保持代碼一致性

效率對比

場景傳統方式使用 Claude Code
重構函數手動逐行修改,30+ 分鐘自然語言描述,2 分鐘完成
添加單元測試手寫模板,反覆調試一句話生成完整測試套件
代碼審查人工逐行閱讀秒級發現潛在問題和改進點

支持環境與系統要求

macOS Linux Windows (WSL) VS Code JetBrains IDEs
  • Node.js 18 或更高版本
  • npm 或 yarn 包管理器
  • 有效的 AIOneGate API Key
  • 穩定的網絡連接

安裝步驟

推薦使用 cc-switch 一鍵完成所有配置

cc-switch →

手動安裝步驟:

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

API 配置

1. 獲取 API Token

訪問 AIOneGate 控制台,在令牌管理頁面創建新令牌。

2. 配置 settings.json

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-your-api-key",
    "ANTHROPIC_BASE_URL": "你的AIOneGate地址",
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "64000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "permissions": { "allow": [], "deny": [] },
  "alwaysThinkingEnabled": false
}

3. 配置 .claude.json

{ "hasCompletedOnboarding": true }
Tip設置 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 可關閉遙測,節省 token 用量。

基本使用方法

在項目目錄中執行 claude 即可啟動,然後用自然語言描述你要做的事情。

cd your-project
claude
# 然後輸入指令,例如:
# "幫我重構 utils.ts,把所有工具函數拆分到獨立文件"

常用命令參考

命令說明
/help顯示所有可用命令
/clear清除當前對話上下文
/compact壓縮上下文以節省 token
/config查看或修改配置
/cost查看本次會話的 token 用量
/exit退出 Claude Code

MCP 協議

Claude Code 支持 MCP,可在項目根目錄創建 .mcp.json 擴展工具能力:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/project"]
    }
  }
}

高級技巧

在項目根目錄創建 CLAUDE.md,為 Claude Code 提供項目上下文和指令:

# CLAUDE.md
## 項目說明
這是一個 React + TypeScript 項目。

## 編碼規範
- 使用 ESLint + Prettier
- 組件使用函數式寫法
- 狀態管理使用 Zustand

## 禁止事項
- 不要修改 config/ 目錄下的文件
- 不要直接操作數據庫

VS Code 插件

在 VS Code 擴展市場搜索 Claude Code 安裝,可在 IDE 內直接使用,無需切換終端。

使用心得 & 常見問題

Q: 提示 API Key 無效怎麼辦?
檢查 settings.json 中 ANTHROPIC_AUTH_TOKEN 的值,確保 API Key 前綴為 sk- 且沒有多餘空格。同時確認 AIOneGate 地址末尾不帶斜杠。
Q: 如何限制 Claude Code 只讀不寫?
在 permissions.deny 中添加 Bash(write) 即可。
Q: token 消耗太快怎麼辦?
設置 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1;定期 /compact;在 CLAUDE.md 限定工作範圍。

參考連結

Roo Code 完整教程

⏱ 閱讀時間約 6 分鐘📅 2025

什麼是 Roo Code?

Roo Code 是一款強大的 VS Code AI 編碼插件,支持多種 AI 模型,深度整合在編輯器側邊欄中。

🔌
VS Code 原生整合
無縫嵌入編輯器,無需切換窗口
🤖
多模型支持
支持 Anthropic、OpenAI、本地模型等
🛠️
自動化工具調用
自動讀寫文件、執行命令、搜索代碼庫
💡
上下文感知
理解整個項目結構,提供精準建議

安裝插件

在 VS Code 擴展市場搜索 Roo Code 並點擊安裝,安裝完成後在側邊欄會出現 Roo Code 圖標。

API 配置

點擊 Roo Code 側邊欄,進入設置,按以下步驟配置:

  1. API Provider 選擇 Anthropic
  2. 填入 AIOneGate API Key(sk- 開頭)
  3. 分組選 cc5 或 cc7
  4. 勾選 Use custom base URL,填入 AIOneGate 地址
重要:以下兩項絕對不要勾選Send as Anthropic header 和 Enable 1M context 這兩項必須保持不勾選,否則請求會失敗。
API Provider: Anthropic
API Key: sk-your-api-key
Use custom base URL: ✅ 勾選
Base URL: 你的AIOneGate地址
Model: claude-opus-4-6

Send as Anthropic header: ❌ 不勾選
Enable 1M context: ❌ 不勾選

基本使用方法

打開側邊欄 Roo Code 面板,用自然語言描述需求。選中代碼後右鍵可使用 Roo Code 操作。

使用技巧 & 常見問題

Q: 選模型時應選 cc5 還是 cc7?
cc7 是較新分組,推薦優先使用;cc5 作備用。
Q: 為什麼不能勾選 Anthropic 標頭?
勾選後會發送 Anthropic 認證標頭,與 AIOneGate API Key 認證衝突,導致 401 錯誤。

OpenCode 完整教程

⏱ 閱讀時間約 6 分鐘📅 2025

什麼是 OpenCode?

OpenCode 是完全開源的終端 AI 編碼助手,支持多模型切換,提供交互式終端界面並整合 LSP。

🆓
完全開源免費
MIT 協議開源,無訂閱費用
🔄
多模型自由切換
支持多個 AI 提供商,自由切換
🖥️
交互式終端界面
美觀的 TUI 界面,操作直觀流暢
📝
LSP 集成
整合 LSP,提供補全和診斷

安裝方式

方式一:安裝腳本

curl -fsSL https://opencode.ai/install | bash

方式二:npm

npm i -g opencode-ai@latest

方式三:Homebrew(macOS)

brew install opencode

API 配置

Step 1:註冊服務商

opencode auth login
# → 選擇 other
# → 輸入 Provider ID: aionegate
# → 輸入 AIOneGate 的 API Key

Step 2:編輯配置文件

編輯 ~/.config/opencode/opencode.json,添加 AIOneGate 提供商配置。

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "aionegate": {
      "npm": "@ai-sdk/anthropic",
      "name": "AIOneGate",
      "options": { "baseURL": "你的AIOneGate地址/v1" },
      "models": {
        "claude-opus-4-6": { "name": "claude opus 4.6" },
        "claude-sonnet-4-5": { "name": "claude-sonnet-4-5" }
      }
    }
  }
}

Step 3:獲取 API Token

訪問 AIOneGate 控制台,在令牌管理頁面創建新令牌。

TipGPT 模型使用 @ai-sdk/openai 並添加 apiKey;Claude 模型使用 @ai-sdk/anthropic。

基本使用方法

在項目目錄執行 opencode,/models 切換模型,自然語言描述任務。

cd your-project
opencode
# 輸入 /models 選擇模型
# 然後描述任務:
# "分析這個項目的代碼結構並生成文檔"

使用技巧 & 常見問題

Q: 配置文件在哪裡?
Linux/macOS: ~/.config/opencode/opencode.json;Windows: %APPDATA%\opencode\opencode.json
Q: 如何同時配置 Claude 和 GPT 模型?
在 provider 中添加兩個條目,分別使用 @ai-sdk/anthropic 和 @ai-sdk/openai。

CodeX 完整教程

⏱ 閱讀時間約 5 分鐘📅 2025

什麼是 CodeX?

CodeX 是 OpenAI 推出的 AI 編碼助手,由 GPT-5.3 驅動,支持終端和 IDE 插件兩種形態。

GPT-5.3 驅動
使用最新 GPT-5.3-Codex,代碼能力突出
🌐
多語言支持
支持幾乎所有主流編程語言
🔒
沙箱執行
在隔離沙箱環境中安全執行代碼
🔀
雙形態運行
CLI 終端版和 VS Code / Cursor 插件版

安裝方式

CLI 版(終端)

npm install -g @openai/codex

VS Code / Cursor 插件版

在 VS Code 或 Cursor 擴展市場搜索 CodeX 並安裝。

一鍵配置(cc-switch)

推薦使用 cc-switch 工具完成所有配置。

  1. 訪問 cc-switch
  2. 在 AIOneGate 控制台獲取 API Key(/console/token)
  3. 在 cc-switch 中填入 API Key 和 AIOneGate 地址
Tip兌換額度:/console/topup;創建令牌:/console/token。

基本使用方法

重啟終端後執行 codex,在對話中描述需求。

codex
# 示例:
# "用 TypeScript 寫一個 REST API 服務器"
# "幫我優化這段排序算法"

常用命令

命令說明
codex啟動交互式對話
codex "描述任務"直接執行單次任務
codex --help查看幫助信息
codex --model gpt-5.3-codex指定使用的模型

OpenClaw 完整教程

⏱ 閱讀時間約 6 分鐘📅 2025

什麼是 OpenClaw?

OpenClaw 是一款終端 AI 編碼工具,提供 Web UI 界面,支持多模型和插件系統,高度可配置。

🌐
Web UI 界面
終端啟動後可在瀏覽器中操作
🤖
多模型支持
同時配置多個 AI 提供商和模型
🔧
插件系統
豐富插件生態,擴展功能強大
⚙️
高度可配置
JSON 配置,細粒度控制模型參數

安裝步驟

前置要求需要 Node.js 22 或更高版本。請先確認:node --version
npm install -g openclaw@latest

配置說明

Step 1:初始化

openclaw onboard --install-daemon

Step 2:配置向導選項

  • Onboarding mode:選第一個選項
  • Model/auth provider:選 Custom Provider
  • API Base URL:你的AIOneGate地址/v1
  • Endpoint compatibility:Anthropic-compatible
  • Model ID:claude-opus-4-6-thinking

Step 3:獲取 API Key

訪問 AIOneGate 控制台,使用 cc7 或 cc5 分組創建令牌。

Step 4:優化配置文件

編輯 ~/.openclaw/openclaw.json

{
  "models": {
    "providers": {
      "custom-aionegate": {
        "baseUrl": "你的AIOneGate地址",
        "apiKey": "sk-your-api-key",
        "api": "anthropic-messages",
        "models": [{
          "id": "claude-opus-4-6-thinking",
          "contextWindow": 200000,
          "maxTokens": 8192
        }]
      }
    }
  }
}

基本使用

配置完成後執行 openclaw 啟動,瀏覽器自動打開 Web UI,描述任務即可。

openclaw
# 瀏覽器將自動打開 Web UI
# 在對話框中描述你的任務
Tip設置 contextWindow:200000 可充分利用 Claude 的長上下文能力。

Cherry Studio 完整教程

⏱ 閱讀時間約 5 分鐘📅 2025

什麼是 Cherry Studio?

Cherry Studio 是一款跨平台桌面 AI 對話應用,支持多模型切換,圖形化配置,適合非開發者使用。

🖥️
桌面原生應用
支持 Windows、macOS、Linux
🔄
多模型切換
在對話中隨時切換 AI 模型
🎨
圖形化配置
無需編輯配置文件,界面直觀
💬
對話管理
多對話管理,支持搜索和導出

下載安裝

訪問官網下載:https://www.cherry-ai.com/download

Windows macOS Linux

API 配置

Step 1:獲取 API Key

訪問 AIOneGate 控制台,在令牌管理頁面創建令牌。

Step 2:配置 Claude 模型

使用 cc7 分組令牌,填入 API 地址和 Key。

Step 3:配置 GPT 模型

使用 gpt 分組令牌,填入對應 API 地址和 Key。

Step 4:設置端點類型

端點類型選擇 OpenAI-Response。

Tip端點類型選 OpenAI-Response 而非 OpenAI,否則可能出現格式不兼容問題。
API 地址: 你的AIOneGate地址
API Key: sk-your-api-key
端點類型: OpenAI-Response

基本使用方法

打開 Cherry Studio,選擇服務商,新建對話,描述需求。支持 Markdown 渲染和代碼高亮。

使用技巧 & 常見問題

Q: 連接失敗怎麼辦?
確認 API 地址末尾不帶斜杠,端點類型選 OpenAI-Response,API Key 格式正確。
Q: Claude 和 GPT 需要分別配置嗎?
建議分別創建兩個服務商配置:Claude 用 cc7 令牌,GPT 用 gpt 令牌。