Dongx for VSCode

一个为 VSCode 集成 Anthropic API 认证的扩展,支持 OAuth2 登录和环境变量自动配置,同时兼容 Claude Code for VSCode 扩展。

功能特性

• 🔐 双模式认证
  • OAuth2 + PKCE 自动登录
  • 静态 API Token 配置
• 🌍 跨平台环境变量注入
  • 自动配置终端环境变量
  • 兼容 Claude Code 扩展 (claudeCode.environmentVariables)
• 🔧 灵活配置
  • 自定义 API Base URL
  • 支持额外环境变量
• 👀 状态栏显示
  • 实时显示认证状态
  • OAuth/静态模式可视化
• 🗑️ 完整的生命周期管理
  • 登录/登出管理
  • 自动清理配置

命令

• Dongx: Login - OAuth2 登录
• Dongx: Logout - 退出登录并清除 OAuth 数据
• Dongx: Show Login Status - 显示当前登录状态
• Dongx: Update Environment Variables - 手动更新环境变量

使用方法

方式一: OAuth2 登录（推荐）

1. 打开命令面板（macOS: Cmd+Shift+P，Windows/Linux: Ctrl+Shift+P）
2. 运行命令 Dongx: Login
3. 浏览器将自动打开 OAuth 登录页面
4. 完成登录后,环境变量自动配置完成

方式二: 静态 Token 配置

在 VSCode 设置 (settings.json) 中配置:

{
  "dongx.anthropicBaseUrl": "http://japi-ai-proxy-pre.jd.com/aiProxy",
  "dongx.anthropicAuthToken": "sk-ant-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}

配置说明

基础配置

{
  // API Base URL (必填)
  "dongx.anthropicBaseUrl": "http://japi-ai-proxy-pre.jd.com/aiProxy",

  // 静态 Token (可选,使用 OAuth 时可留空)
  "dongx.anthropicAuthToken": "",

  // 认证模式: "oauth" | "static" | "hybrid"
  "dongx.authenticationMode": "hybrid",

  // 启动时自动登录提示
  "dongx.autoLoginPrompt": true,

  // 额外的环境变量 (可选)
  "dongx.environmentVariables": [
    {
      "name": "CUSTOM_VAR",
      "value": "custom_value"
    }
  ]
}

环境变量自动配置

扩展会自动配置以下位置的环境变量:

1. 终端集成环境变量

   "terminal.integrated.env.osx": {
     "ANTHROPIC_BASE_URL": "...",
     "ANTHROPIC_AUTH_TOKEN": "..."
   }
   

2. Claude Code 扩展环境变量

   "claudeCode.environmentVariables": [
     {
       "name": "ANTHROPIC_BASE_URL",
       "value": "..."
     },
     {
       "name": "ANTHROPIC_AUTH_TOKEN",
       "value": "..."
     }
   ]
   

OAuth Token 格式

OAuth 登录后的 token 格式为:

sk-ant-{random_prefix}#{actual_oauth_token}

示例:

sk-ant-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx#389350302879

查看登录状态

1. 查看状态栏图标:

   • ✅ Dongx - OAuth 已认证
   • 🔴 Dongx - 静态 Token 模式
   • ❌ Dongx - 认证失败

2. 运行 Dongx: Show Login Status 命令查看详细信息

登出和清理

运行 Dongx: Logout 命令将:

• 清除 OAuth 认证数据
• 保留静态配置
• 使用静态 Token 更新环境变量（如果有）

与 Claude Code 集成

本扩展完全兼容 Claude Code for VSCode:

1. 自动配置 claudeCode.environmentVariables
2. 设置自定义 API Base URL
3. OAuth 认证 token 自动注入

使用 Claude Code 时,确保:

• 安装了 Claude Code 扩展
• 运行 Dongx: Login 或 Dongx: Update Environment Variables
• 重启 Claude Code 以应用新配置

测试指南

详细的测试步骤请参考 TESTING.md

系统要求

• VS Code 1.94.0 或更高版本
• Node.js (用于 OAuth 服务器)

常见问题

Q: 如何验证配置是否生效?

A: 查看 VSCode 的 settings.json 文件,确认 claudeCode.environmentVariables 已正确设置。

Q: OAuth 登录失败怎么办?

A:

1. 检查网络连接
2. 确认 dongx.anthropicBaseUrl 配置正确
3. 查看开发者工具控制台的错误信息

Q: 如何切换回静态 Token?

A:

1. 运行 Dongx: Logout
2. 在 settings.json 中配置 dongx.anthropicAuthToken
3. 运行 Dongx: Update Environment Variables

开发

本地调试

# 安装依赖
npm install

# 打开 VSCode 调试
# 按 F5 启动扩展开发主机

打包发布

npm run package

许可证

© Anthropic PBC. All rights reserved.