skip to content
杨鸿肇 杨鸿肇
/ EN

AI 编程:工具安装和配置

创建 更新 11 min read
索引

中转站推荐

目前暂时推荐 米醋 API,也可以参考 中转站测评,选择适合自己的方案

Claude Code CLI

  1. 在终端中执行命令进行安装:

    Terminal window
    # 官方安装脚本(macOS/Linux)
    curl -fsSL https://claude.ai/install.sh | bash
    # 官方更新指令
    claude update
    # macOS 也可以使用 brew,版本可能稍旧
    brew install --cask claude-code
    # brew 更新指令
    brew update && brew upgrade --cask claude-code
  2. 配置环境变量:

    1. 简易版(仅使用 API Key):在 ~/.claude/settings.json 中添加:
    "env": {
    //关闭额外附加信息,提高第三方 API 缓存命中率
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
    //关闭不必要的数据传输,等价于设置 DISABLE_AUTOUPDATER、DISABLE_FEEDBACK_COMMAND、
    //DISABLE_ERROR_REPORTING、DISABLE_TELEMETRY 为 1
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    //关闭反馈调查
    "CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY": "1",
    //设置 API
    "ANTHROPIC_BASE_URL": "替换为真实的地址(类似:https://www.xxxx.com)",
    "ANTHROPIC_AUTH_TOKEN": "替换为真实的 API Key",
    // 如果报 Bedrock Runtime: InvokeModelWithResponseStream, ValidationException: invalid beta flag 错误,加上这段
    // "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1",
    // 可能需要指定第三方设置的模型名称
    // "ANTHROPIC_MODEL": "替换为真实的模型名称,可能需要结尾加 [1m] 来开启 1M 上下文"
    // 可以设置默认的 Opus 和 Sonnet 模型,默认开启 1M 上下文
    // "ANTHROPIC_DEFAULT_OPUS_MODEL": "真实的 Opus 模型名称",
    // "ANTHROPIC_DEFAULT_SONNET_MODEL": "真实的 Sonnet 模型名称",
    },
    1. 进阶版(同时支持官方 OAuth 和 API Key):在 ~/.claude/settings.json 中添加:
    "env": {
    // 关闭自动更新
    "DISABLE_AUTOUPDATER": "1",
    // 关闭错误报告
    "DISABLE_ERROR_REPORTING": "1",
    // 关闭反馈命令
    "DISABLE_FEEDBACK_COMMAND": "1",
    // 关闭反馈调查
    "CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY": "1"
    }

    ~/.config/fish/config.fish中添加:

    Terminal window
    function claude
    argparse --ignore-unknown 'o/official' -- $argv
    or return
    if set -q _flag_official
    command claude $argv
    else
    set -lx CLAUDE_CODE_ATTRIBUTION_HEADER 0
    set -lx CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 1
    set -lx CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY 1
    set -lx ANTHROPIC_BASE_URL "替换为真实的地址(类似:https://www.xxxx.com)"
    set -lx ANTHROPIC_AUTH_TOKEN "替换为真实的 API Key"
    # 如果报 Bedrock Runtime: InvokeModelWithResponseStream, ValidationException: invalid beta flag 错误,加上这段
    # set -lx CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS "1"
    # 可能需要指定第三方设置的模型名称
    # set -lx ANTHROPIC_MODEL "替换为真实的模型名称,可能需要结尾加 [1m] 来开启 1M 上下文"
    # 可以设置默认的 Opus 和 Sonnet 模型,默认开启 1M 上下文
    # set -lx ANTHROPIC_DEFAULT_OPUS_MODEL "真实的 Opus 模型名称"
    # set -lx ANTHROPIC_DEFAULT_SONNET_MODEL "真实的 Sonnet 模型名称"
    command claude $argv
    end
    end

    之后使用时额外添加 -o 或者 --official 参数即可使用官方渠道。

  3. 启动指令:

    Terminal window
    # 使用 API Key 创建指定名称对话
    claude -n "对话名称"
    # 使用 API Key 查看历史对话
    claude -r
    # 使用官方渠道创建指定名称对话
    claude -o -n "对话名称"

Claude Code 配套工具

ccstatusline(自定义状态栏)

  1. 调整配置:
    Terminal window
    bunx ccstatusline@latest
    # 或者 npx ccstatusline@latest
  2. ~/.claude/settings.json 中添加以下内容:
    {
    "statusLine": {
    "type": "command",
    "command": "bunx ccstatusline@latest"
    // 或者替换为 "npx ccstatusline@latest"
    },
    }

Clawd on Desk(桌面宠物)

  1. 从官方 GitHub 仓库 Releases 中下载并安装:Clawd on Desk

Codex CLI & 桌面版

  1. 通过 brew 安装 CLI 版本:
    Terminal window
    brew install --cask codex
    通过官网安装桌面版:Codex
  2. ~/.codex/config.toml 中添加:
    model_provider = "ProxyAPI"
    model = "gpt-5.5"
    # 可配置 xhigh, high, medium, low, minimal
    model_reasoning_effort = "xhigh"
    # 中转配置
    [model_providers.ProxyAPI]
    name = "中转代理"
    wire_api = "responses"
    requires_openai_auth = true
    # 注意:这个地址需要包含 /v1 端点
    base_url = "替换为真实的地址(类似:https://www.xxx.com/v1)"
  3. 登录方式:
    1. 通过 API Key 登录 CLI:修改 ~/.codex/config.tomlmodel_providerProxyAPI,在 ~/.codex/auth.json 中添加:
    {
    "auth_mode": "apikey",
    "OPENAI_API_KEY": "替换为真实的 API Key"
    }
    1. 通过官方 OAuth 登录 CLI:修改 ~/.codex/config.tomlmodel_provideropenai,并执行 codex login 登录,自动覆盖生成 ~/.codex/auth.json
    2. 通过 API Key 登录桌面版:修改 ~/.codex/config.tomlmodel_providerProxyAPI,重启桌面版,退出登录,选择输入 API Key 登录,自动覆盖生成 ~/.codex/auth.json
    3. 通过官方 OAuth 登录桌面版:修改 ~/.codex/config.tomlmodel_provideropenai,重启桌面版,退出登录,选择官方登录,进行 OAuth,自动覆盖生成 ~/.codex/auth.json

VSCode 系列编辑器插件

适用于偏爱编辑器侧边栏交互的开发者,个人更习惯使用 CLI 或者桌面版 APP

Codex

继承系统级 .codex 中配置

  1. 安装插件:Codex – OpenAI’s coding agent
  2. 如果使用官方 OAuth,直接打开侧边栏对话框登录;如果使用第三方 API Key,创建或者编辑 ~/.codex/config.toml 文件,可以使用指令:
    Terminal window
    code ~/.codex/config.toml
    或者 Windows 系统:
    Terminal window
    code "$HOME\.codex\config.toml"
    添加:
    model_provider = "ProxyAPI"
    model = "gpt-5.5"
    # 可配置 xhigh, high, medium, low, minimal
    model_reasoning_effort = "xhigh"
    # 中转配置
    [model_providers.ProxyAPI]
    name = "中转代理"
    wire_api = "responses"
    requires_openai_auth = true
    # 注意:这个地址需要包含 /v1 端点
    base_url = "替换为真实的地址(类似:https://www.xxx.com/v1)"
    然后在侧边栏对话框中使用 API Key 登录

Claude Code

在 VSCode 本身的设置中设置环境变量

  1. 安装插件:Claude Code for VS Code
  2. 如果使用官方 OAuth,直接打开侧边栏对话框登录;如果使用第三方 API Key,在设置中搜索 Claude Code: Environment Variables,然后点击 在 settings.json 中编辑,添加:
    "claudeCode.environmentVariables": [
    {
    "name": "CLAUDE_CODE_ATTRIBUTION_HEADER",
    "value": "0"
    },
    {
    "name": "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC",
    "value": "1"
    },
    {
    "name": "CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY",
    "value": "1"
    },
    {
    "name": "ANTHROPIC_BASE_URL",
    "value": "替换为真实的地址(类似:https://www.xxxx.com)"
    },
    {
    "name": "ANTHROPIC_AUTH_TOKEN",
    "value": "替换为真实的 API Key"
    },
    // 如果报 Bedrock Runtime: InvokeModelWithResponseStream, ValidationException: invalid beta flag 错误,加上这段
    // {
    // "name": "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS",
    // "value": "1"
    // }
    // 可能需要指定第三方设置的模型名称
    // {
    // "name": "ANTHROPIC_MODEL",
    // "value": "替换为真实的模型名称,可能需要结尾加 [1m] 来开启 1M 上下文"
    // }
    // 可以设置默认的 Opus 和 Sonnet 模型,默认开启 1M 上下文
    // {
    // "name": "ANTHROPIC_DEFAULT_OPUS_MODEL",
    // "value": "真实的 Opus 模型名称"
    // },
    // {
    // "name": "ANTHROPIC_DEFAULT_SONNET_MODEL",
    // "value": "真实的 Sonnet 模型名称"
    // },
    ],
    然后在侧边栏对话框中无需登录直接使用

Copilot

配置第三方 API Key,需登录且本身已经激活 Copilot 功能,仅适用于 GPT 系列模型,不支持 Claude 系列模型

  1. 安装插件:OAI Compatible Provider for Copilot
  2. 在设置中搜索 Oaicopilot: Base Url,输入真实地址(需要 /v1 端点,类似:https://www.xxxx.com/v1
  3. 在设置中搜索 Oaicopilot: Models,输入真实模型配置参数,类似:
    "oaicopilot.models": [
    {
    "id": "gpt-5.5",
    "context_length": 400000,
    "max_tokens": 128000,
    }
    ]
  4. 在模型选择中点击设置图标,添加来自 OAI Compatible 的模型,在上方弹出的文本框中输入真实的 API Key,之后在对话中可以选择配置好的模型

Claude 注册

  1. 准备材料:
    • Clash Verge
    • 常规代理
    • 静态 IP(可选择 IPdodo 的静态住宅 IP,建议美国地区)
    • 指纹浏览器(可选择 AdsPower,可使用 Google 登录)
    • 接收海外验证码平台(可选择 veritel,可使用 Google 登录)
  2. 配置 Clash Verge 链式代理(常规代理 -> 静态 IP),并添加相关规则:参考项目 clash-verge-proxy-toolkit,建议克隆然后让 AI Agent 阅读此项目来辅助完成
    1. 根据 injection_component.example.yaml 创建自己的 injection_component.yaml 文件
    2. 使用脚本 scripts/proxy/inject.py 注入规则
    3. 使用脚本 scripts/proxy/check.py 测试链式代理是否配置成功
    4. 【可选项】使用脚本 scripts/proxy/export_android.py 根据当前配置生成 Android 版 Clash Meta 配置文件
  3. 在 Clash Verge 设置中关闭 IPV6
  4. 创建指纹浏览器:
    • SunBrowser
    • MacOS
    • User-Agent:让 AI 生成一个符合市面上 Macbook 的参数
    • 代理方式:自定义
    • 代理类型:No Proxy(Clash Verge 会接管)
    • WebRTC:替换
    • 时区、地理位置、语言、界面语言:基于 IP
    • 硬件噪声:全开
    • WebGL 元数据:让 AI 生成一个符合上面 User-Agent 的参数
    • WebGPU:基于 WebGL
    • CPU、RAM、设备名称、MAC 地址:让 AI 生成一个符合上面 User-Agent 的参数
    • Do Not Track:关闭
  5. 关闭 SunBrowser 的 QUIC:访问 chrome://flags/#enable-quic,将 Experimental QUIC protocol 设置为 Disabled
  6. 注册 Google 账号:使用指纹浏览器注册(如果需要手机号验证,在准备好的接收海外验证码平台,选择 IP 所在地手机号进行验证)
  7. 注册 Claude:使用指纹浏览器,用上一步的 Google 账号进行注册(如果需要手机号验证,在准备好的接收海外验证码平台,选择 IP 所在地手机号进行验证)
  8. 后续使用 Claude Code 或者 Claude APP 时,跳转的 OAuth 连接需要复制链接到注册、登录的指纹浏览器打开,不要在默认浏览器打开

Claude 成品号

注:没用过,朋友用过。支持代充或者成品号,也需要静态 IP(最好也有指纹浏览器),只是省去了付款、注册的麻烦。