Files
vibe-coding-cn/i18n/zh/documents/Tutorials and Guides/auggie-mcp配置文档.md
tukuaiai 624ef8d5f9 refactor: 重构目录结构以支持 i18n
创建 'i18n' 目录以存放多语言内容。将所有现有的中文内容(文档、提示词、技能、README)移动到 'i18n/zh/' 中。添加了新的根 README 作为语言入口,并为英文('en')翻译创建了占位符结构。
2025-12-16 21:30:13 +08:00

2.6 KiB
Raw Permalink Blame History

auggie-mcp 详细配置文档

安装步骤

1. 安装 Auggie CLI

npm install -g @augmentcode/auggie@prerelease

2. 用户认证

# 方式一:交互式登录
auggie login

# 方式二:使用 token适用于 CI/CD
export AUGMENT_API_TOKEN="your-token"
export AUGMENT_API_URL="https://i0.api.augmentcode.com/"

Claude Code 配置

添加到用户配置(全局)

claude mcp add-json auggie-mcp --scope user '{
  "type": "stdio",
  "command": "auggie",
  "args": ["--mcp"],
  "env": {
    "AUGMENT_API_TOKEN": "your-token",
    "AUGMENT_API_URL": "https://i0.api.augmentcode.com/"
  }
}'

添加到项目配置(当前项目)

claude mcp add-json auggie-mcp --scope project '{
  "type": "stdio",
  "command": "auggie",
  "args": ["-w", "/path/to/project", "--mcp"],
  "env": {
    "AUGMENT_API_TOKEN": "your-token",
    "AUGMENT_API_URL": "https://i0.api.augmentcode.com/"
  }
}'

Codex 配置

编辑 ~/.codex/config.toml

[mcp_servers."auggie-mcp"]
command = "auggie"
args = ["-w", "/path/to/project", "--mcp"]
startup_timeout_ms = 20000

验证安装

# 检查 MCP 状态
claude mcp list

# 应该显示:
# auggie-mcp: auggie --mcp - ✓ Connected

# 测试功能
claude --print "使用 codebase-retrieval 搜索当前目录下的所有文件"

工具使用示例

1. 搜索特定文件

# 搜索所有 Python 文件
claude --print "使用 codebase-retrieval 搜索 *.py 文件"

# 搜索特定目录
claude --print "使用 codebase-retrieval 搜索 src/ 目录下的文件"

2. 代码分析

# 分析函数实现
claude --print "使用 codebase-retrieval 查找 main 函数的实现"

# 搜索 API 端点
claude --print "使用 codebase-retrieval 搜索所有 API 端点定义"

环境变量配置

创建 ~/.augment/config 文件:

{
  "apiToken": "your-token",
  "apiUrl": "https://i0.api.augmentcode.com/",
  "defaultModel": "gpt-4",
  "workspaceRoot": "/path/to/project"
}

故障排除

1. 连接失败

# 检查 token
auggie token print

# 重新登录
auggie logout && auggie login

2. 路径错误

# 使用绝对路径
auggie -w $(pwd) --mcp

# 检查路径是否存在
ls -la /path/to/project

3. 权限问题

# 检查文件权限
ls -la ~/.augment/

# 修复权限
chmod 600 ~/.augment/session.json

高级配置

自定义缓存目录

export AUGMENT_CACHE_DIR="/custom/cache/path"

设置重试超时

export AUGMENT_RETRY_TIMEOUT=30

禁用确认提示

auggie --allow-indexing --mcp