Skip to main content

AI Programming Environment Setup Guide

This document provides detailed instructions on how to set up a complete AI programming development environment, including tool installation, configuration optimization, and troubleshooting common issues.

System Requirements​

Operating System Support​

  • Windows 10/11 or higher
  • macOS 12.0 or higher
  • Linux Ubuntu 20.04 or higher

Hardware Requirements​

  • RAM: 16GB or higher recommended
  • Storage: At least 50GB of free space
  • Network: Stable internet connection

Installation Steps​

1. Install Codely CLI​

Windows (PowerShell)

npm install -g @unity-china/codely-cli

macOS/Linux

npm install -g @unity-china/codely-cli

2. Configure Environment Variables​

Windows

# Add Tuanjie AI to Path
$env:Path += ";C:\Users\<username>\AppData\Roaming\npm"

# Set API key (if needed)
$env:CODELY_TOKEN = "your-api-token"

macOS/Linux

# Add to bash_profile or zshrc
export PATH="$PATH:$HOME/.npm-global/bin"

# Set API key
export CODELY_TOKEN="your-api-token"

3. Verify Installation​

codely --version
codely --help

Configuration Optimization​

Performance Optimization Settings​

Modify configuration file (~/.codely-cli/settings.json)

{
  "model": "gpt-4",
  "max_tokens": 4000,
  "temperature": 0.1,
  "enable_mcp": true,
  "auto_refresh": true
}

IDE Integration​

VS Code Extensions

{
  "recommendations": [
    "unity-china.codely",
    "github.copilot",
    "ms-vscode.cpptools"
  ]
}

Troubleshooting Common Issues​

Installation Failure​

Issue: npm install fails Solution:

  1. Clear npm cache: npm cache clean --force
  2. Update npm: npm install -g npm@latest
  3. Use a domestic npm mirror: npm config set registry https://registry.npmmirror.com

Startup Error​

Issue: codely command not found Solution:

  1. Check Path configuration: echo $PATH or echo %PATH%
  2. Manually add path: export PATH="$PATH:$HOME/.npm-global/bin"
  3. Reinstall: npm uninstall -g @unity-china/codely-cli && npm install -g @unity-china/codely-cli

Connection Issues​

Issue: Unable to connect to AI service Solution:

  1. Check network connection: ping codely.tuanjie.cn
  2. Verify API key: echo $CODELY_TOKEN
  3. Configure proxy (if needed): codely --proxy http://proxy.example.com:8080

Advanced Configuration​

Custom Model Configuration​

Multi-Model Support

# Add custom model
codely model add custom-model --provider openai

# Switch default model
codely --model custom-model

Plugin Management​

Install Plugin

codely extensions install owner/repo --auto-update

Plugin List

codely extensions list

Best Practices​

Environment Management​

  • Version Control: Use tools like nvm (Node Version Manager) to manage Node.js versions
  • Isolated Environments: Create separate development environments for different projects
  • Regular Updates: Keep CLI and related tools up to date

Workflow Optimization​

  • Script Automation: Create automated scripts to reduce repetitive operations
  • Configuration Backup: Regularly back up configuration files
  • Performance Monitoring: Monitor system resource usage

Next Steps​

After completing environment setup, it is recommended to:

  1. Run codely --example-prompt explain-code to test basic functionality
  2. Try basic code analysis tasks
  3. Explore advanced features and plugins

For further assistance, please refer to official documentation or contact technical support.