跳转到主要内容
VS Code 是最流行的代码编辑器之一。你可以通过安装 Claude Code 或 Codex 扩展,在编辑器内直接使用 AIOHub 提供的 AI 模型进行代码补全、对话和重构。

前置条件

扩展概览

两个扩展使用不同的协议和配置,互不冲突,可以同时安装并按需切换:
VS Code 扩展市场中的 Claude Code 和 Codex
扩展协议Base URL
Claude CodeClaude Messageshttps://api.aiohub.org
CodexOpenAI Responseshttps://api.aiohub.org/v1
两个扩展的 API 令牌需要关联正确的分组,否则会出现模型不可用或鉴权失败。创建令牌时请注意选择对应分组。

Claude Code 扩展

Claude Code 是 Anthropic 官方的 VS Code 扩展,提供 AI 对话、代码编辑和终端操作能力。
1

安装扩展

在 VS Code 扩展市场搜索 Claude Code 并安装,或在终端执行:
code --install-extension anthropics.claude-code
2

配置环境变量

Claude Code 扩展复用 Claude Code CLI 的环境变量。将以下内容添加到 ~/.zshrc~/.bashrc
export ANTHROPIC_BASE_URL="https://api.aiohub.org"
export ANTHROPIC_AUTH_TOKEN="sk-你的API令牌"
配置 Claude Code 环境变量
保存后执行 source ~/.bashrc(或 source ~/.zshrc),然后重启 VS Code。
ANTHROPIC_BASE_URL 不要加 /v1。Claude Code 会自行追加 /v1/messages
Windows 用户可在系统环境变量中添加:
变量名
ANTHROPIC_BASE_URLhttps://api.aiohub.org
ANTHROPIC_AUTH_TOKENsk-你的API令牌
也可以在 VS Code 的 settings.json 中配置终端环境变量:
{
  "terminal.integrated.env.osx": {
    "ANTHROPIC_BASE_URL": "https://api.aiohub.org",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的API令牌"
  },
  "terminal.integrated.env.linux": {
    "ANTHROPIC_BASE_URL": "https://api.aiohub.org",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的API令牌"
  },
  "terminal.integrated.env.windows": {
    "ANTHROPIC_BASE_URL": "https://api.aiohub.org",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的API令牌"
  }
}
3

选择分组

API 令牌的分组决定了可用模型和价格。Claude Code 推荐以下分组:
分组特点
claude-bedrock稳定可靠,支持 prompt caching,价格较高
claude-kiro价格较低,偶尔中断,不支持 cache
anthropic标准 Anthropic 路由
详见 令牌分组说明
4

验证连接

打开 VS Code,在 Claude Code 面板中发送一条消息。正常回复即表示配置成功:
Claude Code 对话成功

Codex 扩展

Codex 是 OpenAI 官方的 VS Code 扩展,提供 AI 编程助手能力。
1

安装扩展

在 VS Code 扩展市场搜索 Codex 并安装,或在终端执行:
code --install-extension openai.codex
2

创建配置文件

Codex 扩展复用 Codex CLI 的配置文件。如果你已经按照 Codex CLI 配置 完成了设置,VS Code 扩展会自动读取,可以跳过这一步。如果还没有配置,创建 ~/.codex/config.toml
model_provider = "aiohub"
model = "gpt-5.3-codex"

[model_providers.aiohub]
name = "AIOHub"
base_url = "https://api.aiohub.org/v1"
env_key = "AIOHUB_API_KEY"
wire_api = "responses"
requires_openai_auth = false
supports_websockets = false
Codex 配置文件
3

配置环境变量

~/.bashrc~/.zshrc 中设置 API 令牌:
export AIOHUB_API_KEY="sk-你的API令牌"
配置 Codex 环境变量
base_url 需要包含 /v1。Codex 使用 OpenAI Responses API,与 Claude Code 的地址不同。
4

选择分组

API 令牌的分组决定了可用模型和价格。Codex 推荐以下分组:
分组特点
codex网关中转,兼容性优先
codex-passthrough直通低延迟,仅限 CLI/扩展场景
详见 令牌分组说明
5

验证连接

保存配置后重启 VS Code,在 Codex 面板中发送一条消息。正常回复即表示配置成功:
Codex 对话成功

常见问题

确认 VS Code 版本 ≥ 1.90。部分扩展需要较新版本的 VS Code 才能正常运行。重启 VS Code 后再试。
确认环境变量 ANTHROPIC_AUTH_TOKEN 已正确设置并且 VS Code 能读取到。可以在 VS Code 内置终端中执行 echo $ANTHROPIC_AUTH_TOKEN 验证。
检查 ~/.codex/config.tomlbase_url 是否为 https://api.aiohub.org/v1,以及 AIOHUB_API_KEY 环境变量是否存在。
可以。Claude Code 和 Codex 使用不同的协议和配置,互不冲突。你可以同时安装并按需切换使用。
前往 钱包管理 查看余额。详见 充值说明

其他编辑器扩展

如果你使用的编辑器扩展支持自定义 OpenAI Base URL(如 Continue、Cline 等),请参考 OpenAI 兼容应用 页面进行配置。