# 推荐使用 Homebrew 安装
brew install node

# 或使用 nvm（Node 版本管理器）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
nvm install 20
nvm use 20

# Ubuntu / Debian
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# 或使用 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
nvm install 20 && nvm use 20

# 方式一：winget（推荐）
winget install OpenJS.NodeJS.LTS

# 方式二：从官网下载安装包
# https://nodejs.org/en/download → 选 Windows Installer (.msi)

验证 Node.js 版本

node --version   # 输出 v18.x 或更高即可
npm --version

📦 安装 Claude Code

BASH

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

# 验证安装
claude --version

⚙️ 配置 aioncode

# 追加到 ~/.zshrc（macOS 默认 shell）
echo 'export ANTHROPIC_BASE_URL="https://api.aioncode.com"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="sk-your-aioncode-key"' >> ~/.zshrc
source ~/.zshrc

# 追加到 ~/.bashrc
echo 'export ANTHROPIC_BASE_URL="https://api.aioncode.com"' >> ~/.bashrc
echo 'export ANTHROPIC_API_KEY="sk-your-aioncode-key"' >> ~/.bashrc
source ~/.bashrc

# PowerShell — 写入当前用户环境变量（永久生效）
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.aioncode.com", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-your-aioncode-key", "User")

# 重新打开终端后生效，或当前会话临时生效：
$env:ANTHROPIC_BASE_URL = "https://api.aioncode.com"
$env:ANTHROPIC_API_KEY  = "sk-your-aioncode-key"

💡

也可以每次启动时临时指定（macOS/Linux）：
ANTHROPIC_BASE_URL=https://api.aioncode.com ANTHROPIC_API_KEY=sk-xxx claude

🚀 基本使用

BASH

# 在项目目录下启动
cd your-project
claude

# 直接传入任务（非交互模式）
claude -p "帮我写一个 Python 爬虫"

# 指定模型
claude --model claude-opus-4-7

✅

首次运行 claude 时如果提示登录，直接按 Enter 跳过，环境变量中的 Key 会自动生效。

🐟 Fish Shell 配置（Linux/macOS）

如果你使用 Fish shell，环境变量语法略有不同：

FISH

# 永久写入 Fish 配置
echo 'set -x ANTHROPIC_BASE_URL "https://api.aioncode.com"' >> ~/.config/fish/config.fish
echo 'set -x ANTHROPIC_API_KEY "sk-your-aioncode-key"' >> ~/.config/fish/config.fish
source ~/.config/fish/config.fish

🖥️ Windows 图形界面设置环境变量

不习惯命令行的用户可通过系统界面永久设置：

1

右键「此电脑」→「属性」→「高级系统设置」→「环境变量」

2

在「用户变量」区域点击「新建」，分别添加两个变量：
变量名 ANTHROPIC_BASE_URL，值 https://api.aioncode.com
变量名 ANTHROPIC_API_KEY，值填入你的 Key

3

点击「确定」保存，重新打开 PowerShell 后生效。

✅ 验证环境变量生效

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_API_KEY

# PowerShell
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_API_KEY

❓ 常见问题

⚠️

提示找不到 claude 命令
重新打开终端窗口，或运行 source ~/.zshrc（macOS）/ source ~/.bashrc（Linux）。Windows 用户重启 PowerShell。

⚠️

权限错误（EACCES）
不要用 sudo，改用 nvm 管理 Node.js，或执行 npm config set prefix ~/.npm-global 后将 ~/.npm-global/bin 加入 PATH。

⚠️

杀毒软件误报（Windows）
某些杀毒软件会拦截 Claude Code 的文件操作。在杀毒软件中将 Claude Code 安装目录加入白名单即可。

🤖 AI 编程工具

OpenAI Codex CLI

OpenAI 出品的终端编程助手，轻量级交互，支持多种 GPT 和 o 系列模型，可在终端内完成代码生成、解释、调试等任务。

⚠️

Windows 兼容性提示
Codex CLI 在原生 Windows 上可能遇到兼容性问题。如果遇到异常，强烈建议在 WSL（Windows Subsystem for Linux） 环境中使用。
安装 WSL →，安装后按 Linux 标签操作即可。

📥 安装 Node.js 22+

Codex CLI 要求 Node.js 22 或以上，选择你的操作系统：

brew install node@22
# 或通过 nvm
nvm install 22 && nvm use 22

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

winget install OpenJS.NodeJS   # 安装最新 LTS（当前 22.x）

📦 安装 Codex CLI

BASH

npm install -g @openai/codex

# 验证安装
codex -V

⚙️ 配置 aioncode（推荐：配置文件方式）

Codex CLI 通过 ~/.codex/ 目录下的两个文件管理 API 凭证和 Provider，比环境变量更稳定。

步骤一：创建 auth.json（存放 Key）

mkdir -p ~/.codex
cat > ~/.codex/auth.json << 'EOF'
{
  "OPENAI_API_KEY": "sk-your-aioncode-key"
}
EOF

# 创建目录
New-Item -Path "$env:USERPROFILE\.codex" -ItemType Directory -Force

# 写入 auth.json（无 BOM 的 UTF-8）
$content = @"
{
  "OPENAI_API_KEY": "sk-your-aioncode-key"
}
"@
[System.IO.File]::WriteAllText(
  "$env:USERPROFILE\.codex\auth.json",
  $content,
  [System.Text.UTF8Encoding]::new($false)
)

步骤二：创建 config.toml（配置 Provider）

cat > ~/.codex/config.toml << 'EOF'
model_provider = "aioncode"
model = "gpt-4o"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.aioncode]
name = "aioncode"
base_url = "https://api.aioncode.com/v1"
wire_api = "responses"
EOF

$content = @"
model_provider = "aioncode"
model = "gpt-4o"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.aioncode]
name = "aioncode"
base_url = "https://api.aioncode.com/v1"
wire_api = "responses"
"@
[System.IO.File]::WriteAllText(
  "$env:USERPROFILE\.codex\config.toml",
  $content,
  [System.Text.UTF8Encoding]::new($false)
)

💡

将 auth.json 中的 sk-your-aioncode-key 替换为你在 aioncode 后台创建的实际 Key。

🚀 基本使用

BASH

# 交互模式
codex

# 直接执行任务
codex "解释这段代码的作用"

# 完全自动模式（谨慎使用，会自动执行命令）
codex --approval-mode full-auto "添加单元测试"

❓ 常见问题

⚠️

Windows 上运行报错或无法启动
原生 Windows 支持不完善，请改用 WSL（Windows Subsystem for Linux）环境运行。

⚠️

config.toml 中 wire_api 的含义
wire_api = "responses" 表示使用 OpenAI Responses API 格式（/v1/responses），这是 Codex CLI 默认使用的端点，aioncode 完全兼容此格式。

🖱️ AI 编程工具

Cursor

基于 VS Code 的 AI 原生代码编辑器，提供 Tab 补全、Chat、Composer 等功能，通过自定义 API 接入 aioncode 可大幅降低使用成本。

📥 安装 Cursor

访问 cursor.com 下载适合你系统的安装包（支持 macOS / Windows / Linux）。

⚙️ 配置 aioncode

1

打开设置

点击右上角头像 → Settings → 左侧选择 Models（或使用快捷键 ⌘ ,）

2

填写 API 配置

在 OpenAI API Key 或 Anthropic API Key 处填入你的 aioncode Key。

然后展开「Override OpenAI Base URL」，填入：

https://api.aioncode.com/v1

3

选择模型

在模型下拉列表中选择你需要的模型，或在输入框手动输入 aioncode 支持的模型名称。

⚠️

Cursor 有自己的订阅计划，使用自定义 API Key 时，消耗的是你 aioncode 账户的额度，而不是 Cursor 订阅额度。

🔧 AI 编程工具

Cline / Continue

VS Code 中最受欢迎的两款 AI 编程插件。在熟悉的编辑器中获得 AI 加持，完全免费开源，通过 aioncode 接入付费模型。

🔧 Cline

1

安装插件

在 VS Code 扩展市场搜索 Cline 并安装，或访问 VS Code Marketplace。

2

配置 API

点击 Cline 图标打开侧边栏 → 齿轮图标 → 选择 Provider：

配置项	填写值
API Provider	OpenAI Compatible
Base URL	`https://api.aioncode.com/v1`
API Key	你的 aioncode Key
Model	填入模型名，如 `claude-opus-4-7`

🔄 Continue

1

安装插件

在 VS Code 扩展市场搜索 Continue 并安装。

2

编辑配置文件

打开 ~/.continue/config.json，添加 aioncode 作为 Provider：

JSON

{
  "models": [
    {
      "title": "Claude via aioncode",
      "provider": "openai",
      "model": "claude-opus-4-7",
      "apiKey": "sk-your-aioncode-key",
      "apiBase": "https://api.aioncode.com/v1"
    }
  ]
}

📦 SDK 接入

OpenAI SDK

使用 OpenAI 官方 SDK 接入 aioncode，无需修改任何业务逻辑，只需两行配置。

🐍 Python

PYTHON

pip install openai

PYTHON

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-aioncode-key",
    base_url="https://api.aioncode.com/v1",
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[
        {"role": "user", "content": "Hello!"}
    ],
)
print(response.choices[0].message.content)

📦 Node.js / TypeScript

BASH

npm install openai

TS

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'sk-your-aioncode-key',
  baseURL: 'https://api.aioncode.com/v1',
});

const response = await client.chat.completions.create({
  model: 'gpt-4o',
  messages: [{ role: 'user', content: 'Hello!' }],
});
console.log(response.choices[0].message.content);

📦 SDK 接入

Anthropic SDK

使用 Anthropic 官方 SDK 时，通过 base_url 参数或环境变量切换到 aioncode 端点。

🐍 Python

PYTHON

pip install anthropic

PYTHON

import anthropic

client = anthropic.Anthropic(
    api_key="sk-your-aioncode-key",
    base_url="https://api.aioncode.com",
)

message = client.messages.create(
    model="claude-opus-4-7",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Hello, Claude!"}
    ],
)
print(message.content[0].text)

或使用环境变量（推荐）

BASH

export ANTHROPIC_API_KEY="sk-your-aioncode-key"
export ANTHROPIC_BASE_URL="https://api.aioncode.com"

📦 Node.js / TypeScript

BASH

npm install @anthropic-ai/sdk

TS

import Anthropic from '@anthropic-ai/sdk';

const client = new Anthropic({
  apiKey: 'sk-your-aioncode-key',
  baseURL: 'https://api.aioncode.com',
});

const message = await client.messages.create({
  model: 'claude-opus-4-7',
  max_tokens: 1024,
  messages: [{ role: 'user', content: 'Hello!' }],
});
console.log(message.content[0].text);

✨ AI 编程工具

Gemini CLI

Google 官方出品的终端 AI 助手。Gemini CLI 当前版本强绑定 Google 官方端点，不支持自定义 Base URL，因此无法直接通过 aioncode 中转。如需在终端使用 Gemini 系列模型，推荐通过 OpenAI 兼容协议接入。

⚠️

Gemini CLI 暂不支持 Base URL 替换
官方 Gemini CLI（@google/gemini-cli）目前不提供环境变量覆盖 API 端点的能力，GOOGLE_GEMINI_BASE_URL 等变量对其无效。若需使用 Gemini 模型，请通过下方 OpenAI SDK 方式调用。

✅ 推荐替代方案：OpenAI SDK 调用 Gemini 模型

aioncode 已支持 Gemini 系列模型，通过 OpenAI 兼容协议即可调用，无需安装 Gemini CLI。

🐍 Python 示例

PYTHON

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-aioncode-key",
    base_url="https://api.aioncode.com/v1",
)

response = client.chat.completions.create(
    model="gemini-2.5-pro",
    messages=[{"role": "user", "content": "Hello!"}],
)
print(response.choices[0].message.content)

📦 Node.js 示例

TS

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'sk-your-aioncode-key',
  baseURL: 'https://api.aioncode.com/v1',
});

const response = await client.chat.completions.create({
  model: 'gemini-2.5-pro',
  messages: [{ role: 'user', content: 'Hello!' }],
});
console.log(response.choices[0].message.content);

💡

支持的 Gemini 模型 ID 请查看「模型列表」页面，常用的有 gemini-2.5-pro、gemini-2.5-flash。

🐙 AI 编程工具

GitHub Copilot（VS Code）

通过安装 OAI Compatible Provider for Copilot 插件，无需 GitHub Copilot 订阅，直接用 aioncode Key 在 VS Code 中使用 AI 编程助手。

💡

此方案不需要购买 GitHub Copilot 订阅，只消耗你的 aioncode 额度，性价比极高。

📥 安装步骤

1

安装 VS Code

访问 code.visualstudio.com 下载并安装 VS Code（支持 Windows / macOS / Linux）。

2

安装 OAI Compatible Provider for Copilot 插件

在 VS Code 中按 Ctrl+Shift+X（Windows/Linux）或 ⌘+Shift+X（macOS）打开扩展市场，搜索：

OAI Compatible Provider for Copilot

找到后点击「安装」。

3

配置 Base URL

按 Ctrl+,（Windows/Linux）或 ⌘+,（macOS）打开设置，搜索 oai，找到 Oaicopilot: Base Url，填入：

https://api.aioncode.com/v1

4

添加模型 & 输入 API Key

点击 VS Code 右侧活动栏的 GitHub Copilot 图标 → 点击模型选择下拉 → Manage Models... → 选择 OAI Compatible → 在弹出框中填入你的 aioncode Key → 勾选你需要的模型 → 点击 OK。

5

开始使用

在 Copilot 面板中，选择带有 via OAI Compatible 后缀的模型即可使用 aioncode 服务。Copilot 的所有功能（Chat、补全、Agent）均可正常使用。

❓ 常见问题

⚠️

模型列表为空
API Key 填写错误，或网络无法访问 aioncode 服务。重新在 Manage Models 中输入 Key 并重启 VS Code。

⚠️

Copilot 图标不可用
需要安装 GitHub Copilot 主插件（免费版即可），OAI Compatible 插件是在其基础上扩展 Provider 的。

🖥️ AI 编程工具

OpenCode

开源终端 AI IDE，支持多 Provider 配置，通过 JSON 配置文件接入 aioncode，可同时使用 Claude、GPT、Gemini 等多个模型。

📥 安装 Node.js 18+

brew install node

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

winget install OpenJS.NodeJS.LTS

📦 安装 OpenCode

BASH

npm install -g opencode-ai@latest

# 验证安装
opencode --version

⚙️ 配置 aioncode

OpenCode 通过 ~/.config/opencode/opencode.json 文件配置 Provider。

创建配置文件

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

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.config\opencode"
notepad "$env:USERPROFILE\.config\opencode\opencode.json"

配置文件内容

JSON

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "aioncode": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "aioncode",
      "options": {
        "baseURL": "https://api.aioncode.com/v1",
        "apiKey": "sk-your-aioncode-key"
      },
      "models": {
        "claude-opus-4-7": {},
        "claude-sonnet-4-6": {},
        "gpt-4o": {},
        "gpt-4o-mini": {},
        "o3": {},
        "o4-mini": {}
      }
    }
  }
}

将 sk-your-aioncode-key 替换为你的 aioncode Key。可在 models 中按需增删模型。

🚀 基本使用

BASH

# 在项目目录下启动
cd your-project
opencode

# 启动后选择 aioncode provider 下的模型即可

❓ 常见问题

⚠️

npm 权限错误（macOS/Linux）
建议配置 npm 使用用户目录：mkdir ~/.npm-global && npm config set prefix ~/.npm-global，然后将 ~/.npm-global/bin 加入 PATH。

⚠️

模型列表不显示
确认 opencode.json 中 JSON 格式正确，baseURL 和 apiKey 均已填写，然后重启 OpenCode。

🧠 支持的模型

模型列表

aioncode 持续更新支持最新模型，以下为当前主要可用模型。完整列表请查看后台「模型」页面。

💡

以下为常用示例模型，完整且最新的可用模型列表以后台「模型」页面为准。模型更新频繁，建议直接在后台查看实时可用 ID 与倍率。

⚡ Claude 系列（Anthropic）

模型 ID 示例	说明	推荐用途
`claude-opus-4-7`	旗舰智能，最强推理	复杂编程、深度分析
`claude-sonnet-4-6`	速度与智能最佳平衡	日常开发、代码审查
`claude-haiku-4-5-20251001`	超快速、低成本	简单任务、高并发

🤖 GPT / o 系列（OpenAI）

模型 ID 示例	说明	推荐用途
`gpt-4o`	多模态旗舰模型	通用任务、图像理解
`gpt-4o-mini`	轻量快速版	批量处理、低成本场景
`o3`	强化推理模型	数学、逻辑、科学
`o4-mini`	轻量推理模型	编程推理、性价比高

🌟 Gemini 系列（Google）

模型 ID 示例	说明	推荐用途
`gemini-2.5-pro`	旗舰多模态，100 万上下文	长文档分析、多模态任务
`gemini-2.5-flash`	快速轻量版	高并发、低延迟场景

🐳 DeepSeek 系列

模型 ID 示例	说明	推荐用途
`deepseek-r1`	强推理，超低价格	推理任务、性价比首选
`deepseek-v3`	通用对话模型	日常问答、代码辅助

⚠️

以上模型 ID 仅供参考，实际可用 ID 请以后台「模型」页面为准。模型定价请在后台查看实时倍率，aioncode 价格通常为官方的 5–7 折。