AI 开发辅助工具

加速 AI Agent 开发的工具：AI 编码助手、API 管理、调试工具。

AI 编码助手

Cursor（强烈推荐）

https://cursor.com — AI 代码编辑器，基于 VS Code，支持 Composer（多文件编辑）、Agent（自主完成任务）

核心功能：

  • Ctrl+K / Cmd+K：Inline AI 编辑，选中代码后提问或修改
  • Ctrl+L / Cmd+L：Chat 对话，整项目上下文理解
  • Composer：AI 自主创建/修改多个文件，完成整个功能模块
  • Agent 模式：AI 自动执行 git、终端命令，修复 bug
  • 多模型支持：Claude 3.5 / GPT-4o / Gemini 可选

AI Agent 开发场景使用：

1
2
3
1. 用 Composer 快速生成 LangChain Agent 骨架代码
2. 用 Agent 模式自动补全 RAG 流程中的文档处理逻辑
3. 用 Chat 解释第三方 SDK 用法

安装：

1
2
3
4
# Linux
wget -qO /tmp/cursor.AppImage https://cursor.sh/linux/direct && \
chmod +x /tmp/cursor.AppImage && \
mv /tmp/cursor.AppImage ~/.local/bin/cursor

国内下载地址（备选）：

1
https://www.cursor.com/dl/zh-CN

GitHub Copilot

集成在 VS Code / JetBrains / Neovim 的 AI 补全插件

安装：

1
2
3
# VS Code
code --install-extension GitHub.copilot
# 或通过 IDE 插件市场搜索 "GitHub Copilot"

核心功能：

  • Tab 补全（AI 预测下一行）
  • Inline Chat（Ctrl+I 解释 / 重写代码）
  • Copilot Chat（IDE 内对话）
  • PR 摘要

注意：Copilot 更适合辅助编程，Cursor 的 Composer / Agent 模式更适合自主完成 Agent 开发任务。

Claude API（网页版）

https://claude.ai — 直接网页对话，适合快速验证 Prompt、测试 Function Calling Schema

使用场景：

  • 快速验证 Prompt 效果（复制粘贴测试）
  • 生成 JSON Schema（让 Claude 生成 Tool 定义）
  • 调试 Agent 行为

API Key 管理

1Password / Bitwarden（生产推荐）

1
2
# 1Password CLI 获取 API Key
op inject -i .env.template > .env

环境变量管理最佳实践

1
2
3
4
5
6
7
8
# .env 文件（Nginx/不提交到 Git）
OPENAI_API_KEY=sk-xxxxx
ANTHROPIC_API_KEY=sk-ant-xxxxx

# .gitignore 添加
.env
.env.local
.env.production

密钥轮换

平台轮换方式
OpenAIAccount → API Keys → Create new key → 旧 key 90 天后自动失效
AnthropicConsole → Account → API Keys → Create
硅基流动个人中心 → API Key 管理

API 调试工具

HTTPie（替代 curl）

1
2
3
4
5
6
7
8
9
10
11
12
13
# 安装
uv tool install httpie

# 测试 OpenAI API
https api https://api.openai.com/v1/chat/completions \
  Authorization:"Bearer $OPENAI_API_KEY" \
  model="gpt-4o" \
  messages:='[{"role":"user","content":"Hello"}]'

# 测试 Ollama
https POST http://localhost:11434/api/chat \
  model=llama3.2 \
  messages:='[{"role":"user","content":"Hello"}]'

Postman / Insomnia

日志与调试

Python 日志配置（structlog 推荐）

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
import structlog

structlog.configure(
    processors=[
        structlog.stdlib.filter_by_level,
        structlog.stdlib.add_logger_name,
        structlog.stdlib.add_log_level,
        structlog.processors.TimeStamper(fmt="iso"),
        structlog.processors.JSONRenderer()
    ],
    wrapper_class=structlog.stdlib.BoundLogger,
    context_class=dict,
    logger_factory=structlog.stdlib.LoggerFactory(),
)

logger = structlog.get_logger()
logger.info("ai_call", model="gpt-4o", prompt_tokens=120, cost=0.003)

Spring Boot 日志（AI 调用追踪）

1
2
3
4
logging:
  level:
    org.springframework.ai: DEBUG
    com.example.aiagent: DEBUG

模型成本监控

OpenRouter / Portkey（多模型网关）

1
2
3
4
5
6
7
8
9
10
11
12
# Portkey AI - AI 可观测性 + 成本追踪
from langchain_openai import ChatOpenAI
from portkey_ai import Portkey

portkey = Portkey(
    api_key="pk-xxxxx",
    trace_id="agent-001",
    metadata={"user_id": "user123"}
)

# 所有请求自动追踪
llm = ChatOpenAI(model="gpt-4o", callbacks=[portkey])

开发环境快速验证清单

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
# 1. Python 环境
python --version                    # 应该是 3.11+
uv --version                        # uv 已安装

# 2. Java 环境
java --version                      # 应该是 21+
mvn --version                       # Maven 可用

# 3. Docker
docker --version
docker compose version

# 4. Ollama（如使用本地模型）
ollama list

# 5. API Key 验证
curl https://api.openai.com/v1/models \
  -H "Authorization: Bearer $OPENAI_API_KEY" | jq '.data[0].id'