跳到主要内容
快速上手API 参考接入与支持
工具接入

编程工具接入指南

本文只写已经复核过的配置规则。不要把所有编程工具都当成同一种协议来填地址。

编程工具接入指南

本文只写已经复核过的配置规则。不要把所有编程工具都当成同一种协议来填地址。

这类工具大多按 OpenAI Chat Completions 的 choices 结构读取返回。

所以 OpenAI 兼容工具的第一条测试请求，统一建议先用 claude-sonnet-4-6。

接入前准备​

  1. 登录控制台：https://anideaai.com/console
  2. 在「令牌」页面创建 API Key（示例：sk-xxxxx）
  3. 准备可用模型名（建议先调用 GET https://anideaai.com/v1/models 查看）

先分清 4 类​

截至 2026 年 3 月 8 日，按官方资料核对后，可分成下面 4 类：

  • OpenAI 兼容工具：直接填 https://anideaai.com/v1
    • Continue、Cline 的 OpenAI 兼容方式、Aider、avante.nvim
  • Anthropic 协议工具：填根地址 https://anideaai.com
    • Claude Code
  • 需要自定义 provider 配置，不是只改一个环境变量
    • Codex CLI
  • 官方文档没有给出“通用自定义网关”入口
    • Cursor、Windsurf

工具速查表​

工具当前建议地址写法说明
Continue推荐https://anideaai.com/v1OpenAI 兼容
Cline推荐https://anideaai.com/v1选择 OpenAI 兼容提供方
Claude Code推荐https://anideaai.com不要手动把 /v1 填进 ANTHROPIC_BASE_URL
Codex CLI可用base_url = "https://anideaai.com/v1"走 config.toml 自定义 provider
Aider推荐https://anideaai.com/v1模型名前面要带 openai/
avante.nvim推荐https://anideaai.com/v1OpenAI provider 的 endpoint
Cursor不建议写进本页直连方案-官方文档当前只写官方 provider / BYOK
Windsurf不建议写进本页直连方案-官方文档当前只写官方 provider / BYOK

Continue（VSCode 插件）​

  1. 打开 Continue 当前使用的配置文件
  2. 新版通常使用 config.yaml，可写成：
models:
  - name: AnideaAI GPT
    provider: openai
    model: claude-sonnet-4-6
    apiBase: https://anideaai.com/v1
    apiKey: sk-xxxxx
  1. 重启 Continue，并发起一次简单问答

常见问题：

  • 配置不生效：先确认你改的是当前生效的配置文件
  • 返回模型不可用：改为你账号已开通的模型名

Cline（VSCode 插件）​

  1. 安装并打开 Cline
  2. 选择 OpenAI 兼容提供方
  3. 填写：
    • OpenAI API Key = sk-xxxxx
    • OpenAI Base URL = https://anideaai.com/v1
    • Model = claude-sonnet-4-6 或其他可用模型
  4. 发送一条“读取当前项目结构”验证

常见问题：

  • 报 404：通常是地址漏了 /v1
  • 工具调用失败：先关闭高级工具调用再重试

Claude Code​

Claude Code 走的是 Anthropic 协议。它会自己请求 messages 接口，所以这里要填根地址，不要直接把 /v1 填进去。

export ANTHROPIC_BASE_URL="https://anideaai.com"
export ANTHROPIC_AUTH_TOKEN="sk-xxxxx"
export ANTHROPIC_MODEL="claude-sonnet-4-6"

主站快速开始里的完整分系统教程，已经拆到单独文档页：Claude Code 接入指南。

常见问题：

  • 报路径错误：先检查是不是把 ANTHROPIC_BASE_URL 错填成了 https://anideaai.com/v1
  • 报模型不存在：先在 GET /v1/models 里确认模型名

Codex CLI​

Codex CLI 官方文档支持自定义 provider，但方式是写 ~/.codex/config.toml，不是直接在本页里写死 OPENAI_BASE_URL。

示例：

model = "gpt-5.3-codex"
model_provider = "anideaai"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"
network_access = "enabled"
model_verbosity = "high"

[model_providers.anideaai]
name = "AnideaAI"
base_url = "https://anideaai.com/v1"
wire_api = "responses"
env_key = "ANIDEAAI_OAI_KEY"

然后在 shell 里设置：

export ANIDEAAI_OAI_KEY="sk-xxxxx"

主站快速开始里的完整分系统教程，已经拆到单独文档页：Codex CLI 接入指南。

常见问题：

  • CLI 仍连默认地址：检查 model_provider 是否切到了 anideaai
  • ANIDEAAI_OAI_KEY 不生效：检查是不是误加了 requires_openai_auth = true
  • 返回 401：确认 ANIDEAAI_OAI_KEY 已导出，且值没有空格

Aider​

  1. 安装并进入项目目录
  2. 用 OpenAI 兼容参数指定网关。注意模型名前面要带 openai/：
aider --model openai/claude-sonnet-4-6 \
  --openai-api-key sk-xxxxx \
  --openai-api-base https://anideaai.com/v1
  1. 让 Aider 读取一个文件并生成修改建议

常见问题：

  • Aider 直接去找 Anthropic Key：通常是模型名前面漏了 openai/
  • 上下文过大：缩小一次编辑的文件范围

avante.nvim​

  1. 在 Neovim 插件配置里使用内置 openai provider
  2. 示例：
return {
  provider = "openai",
  openai = {
    endpoint = "https://anideaai.com/v1",
    model = "claude-sonnet-4-6",
    api_key_name = "ANIDEAAI_API_KEY",
  },
}
  1. 在 shell 中导出密钥：export ANIDEAAI_API_KEY=sk-xxxxx
  2. 重启 Neovim，触发一次对话或补全

常见问题：

  • 无响应：确认插件读取到了环境变量
  • 报 TLS 错误：检查本机代理或证书设置

Cursor（当前不作为直连方案）​

  • Cursor 官方文档当前公开的是官方 provider API Key / BYOK 路线，没有给出通用自定义网关的稳定配置方式。
  • 为避免误导，本页不再把 Cursor 写成“直接填 AnideaAI Base URL 就能用”。
  • 如果你想在 VSCode / Cursor 类场景里直连 AnideaAI，建议优先改用 Continue 或 Cline。

Windsurf（当前不作为直连方案）​

  • Windsurf 官方文档当前公开的是指定模型的 BYOK 路线，没有给出通用自定义网关的稳定配置方式。
  • 为避免误导，本页不再把 Windsurf 写成“直接填 AnideaAI Base URL 就能用”。
  • 如果你的目标是把编程助手直接接到 AnideaAI，建议优先改用 Continue、Cline、Aider、Claude Code 或 Codex CLI。

GitHub Copilot（限制说明）​

  • 官方 Copilot 当前以 GitHub 账户体系为主，不提供通用自定义 API 网关入口。
  • 如需接入 AnideaAI，建议改用 Continue、Cline、Aider、Claude Code 或 Codex CLI。

Roo Code（暂不写死字段名）​

  • Roo Code 的版本变化较快，公开资料里可稳定检索到的是“支持 OpenAI Compatible provider”，但当前字段名称和设置入口不如前几项稳定。
  • 为避免把界面字段名写错，本页暂不写死具体点击路径。
  • 如果你的版本里明确有 OpenAI 兼容提供方，再按 https://anideaai.com/v1、sk-xxxxx、模型名这 3 个值填写。

推荐排障顺序​

  1. 先确认你用的是哪一类工具，不要默认所有工具都填 /v1
  2. 再检查 Key 是否有效
  3. 然后确认模型名是否在 GET /v1/models 里存在
  4. 最后再看客户端版本是否过旧
这页有帮助吗？
本页目录