AI 接入使用文档

概述

本文档介绍公司 AI 服务的接入方式，包括 AI 辅助编码工具的配置以及 AI 能力集成到业务系统的开发规范。

AI 辅助编码工具配置

通过公司 AI API 控制台配合 cc-switch 工具，可以在本地使用 Claude Code / Codex 等 AI 编码助手。

前置条件

• 已开通公司 AI API 账号
• VSCode 编辑器（或终端环境）
• Claude Code（必装）：AI 辅助编码工具，通过 VSCode 扩展市场搜索 Claude Code 安装，同时安装 CLI（npm install -g @anthropic-ai/claude-code）
• Codex（必装）：AI 辅助编码工具，通过 VSCode 扩展市场搜索 Codex 安装，同时安装 CLI（npm install -g @openai/codex）

配置流程

1. 查看额度并创建令牌

1. 打开 API 控制台
2. 确认自己的可用额度
3. 进入 令牌管理 页面，点击创建新令牌

2. 下载安装 cc-switch

1. 访问 cc-switch 文档页
2. 根据自己的操作系统下载对应版本的 cc-switch
3. 安装到本地

3. 导入令牌到 cc-switch

1. 回到 令牌管理 页面
2. 找到已创建的令牌，点击右侧「聊天」按钮旁边的下拉菜单
3. 选择「cc-switch 导入」
4. 根据需要选择要使用的模型，完成导入

4. 安装编码工具

根据自己的使用习惯，选择以下任一方式：

方式	说明
VSCode 插件 - Claude Code	在 VSCode 扩展市场搜索 Claude Code 安装
VSCode 插件 - Codex	在 VSCode 扩展市场搜索 Codex 安装
CLI（命令行）	自行下载 Claude Code CLI 或 Codex CLI 使用

安装完成后，工具会自动读取 cc-switch 配置的令牌和模型信息，即可开始使用。

Claude Code 配置

需要在 Claude Code 的全局配置中添加以下环境变量：

{
  "env": {
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

有两种方式修改此配置：

• 方式一（推荐）：直接在 cc-switch 的设置界面中修改，无需手动查找系统文件
• 方式二：手动编辑系统配置文件 ~/.claude/settings.json（Windows 路径为 %USERPROFILE%\.claude\settings.json）

注意：更换令牌或使用新模型的令牌时，此配置文件也需要同步更新。同样可以通过 cc-switch 直接修改，无需手动查找系统文件。

其他插件（如 everything-claude-code、frontend-design 等）可通过 Claude Code 内自行安装启用。

推荐插件列表：

插件名	说明
everything-claude-code	全能工具集，包含代码审查、重构、调试等多种技能
frontend-design	前端设计辅助
superpowers	增强工作流（计划、头脑风暴、TDD 等）
code-review	代码审查
skill-creator	自定义技能创建

常见问题

• 额度不足：联系管理员充值或申请额度
• 令牌失效：回到控制台重新创建令牌并重新导入
• 模型切换：打开 cc-switch，切换到需要的模型即可