Skip to content

常用AI编程工具安装与配置 ​

工具公司官方首页
DeepSeek HarnessDeepSeekwww.deepseek.com
QoderAlibabaqoder.com.cn
Qwen CodeAlibabaqwen.ai
TraeByteDancewww.trae.cn
CodeBuddyTencentwww.codebuddy.cn
WorkBuddyTencentwww.workbuddy.cn
Claude CodeAnthropiccode.claude.com
CodexOpenAIopenaicli.com
OpenCodeanomalycogithub.com
PiEarendilhttps://pi.dev/

排名不分先后。其它 Agent ,如:Kimi Code、MiniMax Code、OpenClaw、Hermes、GitHub Copilot、Cursor 等等, 不一一列举。

国内 AI 编程工具 ​

DeepSeek Harness ​

平台通用安装指令ArchLinux安装指令
CLInpm i -g @deepseek-ai/dshyay -S deepseek-harness-bin
DesktopDeepSeek Harnessyay -S deepseek-harness-desktop

对于 CLI 平台,使用dsh web启动,并在浏览器中访问:http://127.0.0.1:3080。

Qoder ​

平台通用安装指令ArchLinux安装指令
DesktopQoder CNyay -S qoder-cn-bin
IDEQoder CN IDEyay -S qoder-cn-ide-bin
CLInpm i -g @qodercn-ai/qoderclicnyay -S qoder-cli-cn-bin
VSCodeQoder CN-
JetbrainsQoder CN-

Qoder 分为国内版和国际版,上述安装指令都以国内版为例(带 CN 标识)。

Qwen Code ​

平台通用安装指令ArchLinux安装指令
CLInpm i -g @qwen-code/qwen-codeyay -S qwen-code-bin
DesktopQwen Code Desktop-
VSCodeQwen Code Companion-

对于 CLI 平台,使用qwen serve启动,并在浏览器中访问:http://127.0.0.1:4170。

Trae ​

平台通用安装指令ArchLinux安装指令
IDETRAEyay -S trae-cn
VSCodeTRAE AI: Coding Assistant-
JetbrainsTRAE AI: Coding Assistant-

CodeBuddy ​

平台通用安装指令ArchLinux安装指令
IDECodeBuddyyay -S codebuddy-ide-cn
CLInpm i -g @tencent-ai/codebuddy-codeyay -S codebuddy-cli
VSCodeTencent Cloud CodeBuddy-
JetbrainsTencent Cloud CodeBuddy-

WorkBuddy ​

平台通用安装指令ArchLinux安装指令
DesktopWorkBuddyyay -S workbuddy

国际 AI 编程工具 ​

Claude Code ​

平台通用安装指令ArchLinux安装指令
CLInpm i -g @anthropic-ai/claude-codeyay -S claude-code(国内无法访问)

使用 cc-switch 添加新的 Claude 供应商,或修改配置文件 ~/.claude/settings.json,使 Claude Code 连接第三方大模型服务。

Codex ​

平台通用安装指令ArchLinux安装指令
CLInpm i -g @openai/codexsudo pacman -S openai-codex
DesktopChatGPT Desktop(国内无法访问)yay -S chatgpt-desktop

使用 cc-switch 添加新的 OpenAI 供应商,或修改配置文件 ~/.codex/config.toml 与 ~/.codex/auth.json,使 Codex 连接第三方大模型服务。

OpenCode ​

平台通用安装指令ArchLinux安装指令
CLInpm i -g @opencode/clisudo pacman -S opencode
DesktopOpenCode Desktopyay -S opencode-desktop-bin

使用 cc-switch 添加新的 OpenCode 供应商,或修改配置文件~/.config/opencode/opencode.json,使 OpenCode 连接第三方大模型服务。

另外,也可使用 connect 命令连接第三方大模型:启动opencode,输入/connect,选择provider,输入API KEY。

Pi ​

平台通用安装指令ArchLinux安装指令
CLInpm i -g --ignore-scripts @earendil-works/pi-coding-agentyay -S pi-coding-agent

使用 cc-switch 添加新的 Pi 供应商,或修改配置文件 ~/.pi/agent/models.json,使 Pi 连接第三方大模型服务。

附录 ​

基于 cc-switch 管理大模型配置 ​

安装 cc-switch:

shell
sudo pacman -S cc-switch

在 cc-switch 中为 Agent 应用配置对应的模型服务供应商,以 OpenCode 配置 DeepSeek 为例:

cc-switch 配置

json
{
  "npm": "@ai-sdk/openai-compatible",
  "options": {
    "baseURL": "https://api.deepseek.com/v1",
    "apiKey": "sk-xxxxxx",
    "setCacheKey": true
  },
  "models": {
    "deepseek-flash": {
      "name": "DeepSeek V4.1 Flash",
      "reasoning": true,
      "limit": {
        "context": 1000000,
        "output": 384000
      },
      "modalities": {
        "input": [
          "text",
          "image"
        ],
        "output": [
          "text"
        ]
      }
    }
  }
}

添加完上述配置后,将自动生成对应 Agent 应用的原生配置:

~/.config/opencode/opencode.json

json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "deepseek": {
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "baseURL": "https://api.deepseek.com/v1",
        "apiKey": "sk-xxxxxx",
        "setCacheKey": true
      },
      "models": {
        "deepseek-flash": {
          "name": "DeepSeek V4.1 Flash",
          "reasoning": true,
          "limit": {
            "context": 1000000,
            "output": 384000
          },
          "modalities": {
            "input": [
              "text",
              "image"
            ],
            "output": [
              "text"
            ]
          }
        }
      }
    }
  }
}

基于 ACP 协议连接任意 Agent CLI ​

ACP 协议定义了编辑器与 Agent 之间的标准通信接口。通过ACP协议,可以在任意 Client 中注册并使用任意 Agent ,这些 Agent 的注册信息可以在 ACP Registry 中找到。

以 Jetbrains 为例,可以使用官方提供的 ACP Registry 快速配置 ACP,随后在 AI Chat 中使用对应 Agent 。如果有个性化需求,如:

  • 官方ACP Registry 只支持Qoder国际版,需要使用国内版 Qoder CLI
  • IDEA 与 PyCharm 对同一个 ACP Agent 会冗余缓存两份,需要节省硬盘空间。

可考虑手工指定 ACP 配置,编辑下述 ~/.jetbrains/acp.json 文件(点击 Agents 页面左下角的 Edit acp.json 链接),新增自定义的 ACP 配置,以 OpenCode 为例,如下所示:

json
{
  "agent_servers": {
    "OpenCode": {
      // npm i -g @opencode/cli
      "command": "~/.local/bin/opencode",
      "args": [
        "acp"
      ]
    }
  },
  "default_mcp_settings": {}
}

Agent CLI 安装命令汇总 ​

shell
# DeepSeek Harness
npm i -g --allow-scripts=@deepseek-ai/dsh-subprocess-local,koffi,node-pty,@google/genai,protobufjs @deepseek-ai/dsh
# Qoder CN CLI
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm i -g --allow-scripts=@qodercn-ai/qoderclicn,sharp @qodercn-ai/qoderclicn
# Qwen Code
npm i -g --allow-scripts=@qwen-code/audio-capture @qwen-code/qwen-code 
# CodeBuddy Code
npm i -g @tencent-ai/codebuddy-code
# Claude Code
npm i -g --allow-scripts=@anthropic-ai/claude-code @anthropic-ai/claude-code
# Codex
npm i -g @openai/codex
# OpenCode
npm i -g --allow-scripts=@opencode/cli @opencode/cli
# PI
npm i -g --ignore-scripts @earendil-works/pi-coding-agent