LINKAGI QUICK START

LinkAGI 简明使用教程

先注册并创建一个 API Key,再选择你要使用的工具。大多数用户只需要看“快速开始”和对应工具的一节。

最后更新:2026-07-16

01

快速开始

所有工具都先完成下面 3 步。

  1. 1
    注册账号

    使用邮箱注册并完成邮箱验证码验证。

    去注册
  2. 2
    创建 API Key

    登录控制台,进入“令牌管理”,点击“添加令牌”。

    令牌管理
  3. 3
    选择令牌分组

    选择与你要使用的工具或模型对应的分组,然后复制 sk-...

    下一步
在 LinkAGI 控制台进入令牌管理并添加令牌
进入“令牌管理”,点击“添加令牌”。
创建 LinkAGI API Key 并选择令牌分组
填写名称、选择对应分组并提交,然后复制生成的 API Key。
Claude Code / Anthropic https://api.linktoagi.com
Codex / OpenAI 客户端 https://api.linktoagi.com/v1
Gemini CLI https://api.linktoagi.com

02

选择你要使用的工具

更省事
不想手动修改配置文件?

使用 CC Switch 图形化配置 Codex、Claude Code 和 Gemini CLI。

查看快速配置 →

03

使用 CC Switch 快速配置

可选方式。适合不想手动查找和编辑配置文件的用户。

怎么选:首次使用可以优先尝试 CC Switch;如果安装受限、配置未生效或你更习惯命令行,直接使用后面的手动配置。

1下载并安装

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

  • macOS:选择名称中带 macOS 的安装包。
  • Windows:选择名称中带 Windows 的安装包。
  • Linux:根据系统选择 AppImage.deb.rpm
在 GitHub Releases 中选择 CC Switch 的 macOS 或 Windows 安装包
截图中的版本号仅作示例,请下载页面上的最新版本。

2选择工具并添加提供方

打开 CC Switch,在顶部选择 CodexClaudeGemini,点击右上角“+”,然后选择“自定义配置”。

3填写 LinkAGI 配置

提供方名称填写 LinkAGI,API Key 填写控制台创建的 sk-...。API 地址按工具填写:

CC Switch 顶部工具API 地址模型
Codexhttps://api.linktoagi.com/v1控制台中的 OpenAI / Codex 模型名
Claudehttps://api.linktoagi.com控制台中的 Claude 模型名
Geminihttps://api.linktoagi.com控制台中的 Gemini 模型名

4保存并启用

保存后回到对应工具页面,点击刚创建的 LinkAGI 提供方并启用。完全关闭后重新打开 Codex、Claude Code 或 Gemini CLI,再进行第一次调用。

验证方法:工具能够正常回复,并且 LinkAGI 控制台“使用日志”出现对应请求,即表示配置成功。

04

Codex

不需要登录 ChatGPT 账号,配置 LinkAGI API Key 后直接使用。

1安装 Codex CLI

已经安装 Node.js 的用户,在终端运行:

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

没有 Node.js?先从 Node.js 官网安装 LTS 版本,再重新运行上面的命令。

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"
模型名称:如果控制台显示的可用模型不是 gpt-5.4,请把 model 改成控制台中的实际模型名。

3设置 API Key

macOS / Linux / WSL展开命令
export LINKAGI_API_KEY="sk-替换成你创建的API Key"

需要长期生效时,将同一行加入 ~/.zshrc~/.bashrc

Windows PowerShell展开命令
[Environment]::SetEnvironmentVariable(
  "LINKAGI_API_KEY",
  "sk-替换成你创建的API Key",
  "User"
)

设置后完全关闭并重新打开 PowerShell、VS Code 或 Cursor。

4启动并验证

cd 你的项目目录
codex

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

看到 ChatGPT 登录页面?通常是配置文件路径或环境变量没有被读取。检查后完全重开终端,不要执行 codex login

05

Claude Code

安装官方 CLI,再用一个配置文件接入 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 扩展。修改配置后请完全重启编辑器。

在 VS Code 或 Cursor 中安装 Claude Code 扩展

06

Gemini CLI

安装 CLI,填写 API 地址和 Key,然后启动。

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
出现 401:先确认 Key、余额和模型名;仍然报错时,在 Gemini CLI 中输入 /auth,选择 Gemini API Key 后重新填写。

07

Cherry Studio 等客户端

支持自定义 API 地址的客户端,一般只需要填写 3 项。

配置项填写内容
提供方OpenAI 或 OpenAI-compatible
API 地址https://api.linktoagi.com/v1
API Key控制台创建的 sk-...
模型选择或填写控制台显示的可用模型名
在第三方客户端中填写 LinkAGI API 地址和 API Key
示例:开启自定义提供方,填写 API Key 和 https://api.linktoagi.com/v1
使用 Anthropic / Claude 类型的客户端地址不同

提供方选择 Anthropic 时,API 地址通常填写 https://api.linktoagi.com,不要在末尾添加 /v1

08

常见问题

需要 ChatGPT、Claude 或 Google 账号登录吗?

不需要。使用 LinkAGI 控制台创建的 API Key,并按上面的配置接入即可。

为什么返回 401 / Unauthorized?

检查 API Key 是否完整、是否有多余空格、令牌是否启用,以及账户余额是否充足。

为什么返回 404 或模型不存在?

Codex 和 OpenAI 客户端地址应使用 https://api.linktoagi.com/v1;Claude Code 和 Gemini CLI 使用不带 /v1 的地址。模型名必须与控制台显示一致。

CLI 可以使用,VS Code / Cursor 不可以?

修改环境变量或配置文件后,完全退出并重新打开编辑器。Windows 原生环境与 WSL 是两套独立配置,需要分别设置。

在哪里查看调用和扣费?

登录 LinkAGI 控制台,打开“使用日志”查看每次请求的模型、Token 和费用记录。

需要 WSL、MCP、IDE、提示词或更完整的排障内容?

简明教程只保留首次接入所需步骤,原有详细内容已经整理到完整教程。

查看完整教程

09

联系支持

问题反馈、商务咨询、企业技术支持。

配置仍未成功?

请准备好使用的工具名称、报错截图和 API 地址,通过关于与支持页面联系客服。

LinkAGI 客服微信二维码