LinkAGI 简明使用教程

1下载并安装

打开 CC Switch Releases，下载与你系统匹配的最新版本：

• macOS：选择名称中带 macOS 的安装包。
• Windows：选择名称中带 Windows 的安装包。
• Linux：根据系统选择 AppImage、.deb 或 .rpm。

2选择工具并添加提供方

打开 CC Switch，在顶部选择 Codex、Claude 或 Gemini，点击右上角“+”，然后选择“自定义配置”。

3填写 LinkAGI 配置

先在下方选择要配置的工具，再逐项填写。提供方名称统一填写 LinkAGI，API Key 使用控制台创建的 sk-...。

4保存并启用

保存后回到对应工具页面，在 LinkAGI 提供方右侧点击“启用”。完全关闭并重新打开 Codex、Claude Code 或 Gemini CLI，再进行第一次调用。

1安装 Codex CLI

已经安装 Node.js 的用户，在终端运行：

npm install -g @openai/codex
codex --version

喜欢图形界面也可以下载 Codex 桌面版；LinkAGI 的自定义提供方仍通过同一份 ~/.codex/config.toml 配置。

2创建配置文件

macOS、Linux：~/.codex/config.toml；Windows：%USERPROFILE%\.codex\config.toml。

model_provider = "linkagi"
model = "gpt-5.4"
model_reasoning_effort = "high"

[model_providers.linkagi]
name = "LinkAGI"
base_url = "https://api.linktoagi.com/v1"
wire_api = "responses"
env_key = "LINKAGI_API_KEY"

3设置 API Key

export LINKAGI_API_KEY="sk-替换成你创建的API Key"

[Environment]::SetEnvironmentVariable(
  "LINKAGI_API_KEY",
  "sk-替换成你创建的API Key",
  "User"
)

4启动并验证

cd 你的项目目录
codex

进入 Codex 后输入 /status，确认提供方是 linkagi，然后直接开始提问。

1安装 Claude Code

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

2创建配置文件

macOS、Linux：~/.claude/settings.json；Windows：%USERPROFILE%\.claude\settings.json。

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-替换成你创建的API Key",
    "ANTHROPIC_BASE_URL": "https://api.linktoagi.com",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

3启动

cd 你的项目目录
claude

首次提问成功，并且控制台“使用日志”出现记录，即表示配置完成。

在 VS Code / Cursor 中使用可选

在扩展商店搜索并安装发布者为 Anthropic 的 Claude Code 扩展。修改配置后请完全重启编辑器。

1安装 Gemini CLI

npm install -g @google/gemini-cli
gemini --version

2填写环境配置

创建或编辑 ~/.gemini/.env：

GOOGLE_GEMINI_BASE_URL="https://api.linktoagi.com"
GEMINI_API_KEY="sk-替换成你创建的API Key"
GEMINI_MODEL="gemini-3-pro-preview"

再创建或编辑 ~/.gemini/settings.json：

{
  "ide": {
    "enabled": true
  },
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}

3启动

cd 你的项目目录
gemini